From 010afa8116b3ab8e804cf21a0e11732e9c204a3f Mon Sep 17 00:00:00 2001 From: Sascha Wildner Date: Thu, 26 Apr 2007 17:35:03 +0000 Subject: [PATCH] Use .Xr for manpage references. --- lib/libc/sys/link.2 | 5 +++-- lib/libc/sys/unlink.2 | 5 +++-- sbin/reboot/boot_pc32.8 | 6 ++++-- share/man/man4/targ.4 | 6 ++++-- share/man/man5/devices.conf.5 | 24 ++++++++++++++++++------ share/man/man7/hier.7 | 6 +++--- share/man/man8/man8.i386/MAKEDEV.8 | 7 ++++--- usr.sbin/syslogd/syslog.conf.5 | 8 +++++--- 8 files changed, 44 insertions(+), 23 deletions(-) diff --git a/lib/libc/sys/link.2 b/lib/libc/sys/link.2 index 5d9ec0b479..8107f25d34 100644 --- a/lib/libc/sys/link.2 +++ b/lib/libc/sys/link.2 @@ -31,7 +31,7 @@ .\" .\" @(#)link.2 8.3 (Berkeley) 1/12/94 .\" $FreeBSD: src/lib/libc/sys/link.2,v 1.11.2.7 2001/12/14 18:34:01 ru Exp $ -.\" $DragonFly: src/lib/libc/sys/link.2,v 1.3 2005/02/03 03:47:26 drhodus Exp $ +.\" $DragonFly: src/lib/libc/sys/link.2,v 1.4 2007/04/26 17:35:03 swildner Exp $ .\" .Dd March 5, 1999 .Dt LINK 2 @@ -117,7 +117,8 @@ The link named by .Fa name2 does exist. .It Bq Er EPERM -The named file has its immutable or append-only flag set (see chflags(2)). +The named file has its immutable or append-only flag set (see +.Xr chflags 2 ) . .It Bq Er EPERM The file named by .Fa name1 diff --git a/lib/libc/sys/unlink.2 b/lib/libc/sys/unlink.2 index 29afb6c321..5cec372eab 100644 --- a/lib/libc/sys/unlink.2 +++ b/lib/libc/sys/unlink.2 @@ -31,7 +31,7 @@ .\" .\" @(#)unlink.2 8.1 (Berkeley) 6/4/93 .\" $FreeBSD: src/lib/libc/sys/unlink.2,v 1.8.2.4 2001/12/14 18:34:02 ru Exp $ -.\" $DragonFly: src/lib/libc/sys/unlink.2,v 1.3 2005/02/03 03:43:44 drhodus Exp $ +.\" $DragonFly: src/lib/libc/sys/unlink.2,v 1.4 2007/04/26 17:35:03 swildner Exp $ .\" .Dd June 4, 1993 .Dt UNLINK 2 @@ -84,7 +84,8 @@ to be removed. .It Bq Er ELOOP Too many symbolic links were encountered in translating the pathname. .It Bq Er EPERM -The named file has its immutable or append-only flag set (see chflags(2)). +The named file has its immutable or append-only flag set (see +.Xr chflags 2 ) . .It Bq Er EPERM The named file is a directory. .It Bq Er EPERM diff --git a/sbin/reboot/boot_pc32.8 b/sbin/reboot/boot_pc32.8 index b6f05a7338..5de2f982b9 100644 --- a/sbin/reboot/boot_pc32.8 +++ b/sbin/reboot/boot_pc32.8 @@ -39,7 +39,7 @@ .\" @(#)boot_i386.8 8.2 (Berkeley) 4/19/94 .\" .\" $FreeBSD: src/sbin/reboot/boot_i386.8,v 1.23.2.11 2002/04/24 17:47:58 rnordier Exp $ -.\" $DragonFly: src/sbin/reboot/boot_pc32.8,v 1.8 2007/02/19 09:34:33 swildner Exp $ +.\" $DragonFly: src/sbin/reboot/boot_pc32.8,v 1.9 2007/04/26 17:35:03 swildner Exp $ .\" .Dd April 19, 1994 .Dt BOOT 8 i386 @@ -199,7 +199,9 @@ as early as possible in kernel initialization. .It Fl g use the GDB remote debugging protocol. .It Fl n -ignore key press to interrupt boot before loader(8) is invoked. +ignore key press to interrupt boot before +.Xr loader 8 +is invoked. .It Fl P probe the keyboard. If no keyboard is found, the .Fl D diff --git a/share/man/man4/targ.4 b/share/man/man4/targ.4 index b6d6db7576..9c8e0a9710 100644 --- a/share/man/man4/targ.4 +++ b/share/man/man4/targ.4 @@ -23,7 +23,7 @@ .\" SUCH DAMAGE. .\" .\" $FreeBSD: src/share/man/man4/targ.4,v 1.3.2.1 2003/02/18 22:07:11 njl Exp $ -.\" $DragonFly: src/share/man/man4/targ.4,v 1.4 2006/05/26 21:39:39 swildner Exp $ +.\" $DragonFly: src/share/man/man4/targ.4,v 1.5 2007/04/26 17:35:03 swildner Exp $ .\" .Dd November 15, 2002 .Dt TARG 4 @@ -49,7 +49,9 @@ driver supplies control devices, .Pa /dev/targ0 , .Pa /dev/targ1 , etc. -If a device is already in use, open(2) will fail and +If a device is already in use, +.Xr open 2 +will fail and .Va errno will be set to .Er EBUSY . diff --git a/share/man/man5/devices.conf.5 b/share/man/man5/devices.conf.5 index 0d4fa8db07..ceb13395e7 100644 --- a/share/man/man5/devices.conf.5 +++ b/share/man/man5/devices.conf.5 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $DragonFly: src/share/man/man5/devices.conf.5,v 1.2 2006/02/17 20:37:10 swildner Exp $ +.\" $DragonFly: src/share/man/man5/devices.conf.5,v 1.3 2007/04/26 17:35:03 swildner Exp $ .\" .\" Note: The date here should be updated whenever a non-trivial .\" change is made to the manual page. @@ -37,24 +37,34 @@ .Sh DESCRIPTION The .Nm -file is used by the MAKEDEV(8) shell script. Normally, MAKEDEV(8) creates any special +file is used by the +.Xr MAKEDEV 8 +shell script. +Normally, +.Xr MAKEDEV 8 +creates any special file (device node) with reasonable ownership and permissions. To override these default settings, you can put corresponding entries in your .Pa devices.conf -file, so MAKEDEV(8) will use these when it creates the special file. +file, so +.Xr MAKEDEV 8 +will use these when it creates the special file. .Pp This feature comes in handy if you're using (e.g.) tape backup software like .Pa bacula in conjunction with a tape autochanger device. In this case, the .Dq bacula-sd storage daemon needs read/write access to /dev/pass?, which is not granted by default -when MAKEDEV(8) creates the pass? device node. +when +.Xr MAKEDEV 8 +creates the pass? device node. .Pp So, instead of manually changing the permissions of /dev/pass? after each .Dq make upgrade , you can simply put a local override entry into .Pa devices.conf , -so the device node will have the new permissions the next time MAKEDEV(8) +so the device node will have the new permissions the next time +.Xr MAKEDEV 8 creates it. .Sh FILE FORMAT The contents of the @@ -73,7 +83,9 @@ node to be overridden, the ownership in format and the new file permissions. The fourth field is optional and reserved for comments (or whatever). .Pp -Due to the huge number of device nodes that MAKEDEV(8) can create, +Due to the huge number of device nodes that +.Xr MAKEDEV 8 +can create, the first field (the device node name) may contain the .Ql * wildcard character, if the new ownership/permissions should apply to an entire diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7 index 27d41c97c6..6a4bee46c3 100644 --- a/share/man/man7/hier.7 +++ b/share/man/man7/hier.7 @@ -31,7 +31,7 @@ .\" .\" @(#)hier.7 8.1 (Berkeley) 6/5/93 .\" $FreeBSD: src/share/man/man7/hier.7,v 1.29.2.17 2003/01/13 21:43:50 ceri Exp $ -.\" $DragonFly: src/share/man/man7/hier.7,v 1.8 2006/10/09 11:48:08 swildner Exp $ +.\" $DragonFly: src/share/man/man7/hier.7,v 1.9 2007/04/26 17:35:03 swildner Exp $ .\" .Dd August 23, 2006 .Dt HIER 7 @@ -604,9 +604,9 @@ see .It Pa db/ misc. automatically generated system-specific database files .It Pa empty/ -empty directory used by sshd(8) for privilege separation; -see +empty directory used by .Xr sshd 8 +for privilege separation .It Pa games/ misc. game status and score files .It Pa heimdal/ diff --git a/share/man/man8/man8.i386/MAKEDEV.8 b/share/man/man8/man8.i386/MAKEDEV.8 index e5e6e505fb..7935f53729 100644 --- a/share/man/man8/man8.i386/MAKEDEV.8 +++ b/share/man/man8/man8.i386/MAKEDEV.8 @@ -31,7 +31,7 @@ .\" .\" @(#)MAKEDEV.8 8.1 (Berkeley) 6/5/93 .\" $FreeBSD: src/share/man/man8/man8.i386/MAKEDEV.8,v 1.15.2.5 2002/05/11 06:15:16 dd Exp $ -.\" $DragonFly: src/share/man/man8/man8.i386/MAKEDEV.8,v 1.8 2006/03/21 05:24:28 swildner Exp $ +.\" $DragonFly: src/share/man/man8/man8.i386/MAKEDEV.8,v 1.9 2007/04/26 17:35:03 swildner Exp $ .\" .Dd June 5, 1993 .Dt MAKEDEV 8 i386 @@ -119,8 +119,9 @@ finds overrides for a given special file in .Pa /etc/devices.conf , it will use these settings when it creates the device node. .Pp -Please see the devices.conf(5) manpage for more information on how to override the -default settings. +See +.Xr devices.conf 5 +for more information on how to override the default settings. .Sh FILES .Bl -tag -width /dev/xxxx -compact .It Pa /dev diff --git a/usr.sbin/syslogd/syslog.conf.5 b/usr.sbin/syslogd/syslog.conf.5 index 5d87ef5c56..53c6590068 100644 --- a/usr.sbin/syslogd/syslog.conf.5 +++ b/usr.sbin/syslogd/syslog.conf.5 @@ -31,7 +31,7 @@ .\" .\" @(#)syslog.conf.5 8.1 (Berkeley) 6/9/93 .\" $FreeBSD: src/usr.sbin/syslogd/syslog.conf.5,v 1.35 2004/07/03 18:35:53 ru Exp $ -.\" $DragonFly: src/usr.sbin/syslogd/syslog.conf.5,v 1.6 2006/08/18 03:42:58 swildner Exp $ +.\" $DragonFly: src/usr.sbin/syslogd/syslog.conf.5,v 1.7 2007/04/26 17:35:03 swildner Exp $ .\" .Dd June 9, 1993 .Dt SYSLOG.CONF 5 @@ -353,8 +353,10 @@ Selected messages are written to all logged-in users. A percent sign .Pq Dq \&% , followed by a pathname (beginning with a leading slash). Selected messages -are written to a circular log file. See clog(8) for a discussion of -circular log files. +are written to a circular log file. +See +.Xr clog 8 +for a discussion of circular log files. .It A vertical bar .Pq Dq \&| , -- 2.11.4.GIT