Date: Tue, 4 Dec 2001 16:11:17 +0200 From: Ruslan Ermilov <ru@FreeBSD.ORG> To: Giorgos Keramidas <charon@labs.gr> Cc: "Gary W. Swearingen" <swear@blarg.net>, freebsd-doc@FreeBSD.ORG Subject: Re: How do I unformat a man page like /tmp/man.1? Message-ID: <20011204161117.D67698@sunbay.com> In-Reply-To: <20011204140336.GC68120@hades.hell.gr> References: <mcelmcn7ux.lmc@localhost.localdomain> <20011203115234.GB1560@hades.hell.gr> <7o667om8ff.67o@localhost.localdomain> <20011204101659.A26925@sunbay.com> <20011204140336.GC68120@hades.hell.gr>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20011204161117.D67698>