From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1P1P1n-0005bs-J9 for garchives@archives.gentoo.org; Thu, 30 Sep 2010 19:42:51 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 53083E0AA2; Thu, 30 Sep 2010 19:42:36 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 1C688E0AA2 for ; Thu, 30 Sep 2010 19:42:36 +0000 (UTC) Received: from localhost (localhost [127.0.0.1]) by smtp.gentoo.org (Postfix) with ESMTP id C103C1B4044 for ; Thu, 30 Sep 2010 19:42:35 +0000 (UTC) X-Virus-Scanned: by amavisd-new using ClamAV at gentoo.org X-Spam-Score: -2.276 X-Spam-Level: X-Spam-Status: No, score=-2.276 required=5.5 tests=[AWL=0.323, BAYES_00=-2.599] Received: from smtp.gentoo.org ([127.0.0.1]) by localhost (smtp.gentoo.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id qvRMkxFL7Au8 for ; Thu, 30 Sep 2010 19:42:29 +0000 (UTC) Received: from lo.gmane.org (lo.gmane.org [80.91.229.12]) by smtp.gentoo.org (Postfix) with ESMTP id E84AD1B4025 for ; Thu, 30 Sep 2010 19:42:25 +0000 (UTC) Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1P1P1K-0005Ef-B8 for gentoo-user@gentoo.org; Thu, 30 Sep 2010 21:42:22 +0200 Received: from dsl.comtrol.com ([64.122.56.22]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 30 Sep 2010 21:42:22 +0200 Received: from grant.b.edwards by dsl.comtrol.com with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 30 Sep 2010 21:42:22 +0200 X-Injected-Via-Gmane: http://gmane.org/ To: gentoo-user@lists.gentoo.org From: Grant Edwards Subject: [gentoo-user] Re: ridiculously wide handbook pages Date: Thu, 30 Sep 2010 19:42:05 +0000 (UTC) Message-ID: References: <4CA4D967.4000900@gmail.com> <4CA4E19D.7000303@gmail.com> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-user@lists.gentoo.org Reply-to: gentoo-user@lists.gentoo.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: dsl.comtrol.com User-Agent: slrn/pre0.9.9-102 (Linux) X-Archives-Salt: 90c997d5-8a45-4277-96b1-60cd4f36058a X-Archives-Hash: 0ae3644461677b87e1cf5333519287f2 On 2010-09-30, Dale wrote: > Grant Edwards wrote: > >>>> http://www.gentoo.org/proj/en/base/embedded/handbook/?part=1&chap=2 >>>> >>>> >>> This one has a horizontal scrollbar but only adjust about a half inch or >>> so. It almost fits. >>> >> Are the text paragraphs re-wrapped as you narrow the window? > > That one has a scrollbar no matter what. It appears that section "Code > Listing 2.4: Using SH4 cross-compiler" is making it really long. It has > a line in that box that is pretty long. It's the longest line I saw in > the whole page. > > So, it appears as someone else posted that the pretty blue boxes set > the minimum width. I think that's definitely the issue. > Whatever is the longest line sets the width. How would one go about > changing that I wonder? I think it can probably be set in the CSS stylesheet, but I'm pretty fuzzy when it comes to CSS details. I do know that the web pages I generate with asciidoc don't have this problem. In general, the width of the text paragraphs is determined by the browser width, but listing blocks don't get wrapped and you may have to scroll over to see the ends of the really wide ones. I usually set a max text width as well, so that if you do widen your browser window to see the really wide listing blocks, you still end up with text columns that max out at a reasonable width. Setting a max-width for text is probably more a matter of taste/style, but I don't think that anybody can argue that having the minium text width determined by the maximum listing width is right. > I know when someone posts a long command on this mailing list, it > makes it hard to understand when Seamonkey shops it up into two > lines. We definitely don't want to wrap things like command lines, config file listings, code listings, and program input/output. That's why you (directly or indirectly) assign them a different CSS style or object type -- so that you can do things like wrap normal text and not listings or examples. > Most people are good enough to post that the command has to be all on > one line tho. It appears that a email problem is also a website > problem too. When to wrap a line and when not to? I don't think listings/code/shell-examples should not be wrapped, and AFAIK, nobody's arguing that they should be. However, I do assert that normal text paragraphs should be wrapped to fit within the browser window. In text-only e-mail messages, there's no way to tell the difference between the two. Whatever's generating the HTML/CSS for the Gentoo manual web pages does know the difference, and should be able to do The Right Thing(tm). The manual HTML is definitely machine-generated, but I can't tell you by what at this point, so I can't offer a specific fix... -- Grant Edwards grant.b.edwards Yow! Can you MAIL a BEAN at CAKE? gmail.com