[PATCH] file and directory name errors in man pages
Sascha Wildner
saw at online.de
Thu May 13 12:19:54 PDT 2004
Hi all,
I've checked the directory and file names in the 'Pa' macros of the man
pages against what's installed and found some errors. See attached patch.
Regards,
Sascha
--
http://yoyodyne.ath.cx
diff -ur /usr/src/share/man/man4/man4.i386/meteor.4 manpages/src/share/man/man4/man4.i386/meteor.4
--- /usr/src/share/man/man4/man4.i386/meteor.4 2003-06-17 06:36:59.000000000 +0200
+++ manpages/src/share/man/man4/man4.i386/meteor.4 2004-05-13 18:32:42.000000000 +0200
@@ -33,7 +33,7 @@
.Pp
.Bl -item -offset indent -compact
.It
-.Pa /sys/pci/meteor.c
+.Pa /sys/dev/video/meteor/meteor.c
.It
.Pa /sys/i386/include/ioctl_meteor.h
.El
diff -ur /usr/src/share/man/man4/man4.i386/scd.4 manpages/src/share/man/man4/man4.i386/scd.4
--- /usr/src/share/man/man4/man4.i386/scd.4 2003-06-17 06:37:00.000000000 +0200
+++ manpages/src/share/man/man4/man4.i386/scd.4 2004-05-13 18:30:15.000000000 +0200
@@ -53,7 +53,7 @@
accesses the raw device.
.El
.Sh SEE ALSO
-.Pa /sys/i386/isa/scd.c
+.Pa /sys/dev/disk/scd.c
.Sh AUTHORS
.An -nosplit
The driver was written by
diff -ur /usr/src/share/man/man4/vinum.4 manpages/src/share/man/man4/vinum.4
--- /usr/src/share/man/man4/vinum.4 2004-03-11 13:28:55.000000000 +0100
+++ manpages/src/share/man/man4/vinum.4 2004-05-13 19:27:20.000000000 +0200
@@ -175,7 +175,7 @@
kernel and the user components. To do this, edit the files
.Pa /usr/src/sbin/vinum/Makefile
and
-.Pa /usr/src/sys/modules/vinum/Makefile
+.Pa /sys/dev/raid/vinum/Makefile
and edit the CFLAGS variable to remove the -DVINUMDEBUG option. If you have
configured
.Nm
@@ -252,7 +252,7 @@
calls are intended for the use of the
.Nm
configuration program only. They are described in the header file
-.Pa /sys/sys/vinumio.h
+.Pa /sys/dev/raid/vinum/vinumio.h
.Ss DISK LABELS
Conventional disk special devices have a
.Em disk label
@@ -790,12 +790,12 @@
.Bl -enum
.It
Copy the files
-.Pa /usr/src/sys/modules/vinum/.gdbinit.crash ,
-.Pa /usr/src/sys/modules/vinum/.gdbinit.kernel ,
-.Pa /usr/src/sys/modules/vinum/.gdbinit.serial ,
-.Pa /usr/src/sys/modules/vinum/.gdbinit.vinum
+.Pa /sys/dev/raid/vinum/.gdbinit.crash ,
+.Pa /sys/dev/raid/vinum/.gdbinit.kernel ,
+.Pa /sys/dev/raid/vinum/.gdbinit.serial ,
+.Pa /sys/dev/raid/vinum/.gdbinit.vinum
and
-.Pa /usr/src/sys/modules/vinum/.gdbinit.vinum.paths
+.Pa /sys/dev/raid/vinum/.gdbinit.vinum.paths
to the directory in which you will be performing the analysis, typically
.Pa /var/crash .
.It
@@ -820,13 +820,13 @@
.Pa /modules/vinum.ko
is stripped, you will have to find a version which is not. Usually this will be
either in
-.Pa /usr/obj/sys/modules/vinum/vinum.ko
+.Pa /usr/obj/usr/src/sys/SYSTEM_NAME/usr/src/sys/dev/raid/vinum/vinum.ko
(if you have built
.Nm
with a
.Ar make world )
or
-.Pa /usr/src/sys/modules/vinum/vinum.ko
+.Pa /sys/dev/raid/vinum/vinum.ko
(if you have built
.Nm
in this directory). Modify the file
@@ -886,13 +886,13 @@
318 in_Debugger = 0;
#1 0xf108d9bc in vinumioctl (dev=0x40001900, cmd=0xc008464b, data=0xf6dedee0 "",
flag=0x3, p=0xf68b7940) at
- /usr/src/sys/modules/Vinum/../../dev/Vinum/vinumioctl.c:102
+ /usr/src/sys/dev/raid/vinum/vinumioctl.c:102
102 Debugger ("vinum debug");
(kgdb) bt
#0 Debugger (msg=0xf0f661ac "vinum debug") at ../../i386/i386/db_interface.c:318
#1 0xf0f60a7c in vinumioctl (dev=0x40001900, cmd=0xc008464b, data=0xf6923ed0 "",
flag=0x3, p=0xf688e6c0) at
- /usr/src/sys/modules/vinum/../../dev/vinum/vinumioctl.c:109
+ /usr/src/sys/dev/raid/vinum/vinumioctl.c:109
#2 0xf01833b7 in spec_ioctl (ap=0xf6923e0c) at ../../miscfs/specfs/spec_vnops.c:424
#3 0xf0182cc9 in spec_vnoperate (ap=0xf6923e0c) at ../../miscfs/specfs/spec_vnops.c:129
#4 0xf01eb3c1 in ufs_vnoperatespec (ap=0xf6923e0c) at ../../ufs/ufs/ufs_vnops.c:2312
diff -ur /usr/src/share/man/man4/vlan.4 manpages/src/share/man/man4/vlan.4
--- /usr/src/share/man/man4/vlan.4 2004-03-11 13:28:55.000000000 +0100
+++ manpages/src/share/man/man4/vlan.4 2004-05-13 19:21:07.000000000 +0200
@@ -125,7 +125,7 @@
requires defining
.Dv BIG_PACKET
in the
-.Pa /usr/src/sys/pci/if_de.c
+.Pa /sys/dev/netif/de/if_de.c
source file and rebuilding the kernel.
The hack works only for the 21041, 21140, and 21140A chips.
.It Xr fxp 4
diff -ur /usr/src/share/man/man5/make.conf.5 manpages/src/share/man/man5/make.conf.5
--- /usr/src/share/man/man5/make.conf.5 2004-03-11 13:28:56.000000000 +0100
+++ manpages/src/share/man/man5/make.conf.5 2004-05-13 18:39:32.000000000 +0200
@@ -49,10 +49,9 @@
directly.
Instead, it is included by the
various makefiles in
-.Pa /usr/src ,
-.Pa /usr/ports
+.Pa /usr/src
and
-.Pa /usr/doc
+.Pa /usr/ports
which conditionalize their
internal actions according to the settings found there.
.Pp
@@ -132,7 +131,7 @@
and
.Va NO_CPU_COPTFLAGS
variables, respectively. Refer to
-.Pa /usr/share/examples/etc/make.conf
+.Pa /usr/share/examples/etc/defaults/make.conf
for a list of recognized
.Va CPUTYPE
options.
@@ -905,7 +904,6 @@
.Bl -tag -width /etc/defaults/make.conf -compact
.It Pa /etc/defaults/make.conf
.It Pa /etc/make.conf
-.It Pa /usr/doc/Makefile
.It Pa /usr/src/Makefile
.It Pa /usr/src/Makefile.inc1
.It Pa /usr/ports/Mk/bsd.port.mk
diff -ur /usr/src/share/man/man7/build.7 manpages/src/share/man/man7/build.7
--- /usr/src/share/man/man7/build.7 2004-03-11 13:28:56.000000000 +0100
+++ manpages/src/share/man/man7/build.7 2004-05-12 21:22:06.000000000 +0200
@@ -34,20 +34,17 @@
.Sh DESCRIPTION
The source for the
.Dx
-system and applications are contained in three different directories,
+system and applications is contained in two different directories,
normally
-.Pa /usr/src ,
-.Pa /usr/doc ,
+.Pa /usr/src
and
.Pa /usr/ports .
.Pa /usr/src
contains the
.Dq "base system"
sources, which is loosely defined as the things required to rebuild
-the system to a useful state.
-.Pa /usr/doc
-contains the source for the system documentation, excluding the manual
-pages.
+the system to a useful state. It also contains the source for the
+system documentation, excluding the manual pages.
.Pa /usr/ports
is a tree that provides a consistent interface for building and
installing third party applications.
@@ -136,11 +133,10 @@
.Sh FILES
.Bl -tag -width ".Pa /usr/share/examples/etc/make.conf" -compact
.It Pa /etc/make.conf
-.It Pa /usr/doc/Makefile
-.It Pa /usr/doc/share/mk/doc.project.mk
+.It Pa /usr/src/share/doc/Makefile
.It Pa /usr/ports/Mk/bsd.port.mk
.It Pa /usr/ports/Mk/bsd.sites.mk
-.It Pa /usr/share/examples/etc//make.conf
+.It Pa /usr/share/examples/etc/defaults/make.conf
.It Pa /usr/src/Makefile
.It Pa /usr/src/Makefile.inc1
.El
More information about the Submit
mailing list