Subject: misc/2849: .Nx macro in mdoc doesn't work without parameter
To: None <gnats-bugs@gnats.netbsd.org>
From: Perry E. Metzger <perry@piermont.com>
List: netbsd-bugs
Date: 10/15/1996 18:35:16
>Number: 2849
>Category: misc
>Synopsis: .Nx macro in mdoc doesn't work without parameter
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: misc-bug-people (Misc Bug People)
>State: open
>Class: sw-bug
>Submitter-Id: net
>Arrival-Date: Tue Oct 15 15:50:01 1996
>Last-Modified:
>Originator: Perry E. Metzger
>Organization:
Perry Metzger perry@piermont.com
--
>Release: 1.2A
>Environment:
System: NetBSD jekyll.piermont.com 1.2_ALPHA NetBSD 1.2_ALPHA (JEKYLL) #46: Sat Jun 1 14:07:34 EDT 1996 perry@jekyll.piermont.com:/usr/src/sys/arch/i386/compile/JEKYLL i386
>Description:
NetBSD has added a .Nx macro to the mdoc macros, by analogy to .Ux and
.Bx. This should print
NetBSD 1.2
as a result of
.Nx 1.2
and should print
NetBSD
as a result of
.Nx
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.
>How-To-Repeat:
Just try a bare
.Nx
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.)
>Fix:
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.
>Audit-Trail:
>Unformatted: