Re: mandoc(1) Fatal error(s)

[Martin Husemann <martin%duskware.de@localhost>]

On Thu, Feb 21, 2013 at 12:19:40AM -0800, jgw%sdf.org@localhost wrote:
> % mandoc -Tlint geomyidae.8
> geomyidae.8:84:2: ERROR: missing end of block: It breaks Bd

I got a few hints from Alan Barret:
the message could slightly be improved. Basically it is trying to tell
you that you have a .It item inside a .Bd/.Ed block instead of a list,
which is incorrect nesting.

It would make some kind of sense if the nesting looked like:

 .Bl
   .It
     .Bd
       ...
     .Ed
   .It
     .Bd
       ...
     .Ed
 .El

but using a "display" for this seems dubious (this is no quote, or
code sniplet, just plain english), so the easiest fix is to delete the
.Bd and .Ed lines completely.

>   % nl geomyidae.8 | sed -n '78,97p'
>     77  .
>     78  .Sh OPTIONS
>     79  geomyidae options and default settings:
>     80  .Bl -tag -width ".Fl test Ao Ar string Ac"
>     81  .
>     82  .Bd -filled
>     83  .It Fl d
>     84  Don't fork into background
>     85  .Ed
>     86  .
>     87  .Bd -filled
>     88  .It Fl l Ar logfile
>     89  Specify file where log output is written (no default)
>     90  .Ed
>     91  .
>     92  .Bd -filled
>     93  .It Fl v Ar loglevel
>     94  Set the logging level (default: 7)
>     95  .Ed
>     96  .
> 
> And for comparision, the groff(1) output:
> 
>   % groff -wall -bz -mdoc -Tascii geomyidae.8
>    <zip, nada, zilch> 

Groff is a bit too forgiving :-)

Martin