From owner-freebsd-doc Tue Dec 4 6:16:14 2001 Delivered-To: freebsd-doc@freebsd.org Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by hub.freebsd.org (Postfix) with ESMTP id E150337B41B for ; Tue, 4 Dec 2001 06:16:05 -0800 (PST) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.11.6/8.11.2) id fB4EBHI77276; Tue, 4 Dec 2001 16:11:17 +0200 (EET) (envelope-from ru) Date: Tue, 4 Dec 2001 16:11:17 +0200 From: Ruslan Ermilov To: Giorgos Keramidas Cc: "Gary W. Swearingen" , freebsd-doc@FreeBSD.ORG Subject: Re: How do I unformat a man page like /tmp/man.1? Message-ID: <20011204161117.D67698@sunbay.com> References: <20011203115234.GB1560@hades.hell.gr> <7o667om8ff.67o@localhost.localdomain> <20011204101659.A26925@sunbay.com> <20011204140336.GC68120@hades.hell.gr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20011204140336.GC68120@hades.hell.gr> User-Agent: Mutt/1.3.23i 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 On Tue, Dec 04, 2001 at 04:03:36PM +0200, Giorgos Keramidas wrote: > On 2001-12-04 10:16:59, Ruslan Ermilov wrote: > > On Mon, Dec 03, 2001 at 11:04:52AM -0800, Gary W. Swearingen wrote: > > > This command > > > > > > zcat /usr/share/man/man5/named.conf.5.gz | nroff -mandoc | less > > > > > > gives dozens of these lines with increasing line numbers (along with > > > occasional spurts of good output): > > > > > > mdoc warning: Empty input line #19 > > > > > Yeah, I know. New mdoc(7) does a very good job of notifying about bad > > formatted manpages (on stderr), and this manpage is from contrib/bind > > part of the CVS tree, and I have had patches for contrib/ and crypto/ > > for almost a year now (see attached). > > These are really empty lines. It's not a problem of the terminal or > of Gary's revision of the manpage. I checked it here, and he's right, > groff complains for dozens of lines. > It's not the groff who complains, it's the mdoc(7) package. :-) > Gary has told me in private mail that he will try to get the BIND > developers to correct these errors in their own tree, so that a future > import of BIND sources will bring these cleanly in our CVS tree. > Great news! I do have a mega-patch for contrib/bind manuals that fixes all mdoc and groff warnings for them. I suggest that Gary talks to me, and I'll send him this patch on request. > For the moment, the simple work-around is to use grep, in order to > remove whitespace-only lines, before calling groff. > > % zcat manpage.gz | grep -v '^[[:space:]]$' | nroff -mandoc > This is not quite correct. Empty lines are permitted within mdoc(7) displays (.Bd/.Ed). 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