mdoc(7) police: protect trailing full stops of abbreviations

with a trailing zero-width space: `e.g.\&'.
This commit is contained in:
Ruslan Ermilov 2001-08-10 13:45:36 +00:00
parent 4446bcb757
commit 57e4378bf6
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=81449
47 changed files with 55 additions and 55 deletions

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 .

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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,

View File

@ -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,

View File

@ -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 .

View File

@ -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,

View File

@ -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.

View File

@ -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 .

View File

@ -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

View File

@ -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.

View File

@ -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.

View File

@ -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,

View File

@ -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.

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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 .

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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 ,

View File

@ -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

View File

@ -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.)

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -452,7 +452,7 @@ variables:
.It Va \&$
A single dollar sign
.Ql \&$ ,
i.e.
i.e.\&
.Ql \&$$
expands to a single dollar
sign.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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