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