From 33e34aeeb5bc540d849c497452e05717429183c2 Mon Sep 17 00:00:00 2001 From: ru Date: Fri, 29 Sep 2006 15:20:48 +0000 Subject: Markup fixes. --- usr.bin/du/du.1 | 6 +++++- usr.bin/file/magic.5 | 7 +------ usr.bin/find/find.1 | 3 ++- usr.bin/locate/locate/locate.1 | 14 ++++++++------ usr.bin/logger/logger.1 | 3 ++- usr.bin/login/login.1 | 4 ++-- usr.bin/lorder/lorder.1 | 6 +++--- usr.bin/make/make.1 | 2 +- usr.bin/mktemp/mktemp.1 | 2 +- usr.bin/mkuzip/mkuzip.8 | 6 +++++- usr.bin/netstat/netstat.1 | 13 +++++++------ usr.bin/split/split.1 | 12 +++++++++--- usr.bin/su/su.1 | 6 +++--- usr.bin/time/time.1 | 2 +- usr.bin/truncate/truncate.1 | 2 +- usr.bin/truss/truss.1 | 4 ++-- usr.bin/vmstat/vmstat.8 | 2 +- usr.bin/whois/whois.1 | 5 +++-- usr.bin/xargs/xargs.1 | 6 +++--- usr.bin/xinstall/install.1 | 10 ++++++---- 20 files changed, 66 insertions(+), 49 deletions(-) diff --git a/usr.bin/du/du.1 b/usr.bin/du/du.1 index cb4d458..8594ba7 100644 --- a/usr.bin/du/du.1 +++ b/usr.bin/du/du.1 @@ -97,7 +97,11 @@ Display block counts in 1024-byte (1-Kbyte) blocks. .It Fl m Display block counts in 1048576-byte (1-Mbyte) blocks. .It Fl n -Ignore files and directories with user "nodump" flag (UF_NODUMP) set. +Ignore files and directories with user +.Dq nodump +flag +.Pq Dv UF_NODUMP +set. .It Fl x File system mount points are not traversed. .El diff --git a/usr.bin/file/magic.5 b/usr.bin/file/magic.5 index 27e85a1..af8be12 100644 --- a/usr.bin/file/magic.5 +++ b/usr.bin/file/magic.5 @@ -424,12 +424,7 @@ is newer than .Pa /usr/share/misc/magic.mgc it is not used. Use the command: -.Po -cd /usr/share/misc && -.Nm file -.Fl C -.Fl m Ar magic -.Pc +.Dq Li "cd /usr/share/misc && file -C -m magic" to rebuild. .Sh SEE ALSO .Xr file 1 diff --git a/usr.bin/find/find.1 b/usr.bin/find/find.1 index 0367e72..f817eeb 100644 --- a/usr.bin/find/find.1 +++ b/usr.bin/find/find.1 @@ -661,7 +661,8 @@ is specified, the given expression shall be effectively replaced by .It Ic -print0 This primary always evaluates to true. It prints the pathname of the current file to standard output, followed by an -.Tn ASCII NUL +.Tn ASCII +.Dv NUL character (character code 0). .It Ic -prune This primary always evaluates to true. diff --git a/usr.bin/locate/locate/locate.1 b/usr.bin/locate/locate/locate.1 index 2a8727a..c436cd4 100644 --- a/usr.bin/locate/locate/locate.1 +++ b/usr.bin/locate/locate/locate.1 @@ -81,7 +81,8 @@ Historically, locate only stored characters between 32 and 127. The current implementation store any character except newline .Pq Sq \en -and NUL +and +.Dv NUL .Pq Sq \e0 . The 8-bit character support does not waste extra space for plain ASCII file names. @@ -92,7 +93,8 @@ The following options are available: .Bl -tag -width 10n .It Fl 0 Print pathnames separated by an -.Tn ASCII NUL +.Tn ASCII +.Dv NUL character (character code 0) instead of default NL (newline, character code 10). .It Fl S @@ -150,7 +152,7 @@ or .Dl "$ locate -d db1:db2 -d db3 pattern" .Pp If -.Ar - +.Fl is given as the database name, standard input will be read instead. For example, you can compress your database and use: @@ -161,7 +163,7 @@ $ zcat database.gz | locate -d - pattern This might be useful on machines with a fast CPU and little RAM and slow I/O. Note: you can only use -.Ar one +.Em one pattern for stdin. .It Fl i Ignore case distinctions in both the pattern and the database. @@ -239,7 +241,7 @@ The .Nm database is typically built by user .Dq nobody -and the +and the .Xr locate.updatedb 8 utility skips directories which are not readable for user @@ -249,7 +251,7 @@ group or world. For example, if your HOME directory is not world-readable, -.Ar none +.Em none of your files are in the database. .Pp diff --git a/usr.bin/logger/logger.1 b/usr.bin/logger/logger.1 index 836ad1c..d7e28b1 100644 --- a/usr.bin/logger/logger.1 +++ b/usr.bin/logger/logger.1 @@ -89,7 +89,8 @@ Send the message to the specified number on a remote system, which can be specified as a service name or as a decimal number. -The default is ``syslog''. +The default is +.Dq Li syslog . If an unknown service name is used, .Nm prints a warning and falls back to port 514. diff --git a/usr.bin/login/login.1 b/usr.bin/login/login.1 index e6c1d96..0ca8117 100644 --- a/usr.bin/login/login.1 +++ b/usr.bin/login/login.1 @@ -123,14 +123,14 @@ Consult the .Xr builtin 1 manual page. .Pp -The +The .Nm utility will submit an audit record when login succeeds or fails. Failure to determine the current auditing state will result in an error exit from .Nm . .Sh FILES -.Bl -tag -width ".Pa /etc/login.conf" -compact +.Bl -tag -width ".Pa /etc/security/audit_control" -compact .It Pa /etc/fbtab changes device protections .It Pa /etc/login.conf diff --git a/usr.bin/lorder/lorder.1 b/usr.bin/lorder/lorder.1 index 20ac7e0..7e98a34 100644 --- a/usr.bin/lorder/lorder.1 +++ b/usr.bin/lorder/lorder.1 @@ -61,9 +61,9 @@ object modules so that all references may be resolved in a single pass of the loader. .Pp When linking static binaries, -.Nm -and -.Xr tsort 1 +.Nm +and +.Xr tsort 1 can be used to properly order library archives automatically. .Sh EXAMPLES .Bd -literal -offset indent diff --git a/usr.bin/make/make.1 b/usr.bin/make/make.1 index cb6ee2d..387a5aa 100644 --- a/usr.bin/make/make.1 +++ b/usr.bin/make/make.1 @@ -32,7 +32,7 @@ .\" @(#)make.1 8.8 (Berkeley) 6/13/95 .\" $FreeBSD$ .\" -.Dd October 14, 2005 +.Dd April 8, 2006 .Dt MAKE 1 .Os .Sh NAME diff --git a/usr.bin/mktemp/mktemp.1 b/usr.bin/mktemp/mktemp.1 index 7d65aaa..6e35759 100644 --- a/usr.bin/mktemp/mktemp.1 +++ b/usr.bin/mktemp/mktemp.1 @@ -32,7 +32,7 @@ .\" From: $OpenBSD: mktemp.1,v 1.8 1998/03/19 06:13:37 millert Exp $ .\" $FreeBSD$ .\" -.Dd November 20, 1996 +.Dd December 30, 2005 .Dt MKTEMP 1 .Os .Sh NAME diff --git a/usr.bin/mkuzip/mkuzip.8 b/usr.bin/mkuzip/mkuzip.8 index c535e9a..37d86ba 100644 --- a/usr.bin/mkuzip/mkuzip.8 +++ b/usr.bin/mkuzip/mkuzip.8 @@ -7,7 +7,7 @@ .\" .\" $FreeBSD$ .\" -.Dd September 10, 2004 +.Dd March 17, 2006 .Dt MKUZIP 8 .Os .Sh NAME @@ -30,7 +30,9 @@ class will be able to decompress the resulting image at run-time. This allows for a significant reduction of size of disk image at the expense of some CPU time required to decompress the data each time it is read. +The .Nm +utility works in two phases: .Bl -enum .It @@ -74,7 +76,9 @@ sizes lead to higher overhead in the class, as the class has to decompress the whole cluster even if only a few bytes from that cluster have to be read. .Pp +The .Nm +utility inserts a short shell script at the beginning of the generated image, which makes it possible to .Dq run diff --git a/usr.bin/netstat/netstat.1 b/usr.bin/netstat/netstat.1 index 285ffab..e94fd64 100644 --- a/usr.bin/netstat/netstat.1 +++ b/usr.bin/netstat/netstat.1 @@ -32,7 +32,7 @@ .\" @(#)netstat.1 8.8 (Berkeley) 4/18/94 .\" $FreeBSD$ .\" -.Dd September 7, 2005 +.Dd December 18, 2005 .Dt NETSTAT 1 .Os .Sh NAME @@ -437,18 +437,19 @@ flags displayed when .Nm is invoked with the .Fl B -option represents the underlying parameters of the bpf peer. Each flag is +option represent the underlying parameters of the bpf peer. +Each flag is represented as a single lower case letter. The mapping between the letters and flags in order of appearance are: .Bl -column ".Li i" .It Li p Ta Set if listening promiscuously -.It Li i Ta BIOCIMMEDIATE has been set on the device -.It Li f Ta BIOCGHDRCMPLT status: source link addresses are being +.It Li i Ta Dv BIOCIMMEDIATE No has been set on the device +.It Li f Ta Dv BIOCGHDRCMPLT No status: source link addresses are being filled automatically -.It Li s Ta BIOCGSEESENT status: see packets originating locally and +.It Li s Ta Dv BIOCGSEESENT No status: see packets originating locally and remotely on the interface. .It Li a Ta Packet reception generates a signal -.It Li l Ta BIOCLOCK status: descriptor has been locked +.It Li l Ta Dv BIOCLOCK No status: descriptor has been locked .El .Pp For more information about these flags, please refer to diff --git a/usr.bin/split/split.1 b/usr.bin/split/split.1 index 329326d..5e8e198 100644 --- a/usr.bin/split/split.1 +++ b/usr.bin/split/split.1 @@ -46,7 +46,9 @@ .Nm .Fl b Ar byte_count Ns .Oo -.Cm K Ns | Ns Cm k Ns | Ns Cm M Ns | Ns Cm m Ns | Ns Cm G Ns | Ns Cm g +.Sm off +.Cm K | k | M | m | G | g +.Sm on .Oc .Op Fl a Ar suffix_length .Op Ar file Op Ar prefix @@ -77,7 +79,11 @@ The options are as follows: Use .Ar suffix_length letters to form the suffix of the file name. -.It Fl b Ar byte_count Ns Op Cm K Ns | Ns Cm k Ns | Ns Cm M Ns | Ns Cm m Ns | Ns Cm G Ns | Ns Cm g +.It Fl b Ar byte_count Ns Oo +.Sm off +.Cm K | k | M | m | G | g +.Sm on +.Oc Create smaller files .Ar byte_count bytes in length. @@ -126,7 +132,7 @@ In this case, each file into which the file is split is named by the prefix followed by a lexically ordered suffix using .Ar suffix_length characters in the range -.Dq Li a Ns - Ns Li z . +.Dq Li a Ns - Ns Li z . If .Fl a is not specified, two letters are used as the suffix. diff --git a/usr.bin/su/su.1 b/usr.bin/su/su.1 index ef8e91c..dafe292 100644 --- a/usr.bin/su/su.1 +++ b/usr.bin/su/su.1 @@ -59,11 +59,11 @@ In particular, by default only users in the .Dq Li wheel group can switch to UID 0 .Pq Dq Li root . -This group requirement may be changed by modifying the +This group requirement may be changed by modifying the .Dq Li pam_group -section of +section of .Pa /etc/pam.d/su . -See +See .Xr pam_group 8 for details on how to modify this setting. .Pp diff --git a/usr.bin/time/time.1 b/usr.bin/time/time.1 index f4b72fc..79419bf 100644 --- a/usr.bin/time/time.1 +++ b/usr.bin/time/time.1 @@ -32,7 +32,7 @@ .\" @(#)time.1 8.1 (Berkeley) 6/6/93 .\" $FreeBSD$ .\" -.Dd June 6, 1993 +.Dd May 14, 2006 .Dt TIME 1 .Os .Sh NAME diff --git a/usr.bin/truncate/truncate.1 b/usr.bin/truncate/truncate.1 index 95d6d99..1ed0a48 100644 --- a/usr.bin/truncate/truncate.1 +++ b/usr.bin/truncate/truncate.1 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd July 4, 2000 +.Dd April 9, 2006 .Dt TRUNCATE 1 .Os .Sh NAME diff --git a/usr.bin/truss/truss.1 b/usr.bin/truss/truss.1 index 3efa65f..d534325 100644 --- a/usr.bin/truss/truss.1 +++ b/usr.bin/truss/truss.1 @@ -1,6 +1,6 @@ .\" $FreeBSD$ .\" -.Dd September 3, 2004 +.Dd January 2, 2004 .Dt TRUSS 1 .Os .Sh NAME @@ -61,7 +61,7 @@ Display strings using at most .Ar strsize characters. If the buffer is larger, -.Qq ... +.Dq Li ... will be displayed at the end of the string. The default .Ar strsize diff --git a/usr.bin/vmstat/vmstat.8 b/usr.bin/vmstat/vmstat.8 index 24afc7d..ab36788 100644 --- a/usr.bin/vmstat/vmstat.8 +++ b/usr.bin/vmstat/vmstat.8 @@ -32,7 +32,7 @@ .\" @(#)vmstat.8 8.1 (Berkeley) 6/6/93 .\" $FreeBSD$ .\" -.Dd February 11, 2005 +.Dd February 11, 2006 .Dt VMSTAT 8 .Os .Sh NAME diff --git a/usr.bin/whois/whois.1 b/usr.bin/whois/whois.1 index fbbf740..52da220 100644 --- a/usr.bin/whois/whois.1 +++ b/usr.bin/whois/whois.1 @@ -32,7 +32,7 @@ .\" From: @(#)whois.1 8.1 (Berkeley) 6/6/93 .\" $FreeBSD$ .\" -.Dd December 11, 2004 +.Dd January 23, 2006 .Dt WHOIS 1 .Os .Sh NAME @@ -90,7 +90,8 @@ It contains points of contact for subdomains of .It Fl f Use the African Network Information Centre .Pq Tn AfriNIC -database. It contains network numbers used in Africa and the islands of the +database. +It contains network numbers used in Africa and the islands of the western Indian Ocean. .It Fl g Use the US non-military federal government database, which contains points of diff --git a/usr.bin/xargs/xargs.1 b/usr.bin/xargs/xargs.1 index b8fe2c8..dd1d2a8 100644 --- a/usr.bin/xargs/xargs.1 +++ b/usr.bin/xargs/xargs.1 @@ -37,7 +37,7 @@ .\" $FreeBSD$ .\" $xMach: xargs.1,v 1.2 2002/02/23 05:23:37 tim Exp $ .\" -.Dd August 2, 2004 +.Dd December 30, 2005 .Dt XARGS 1 .Os .Sh NAME @@ -308,9 +308,9 @@ utility is expected to be .St -p1003.2 compliant. The -.Fl J , o , P, S +.Fl J , o , P, R and -.Fl R +.Fl S options are non-standard .Fx extensions which may not be available on other operating systems. diff --git a/usr.bin/xinstall/install.1 b/usr.bin/xinstall/install.1 index 197bea5..31ce10a 100644 --- a/usr.bin/xinstall/install.1 +++ b/usr.bin/xinstall/install.1 @@ -32,7 +32,7 @@ .\" From: @(#)install.1 8.1 (Berkeley) 6/6/93 .\" $FreeBSD$ .\" -.Dd May 7, 2001 +.Dd March 6, 2006 .Dt INSTALL 1 .Os .Sh NAME @@ -192,14 +192,16 @@ option has been specified. .Pp If the .Ev DONTSTRIP -environment variable is present +environment variable is present, .Nm will ignore any specification of the .Fl s option. -This is mainly for use in debugging The FreeBSD Ports Collection. +This is mainly for use in debugging the +.Fx +Ports Collection. .Sh FILES -.Bl -tag -width INS@XXXX -compact +.Bl -tag -width ".Pa INS@XXXX" -compact .It Pa INS@XXXX If either .Fl S -- cgit v1.1