Subject: Re: bin/14591
To: None <wiz@netbsd.org>
From: Jeremy C. Reed <reed@reedmedia.net>
List: netbsd-bugs
Date: 03/06/2002 08:57:29
On 6 Mar 2002 wiz@netbsd.org wrote:

> Synopsis: "man -h mail" outputs over 590 lines of junk
>
> State-Changed-From-To: open->closed
> State-Changed-By: wiz
> State-Changed-When: Wed Mar 6 06:09:26 PST 2002
> State-Changed-Why:
> mdoc Problem: man(1) looks for DESCRIPTION, which was missing in that
> particular man page. I'll go hunt down any other man pages that have this
> problem now.
> Thanks for the PR!

You're welcome.

I'm glad you found the problem. (I should have looked myself.)

I see now that DESCRIPTION is "mandatory" (as documented in mdoc.samples).

I was thinking that the how() in /usr.bin/man/man.c should also consider
that the SYNOPSIS is finished by maybe checking for lines starting with
".Sh" and maybe for lines that do not start with ".Nm", ".Op", ".Ar",
".Bk" , ".Ek" or ".Fl".  But I see it uses the formated (cat) page.

Or maybe it should check for "INTRODUCTION" and "RETURN VALUES" also.

I also tried simply checking for a blank line, but it only works for some,
e.g. it doesn't work for as(1).

   Jeremy C. Reed
   http://www.reedmedia.net/