mdoc(7) police: protect trailing full stops of abbreviations
with a trailing zero-width space: `e.g.\&'.
This commit is contained in:
parent
f363f88ff9
commit
9174553bc8
@ -48,7 +48,7 @@
|
||||
The
|
||||
.Fn getdiskbyname
|
||||
function
|
||||
takes a disk name (e.g.
|
||||
takes a disk name (e.g.\&
|
||||
.Ql rm03 )
|
||||
and returns a prototype disk label
|
||||
describing its geometry information and the standard
|
||||
|
@ -131,7 +131,7 @@ The
|
||||
function
|
||||
closes any open files.
|
||||
.Pp
|
||||
These routines have been written to ``shadow'' the password file, e.g.
|
||||
These routines have been written to ``shadow'' the password file, e.g.\&
|
||||
allow only certain programs to have access to the encrypted password.
|
||||
If the process which calls them has an effective uid of 0, the encrypted
|
||||
password will be returned, otherwise, the password field of the returned
|
||||
|
@ -442,7 +442,7 @@ is first ORed with
|
||||
the
|
||||
.Dq message
|
||||
that results is the printable name of the error code,
|
||||
e.g.
|
||||
e.g.\&
|
||||
.Dq Dv REG_NOMATCH ,
|
||||
rather than an explanation thereof.
|
||||
If
|
||||
|
@ -121,6 +121,6 @@ A user other than the super-user attempted to set the time.
|
||||
.Sh STANDARDS
|
||||
The
|
||||
.Fn clock_gettime ,
|
||||
etc.
|
||||
etc.\&
|
||||
functions conform to
|
||||
.St -p1003.1b-93 .
|
||||
|
@ -152,7 +152,7 @@ Unlike The Sun implementation, multiple
|
||||
.Fn mlock
|
||||
calls on the same address range require the corresponding number of
|
||||
.Fn munlock
|
||||
calls to actually unlock the pages, i.e.
|
||||
calls to actually unlock the pages, i.e.\&
|
||||
.Fn mlock
|
||||
nests.
|
||||
This should be considered a consequence of the implementation
|
||||
|
@ -108,7 +108,7 @@ The flag
|
||||
.Dv MSG_OOB
|
||||
is used to send
|
||||
.Dq out-of-band
|
||||
data on sockets that support this notion (e.g.
|
||||
data on sockets that support this notion (e.g.\&
|
||||
.Dv SOCK_STREAM ) ;
|
||||
the underlying protocol must also support
|
||||
.Dq out-of-band
|
||||
|
@ -170,7 +170,7 @@ layer.
|
||||
These functions may be used in new applications, but users may find it
|
||||
easier to use the various SCSI CCB building functions included with the
|
||||
.Xr cam 3
|
||||
library. (e.g.
|
||||
library. (e.g.\&
|
||||
.Fn cam_fill_csio ,
|
||||
.Fn scsi_start_stop ,
|
||||
and
|
||||
|
@ -180,7 +180,7 @@ values for a
|
||||
.It CHUNK_PAST_1024
|
||||
This chunk cannot be booted from because it extends past cylinder 1024.
|
||||
.It CHUNK_BSD_COMPAT
|
||||
This chunk is in the BSD-compatibility, and has a short name too, i.e.
|
||||
This chunk is in the BSD-compatibility, and has a short name too, i.e.\&
|
||||
.Ql wd0s4f -> wd0f .
|
||||
.It CHUNK_ALIGN
|
||||
This chunk should be aligned.
|
||||
|
@ -156,7 +156,7 @@ can contain control characters of the form
|
||||
.Sm off
|
||||
.Sq No ^ Ar character
|
||||
.Sm on
|
||||
(e.g.
|
||||
(e.g.\&
|
||||
.Sq ^A ) ,
|
||||
and the following backslashed escape sequences:
|
||||
.Pp
|
||||
|
@ -99,7 +99,7 @@ variable
|
||||
.Va errno ,
|
||||
and allows computation to resume.
|
||||
Alternatively, the Reserved Operand Fault Handler could be
|
||||
changed to respond by returning that plausible value, etc.
|
||||
changed to respond by returning that plausible value, etc.\&
|
||||
instead of aborting.
|
||||
.Pp
|
||||
In the table below, the first two columns show various
|
||||
|
@ -93,7 +93,7 @@ is in its canonical form.
|
||||
No hostname or address lookups are attempted.
|
||||
.Pp
|
||||
It is possible to call this function with either the hostname or
|
||||
the IP address missing (i.e.
|
||||
the IP address missing (i.e.\&
|
||||
.Dv NULL )
|
||||
and matching will be performed
|
||||
only on the basis of the parameter given.
|
||||
|
@ -32,7 +32,7 @@ default values used by other entries via the
|
||||
.Em tc=.dummy-entry
|
||||
mechanism. Most tags must be followed by an equals-sign
|
||||
and a value as above. Some may also appear in a boolean form with no
|
||||
value (i.e.
|
||||
value (i.e.\&
|
||||
.Em :tg: ) .
|
||||
The currently recognized tags are:
|
||||
.Pp
|
||||
|
@ -79,7 +79,7 @@ returns a
|
||||
report that lists all people logged into
|
||||
the system at that moment.
|
||||
.Pp
|
||||
If a user name is specified (e.g.
|
||||
If a user name is specified (e.g.\&
|
||||
.Pf eric Aq Tn CRLF )
|
||||
then the
|
||||
response lists more extended information for only that particular user,
|
||||
|
@ -123,7 +123,7 @@ is given.
|
||||
.Pp
|
||||
The final disk name can be provided as a
|
||||
.Sq bare
|
||||
disk name only, e.g.
|
||||
disk name only, e.g.\&
|
||||
.Ql da0 ,
|
||||
or as a full pathname.
|
||||
If omitted,
|
||||
|
@ -123,7 +123,7 @@ is given.
|
||||
.Pp
|
||||
The final disk name can be provided as a
|
||||
.Sq bare
|
||||
disk name only, e.g.
|
||||
disk name only, e.g.\&
|
||||
.Ql da0 ,
|
||||
or as a fully qualified device node under
|
||||
.Pa /dev .
|
||||
|
@ -123,7 +123,7 @@ is given.
|
||||
.Pp
|
||||
The final disk name can be provided as a
|
||||
.Sq bare
|
||||
disk name only, e.g.
|
||||
disk name only, e.g.\&
|
||||
.Ql da0 ,
|
||||
or as a full pathname.
|
||||
If omitted,
|
||||
|
@ -263,7 +263,7 @@ will time out after 30 seconds and print a warning message.
|
||||
will cease creating new processes
|
||||
and allow the system to slowly die away, if it is sent a terminal stop
|
||||
.Pq Dv TSTP
|
||||
signal, i.e.
|
||||
signal, i.e.\&
|
||||
.Dq Li "kill \-TSTP 1" .
|
||||
A later hangup will resume full
|
||||
multi-user operations, or a terminate will start a single-user shell.
|
||||
@ -276,7 +276,7 @@ and
|
||||
will terminate all possible processes (again, it will not wait
|
||||
for deadlocked processes) and reboot the machine if sent the interrupt
|
||||
.Pq Dv INT
|
||||
signal, i.e.
|
||||
signal, i.e.\&
|
||||
.Dq Li "kill \-INT 1".
|
||||
This is useful for shutting the machine down cleanly from inside the kernel
|
||||
or from X when the machine appears to be hung.
|
||||
|
@ -123,7 +123,7 @@ is given.
|
||||
.Pp
|
||||
The final disk name can be provided as a
|
||||
.Sq bare
|
||||
disk name only, e.g.
|
||||
disk name only, e.g.\&
|
||||
.Ql da0 ,
|
||||
or as a fully qualified device node under
|
||||
.Pa /dev .
|
||||
|
@ -484,7 +484,7 @@ If the SA is not available in every level, the kernel will request
|
||||
getting SA to the key exchange daemon.
|
||||
.Li default
|
||||
means the kernel consults to the system wide default against protocol you
|
||||
specified, e.g.
|
||||
specified, e.g.\&
|
||||
.Li esp_trans_deflev
|
||||
sysctl variable, when the kernel processes the packet.
|
||||
.Li use
|
||||
|
@ -1359,7 +1359,7 @@ common networking problems, solved using
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Nm
|
||||
system was designed and first implemented at Whistle Communications, Inc.
|
||||
system was designed and first implemented at Whistle Communications, Inc.\&
|
||||
in a version of
|
||||
.Fx 2.2
|
||||
customized for the Whistle InterJet.
|
||||
|
@ -204,7 +204,7 @@ There are currently four debugging flags that may be turned on:
|
||||
This debugging flag enables general informational printfs for the device
|
||||
or devices in question.
|
||||
.It Dv CAM_DEBUG_TRACE
|
||||
This debugging flag enables function-level command flow tracing. i.e.
|
||||
This debugging flag enables function-level command flow tracing. i.e.\&
|
||||
kernel printfs will happen at the entrance and exit of various functions.
|
||||
.It Dv CAM_DEBUG_SUBTRACE
|
||||
This debugging flag enables debugging output internal to various functions.
|
||||
|
@ -89,7 +89,7 @@ either by statically linking the VESA module or by loading the VESA module
|
||||
you can load bitmaps up to a resolution of 1024x768, depending on the VESA
|
||||
BIOS and the amount of video memory on the video card.
|
||||
.Ss Screen saver
|
||||
The screen saver will activate when the system is considered idle: i.e.
|
||||
The screen saver will activate when the system is considered idle: i.e.\&
|
||||
when the user has not typed a key or moved the mouse for a specified period
|
||||
of time.
|
||||
As the screen saver is an optional module,
|
||||
|
@ -88,7 +88,7 @@ such as descriptors, from the device.
|
||||
Each endpoint, except the control endpoint, is unidirectional.
|
||||
.Pp
|
||||
The endpoints in a device are grouped into interfaces.
|
||||
An interface is a logical unit within a device; e.g.
|
||||
An interface is a logical unit within a device; e.g.\&
|
||||
a compound device with both a keyboard and a trackball would present
|
||||
one interface for each.
|
||||
An interface can sometimes be set into different modes,
|
||||
@ -245,7 +245,7 @@ struct usb_device_stats {
|
||||
.Pp
|
||||
The
|
||||
.Va requests
|
||||
field is indexed by the transfer kind, i.e.
|
||||
field is indexed by the transfer kind, i.e.\&
|
||||
.Va UE_* ,
|
||||
and indicates how many transfers of each kind that has been completed
|
||||
by the controller.
|
||||
|
@ -130,7 +130,7 @@ set it to melody mode.
|
||||
.Pq Vt str
|
||||
Path to the configuration file for the
|
||||
.Xr pccardd 8
|
||||
daemon (e.g.
|
||||
daemon (e.g.\&
|
||||
.Pa /etc/pccard.conf.sample ) .
|
||||
.It Va pccardd_flags
|
||||
.Pq Vt str
|
||||
|
@ -170,7 +170,7 @@ If more than one instance of these keywords is present,
|
||||
the last instance will override.
|
||||
.Pp
|
||||
The keyword and value must appear on a single line, and the keyword
|
||||
(e.g.
|
||||
(e.g.\&
|
||||
.Sy nameserver )
|
||||
must start the line. The value follows
|
||||
the keyword, separated by white space.
|
||||
|
@ -38,7 +38,7 @@ settings for the kernel. The
|
||||
.Pa /etc/sysctl.conf
|
||||
is in the format of the
|
||||
.Xr sysctl 8
|
||||
command, i.e.
|
||||
command, i.e.\&
|
||||
.Bd -literal -offset indent
|
||||
sysctl_mib=value
|
||||
.Ed
|
||||
|
@ -539,7 +539,7 @@ It is a very good idea to protect internal services from external access
|
||||
by firewalling them off at your border routers. The idea here is to prevent
|
||||
saturation attacks from outside your LAN, not so much to protect internal
|
||||
services from network-based root compromise. Always configure an exclusive
|
||||
firewall, i.e.
|
||||
firewall, i.e.\&
|
||||
.So
|
||||
firewall everything *except* ports A, B, C, D, and M-Z
|
||||
.Sc .
|
||||
|
@ -193,7 +193,7 @@ case of a crash but could very easily be several seconds (even a minute!)
|
||||
behind updating the physical disk. If you crash you may lose more work
|
||||
than otherwise. Secondly, softupdates delays the freeing of filesystem
|
||||
blocks. If you have a filesystem (such as the root filesystem) which is
|
||||
close to full, doing a major update of it, e.g.
|
||||
close to full, doing a major update of it, e.g.\&
|
||||
.Em make installworld,
|
||||
can run it out of space and cause the update to fail.
|
||||
.Pp
|
||||
@ -226,7 +226,7 @@ and
|
||||
utilities may be used to create simple striped filesystems. Generally
|
||||
speaking, striping smaller partitions such as the root and /var/tmp,
|
||||
or essentially read-only partitions such as /usr is a complete waste of
|
||||
time. You should only stripe partitions that require serious I/O performance...
|
||||
time. You should only stripe partitions that require serious I/O performance,
|
||||
typically /var, /home, or custom partitions used to hold databases and web
|
||||
pages. Choosing the proper stripe size is also
|
||||
important. Filesystems tend to store meta-data on power-of-2 boundaries
|
||||
|
@ -53,7 +53,7 @@ or
|
||||
.Li char * .
|
||||
.Pp
|
||||
.Fa busname
|
||||
is the parent bus of the driver (PCI, ISA, PPBUS and others), e.g.
|
||||
is the parent bus of the driver (PCI, ISA, PPBUS and others), e.g.\&
|
||||
.Ql pci ,
|
||||
.Ql isa ,
|
||||
or
|
||||
|
@ -47,7 +47,7 @@
|
||||
Free a resource allocated by
|
||||
.Xr bus_alloc_resource 9 .
|
||||
The resource must not be in use on release, i.e. call an appropriate function
|
||||
before (e.g.
|
||||
before (e.g.\&
|
||||
.Xr bus_teardown_intr 9
|
||||
for IRQs).
|
||||
.Bl -item
|
||||
|
@ -176,7 +176,7 @@ number is currently only a 32-bit integer, but it could be enlarged if
|
||||
someone has a system with more than four billion device arrival events.
|
||||
.It device_name
|
||||
The device name is a text string given by the registering driver to
|
||||
identify itself. (e.g.
|
||||
identify itself. (e.g.\&
|
||||
.Dq da ,
|
||||
.Dq cd ,
|
||||
.Dq sa ,
|
||||
|
@ -220,7 +220,7 @@ Functions used from other parts of the kernel are prototyped in the
|
||||
relevant include file.
|
||||
.Pp
|
||||
Functions that are used locally in more than one module go into a
|
||||
separate header file, e.g.
|
||||
separate header file, e.g.\&
|
||||
.Pa extern.h .
|
||||
.Pp
|
||||
Only use the __P macro from the include file <sys/cdefs.h> if the source
|
||||
@ -242,7 +242,7 @@ void function(int fd);
|
||||
In header files visible to userland applications, prototypes that are
|
||||
visible must use either protected names or no names with the types. It
|
||||
is preferable to use protected names.
|
||||
e.g., use:
|
||||
E.g., use:
|
||||
.Bd -literal
|
||||
void function(int);
|
||||
.Ed
|
||||
|
@ -185,7 +185,7 @@ and
|
||||
.Xr close 2
|
||||
system calls.
|
||||
.Pp
|
||||
Any call which returns a vnode (e.g.
|
||||
Any call which returns a vnode (e.g.\&
|
||||
.Xr VFS_GET 9 ,
|
||||
.Xr VOP_LOOKUP 9
|
||||
etc.)
|
||||
|
@ -121,7 +121,7 @@ If the character is omitted,
|
||||
it is assumed to be
|
||||
.Em = .
|
||||
.It ""
|
||||
Numeric values are specified in C form; e.g.
|
||||
Numeric values are specified in C form; e.g.\&
|
||||
.Em 13
|
||||
is decimal,
|
||||
.Em 013
|
||||
|
@ -1175,7 +1175,7 @@ then forks a shell, using
|
||||
with the argument supplied, and reads (writes) from the stdin
|
||||
(stdout).
|
||||
If the shell command includes spaces, the argument
|
||||
must be quoted; e.g.
|
||||
must be quoted; e.g.\&
|
||||
\*(Lq" ls -lt"\*(Rq.
|
||||
A particularly
|
||||
useful example of this mechanism is: \*(Lqdir \&|more\*(Rq.
|
||||
@ -1191,7 +1191,7 @@ c.f. the
|
||||
command.
|
||||
If the
|
||||
.Nm
|
||||
command expects a single local file (e.g.
|
||||
command expects a single local file (e.g.\&
|
||||
.Ic put ) ,
|
||||
only the first filename generated by the "globbing" operation is used.
|
||||
.It
|
||||
|
@ -601,7 +601,7 @@ Arguments are of the form
|
||||
(no space before or after =) or
|
||||
.Ar option .
|
||||
Quotation marks may be placed around any part of the assignment statement to
|
||||
quote blanks or tabs, i.e.
|
||||
quote blanks or tabs, i.e.\&
|
||||
.Dq Li "set indentprefix=\*q->\*q"
|
||||
.It Ic saveignore
|
||||
.Ic Saveignore
|
||||
|
@ -452,7 +452,7 @@ variables:
|
||||
.It Va \&$
|
||||
A single dollar sign
|
||||
.Ql \&$ ,
|
||||
i.e.
|
||||
i.e.\&
|
||||
.Ql \&$$
|
||||
expands to a single dollar
|
||||
sign.
|
||||
|
@ -65,7 +65,7 @@ Note that inclusion can be suppressed by using
|
||||
.Ql \e'
|
||||
instead of
|
||||
.Ql \e. ,
|
||||
i.e.
|
||||
i.e.\&
|
||||
.Pp
|
||||
.Dl \'so /usr/lib/tmac.s
|
||||
.Pp
|
||||
|
@ -172,7 +172,7 @@ refer to
|
||||
for a full description.
|
||||
Each system has a default baud rate with which to
|
||||
establish a connection. If this value is not suitable, the baud rate
|
||||
to be used may be specified on the command line, e.g.
|
||||
to be used may be specified on the command line, e.g.\&
|
||||
.Ql "tip -300 mds" .
|
||||
.Pp
|
||||
When
|
||||
|
@ -80,7 +80,7 @@ is useful only to the super-user.
|
||||
A user may dequeue an individual job by specifying its job number.
|
||||
This number may be obtained from the
|
||||
.Xr lpq 1
|
||||
program, e.g.
|
||||
program, e.g.\&
|
||||
.Pp
|
||||
.Bd -literal -offset indent
|
||||
\&% lpq \-l
|
||||
|
@ -176,7 +176,7 @@ information are:
|
||||
.Pp
|
||||
.Bl -tag -compact -width modelxxx
|
||||
.It Ar port
|
||||
Port (device file) name, i.e.
|
||||
Port (device file) name, i.e.\&
|
||||
.Pa /dev/cuaa0 ,
|
||||
.Pa /dev/mse0
|
||||
and
|
||||
|
@ -98,7 +98,7 @@ there's no way to control the packetization of the input.
|
||||
.Sh HISTORY
|
||||
The
|
||||
.Em netgraph
|
||||
system was designed and first implemented at Whistle Communications, Inc.
|
||||
system was designed and first implemented at Whistle Communications, Inc.\&
|
||||
in a version of
|
||||
.Fx 2.2
|
||||
customized for the Whistle InterJet.
|
||||
|
@ -184,7 +184,7 @@ package (these usually ending with the
|
||||
.Dq .tgz
|
||||
suffix) or a
|
||||
URL pointing at a file available on an ftp site. Thus you may
|
||||
extract files directly from their anonymous ftp locations (e.g.
|
||||
extract files directly from their anonymous ftp locations (e.g.\&
|
||||
.Nm
|
||||
ftp://ftp.freebsd.org/pub/FreeBSD/packages/shells/bash-1.14.4.tgz).
|
||||
Note: If you wish to use
|
||||
|
@ -193,7 +193,7 @@ loading any required 3rd-party routing daemons as necessary.
|
||||
.Bl -tag -width indent
|
||||
.It router
|
||||
can be set to the name of the desired routing daemon,
|
||||
e.g.
|
||||
e.g.\&
|
||||
.Dq routed
|
||||
or
|
||||
.Dq gated ,
|
||||
@ -751,7 +751,7 @@ The netmask for the selected host interface (non-optional).
|
||||
.It _ftpPath
|
||||
The fully qualified URL of the FTP site containing the
|
||||
.Fx
|
||||
distribution you're interested in, e.g.
|
||||
distribution you're interested in, e.g.\&
|
||||
.Ar ftp://ftp.FreeBSD.org/pub/FreeBSD/ .
|
||||
.El
|
||||
.It mediaSetFTPActive
|
||||
|
@ -484,7 +484,7 @@ If the SA is not available in every level, the kernel will request
|
||||
getting SA to the key exchange daemon.
|
||||
.Li default
|
||||
means the kernel consults to the system wide default against protocol you
|
||||
specified, e.g.
|
||||
specified, e.g.\&
|
||||
.Li esp_trans_deflev
|
||||
sysctl variable, when the kernel processes the packet.
|
||||
.Li use
|
||||
|
@ -193,7 +193,7 @@ loading any required 3rd-party routing daemons as necessary.
|
||||
.Bl -tag -width indent
|
||||
.It router
|
||||
can be set to the name of the desired routing daemon,
|
||||
e.g.
|
||||
e.g.\&
|
||||
.Dq routed
|
||||
or
|
||||
.Dq gated ,
|
||||
@ -751,7 +751,7 @@ The netmask for the selected host interface (non-optional).
|
||||
.It _ftpPath
|
||||
The fully qualified URL of the FTP site containing the
|
||||
.Fx
|
||||
distribution you're interested in, e.g.
|
||||
distribution you're interested in, e.g.\&
|
||||
.Ar ftp://ftp.FreeBSD.org/pub/FreeBSD/ .
|
||||
.El
|
||||
.It mediaSetFTPActive
|
||||
|
@ -93,10 +93,10 @@ below.
|
||||
.It Ar foreground Op Ar background
|
||||
Change colors when displaying text.
|
||||
Specify the foreground color
|
||||
(e.g.
|
||||
(e.g.\&
|
||||
.Dq vidcontrol white ) ,
|
||||
or both a foreground and background colors
|
||||
(e.g.
|
||||
(e.g.\&
|
||||
.Dq vidcontrol yellow blue ) .
|
||||
Use the
|
||||
.Cm show
|
||||
|
Loading…
Reference in New Issue
Block a user