From owner-freebsd-doc Thu Dec 13 2:20:23 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 304CF37B41F for ; Thu, 13 Dec 2001 02:20:02 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id fBDAK1t18753; Thu, 13 Dec 2001 02:20:02 -0800 (PST) (envelope-from gnats) Date: Thu, 13 Dec 2001 02:20:02 -0800 (PST) Message-Id: <200112131020.fBDAK1t18753@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Ruslan Ermilov Subject: Re: docs/32676: file(1) formatting nit Reply-To: Ruslan Ermilov Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/32676; it has been noted by GNATS. From: Ruslan Ermilov To: Rich Morin 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 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message