Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src/share/man/man9 Remove boilerplate in CODE REFERENCES on file...



details:   https://anonhg.NetBSD.org/src/rev/310d4fbb54a1
branches:  trunk
changeset: 759219:310d4fbb54a1
user:      wiz <wiz%NetBSD.org@localhost>
date:      Thu Dec 02 12:54:13 2010 +0000

description:
Remove boilerplate in CODE REFERENCES on file paths.
Describe in intro(9) how to read paths in the CODE REFERENCES section.

diffstat:

 share/man/man9/autoconf.9         |   9 +--------
 share/man/man9/bluetooth.9        |   9 +--------
 share/man/man9/bpf.9              |   8 +-------
 share/man/man9/buffercache.9      |   9 +--------
 share/man/man9/callback.9         |  10 +---------
 share/man/man9/cardbus.9          |   9 +--------
 share/man/man9/condvar.9          |   8 +-------
 share/man/man9/config.9           |   9 +--------
 share/man/man9/coredump_write.9   |  10 +---------
 share/man/man9/cpu_coredump.9     |   9 +--------
 share/man/man9/cpu_initclocks.9   |   9 +--------
 share/man/man9/csf.9              |   8 +-------
 share/man/man9/deviter.9          |  10 +---------
 share/man/man9/disk.9             |   9 +--------
 share/man/man9/dofileread.9       |   9 +--------
 share/man/man9/edid.9             |   9 +--------
 share/man/man9/ethersubr.9        |   6 +++---
 share/man/man9/evcnt.9            |   9 +--------
 share/man/man9/extent.9           |   9 +--------
 share/man/man9/file.9             |   9 +--------
 share/man/man9/filedesc.9         |   9 +--------
 share/man/man9/intro.9            |   6 ++++--
 share/man/man9/ioasic.9           |   9 +--------
 share/man/man9/isa.9              |   9 +--------
 share/man/man9/isapnp.9           |  11 +----------
 share/man/man9/kmem.9             |  11 +----------
 share/man/man9/kthread.9          |   9 +--------
 share/man/man9/m_tag.9            |   9 +--------
 share/man/man9/mbuf.9             |   8 ++------
 share/man/man9/mca.9              |   9 +--------
 share/man/man9/module.9           |   8 +-------
 share/man/man9/mutex.9            |   8 +-------
 share/man/man9/namecache.9        |   9 +--------
 share/man/man9/namei.9            |   9 +--------
 share/man/man9/npf_ncode.9        |  11 +----------
 share/man/man9/pci.9              |   9 +--------
 share/man/man9/pcmcia.9           |   9 +--------
 share/man/man9/pcq.9              |  11 +----------
 share/man/man9/percpu.9           |  11 +----------
 share/man/man9/pmf.9              |   9 +--------
 share/man/man9/pool_cache.9       |  11 +----------
 share/man/man9/ras.9              |   9 +--------
 share/man/man9/rasops.9           |   9 +--------
 share/man/man9/rssadapt.9         |  10 +---------
 share/man/man9/rwlock.9           |   8 +-------
 share/man/man9/sched_4bsd.9       |   8 +-------
 share/man/man9/sched_m2.9         |   8 +-------
 share/man/man9/secmodel.9         |   4 ++--
 share/man/man9/secmodel_overlay.9 |   6 +++---
 share/man/man9/select.9           |   9 +--------
 share/man/man9/sockopt.9          |   8 +-------
 share/man/man9/sysmon_envsys.9    |  10 +---------
 share/man/man9/tc.9               |   9 +--------
 share/man/man9/ubc.9              |  11 +----------
 share/man/man9/vattr.9            |   9 +--------
 share/man/man9/vfsops.9           |   9 +--------
 share/man/man9/vfssubr.9          |   9 +--------
 share/man/man9/vme.9              |  11 +----------
 share/man/man9/vmem.9             |  10 +---------
 share/man/man9/vnfileops.9        |   9 +--------
 share/man/man9/vnode.9            |   9 +--------
 share/man/man9/vnsubr.9           |   9 +--------
 share/man/man9/workqueue.9        |  11 +----------
 share/man/man9/wscons.9           |   9 +--------
 share/man/man9/wsdisplay.9        |   9 +--------
 share/man/man9/wsfont.9           |   9 +--------
 share/man/man9/wskbd.9            |   9 +--------
 share/man/man9/wsmouse.9          |   9 +--------
 share/man/man9/xcall.9            |  11 +----------
 69 files changed, 78 insertions(+), 545 deletions(-)

diffs (truncated from 1604 to 300 lines):

diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/autoconf.9
--- a/share/man/man9/autoconf.9 Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/autoconf.9 Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: autoconf.9,v 1.27 2010/06/25 15:16:14 tsutsui Exp $
+.\"     $NetBSD: autoconf.9,v 1.28 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2001, 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -402,13 +402,6 @@
 them returns 1.
 .El
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing or using the
-autoconfiguration framework can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 The autoconfiguration framework itself is implemented within the file
 .Pa sys/kern/subr_autoconf.c .
 Data structures and function prototypes for the framework are located in
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/bluetooth.9
--- a/share/man/man9/bluetooth.9        Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/bluetooth.9        Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: bluetooth.9,v 1.4 2007/12/02 20:03:11 wiz Exp $
+.\"    $NetBSD: bluetooth.9,v 1.5 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2006 Itronix Inc.
 .\" All rights reserved.
@@ -348,13 +348,6 @@
 .Ar ref .
 .El
 .Sh CODE REFERENCES
-This section describes places in the
-.Nx
-source tree where actual code implementing or using the
-Bluetooth Protocol Stack can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 The Bluetooth Protocol Stack is contained in the
 .Pa sys/netbt
 directory.
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/bpf.9
--- a/share/man/man9/bpf.9      Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/bpf.9      Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: bpf.9,v 1.2 2010/06/08 04:08:37 jruoho Exp $
+.\"     $NetBSD: bpf.9,v 1.3 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -62,12 +62,6 @@
 .Nm
 is absent or present in the kernel, respectively.
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where the implementation can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 The
 .Nm
 implementation is located in
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/buffercache.9
--- a/share/man/man9/buffercache.9      Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/buffercache.9      Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: buffercache.9,v 1.24 2009/11/11 08:43:18 rmind Exp $
+.\"     $NetBSD: buffercache.9,v 1.25 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c)2003 YAMAMOTO Takashi,
 .\" All rights reserved.
@@ -335,13 +335,6 @@
 .El
 .\" ------------------------------------------------------------
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing the buffer cache subsystem
-can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 The buffer cache subsystem is implemented within the file
 .Pa sys/kern/vfs_bio.c .
 .Sh SEE ALSO
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/callback.9
--- a/share/man/man9/callback.9 Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/callback.9 Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: callback.9,v 1.4 2009/10/29 01:52:39 wiz Exp $
+.\"    $NetBSD: callback.9,v 1.5 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2009 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -104,14 +104,6 @@
 will be passed to the callback functions.
 .El
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing the
-.Nm
-interface can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 The
 .Nm
 interface is implemented within the file
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/cardbus.9
--- a/share/man/man9/cardbus.9  Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/cardbus.9  Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: cardbus.9,v 1.15 2010/04/15 08:40:46 jruoho Exp $
+.\"     $NetBSD: cardbus.9,v 1.16 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -304,13 +304,6 @@
 .Xr bus_dma 9
 interface.
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing or using the
-machine-independent CardBus subsystem can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 The CardBus subsystem itself is implemented within the files
 .Pa sys/dev/cardbus/cardbus.c ,
 .Pa sys/dev/cardbus/cardbus_map.c
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/condvar.9
--- a/share/man/man9/condvar.9  Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/condvar.9  Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: condvar.9,v 1.13 2008/08/06 07:08:31 skrll Exp $
+.\"    $NetBSD: condvar.9,v 1.14 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2006, 2007, 2008 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -261,12 +261,6 @@
        mutex_exit(\*[Am]res-\*[Gt]mutex);
 .Ed
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where code implementing condition variables can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 The core of the CV implementation is in
 .Pa sys/kern/kern_condvar.c .
 .Pp
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/config.9
--- a/share/man/man9/config.9   Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/config.9   Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: config.9,v 1.28 2010/04/05 19:27:16 joerg Exp $
+.\"     $NetBSD: config.9,v 1.29 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -319,13 +319,6 @@
 This can be used when some locators do not make sense for some devices,
 but the software interface requires them.
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing or using the
-autoconfiguration framework can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 The device definition files are in
 .Pa sys/conf/files ,
 .Pa sys/arch/\*[Lt]arch\*[Gt]/conf/files.\*[Lt]arch\*[Gt] ,
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/coredump_write.9
--- a/share/man/man9/coredump_write.9   Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/coredump_write.9   Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: coredump_write.9,v 1.4 2008/07/11 13:20:17 gdt Exp $
+.\"     $NetBSD: coredump_write.9,v 1.5 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -57,14 +57,6 @@
 .Fn coredump_write
 returns 0 on success and an appropriate error code on failure.
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing or using
-.Fn coredump_write
-can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 Process core dumps are initiated within the file
 .Pa sys/kern/kern_sig.c .
 Process core dumps for ELF
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/cpu_coredump.9
--- a/share/man/man9/cpu_coredump.9     Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/cpu_coredump.9     Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: cpu_coredump.9,v 1.9 2008/04/30 13:10:58 martin Exp $
+.\"     $NetBSD: cpu_coredump.9,v 1.10 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2002, 2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -57,13 +57,6 @@
 .Fn cpu_coredump
 returns 0 on success and an appropriate error code on failure.
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing or using the
-machine-dependent coredump interface can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 Process core dumps are initiated within the file
 .Pa sys/kern/kern_sig.c .
 Process core dumps for ELF
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/cpu_initclocks.9
--- a/share/man/man9/cpu_initclocks.9   Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/cpu_initclocks.9   Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: cpu_initclocks.9,v 1.7 2008/04/30 13:10:58 martin Exp $
+.\"     $NetBSD: cpu_initclocks.9,v 1.8 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -45,13 +45,6 @@
 perform the machine-dependent initialization of clock frequencies and
 start the real-time and statistic clocks running.
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing or using the
-machine-dependent clocks initialization interface can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 Machine-independent clock interface operations are performed within
 the file
 .Pa sys/kern/kern_clock.c .
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/csf.9
--- a/share/man/man9/csf.9      Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/csf.9      Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: csf.9,v 1.6 2009/09/02 10:54:20 ahoka Exp $
+.\"     $NetBSD: csf.9,v 1.7 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -185,12 +185,6 @@
 to initialize any other scheduler-specific data.
 .El
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing the scheduler can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 The
 .Nm
 programming interface is defined within the file
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/deviter.9
--- a/share/man/man9/deviter.9  Thu Dec 02 12:04:01 2010 +0000
+++ b/share/man/man9/deviter.9  Thu Dec 02 12:54:13 2010 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: deviter.9,v 1.2 2009/11/05 09:55:38 wiz Exp $
+.\" $NetBSD: deviter.9,v 1.3 2010/12/02 12:54:13 wiz Exp $
 .\"
 .\" Copyright (c) 2009 David Young <dyoung%NetBSD.org@localhost>
 .\" All rights reserved.
@@ -183,14 +183,6 @@
 MUST be released.
 .El
 .Sh CODE REFERENCES
-This section describes places within the
-.Nx
-source tree where actual code implementing
-.Nm
-can be found.
-All pathnames are relative to
-.Pa /usr/src .
-.Pp
 Device iteration is implemented within the files
 .Pa sys/sys/device.h
 and
diff -r ec972d643754 -r 310d4fbb54a1 share/man/man9/disk.9



Home | Main Index | Thread Index | Old Index