Subject: misc/2849: .Nx macro in mdoc doesn't work without parameter
To: None <email@example.com>
From: Perry E. Metzger <firstname.lastname@example.org>
Date: 10/15/1996 18:35:16
>Synopsis: .Nx macro in mdoc doesn't work without parameter
>Responsible: misc-bug-people (Misc Bug People)
>Arrival-Date: Tue Oct 15 15:50:01 1996
>Originator: Perry E. Metzger
Perry Metzger email@example.com
System: NetBSD jekyll.piermont.com 1.2_ALPHA NetBSD 1.2_ALPHA (JEKYLL) #46: Sat Jun 1 14:07:34 EDT 1996 firstname.lastname@example.org:/usr/src/sys/arch/i386/compile/JEKYLL i386
NetBSD has added a .Nx macro to the mdoc macros, by analogy to .Ux and
.Bx. This should print
as a result of
and should print
as a result of
However, as it turns out, it doesn't work right when the macro is used
bare -- in particular, it prints nothing at all when you just do ".Nx"
alone on a line. ".Nx 1.2" works just fine.
Just try a bare
in a mdoc file.
Today, I hacked the mdoc.7 and mdoc.samples.7 man pages to contain
documentation for the .Nx macro -- these files now contain
uses of .Nx, and you can see how things fail by trying them out and
how the similar macros .Ux and .Bx work when used bare. (Today's
source tree or later will contain this documentation.)
Lord knows. I'm not a *roff hacker. To me it might as well be chinese.
Someone who actually understands ?roff is going to have to go in and
fix the thing. It is, however, a matter of importance -- lots of
documentation could use the .Nx macro.