deroff(1) and deroff (1b) with mdoc(7) (was: demandoc(1))

From: Graham Perrin <grahamperrin_at_freebsd.org>
Date: Sun, 06 Aug 2023 11:32:51 UTC
From 
<https://docs.freebsd.org/en/books/fdp-primer/book/#manual-pages-markup>:

> … Most existing FreeBSD manual pages, and all new ones, use the 
> mdoc(7) form …

<https://man.freebsd.org/cgi/man.cgi?query=mdoc&sektion=7&manpath=freebsd-release>


On 06/08/2023 06:13, Bakul Shah wrote:

> …
>
> Isn't deroff good enough?

Interesting, thanks.


<https://www.freshports.org/sysutils/heirloom/>

deroff(1) /usr/local/heirloom/usr/5bin/deroff is potentially more useful 
than
deroff(1b) /usr/local/heirloom/usr/ucb/deroff however
deroff(1) removes a little too much; 
<https://reviews.freebsd.org/P600$148-153>.


<https://www.freshports.org/devel/plan9port/>

deroff(1) in Plan 9 from User Space has:

- a manual page that differs from deroff(1) and deroff(1b) in the 
Heirloom Toolchest

- the same glitch (below).


% cat /usr/src/share/man/man8/rc.8 | grep Operation\ of
.Ss Operation of Nm
.Ss Operation of Nm rc.shutdown
% /usr/local/plan9/bin/deroff /usr/src/share/man/man8/rc.8 | grep Operation
Operation
Operation   rc.shutdown
%