From rdm@cfcl.com  Mon Dec 10 09:34:43 2001
Return-Path: <rdm@cfcl.com>
Received: from idiom.com (idiom.com [216.240.32.1])
	by hub.freebsd.org (Postfix) with ESMTP id CEA2537B405
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 10 Dec 2001 09:34:42 -0800 (PST)
Received: from cfcl.com (cpe-24-221-169-54.ca.sprintbbd.net [24.221.169.54])
	by idiom.com (8.9.3/8.9.3) with ESMTP id JAA08575
	for <FreeBSD-gnats-submit@freebsd.org>; Mon, 10 Dec 2001 09:34:41 -0800 (PST)
Received: (from rdm@localhost)
	by cfcl.com (8.11.1/8.11.1) id fBAHb2R12162;
	Mon, 10 Dec 2001 09:37:02 -0800 (PST)
	(envelope-from rdm)
Message-Id: <200112101737.fBAHb2R12162@cfcl.com>
Date: Mon, 10 Dec 2001 09:37:02 -0800 (PST)
From: Rich Morin <rdm@cfcl.com>
Reply-To: rdm@cfcl.com
To: FreeBSD-gnats-submit@freebsd.org
Subject: file(1) formatting nit
X-Send-Pr-Version: 3.2

>Number:         32676
>Category:       docs
>Synopsis:       file(1) formatting nit
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Dec 10 09:40:00 PST 2001
>Closed-Date:    Tue Dec 11 23:59:52 PST 2001
>Last-Modified:  Thu Dec 13 02:20:01 PST 2001
>Originator:     Rich Morin
>Release:        FreeBSD 4.4-RELEASE i386
>Organization:
Canta Forda Computer Laboratory
>Environment:

        FreeBSD fb42.cfcl.com 4.2-RELEASE FreeBSD 4.2-RELEASE #0:
        Mon Nov 20 13:02:55 GMT 2000
        jkh@bento.FreeBSD.org:/usr/src/sys/compile/GENERIC  i386

>Description:

	In the file(1) man page (just above the HISTORY section, the
        following line runs off the right-hand margin:

          file: application/x-executable, dynamically linked (uses
            shared libs), not stripped

>How-To-Repeat:

	% man file

>Fix:

	Fold the example text.

>Release-Note:
>Audit-Trail:

From: Hiten Pandya <hitmaster2k@yahoo.com>
To: freebsd-gnats-submit@FreeBSD.org
Cc: rdm@cfcl.com
Subject: Re: docs/32676: file(1) formatting nit
Date: Mon, 10 Dec 2001 10:04:31 -0800 (PST)

 here is that patch for it...
 
 --- file.1 Tue Oct 9 08:31:02 2001
 +++ file.1.new Mon Dec 10 17:51:20 2001
 @@ -340,7 +340,8 @@
 
 $ file -i file.c file /dev/hda
 file.c: text/x-c
 -file: application/x-executable, dynamically linked
 (uses shared libs), not stripped
 +file: application/x-executable, dynamically linked
 (uses shared libs), 
 + not stripped
 /dev/hda: application/x-not-regular-file
 .Ed
 .Sh HISTORY
 
 =Hiten Pandya
 =<hiten@uk.freebsd.org>
 
 __________________________________________________
 Do You Yahoo!?
 Send your FREE holiday greetings online!
 http://greetings.yahoo.com

From: Alexey Zelkin <phantom@ark.cris.net>
To: Hiten Pandya <hitmaster2k@yahoo.com>
Cc: freebsd-gnats-submit@FreeBSD.ORG, rdm@cfcl.com
Subject: Re: docs/32676: file(1) formatting nit
Date: Mon, 10 Dec 2001 20:59:34 +0200

 hi,
 
 Please submit this change to file's maintainer <christos@netbsd.org>.
 Per David's note he's very responsive to external submissions and
 this change should come with next contrib/file import.
 
 On Mon, Dec 10, 2001 at 10:04:31AM -0800, Hiten Pandya wrote:
 > here is that patch for it...
 > 
 > --- file.1 Tue Oct 9 08:31:02 2001
 > +++ file.1.new Mon Dec 10 17:51:20 2001
 > @@ -340,7 +340,8 @@
 > 
 > $ file -i file.c file /dev/hda
 > file.c: text/x-c
 > -file: application/x-executable, dynamically linked
 > (uses shared libs), not stripped
 > +file: application/x-executable, dynamically linked
 > (uses shared libs), 
 > + not stripped
 > /dev/hda: application/x-not-regular-file
 > .Ed
 > .Sh HISTORY
 > 
 > =Hiten Pandya
 > =<hiten@uk.freebsd.org>
 > 
 > __________________________________________________
 > Do You Yahoo!?
 > Send your FREE holiday greetings online!
 > http://greetings.yahoo.com
 > 
 > To Unsubscribe: send mail to majordomo@FreeBSD.org
 > with "unsubscribe freebsd-doc" in the body of the message
State-Changed-From-To: open->closed 
State-Changed-By: ru 
State-Changed-When: Tue Dec 11 23:59:52 PST 2001 
State-Changed-Why:  
It's normal for literal text to be displayed exactly as 
shown by a corresponding utility, thus causing wraps. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=32676 

From: Ruslan Ermilov <ru@FreeBSD.org>
To: Hiten Pandya <hitmaster2k@yahoo.com>
Cc: bug-followup@FreeBSD.org, rdm@cfcl.com
Subject: Re: docs/32676: file(1) formatting nit
Date: Wed, 12 Dec 2001 09:59:35 +0200

 On Mon, Dec 10, 2001 at 10:04:31AM -0800, Hiten Pandya wrote:
 > here is that patch for it...
 > 
 > --- file.1 Tue Oct 9 08:31:02 2001
 > +++ file.1.new Mon Dec 10 17:51:20 2001
 > @@ -340,7 +340,8 @@
 > 
 > $ file -i file.c file /dev/hda
 > file.c: text/x-c
 > -file: application/x-executable, dynamically linked
 > (uses shared libs), not stripped
 > +file: application/x-executable, dynamically linked
 > (uses shared libs), 
 > + not stripped
 > /dev/hda: application/x-not-regular-file
 > .Ed
 > .Sh HISTORY
 > 
 Starting lines with a space is bogus, and causes groff(1)
 to stop formatting the current line.  There's nothing wrong
 with some text running of a right margin; manpages display
 "literal" text exactly as it is shown by a program, and the
 output of man(1) could be controlled by a pager utility
 like more(1) or less(1).
 
 
 Cheers,
 -- 
 Ruslan Ermilov		Oracle Developer/DBA,
 ru@sunbay.com		Sunbay Software AG,
 ru@FreeBSD.org		FreeBSD committer,
 +380.652.512.251	Simferopol, Ukraine
 
 http://www.FreeBSD.org	The Power To Serve
 http://www.oracle.com	Enabling The Information Age

From: Rich Morin <rdm@cfcl.com>
To: bug-followup@FreeBSD.org
Cc: Ruslan Ermilov <ru@FreeBSD.org>
Subject: Re: docs/32676: file(1) formatting nit
Date: Wed, 12 Dec 2001 09:39:00 -0800

 At 9:59 AM +0200 12/12/01, Ruslan Ermilov wrote:
 >Starting lines with a space is bogus, and causes groff(1)
 >to stop formatting the current line.  There's nothing wrong
 >with some text running of a right margin; manpages display
 >"literal" text exactly as it is shown by a program, and the
 >output of man(1) could be controlled by a pager utility
 >like more(1) or less(1).
 
 Actually, my concern has more to do with the printed form of
 the man page, where part of this line runs off the right-hand
 edge of the page and disappears.  Although you could make a
 weak (IMHO) argument that this is more accurate than folding
 the line, it still looks unprofessional.
 
 -r
 -- 
 email: rdm@cfcl.com; phone: +1 650-873-7841
 http://www.cfcl.com/rdm    - my home page, resume, etc.
 http://www.cfcl.com/Meta   - The FreeBSD Browser, Meta Project, etc.
 http://www.ptf.com/dossier - Prime Time Freeware's DOSSIER series
 http://www.ptf.com/tdc     - Prime Time Freeware's Darwin Collectiontion

From: Ruslan Ermilov <ru@FreeBSD.org>
To: Rich Morin <rdm@cfcl.com>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/32676: file(1) formatting nit
Date: Thu, 13 Dec 2001 11:16:32 +0200

 On Wed, Dec 12, 2001 at 09:39:00AM -0800, Rich Morin wrote:
 > At 9:59 AM +0200 12/12/01, Ruslan Ermilov wrote:
 > >Starting lines with a space is bogus, and causes groff(1)
 > >to stop formatting the current line.  There's nothing wrong
 > >with some text running of a right margin; manpages display
 > >"literal" text exactly as it is shown by a program, and the
 > >output of man(1) could be controlled by a pager utility
 > >like more(1) or less(1).
 > 
 > Actually, my concern has more to do with the printed form of
 > the man page, where part of this line runs off the right-hand
 > edge of the page and disappears.  Although you could make a
 > weak (IMHO) argument that this is more accurate than folding
 > the line, it still looks unprofessional.
 > 
 Hmm, that sounds reasonable.  I'll see how many manpages
 break if I change mdoc(7) literal displays to do filling.
 
 
 Cheers,
 -- 
 Ruslan Ermilov		Oracle Developer/DBA,
 ru@sunbay.com		Sunbay Software AG,
 ru@FreeBSD.org		FreeBSD committer,
 +380.652.512.251	Simferopol, Ukraine
 
 http://www.FreeBSD.org	The Power To Serve
 http://www.oracle.com	Enabling The Information Age
>Unformatted:
