From afc28880fdddae30d2950571e85c673afb083fa0 Mon Sep 17 00:00:00 2001 From: jkh Date: Wed, 1 Sep 1999 10:04:47 +0000 Subject: Use the appropriate macro for double quotes rather than using double quotes. Submitted by: Alexey Zelkin PR: 13436 --- usr.sbin/pkg_install/add/pkg_add.1 | 16 +++++++++++----- usr.sbin/pkg_install/create/pkg_create.1 | 33 +++++++++++++++++++++++--------- usr.sbin/pkg_install/delete/pkg_delete.1 | 5 +++-- usr.sbin/pkg_install/info/pkg_info.1 | 13 +++++++++---- 4 files changed, 47 insertions(+), 20 deletions(-) diff --git a/usr.sbin/pkg_install/add/pkg_add.1 b/usr.sbin/pkg_install/add/pkg_add.1 index 887adc0..766a13c 100644 --- a/usr.sbin/pkg_install/add/pkg_add.1 +++ b/usr.sbin/pkg_install/add/pkg_add.1 @@ -36,13 +36,14 @@ command is used to extract packages that have been previously created with the .Xr pkg_create 1 command. - .Sh WARNING .Bf -emphasis 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 Em 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 @@ -123,7 +124,8 @@ 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 @@ -177,7 +179,9 @@ and the contents then acted on as normal. 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 site. Thus you may extract files directly from their anonymous ftp locations (e.g. .Nm @@ -338,7 +342,9 @@ and .Ar PRE-INSTALL is that this allows you to write a single .Ar install -script that does both ``before and after'' actions. But, separating the +script that does both +.Dq before and after +actions. But, separating the functionality is more advantageous and easier from a maintainence viewpoint. .It After installation is complete, a copy of the packing list, diff --git a/usr.sbin/pkg_install/create/pkg_create.1 b/usr.sbin/pkg_install/create/pkg_create.1 index dfcecb6..c075bf9 100644 --- a/usr.sbin/pkg_install/create/pkg_create.1 +++ b/usr.sbin/pkg_install/create/pkg_create.1 @@ -63,7 +63,9 @@ description of the input syntax is included in this document. The following command line options are supported: .Bl -tag -width indent .It Fl f Ar packinglist -Fetch ``packing list'' for package from the file +Fetch +.Dq packing list +for package from the file .Ar packinglist or .Cm stdin @@ -73,7 +75,9 @@ is a .Cm - (dash). .It Fl c Ar [-]desc -Fetch package ``one line description'' from file +Fetch package +.Dq one line description +from file .Ar desc or, if preceded by .Cm - , @@ -136,7 +140,9 @@ directives in the packing list (see PACKING LIST DETAILS section below). .It Fl p Ar prefix Set .Ar prefix -as the initial directory ``base'' to start from in selecting files for +as the initial directory +.Dq base +to start from in selecting files for the package. .It Fl k Ar dscript Set @@ -167,7 +173,9 @@ the first argument. .It Fl r Ar rscript Set .Ar rscript -to be the ``requirements'' procedure for the package. This can be any +to be the +.Dq requirements +procedure for the package. This can be any executable program (or shell script). It will be invoked automatically at installation/deinstallation time to determine whether or not installation/deinstallation should proceed. @@ -230,7 +238,9 @@ directive. .El .Pp .Sh PACKING LIST DETAILS -The ``packing list'' format (see +The +.Dq packing list +format (see .Fl f ) is fairly simple, being nothing more than a single column of filenames to include in the @@ -276,12 +286,16 @@ Expand to the current directory prefix, as set with in the example case .Pa /usr/local . .It Cm "%B" -Expand to the ``basename'' of the fully qualified filename, that +Expand to the +.Dq basename +of the fully qualified filename, that is the current directory prefix, plus the last filespec, minus the trailing filename. In the example case, that would be .Pa /usr/local/bin . .It Cm "%f" -Expand to the ``filename'' part of the fully qualified name, or +Expand to the +filename +part of the fully qualified name, or the converse of .Cm %B , being in the example case, @@ -302,8 +316,9 @@ as a result of adding the package, but not directly known to the package's table of contents (and hence not automatically removable). The advantage of using .Cm @unexec -over a deinstallation script is that you can use the ``special -sequence expansion'' to get at files regardless of where they've +over a deinstallation script is that you can use the +.Dq special sequence expansion +to get at files regardless of where they've been potentially redirected (see .Fl p ) . .It Cm @mode Ar mode diff --git a/usr.sbin/pkg_install/delete/pkg_delete.1 b/usr.sbin/pkg_install/delete/pkg_delete.1 index dc98701..94757f1 100644 --- a/usr.sbin/pkg_install/delete/pkg_delete.1 +++ b/usr.sbin/pkg_install/delete/pkg_delete.1 @@ -35,13 +35,14 @@ command is used to delete packages that have been previously installed with the .Xr pkg_add 1 command. - .Sh WARNING .Bf -emphasis 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 Em 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 diff --git a/usr.sbin/pkg_install/info/pkg_info.1 b/usr.sbin/pkg_install/info/pkg_info.1 index 8b16b8c..39dbe3d 100644 --- a/usr.sbin/pkg_install/info/pkg_info.1 +++ b/usr.sbin/pkg_install/info/pkg_info.1 @@ -36,9 +36,11 @@ The .Nm command is used to dump out information for packages, either packed up in -files or already installed on the system -with the +files with the .Xr pkg_create 1 +command or already installed on the system +with the +.Xr pkg_add 1 command. .Sh OPTIONS The following command line options are supported: @@ -54,7 +56,9 @@ Turn on verbose output. .It Fl p Show the installation prefix for each package. .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 c Show the comment (one liner) field for each package. @@ -102,7 +106,8 @@ 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 /tmp/instmp.XXXXXX , but it may be necessary to override it in the situation where -- cgit v1.1