From nobody@FreeBSD.org  Mon Aug 19 12:50:44 2002
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id D519037B400
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 19 Aug 2002 12:50:44 -0700 (PDT)
Received: from www.freebsd.org (www.FreeBSD.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 829FF43E75
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 19 Aug 2002 12:50:44 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.12.4/8.12.4) with ESMTP id g7JJoiOT098998
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 19 Aug 2002 12:50:44 -0700 (PDT)
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.12.4/8.12.4/Submit) id g7JJoiCv098997;
	Mon, 19 Aug 2002 12:50:44 -0700 (PDT)
Message-Id: <200208191950.g7JJoiCv098997@www.freebsd.org>
Date: Mon, 19 Aug 2002 12:50:44 -0700 (PDT)
From: Jerry Dunham <jdunham@m3designinc.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Documentation formatting error
X-Send-Pr-Version: www-1.0

>Number:         41791
>Category:       docs
>Synopsis:       Documentation formatting error
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Aug 19 13:00:03 PDT 2002
>Closed-Date:    Mon Jan 10 22:04:26 GMT 2005
>Last-Modified:  Mon Jan 10 22:04:26 GMT 2005
>Originator:     Jerry Dunham
>Release:        4.6
>Organization:
M3 Design, Inc.
>Environment:
No output.  Still installing.
>Description:
      I'm installing 4.6 for the first time.  I read all the documentation accessed via sysinstall, but had a minor problem.  All the documentation appears to be exactly one character wider than
my screen.  I'm losing the rightmost character of many lines.
>How-To-Repeat:
      Install FreeBSD 4.6.
>Fix:
      Reformat text files with lines one character shorter or start lines one character further to the left.
>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Jerry Dunham <jdunham@m3designinc.com>
Cc: bmah@FreeBSD.org, bug-followup@FreeBSD.org
Subject: Re: docs/41791: Documentation formatting error
Date: Mon, 26 Aug 2002 04:01:43 +0300

 On 2002-08-19 12:50 +0000, Jerry Dunham wrote:
 >       I'm installing 4.6 for the first time.  I read all the
 > documentation accessed via sysinstall, but had a minor problem.  All
 > the documentation appears to be exactly one character wider than my
 > screen.  I'm losing the rightmost character of many lines.
 
 I think I know why this happens...
 
 sysinstall uses libdialog as the interface library.  The READMEs and
 other text files are displayed in a text dialog box that is COLS
 columns wide and ROWS rows high.  The rightmost and leftmost columns
 are saved for the libdialog borders.  Thus the maximum visible width
 of a text file in libdialog is (COLS-2) columns.  In an 80-column
 terminal, this is 78.  But the documentation files are formatted with
 a -width option of 80 and thus sometimes wrap at 79 columns.
 
 I think we should probably set HTML2TXTFLAGS to add extra `-width 78'
 options to links while building the release notes.
 
 Bruce, what do you think abou this?
 
 - Giorgos
 

From: bmah@FreeBSD.org (Bruce A. Mah)
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: Jerry Dunham <jdunham@m3designinc.com>, bmah@FreeBSD.org,
	bug-followup@FreeBSD.org
Subject: Re: docs/41791: Documentation formatting error 
Date: Mon, 26 Aug 2002 10:06:41 -0700

 --==_Exmh_1094554506P
 Content-Type: text/plain; charset=us-ascii
 
 If memory serves me right, Giorgos Keramidas wrote:
 > On 2002-08-19 12:50 +0000, Jerry Dunham wrote:
 > >       I'm installing 4.6 for the first time.  I read all the
 > > documentation accessed via sysinstall, but had a minor problem.  All
 > > the documentation appears to be exactly one character wider than my
 > > screen.  I'm losing the rightmost character of many lines.
 
 FYI:  Horizontal scrolling when viewing files works.
 
 That's not a solution to the real problem, but just mentioning this fact.
 
 > I think I know why this happens...
 > 
 > sysinstall uses libdialog as the interface library.  The READMEs and
 > other text files are displayed in a text dialog box that is COLS
 > columns wide and ROWS rows high.  The rightmost and leftmost columns
 > are saved for the libdialog borders.  Thus the maximum visible width
 > of a text file in libdialog is (COLS-2) columns.  In an 80-column
 > terminal, this is 78.  But the documentation files are formatted with
 > a -width option of 80 and thus sometimes wrap at 79 columns.
 > 
 > I think we should probably set HTML2TXTFLAGS to add extra `-width 78'
 > options to links while building the release notes.
 
 Does this option actually exist?  My links might be out of date, but:
 
 nimitz:TRACES% links -dump -width 78 http://www.freebsd.org/index.html
 Unknown option -width
 
 Note that we use the www/links1 port, not www/links, for generating the 
 text docs.
 
 > Bruce, what do you think abou this?
 
 No objections, subject to this actually working.  :-)
 
 Thanks,
 
 Bruce.
 
 
 
 --==_Exmh_1094554506P
 Content-Type: application/pgp-signature
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.0.7 (FreeBSD)
 Comment: Exmh version 2.5+ 20020506
 
 iD8DBQE9amAg2MoxcVugUsMRAj8NAKDkjG7T6chaSPiwtBWEs7YHRODK2QCgj+xj
 dh0vnU2B1o5S/NVM8O7QdM8=
 =nlN+
 -----END PGP SIGNATURE-----
 
 --==_Exmh_1094554506P--
Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Wed Dec 29 09:37:37 GMT 2004 
Responsible-Changed-Why:  
I'll work on fixing this. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=41791 
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Mon Jan 10 22:01:22 GMT 2005 
State-Changed-Why:  
The default line length is now 72 columns.  This should fix the problem 
described for running text.  Inline ASCII art is usually enclosed in <pre> 
tags in the HTML output and left intact in text-only output, so some parts of 
the release notes *may* still cross the 78-column limit, but this should be 
very rare. 

Jerry, thanks for submitting the problem report and, most of all, thanks for 
reminding me that this needs handling despite the fact a long time passed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=41791 
>Unformatted:
