Subject: misc/32546: Assorted mdoc warning fixes
To: None <misc-bug-people@netbsd.org, gnats-admin@netbsd.org,>
From: None <njoly@pasteur.fr>
List: netbsd-bugs
Date: 01/16/2006 14:10:00
>Number:         32546
>Category:       misc
>Synopsis:       Assorted mdoc warning fixes
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Jan 16 14:10:00 +0000 2006
>Originator:     Nicolas Joly
>Release:        NetBSD 3.99.15
>Organization:
Institut Pasteur, Paris.
>Environment:
System: NetBSD lanfeust.sis.pasteur.fr 3.99.15 NetBSD 3.99.15 (LANFEUST) #6: Tue Jan 10 11:15:40 CET 2006 njoly@lanfeust.sis.pasteur.fr:/local/src/NetBSD/obj/amd64/sys/arch/amd64/compile/LANFEUST amd64
Architecture: x86_64
Machine: amd64
>Description:
While building -current on my NetBSD/amd64, i noticed some mdoc warnings:

#    format  user/groupadd.cat8
PATH=/local/src/NetBSD/tool/amd64/lib/groff:${PATH} /local/src/NetBSD/tool/amd64
/bin/nbnroff -mandoc /local/src/NetBSD/src/usr.sbin/user/groupadd.8   > groupadd
.cat8.tmp && mv groupadd.cat8.tmp groupadd.cat8
mdoc warning: A .Bl directive has no matching .El (#67)
[...]
#    format  man4.hpcsh/psh3tp.cat4
PATH=/local/src/NetBSD/tool/amd64/lib/groff:${PATH} /local/src/NetBSD/tool/amd64
/bin/nbnroff -mandoc /local/src/NetBSD/src/share/man/man4/man4.hpcsh/psh3tp.4   
> psh3tp.cat4.tmp && mv psh3tp.cat4.tmp psh3tp.cat4
mdoc warning: extraneous .El call (#44)
[...]
#    format  man4/pci.cat4
PATH=/local/src/NetBSD/tool/amd64/lib/groff:${PATH} /local/src/NetBSD/tool/amd64
/bin/nbnroff -mandoc /local/src/NetBSD/src/share/man/man4/pci.4   > pci.cat4.tmp
 && mv pci.cat4.tmp pci.cat4
mdoc warning: A .Bl directive has no matching .El (#134)
[...]
#    format  man9/signal.cat9
PATH=/local/src/NetBSD/tool/amd64/lib/groff:${PATH} /local/src/NetBSD/tool/amd64
/bin/nbnroff -mandoc /local/src/NetBSD/src/share/man/man9/signal.9   > signal.ca
t9.tmp && mv signal.cat9.tmp signal.cat9
mdoc warning: A .Bd directive has no matching .Ed (#557)
[...]
#    format  man9/vfs_hooks.cat9
PATH=/local/src/NetBSD/tool/amd64/lib/groff:${PATH} /local/src/NetBSD/tool/amd64
/bin/nbnroff -mandoc /local/src/NetBSD/src/share/man/man9/vfs_hooks.9   > vfs_ho
oks.cat9.tmp && mv vfs_hooks.cat9.tmp vfs_hooks.cat9
mdoc warning: A .Bl directive has no matching .El (#99)

>How-To-Repeat:
cd src && ./build.sh build | grep 'mdoc warning'
>Fix:
Index: usr.sbin/user/groupadd.8
===================================================================
RCS file: /cvsroot/src/usr.sbin/user/groupadd.8,v
retrieving revision 1.15
diff -u -r1.15 groupadd.8
--- usr.sbin/user/groupadd.8	25 Nov 2005 08:00:18 -0000	1.15
+++ usr.sbin/user/groupadd.8	16 Jan 2006 14:07:53 -0000
@@ -64,6 +64,7 @@
 Enable verbose mode - explain the commands as they are executed.
 This option is included if built with
 .Dv EXTENSIONS .
+.El
 .Sh EXIT STATUS
 .Ex -std groupadd
 .Sh SEE ALSO
Index: share/man/man4/pci.4
===================================================================
RCS file: /cvsroot/src/share/man/man4/pci.4,v
retrieving revision 1.80
diff -u -r1.80 pci.4
--- share/man/man4/pci.4	9 Oct 2005 15:15:36 -0000	1.80
+++ share/man/man4/pci.4	16 Jan 2006 14:07:54 -0000
@@ -131,6 +131,7 @@
 .Pp
 If a valid interrupt has already been assigned to a device, this
 option leaves the interrupt as is.
+.El
 .Sh HARDWARE
 .Nx
 includes machine-independent
Index: share/man/man4/man4.hpcsh/psh3tp.4
===================================================================
RCS file: /cvsroot/src/share/man/man4/man4.hpcsh/psh3tp.4,v
retrieving revision 1.1
diff -u -r1.1 psh3tp.4
--- share/man/man4/man4.hpcsh/psh3tp.4	23 May 2005 17:44:25 -0000	1.1
+++ share/man/man4/man4.hpcsh/psh3tp.4	16 Jan 2006 14:07:54 -0000
@@ -41,7 +41,6 @@
 Pen movements are passed to
 .Xr wsmouse 4
 as mouse clicks and drags.
-.El
 .Sh SEE ALSO
 .Xr adc 4 ,
 .Xr wsmouse 4 ,
Index: share/man/man9/signal.9
===================================================================
RCS file: /cvsroot/src/share/man/man9/signal.9,v
retrieving revision 1.12
diff -u -r1.12 signal.9
--- share/man/man9/signal.9	20 Dec 2005 19:53:15 -0000	1.12
+++ share/man/man9/signal.9	16 Jan 2006 14:07:54 -0000
@@ -554,6 +554,7 @@
 The current signal trampoline is:
 .Bd -literal -offset indent
 __sigtramp_siginfo_2
+.Ed
 .Sh SEE ALSO
 .Xr sigaction 2 ,
 .Xr signal 7 ,
Index: share/man/man9/vfs_hooks.9
===================================================================
RCS file: /cvsroot/src/share/man/man9/vfs_hooks.9,v
retrieving revision 1.2
diff -u -r1.2 vfs_hooks.9
--- share/man/man9/vfs_hooks.9	23 Sep 2005 20:29:08 -0000	1.2
+++ share/man/man9/vfs_hooks.9	16 Jan 2006 14:07:54 -0000
@@ -96,6 +96,7 @@
 Runs all hooks for the VFS unmount operation.
 Given that these operations shall not fail, it returns
 .Ft void .
+.El
 .Sh CODE REFERENCES
 The VFS hooks interface is implemented within the files
 .Pa sys/kern/vfs_hooks.c