mdoc fixes: use Sq and Dq instead of ' " and ''

This commit is contained in:
grant 2005-02-26 14:09:57 +00:00
parent a836efb32d
commit 16133f304b
5 changed files with 52 additions and 20 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: pkg_add.1,v 1.56 2005/02/04 14:58:59 wiz Exp $
.\" $NetBSD: pkg_add.1,v 1.57 2005/02/26 14:09:57 grant Exp $
.\"
.\" FreeBSD install - a package for the installation and maintenance
.\" of non-core utilities.
@ -62,7 +62,9 @@ depends on or requires from both local disk and via FTP or HTTP.
Since the
.Nm
command may execute scripts or programs contained within a package file,
your system may be susceptible to ``Trojan horses'' or other subtle
your system may be susceptible to
.Dq Trojan horses
or other subtle
attacks from miscreants who create dangerous package files.
.Pp
You are advised to verify the competence and identity of those who
@ -228,14 +230,17 @@ Use
.Ar template
as the input to
.Xr mktemp 3
when creating a ``staging area.''
when creating a
.Dq staging area .
By default, this is the string
.Pa /var/tmp/instmp.XXXXXX ,
but it may be necessary to override it in the situation where
space in your
.Pa /var/tmp
directory is limited.
Be sure to leave some number of `X' characters for
Be sure to leave some number of
.Sq X
characters for
.Xr mktemp 3
to fill in with a unique ID.
.Pp
@ -281,7 +286,9 @@ environment variable.
One or more
.Ar pkg-name
arguments may be specified, each being either a file containing the
package (these usually ending with the ``.tgz'' suffix) or a
package (these usually ending with the
.Dq .tgz
suffix) or a
URL pointing at a file available on an ftp or web site.
Thus you may extract files directly from their anonymous ftp or WWW
locations (e.g.,
@ -310,7 +317,9 @@ passive mode
ftp.
.Sh TECHNICAL DETAILS
.Nm
extracts each package's "packing list"
extracts each package's
.Dq
packing list
into a special staging directory in /var/tmp (or $PKG_TMPDIR if set)
and then runs through the following sequence to fully extract the contents
of the package:

View File

@ -1,4 +1,4 @@
.\" $NetBSD: pkg_admin.1,v 1.34 2004/12/15 17:17:51 wiz Exp $
.\" $NetBSD: pkg_admin.1,v 1.35 2005/02/26 14:09:58 grant Exp $
.\"
.\" Copyright (c) 1999-2002 Hubert Feyrer. All rights reserved.
.\"
@ -78,7 +78,9 @@ if it's set, otherwise it defaults to
Perform checks in a quiet manner.
In normal operation,
.Nm
prints a '.' to standard output to indicate progress.
prints a
.Sq \&.
to standard output to indicate progress.
This option suppresses this progress indicator.
.It Fl S
Set the shell glob pattern for package suffixes when matching package

View File

@ -1,4 +1,4 @@
.\" $NetBSD: pkg_delete.1,v 1.38 2005/02/04 15:01:41 wiz Exp $
.\" $NetBSD: pkg_delete.1,v 1.39 2005/02/26 14:09:58 grant Exp $
.\"
.\" FreeBSD install - a package for the installation and maintenance
.\" of non-core utilities.
@ -45,7 +45,9 @@ command.
Since the
.Nm
command may execute scripts or programs provided by a package file,
your system may be susceptible to ``Trojan horses'' or other subtle
your system may be susceptible to
.Dq Trojan horses
or other subtle
attacks from miscreants who create dangerous package files.
.Pp
You are advised to verify the competence and identity of those who

View File

@ -1,4 +1,4 @@
.\" $NetBSD: pkg_info.1,v 1.46 2005/02/10 22:52:31 grant Exp $
.\" $NetBSD: pkg_info.1,v 1.47 2005/02/26 14:09:58 grant Exp $
.\"
.\" FreeBSD install - a package for the installation and maintenance
.\" of non-core utilities.
@ -152,7 +152,9 @@ from the build information for each package.
An empty string is returned if no such variable definition is found for
the package(s).
.It Fl q
Be ``quiet'' in emitting report headers and such, just dump the
Be
.Dq quiet
in emitting report headers and such, just dump the
raw info (basically, assume a non-human reading).
.It Fl R
For each package, show the packages that require it.
@ -208,16 +210,27 @@ will match versions 1.3 and later of the
package.
The collating sequence of the various package version numbers is
unusual, but strives to be consistent.
The magic string ``alpha'' equates to
The magic string
.Dq alpha
equates to
.Pa alpha version
and sorts before a beta version.
The magic string ``beta'' equates to
The magic string
.Dq beta
equates to
.Pa beta version
and sorts before a release candidate.
The magic string ``rc'' equates to
The magic string
.Dq rc
equates to
.Pa release candidate
and sorts before a release.
The magic string ``pre'', short for ``pre-release'', is a synonym for ``rc''.
The magic string
.Dq pre ,
short for
.Dq pre-release ,
is a synonym for
.Dq rc .
For example,
.Pa name-1.3rc3
will sort before
@ -235,7 +248,9 @@ their numeric counterparts, so that
.Pa name-1.2e
has the same sorting value as
.Pa name-1.2.5
The magic string ``pl'' equates to a
The magic string
.Dq pl
equates to a
.Pa patch level
and has the same value as a dot in the dewey-decimal ordering schemes.
.Sh ENVIRONMENT
@ -262,7 +277,9 @@ whereas searching in the current directory uses
literally.
.It Ev PKG_TMPDIR , Ev TMPDIR
These are tried in turn (if set) as candidate directories in which
to create a ``staging area'' for any files extracted by
to create a
.Dq staging area
for any files extracted by
.Nm
from package files.
If neither

View File

@ -1,4 +1,4 @@
.\" $NetBSD: pkg_view.1,v 1.11 2004/12/15 17:17:51 wiz Exp $
.\" $NetBSD: pkg_view.1,v 1.12 2005/02/26 14:09:58 grant Exp $
.\"
.\" Copyright (c) 2003 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -62,7 +62,9 @@ directory.
Since the
.Nm
command may execute scripts or programs provided by a package file,
your system may be susceptible to ``Trojan horses'' or other subtle
your system may be susceptible to
.Dq Trojan horses
or other subtle
attacks from miscreants who create dangerous package files.
.Pp
You are advised to verify the competence and identity of those who