Module Name: src
Committed By: wiz
Date: Tue Sep 17 19:58:03 UTC 2013
Modified Files:
src/share/man/man9: arp.9 do_setresuid.9 ethersubr.9 fstrans.9
hashinit.9 kprintf.9 microtime.9 rt_timer.9 wdc.9
Log Message:
Sort sections: consistently put CODE REFERENCES directly before SEE ALSO.
To generate a diff of this commit:
cvs rdiff -u -r1.25 -r1.26 src/share/man/man9/arp.9
cvs rdiff -u -r1.4 -r1.5 src/share/man/man9/do_setresuid.9
cvs rdiff -u -r1.24 -r1.25 src/share/man/man9/ethersubr.9
cvs rdiff -u -r1.15 -r1.16 src/share/man/man9/fstrans.9
cvs rdiff -u -r1.8 -r1.9 src/share/man/man9/hashinit.9
cvs rdiff -u -r1.32 -r1.33 src/share/man/man9/kprintf.9
cvs rdiff -u -r1.20 -r1.21 src/share/man/man9/microtime.9
cvs rdiff -u -r1.12 -r1.13 src/share/man/man9/rt_timer.9
cvs rdiff -u -r1.17 -r1.18 src/share/man/man9/wdc.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man9/arp.9
diff -u src/share/man/man9/arp.9:1.25 src/share/man/man9/arp.9:1.26
--- src/share/man/man9/arp.9:1.25 Fri May 14 18:52:53 2010
+++ src/share/man/man9/arp.9 Tue Sep 17 19:58:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: arp.9,v 1.25 2010/05/14 18:52:53 joerg Exp $
+.\" $NetBSD: arp.9,v 1.26 2013/09/17 19:58:03 wiz Exp $
.\"
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -114,6 +114,12 @@ translation to the routing table, if a m
If the route entry contained a pointer to a held packet, that packet is
sent.
.El
+.Sh CODE REFERENCES
+The ARP code is implemented in
+.Pa sys/net/if_arp.h ,
+.Pa sys/netinet/if_inarp.h
+and
+.Pa sys/netinet/if_arp.c .
.Sh SEE ALSO
.Xr ether_ifattach 9
.\" .Xr fddi_ifattach 9 ,
@@ -130,9 +136,3 @@ Rewritten to support other than Ethernet
(original implementation)
.An Ignatios Souvatzis
(support for non-Ethernet)
-.Sh CODE REFERENCES
-The ARP code is implemented in
-.Pa sys/net/if_arp.h ,
-.Pa sys/netinet/if_inarp.h
-and
-.Pa sys/netinet/if_arp.c .
Index: src/share/man/man9/do_setresuid.9
diff -u src/share/man/man9/do_setresuid.9:1.4 src/share/man/man9/do_setresuid.9:1.5
--- src/share/man/man9/do_setresuid.9:1.4 Wed Apr 30 13:10:58 2008
+++ src/share/man/man9/do_setresuid.9 Tue Sep 17 19:58:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: do_setresuid.9,v 1.4 2008/04/30 13:10:58 martin Exp $
+.\" $NetBSD: do_setresuid.9,v 1.5 2013/09/17 19:58:03 wiz Exp $
.\"
.\"-
.\" Copyright (c) 2003 The NetBSD Foundation, Inc.
@@ -78,14 +78,14 @@ The
function sets the group IDs but otherwise behaves in the same manner as
.Nm .
The processes group list is neither examined nor effected.
+.Sh CODE REFERENCES
+These functions are implemented in:
+.Pa sys/kern/kern_prot.c .
.Sh SEE ALSO
.Xr setregid 2 ,
.Xr setreuid 2 ,
.Xr setuid 2 ,
.Xr suser 9
-.Sh CODE REFERENCES
-These functions are implemented in:
-.Pa sys/kern/kern_prot.c .
.Sh HISTORY
Implemented for
.Nx 2.0
Index: src/share/man/man9/ethersubr.9
diff -u src/share/man/man9/ethersubr.9:1.24 src/share/man/man9/ethersubr.9:1.25
--- src/share/man/man9/ethersubr.9:1.24 Thu Dec 2 12:54:13 2010
+++ src/share/man/man9/ethersubr.9 Tue Sep 17 19:58:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: ethersubr.9,v 1.24 2010/12/02 12:54:13 wiz Exp $
+.\" $NetBSD: ethersubr.9,v 1.25 2013/09/17 19:58:03 wiz Exp $
.\"
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -170,15 +170,6 @@ A macro that returns 1, if
.Fa addr
points to an Ethernet/FDDI multicast (or broadcast) address.
.El
-.Sh SEE ALSO
-.Xr arp 9
-.Sh HISTORY
-Rewritten to attach to the new ARP system in
-.Nx 1.3 .
-.Sh AUTHORS
-UCB CSRG (original implementation)
-.Pp
-Ignatios Souvatzis (support for new ARP system)
.Sh CODE REFERENCES
Ethernet support functions are declared in
.In net/if_ether.h
@@ -189,3 +180,12 @@ FDDI support functions are declared in
.In net/if_fddi.h
and defined (if not implemented as macro) in
.Pa sys/net/if_fddisubr.c .
+.Sh SEE ALSO
+.Xr arp 9
+.Sh HISTORY
+Rewritten to attach to the new ARP system in
+.Nx 1.3 .
+.Sh AUTHORS
+UCB CSRG (original implementation)
+.Pp
+Ignatios Souvatzis (support for new ARP system)
Index: src/share/man/man9/fstrans.9
diff -u src/share/man/man9/fstrans.9:1.15 src/share/man/man9/fstrans.9:1.16
--- src/share/man/man9/fstrans.9:1.15 Mon Apr 12 21:28:55 2010
+++ src/share/man/man9/fstrans.9 Tue Sep 17 19:58:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: fstrans.9,v 1.15 2010/04/12 21:28:55 jruoho Exp $
+.\" $NetBSD: fstrans.9,v 1.16 2013/09/17 19:58:03 wiz Exp $
.\"
.\" Copyright (c) 2007 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -213,12 +213,12 @@ xxx_create(void *v)
return 0;
}
.Ed
-.Sh SEE ALSO
-.Xr vfs_resume 9 ,
-.Xr vfs_suspend 9
.Sh CODE REFERENCES
The actual code implementing this subsystem can be found in the file
.Pa sys/kern/vfs_trans.c .
+.Sh SEE ALSO
+.Xr vfs_resume 9 ,
+.Xr vfs_suspend 9
.Sh HISTORY
The
.Nm
Index: src/share/man/man9/hashinit.9
diff -u src/share/man/man9/hashinit.9:1.8 src/share/man/man9/hashinit.9:1.9
--- src/share/man/man9/hashinit.9:1.8 Thu Apr 28 17:08:29 2011
+++ src/share/man/man9/hashinit.9 Tue Sep 17 19:58:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: hashinit.9,v 1.8 2011/04/28 17:08:29 wiz Exp $
+.\" $NetBSD: hashinit.9,v 1.9 2013/09/17 19:58:03 wiz Exp $
.\"
.\" Copyright (c) 2006 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -115,13 +115,13 @@ as appropriate.
returns
.Dv NULL
on failure.
+.Sh CODE REFERENCES
+These functions are implemented in
+.Pa sys/kern/subr_hash.c .
.Sh SEE ALSO
.Xr queue 3 ,
.Xr hash 9 ,
.Xr malloc 9
-.Sh CODE REFERENCES
-These functions are implemented in
-.Pa sys/kern/subr_hash.c .
.Sh HISTORY
A
.Fn hashinit
Index: src/share/man/man9/kprintf.9
diff -u src/share/man/man9/kprintf.9:1.32 src/share/man/man9/kprintf.9:1.33
--- src/share/man/man9/kprintf.9:1.32 Wed Nov 21 17:18:11 2012
+++ src/share/man/man9/kprintf.9 Tue Sep 17 19:58:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: kprintf.9,v 1.32 2012/11/21 17:18:11 christos Exp $
+.\" $NetBSD: kprintf.9,v 1.33 2013/09/17 19:58:03 wiz Exp $
.\"
.\" Copyright (c) 1998, 2002, 2007, 2011 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -263,6 +263,8 @@ The
function returns
.Dv NULL
if no terminal handle could be acquired.
+.Sh CODE REFERENCES
+.Pa sys/kern/subr_prf.c
.Sh SEE ALSO
.Xr printf 1 ,
.Xr printf 3 ,
@@ -270,8 +272,6 @@ if no terminal handle could be acquired.
.Xr boot 8 ,
.Xr autoconf 9 ,
.Xr boothowto 9
-.Sh CODE REFERENCES
-.Pa sys/kern/subr_prf.c
.Sh HISTORY
The
.Fn sprintf
Index: src/share/man/man9/microtime.9
diff -u src/share/man/man9/microtime.9:1.20 src/share/man/man9/microtime.9:1.21
--- src/share/man/man9/microtime.9:1.20 Sat Jul 20 21:39:59 2013
+++ src/share/man/man9/microtime.9 Tue Sep 17 19:58:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: microtime.9,v 1.20 2013/07/20 21:39:59 wiz Exp $
+.\" $NetBSD: microtime.9,v 1.21 2013/09/17 19:58:03 wiz Exp $
.\"
.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -152,12 +152,6 @@ As such, all calls to these functions ar
greater than or equal to the system time returned in any previous calls.
Comparable functions exist to retrieve the time elapsed since boot; see
.Xr microuptime 9 .
-.Sh SEE ALSO
-.Xr settimeofday 2 ,
-.Xr bintime_add 9 ,
-.Xr inittodr 9 ,
-.Xr time_second 9 ,
-.Xr tvtohz 9
.Sh CODE REFERENCES
The implementation of the
.Fn microtime
@@ -172,6 +166,12 @@ The implementation of the time counter s
is machine dependent,
hence its location in the source code tree varies from architecture to
architecture.
+.Sh SEE ALSO
+.Xr settimeofday 2 ,
+.Xr bintime_add 9 ,
+.Xr inittodr 9 ,
+.Xr time_second 9 ,
+.Xr tvtohz 9
.Sh AUTHORS
This manual page was written by
.An Jeremy Cooper
Index: src/share/man/man9/rt_timer.9
diff -u src/share/man/man9/rt_timer.9:1.12 src/share/man/man9/rt_timer.9:1.13
--- src/share/man/man9/rt_timer.9:1.12 Fri May 14 18:37:43 2010
+++ src/share/man/man9/rt_timer.9 Tue Sep 17 19:58:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: rt_timer.9,v 1.12 2010/05/14 18:37:43 joerg Exp $
+.\" $NetBSD: rt_timer.9,v 1.13 2013/09/17 19:58:03 wiz Exp $
.\"
.\" Copyright (c) 1998 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -111,6 +111,13 @@ subsystem.
This is used when a route is deleted to ensure that no dangling
references remain.
.El
+.Sh CODE REFERENCES
+The
+.Nm
+interface is implemented in
+.Pa sys/net/route.h
+and
+.Pa sys/net/route.c .
.Sh SEE ALSO
.Xr netstat 1 ,
.Xr arp 9
@@ -124,10 +131,3 @@ This interface is roughly based on (but,
designed by David Borman of BSDI.
This implementation is by Kevin Lahey of the Numerical Aerospace
Simulation Facility, NASA Ames Research Center.
-.Sh CODE REFERENCES
-The
-.Nm
-interface is implemented in
-.Pa sys/net/route.h
-and
-.Pa sys/net/route.c .
Index: src/share/man/man9/wdc.9
diff -u src/share/man/man9/wdc.9:1.17 src/share/man/man9/wdc.9:1.18
--- src/share/man/man9/wdc.9:1.17 Sun Apr 18 15:19:17 2010
+++ src/share/man/man9/wdc.9 Tue Sep 17 19:58:03 2013
@@ -1,4 +1,4 @@
-.\" $NetBSD: wdc.9,v 1.17 2010/04/18 15:19:17 jruoho Exp $
+.\" $NetBSD: wdc.9,v 1.18 2013/09/17 19:58:03 wiz Exp $
.\"
.\" Copyright (c) 1998 Manuel Bouyer.
.\"
@@ -391,9 +391,6 @@ as well as the values of
and
.Va UDMA_mode
if the modes to be used are not highest ones supported by the drive.
-.Sh SEE ALSO
-.Xr wdc 4 ,
-.Xr bus_space 9
.Sh CODE REFERENCES
The wdc core functions are implemented in
.Pa sys/dev/ic/wdc.c .
@@ -410,3 +407,6 @@ A more complex one, with multiple channe
.Pa sys/arch/atari/dev/wdc_mb.c
makes use of hardware locking, and also provides an example of bus-front
end for a big-endian system, which needs byte-swapping bus_space functions.
+.Sh SEE ALSO
+.Xr wdc 4 ,
+.Xr bus_space 9
