summaryrefslogtreecommitdiffstats
path: root/share/man/man5
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2004-07-03 18:29:24 +0000
committerru <ru@FreeBSD.org>2004-07-03 18:29:24 +0000
commit1cf159866714352fd8d7789b97068220cbb5a1a4 (patch)
tree5526e5113f4e9589bb734483867453b89a7ca4e6 /share/man/man5
parentbf15efbfc56854d6fb20bb4ff7801d7549fe2bfd (diff)
downloadFreeBSD-src-1cf159866714352fd8d7789b97068220cbb5a1a4.zip
FreeBSD-src-1cf159866714352fd8d7789b97068220cbb5a1a4.tar.gz
Mechanically kill hard sentence breaks and double whitespaces.
Diffstat (limited to 'share/man/man5')
-rw-r--r--share/man/man5/a.out.52
-rw-r--r--share/man/man5/devfs.53
-rw-r--r--share/man/man5/disktab.59
-rw-r--r--share/man/man5/elf.56
-rw-r--r--share/man/man5/forward.59
-rw-r--r--share/man/man5/fs.518
-rw-r--r--share/man/man5/fstab.511
-rw-r--r--share/man/man5/hosts.56
-rw-r--r--share/man/man5/hosts.equiv.56
-rw-r--r--share/man/man5/link.53
-rw-r--r--share/man/man5/mailer.conf.511
-rw-r--r--share/man/man5/networks.52
-rw-r--r--share/man/man5/passwd.521
-rw-r--r--share/man/man5/pbm.53
-rw-r--r--share/man/man5/phones.515
-rw-r--r--share/man/man5/procfs.59
-rw-r--r--share/man/man5/protocols.56
-rw-r--r--share/man/man5/rc.conf.54
-rw-r--r--share/man/man5/remote.53
-rw-r--r--share/man/man5/services.52
-rw-r--r--share/man/man5/stab.52
-rw-r--r--share/man/man5/sysctl.conf.56
22 files changed, 102 insertions, 55 deletions
diff --git a/share/man/man5/a.out.5 b/share/man/man5/a.out.5
index ac186d5..e816a57 100644
--- a/share/man/man5/a.out.5
+++ b/share/man/man5/a.out.5
@@ -129,7 +129,7 @@ if necessary.
.El
.Pp
If both EX_DYNAMIC and EX_PIC are set, the object file is a position independent
-executable image (eg. a shared library), which is to be loaded into the
+executable image (e.g.\& a shared library), which is to be loaded into the
process address space by the run-time link editor.
.Pp
The macro
diff --git a/share/man/man5/devfs.5 b/share/man/man5/devfs.5
index 2d88204..173ab19 100644
--- a/share/man/man5/devfs.5
+++ b/share/man/man5/devfs.5
@@ -57,7 +57,8 @@ The conventional mount point is
.Pa /dev .
.Pp
The file system includes several directories, links, symbolic links
-and devices, some of which can also be written. In a chroot'ed
+and devices, some of which can also be written.
+In a chroot'ed
environment,
.Nm
can be used to create a new
diff --git a/share/man/man5/disktab.5 b/share/man/man5/disktab.5
index ab9bef8..cf33790 100644
--- a/share/man/man5/disktab.5
+++ b/share/man/man5/disktab.5
@@ -52,11 +52,14 @@ to initialize the disk label on the disk.
The format is patterned
after the
.Xr termcap 5
-terminal data base. Entries in
+terminal data base.
+Entries in
.Nm
-consist of a number of `:'-separated fields. The
+consist of a number of `:'-separated fields.
+The
first field for each entry gives the names by which a
-disk's entry may be selected, separated by `|' characters. The
+disk's entry may be selected, separated by `|' characters.
+The
last name given should be a long name fully identifying
the disk.
.Pp
diff --git a/share/man/man5/elf.5 b/share/man/man5/elf.5
index 01792c4..5f52875 100644
--- a/share/man/man5/elf.5
+++ b/share/man/man5/elf.5
@@ -351,7 +351,8 @@ file has no section header table this member holds zero.
.It Dv e_flags
This member holds processor-specific flags associated with the file.
Flag
-names take the form EF_`machine_flag'. Currently no flags have been defined.
+names take the form EF_`machine_flag'.
+Currently no flags have been defined.
.It Dv e_ehsize
This member holds the ELF header's size in bytes.
.It Dv e_phentsize
@@ -475,7 +476,8 @@ The array element specifies dynamic linking information.
The array element specifies the location and size of a null-terminated
path name to invoke as an interpreter.
This segment type is meaningful
-only for executable files (though it may occur for shared objects). However
+only for executable files (though it may occur for shared objects).
+However
it may not occur more than once in a file.
If it is present it must precede
any loadable segment entry.
diff --git a/share/man/man5/forward.5 b/share/man/man5/forward.5
index b6d0e46..2234ff3 100644
--- a/share/man/man5/forward.5
+++ b/share/man/man5/forward.5
@@ -41,13 +41,16 @@
The
.Nm .forward
file contains a list of mail addresses or programs
-that the user's mail should be redirected to. If the
+that the user's mail should be redirected to.
+If the
file is not present, then no mail forwarding will be done.
Mail may also be forwarded as the standard input to a program
by prefixing the line
-with the normal shell pipe symbol (|). If arguments
+with the normal shell pipe symbol (|).
+If arguments
are to be passed to the command, then the entire line
-should be enclosed in quotes. For security reasons, the
+should be enclosed in quotes.
+For security reasons, the
.Nm .forward
file must be owned by the user the mail is being sent to,
or by root, and the user's shell must be listed in
diff --git a/share/man/man5/fs.5 b/share/man/man5/fs.5
index 48b4c1b..368f11c 100644
--- a/share/man/man5/fs.5
+++ b/share/man/man5/fs.5
@@ -203,15 +203,18 @@ A file system consists of a number of cylinder groups.
Each cylinder group has inodes and data.
.Pp
A file system is described by its super-block, which in turn
-describes the cylinder groups. The super-block is critical
+describes the cylinder groups.
+The super-block is critical
data and is replicated in each cylinder group to protect against
-catastrophic loss. This is done at file system creation
+catastrophic loss.
+This is done at file system creation
time and the critical
super-block data does not change, so the copies need not be
referenced further unless disaster strikes.
.Pp
Addresses stored in inodes are capable of addressing fragments
-of `blocks'. File system blocks of at most size
+of `blocks'.
+File system blocks of at most size
.Dv MAXBSIZE
can
be optionally broken into 2, 4, or 8 pieces, each of which is
@@ -222,12 +225,15 @@ a
.Dv DEV_BSIZE
unit.
.Pp
-Large files consist of exclusively large data blocks. To avoid
+Large files consist of exclusively large data blocks.
+To avoid
undue wasted disk space, the last data block of a small file is
allocated as only as many fragments of a large block as are
-necessary. The file system format retains only a single pointer
+necessary.
+The file system format retains only a single pointer
to such a fragment, which is a piece of a single large block that
-has been divided. The size of such a fragment is determinable from
+has been divided.
+The size of such a fragment is determinable from
information in the inode, using the
.Fn blksize fs ip lbn
macro.
diff --git a/share/man/man5/fstab.5 b/share/man/man5/fstab.5
index e2a90ad..7e8f10c 100644
--- a/share/man/man5/fstab.5
+++ b/share/man/man5/fstab.5
@@ -86,8 +86,10 @@ The system can support various file system types.
Only the root, /usr, and /tmp file systems need be statically
compiled into the kernel;
everything else will be automatically loaded at mount
-time. (Exception: the UFS family - FFS and LFS cannot
-currently be demand-loaded.) Some people still prefer to statically
+time.
+(Exception: the UFS family - FFS and LFS cannot
+currently be demand-loaded.)
+Some people still prefer to statically
compile other file systems as well.
.Pp
The fourth field,
@@ -97,7 +99,8 @@ It is formatted as a comma separated list of options.
It contains at least the type of mount (see
.Fa fs_type
below) plus any additional options
-appropriate to the file system type. See the options flag
+appropriate to the file system type.
+See the options flag
.Pq Fl o
in the
.Xr mount 8
@@ -131,7 +134,7 @@ If the option ``noauto'' is specified, the file system will not be automatically
mounted at system startup.
Note that, for network file systems
of third party types
-(i.e. types supported by additional software
+(i.e., types supported by additional software
not included in the base system)
to be automatically mounted at system startup,
the
diff --git a/share/man/man5/hosts.5 b/share/man/man5/hosts.5
index 79b20c3..218a4df 100644
--- a/share/man/man5/hosts.5
+++ b/share/man/man5/hosts.5
@@ -55,7 +55,8 @@ aliases
.Ed
.Pp
Items are separated by any number of blanks and/or
-tab characters. A ``#'' indicates the beginning of
+tab characters.
+A ``#'' indicates the beginning of
a comment; characters up to the end of the line are
not interpreted by routines which search the file.
.Pp
@@ -75,7 +76,8 @@ Center
.Pq Tn NIC ,
though local changes may be required
to bring it up to date regarding unofficial aliases
-and/or unknown hosts. As the data base maintained at
+and/or unknown hosts.
+As the data base maintained at
.Tn NIC
is incomplete, use of the name server is recommended for
sites on the
diff --git a/share/man/man5/hosts.equiv.5 b/share/man/man5/hosts.equiv.5
index e824e51..c180d2a 100644
--- a/share/man/man5/hosts.equiv.5
+++ b/share/man/man5/hosts.equiv.5
@@ -63,7 +63,8 @@ A
indicates a host by netgroup or user by netgroup.
A single
.Dq +
-matches all hosts or users. A host name with a leading
+matches all hosts or users.
+A host name with a leading
.Dq -
will reject
all matching hosts and all their users.
@@ -72,7 +73,8 @@ A user name with leading
will reject all matching users from matching hosts.
.Pp
Items are separated by any number of blanks and/or
-tab characters. A
+tab characters.
+A
.Dq #
indicates the beginning of
a comment; characters up to the end of the line are
diff --git a/share/man/man5/link.5 b/share/man/man5/link.5
index 8d443d8..73f0a45 100644
--- a/share/man/man5/link.5
+++ b/share/man/man5/link.5
@@ -180,7 +180,8 @@ struct section_dispatch_table {
.Pp
.Bl -tag -width sdt_filler1
.It Fa sdt_loaded
-A pointer to the first link map loaded (see below). This field is set by
+A pointer to the first link map loaded (see below).
+This field is set by
.Nm ld.so
.It Fa sdt_sods
The start of a (linked) list of shared object descriptors needed by
diff --git a/share/man/man5/mailer.conf.5 b/share/man/man5/mailer.conf.5
index b6971da..87c1249 100644
--- a/share/man/man5/mailer.conf.5
+++ b/share/man/man5/mailer.conf.5
@@ -41,7 +41,8 @@
.Sh DESCRIPTION
The file
.Pa /etc/mail/mailer.conf
-contains a series of pairs. The first member of each pair is the name
+contains a series of pairs.
+The first member of each pair is the name
of a program invoking
.Xr mailwrapper 8
which is typically a symbolic link to
@@ -52,7 +53,8 @@ and
.Xr mailq 1
would be set up this way.)
The second member of each pair is the name of the program to
-actually execute when the first name is invoked. The file may also
+actually execute when the first name is invoked.
+The file may also
contain comments, denoted by a # mark in the first column of any line.
.Sh EXAMPLES
The following is an example of how to set up an
@@ -88,9 +90,10 @@ newaliases /usr/local/sbin/sendmail
appeared in
.Nx 1.4 .
.Sh AUTHORS
-Perry E. Metzger <perry@piermont.com>
+.An Perry E. Metzger Aq perry@piermont.com
.Sh BUGS
-The entire reason this program exists is a crock. Instead, a command
+The entire reason this program exists is a crock.
+Instead, a command
for how to submit mail should be standardized, and all the "behave
differently if invoked with a different name" behavior of things like
.Xr mailq 1
diff --git a/share/man/man5/networks.5 b/share/man/man5/networks.5
index 04ec15b..ff62267 100644
--- a/share/man/man5/networks.5
+++ b/share/man/man5/networks.5
@@ -63,7 +63,7 @@ changes may be required to bring it up to date regarding unofficial aliases
and/or unknown networks.
.Pp
Network numbers may be specified in the conventional
-``.'' (dot) notation using the
+``.'' (dot) notation using the
.Xr inet_network 3
routine
from the Internet address manipulation library,
diff --git a/share/man/man5/passwd.5 b/share/man/man5/passwd.5
index e1a4ac3..9476ec0 100644
--- a/share/man/man5/passwd.5
+++ b/share/man/man5/passwd.5
@@ -65,7 +65,8 @@ The
.Nm master.passwd
file is readable only by root, and consists of newline separated
records, one per user, containing ten colon (``:'') separated
-fields. These fields are as follows:
+fields.
+These fields are as follows:
.Pp
.Bl -tag -width password -offset indent
.It name
@@ -105,18 +106,21 @@ The
.Ar name
field is the login used to access the computer account, and the
.Ar uid
-field is the number associated with it. They should both be unique
+field is the number associated with it.
+They should both be unique
across the system (and often across a group of systems) since they
control file access.
.Pp
While it is possible to have multiple entries with identical login names
-and/or identical user id's, it is usually a mistake to do so. Routines
+and/or identical user id's, it is usually a mistake to do so.
+Routines
that manipulate these files will often return only one of the multiple
entries, and that one by random selection.
.Pp
The login name must never begin with a hyphen (``-''); also, it is strongly
suggested that neither upper-case characters or dots (``.'') be part
-of the name, as this tends to confuse mailers. No field may contain a
+of the name, as this tends to confuse mailers.
+No field may contain a
colon (``:'') as this has been used historically to separate the fields
in the user database.
.Pp
@@ -126,7 +130,8 @@ form of the password.
If the
.Ar password
field is empty, no password will be required to gain access to the
-machine. This is almost invariably a mistake.
+machine.
+This is almost invariably a mistake.
Because these files contain the encrypted user passwords, they should
not be readable by anyone without appropriate privileges.
.Pp
@@ -137,7 +142,8 @@ this field currently has little special meaning.
.Pp
The
.Ar class
-field is a key for a user's login class. Login classes
+field is a key for a user's login class.
+Login classes
are defined in
.Xr login.conf 5 ,
which is a
@@ -280,7 +286,8 @@ or
fields, the specified numbers will override the information retrieved
from the Hesiod domain or the
.Tn NIS
-maps. As well, if the
+maps.
+As well, if the
.Ar gecos ,
.Ar dir
or
diff --git a/share/man/man5/pbm.5 b/share/man/man5/pbm.5
index 228315b..55d2c5c 100644
--- a/share/man/man5/pbm.5
+++ b/share/man/man5/pbm.5
@@ -62,7 +62,8 @@ Programs that read this format should be as lenient as possible,
accepting anything that looks remotely like a bitmap.
.Pp
There is also a variant on the format, available
-by setting the RAWBITS option at compile time. This variant is
+by setting the RAWBITS option at compile time.
+This variant is
different in the following ways:
.Pp
.Bl -bullet -compact
diff --git a/share/man/man5/phones.5 b/share/man/man5/phones.5
index f3360c3..59b491b 100644
--- a/share/man/man5/phones.5
+++ b/share/man/man5/phones.5
@@ -44,22 +44,27 @@ The file
contains the system-wide
private phone numbers for the
.Xr tip 1
-program. This file is normally unreadable, and so may contain
-privileged information. The format of the file is a series of lines
-of the form: <system-name>[\ \et]*<phone-number>. The system name is
+program.
+This file is normally unreadable, and so may contain
+privileged information.
+The format of the file is a series of lines
+of the form: <system-name>[\ \et]*<phone-number>.
+The system name is
one of those defined in the
.Xr remote 5
file and the phone number is constructed from any sequence of
characters terminated only by ``,'' or the end of the line.
The ``='' and ``*'' characters are
indicators to the auto call units to pause and wait for a second dial
-tone (when going through an exchange). The ``='' is required by the
+tone (when going through an exchange).
+The ``='' is required by the
.Tn DF02-AC
and the ``*'' is required by the
.Tn BIZCOMP
1030.
.Pp
-Only one phone number per line is permitted. However, if more than
+Only one phone number per line is permitted.
+However, if more than
one line in the file contains the same system name
.Xr tip 1
will attempt to dial each one in turn, until it establishes a connection.
diff --git a/share/man/man5/procfs.5 b/share/man/man5/procfs.5
index 169421e..47f5f9a 100644
--- a/share/man/man5/procfs.5
+++ b/share/man/man5/procfs.5
@@ -30,7 +30,8 @@ provides a two-level view of process space, unlike the previous
.Nm
implementation.
At the highest level, processes themselves are named, according to
-their process ids in decimal, with no leading zeros. There is also a
+their process ids in decimal, with no leading zeros.
+There is also a
special node called
.Pa curproc
which always refers to the process making the lookup request.
@@ -107,9 +108,11 @@ Only those address which exist in the process can be accessed.
Reads and writes to this file modify the process.
Writes to the text segment remain private to the process.
.It Pa note
-Used for sending signals to the process. Not implemented.
+Used for sending signals to the process.
+Not implemented.
.It Pa notepg
-Used for sending signal to the process group. Not implemented.
+Used for sending signal to the process group.
+Not implemented.
.It Pa regs
Allows read and write access to the process' register set.
This file contains a binary data structure
diff --git a/share/man/man5/protocols.5 b/share/man/man5/protocols.5
index a8ad7a4..fb9577e 100644
--- a/share/man/man5/protocols.5
+++ b/share/man/man5/protocols.5
@@ -43,7 +43,8 @@ The
.Nm
file contains information regarding the known protocols used in the
.Tn DARPA
-Internet. For each protocol a single line should be present
+Internet.
+For each protocol a single line should be present
with the following information:
.Bd -unfilled -offset indent
official protocol name
@@ -52,7 +53,8 @@ aliases
.Ed
.Pp
Items are separated by any number of blanks and/or
-tab characters. A ``#'' indicates the beginning of
+tab characters.
+A ``#'' indicates the beginning of
a comment; characters up to the end of the line are
not interpreted by routines which search the file.
.Pp
diff --git a/share/man/man5/rc.conf.5 b/share/man/man5/rc.conf.5
index eb999e9..6aa9820 100644
--- a/share/man/man5/rc.conf.5
+++ b/share/man/man5/rc.conf.5
@@ -1728,7 +1728,7 @@ operation.
.Pq Vt bool
If set to
.Dq Li YES ,
-configure host to act as an IP router, e.g. to forward packets
+configure host to act as an IP router, e.g.\& to forward packets
between interfaces.
.It Va ipv6_gateway_enable
.Pq Vt bool
@@ -2227,7 +2227,7 @@ Microsoft mouse (serial)
.It Li intellimouse
Microsoft IntelliMouse (serial)
.It Li mousesystems
-Mouse systems Corp. mouse (serial)
+Mouse systems Corp.\& mouse (serial)
.It Li mmseries
MM Series mouse (serial)
.It Li logitech
diff --git a/share/man/man5/remote.5 b/share/man/man5/remote.5
index e50f1f3..edc3e17 100644
--- a/share/man/man5/remote.5
+++ b/share/man/man5/remote.5
@@ -77,7 +77,8 @@ When the
interface is used, entries of the form ``cu300'' are used.
.Sh CAPABILITIES
Capabilities are either strings (str), numbers (num), or boolean
-flags (bool). A string capability is specified by
+flags (bool).
+A string capability is specified by
.Em capability Ns Ar = Ns Em value ;
for example, ``dv=/dev/harris''.
A numeric capability is specified by
diff --git a/share/man/man5/services.5 b/share/man/man5/services.5
index 18e3ed8..738573dd5 100644
--- a/share/man/man5/services.5
+++ b/share/man/man5/services.5
@@ -57,7 +57,7 @@ Items are separated by any number of blanks and/or tab characters.
The port number and protocol name are considered a single
.Em item ;
a ``/'' is used to
-separate the port and protocol (e.g. ``512/tcp'').
+separate the port and protocol (e.g.\& ``512/tcp'').
A ``#'' indicates the beginning of
a comment; subsequent characters up to the end of the line are
not interpreted by the routines which search the file.
diff --git a/share/man/man5/stab.5 b/share/man/man5/stab.5
index 14eeef5..397a58b 100644
--- a/share/man/man5/stab.5
+++ b/share/man/man5/stab.5
@@ -46,7 +46,7 @@ The file
defines some of the symbol table
.Fa n_type
field values for a.out files.
-These are the types for permanent symbols (i.e. not local labels, etc.)
+These are the types for permanent symbols (i.e., not local labels, etc.)
used by the old debugger
.Em sdb
and the Berkeley Pascal compiler
diff --git a/share/man/man5/sysctl.conf.5 b/share/man/man5/sysctl.conf.5
index d302d6b..0e69bcc 100644
--- a/share/man/man5/sysctl.conf.5
+++ b/share/man/man5/sysctl.conf.5
@@ -34,7 +34,8 @@
The
.Pa /etc/sysctl.conf
file is read in when the system goes into multi-user mode to set default
-settings for the kernel. The
+settings for the kernel.
+The
.Pa /etc/sysctl.conf
is in the format of the
.Xr sysctl 8
@@ -45,7 +46,8 @@ sysctl_mib=value
.Pp
Comments are denoted by a
.Dq #
-at the beginning of a line. Comments can also exist at the end of a line,
+at the beginning of a line.
+Comments can also exist at the end of a line,
as seen in the
.Sx EXAMPLES
section, below.
OpenPOWER on IntegriCloud