From owner-freebsd-doc Sat Aug 28 0:21:43 1999 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.ORG [204.216.27.21]) by hub.freebsd.org (Postfix) with ESMTP id B3ED015FFE for ; Sat, 28 Aug 1999 00:21:25 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.9.3/8.9.2) id AAA27752; Sat, 28 Aug 1999 00:20:01 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: from sonet.crimea.ua (OTC-sl3-FLY.CRIS.NET [212.110.136.71]) by hub.freebsd.org (Postfix) with ESMTP id 8A08514D01 for ; Sat, 28 Aug 1999 00:10:22 -0700 (PDT) (envelope-from phantom@scorpion.crimea.ua) Received: (from uucp@localhost) by sonet.crimea.ua (8.8.8/8.8.8) with UUCP id KAA04687 for FreeBSD-gnats-submit@freebsd.org; Sat, 28 Aug 1999 10:11:46 +0400 (MSD) (envelope-from phantom@scorpion.crimea.ua) Received: (from phantom@localhost) by scorpion.crimea.ua (8.8.8/8.8.5+ssl+keepalive) id JAA01550; Sat, 28 Aug 1999 09:52:12 +0400 (MSD) Message-Id: <199908280552.JAA01550@scorpion.crimea.ua> Date: Sat, 28 Aug 1999 09:52:12 +0400 (MSD) From: "Alexey Zelkin" Reply-To: "Alexey Zelkin" To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.2 Subject: docs/13436: [PATCH] pkg_install staff manpages mdoc(7)'fy and description fix Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org >Number: 13436 >Category: docs >Synopsis: pkg_install staff mdoc(7)'fy and pkg_info.1 desc fix >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Aug 28 00:20:00 PDT 1999 >Closed-Date: >Last-Modified: >Originator: Alexey Zelkin >Release: FreeBSD 4.0-CURRENT i386 >Organization: Home >Environment: -current, last cvsuped this night >Description: - mdoc(7)'fy - I already thought that pkg_create(1) only creates packages, but pkg_info.1 said that pkg_create(1) also can install packages. Am I wrong ? >How-To-Repeat: >Fix: Index: add/pkg_add.1 =================================================================== RCS file: /usr/local/CVSROOT/src/usr.sbin/pkg_install/add/pkg_add.1,v retrieving revision 1.31 diff -c -c -r1.31 pkg_add.1 *** pkg_add.1 1999/08/15 08:47:04 1.31 --- pkg_add.1 1999/08/28 05:38:37 *************** *** 36,48 **** 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 attacks from miscreants who create dangerous package files. .Pp You are advised to verify the competence and identity of those who --- 36,49 ---- 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 ! .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,129 **** .Ar template as the input to .Xr mktemp 3 ! when creating a ``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 --- 124,131 ---- .Ar template as the input to .Xr mktemp 3 ! 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,183 **** 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 URL pointing at a file available on an ftp site. Thus you may extract files directly from their anonymous ftp locations (e.g. .Nm --- 179,187 ---- One or more .Ar pkg-name arguments may be specified, each being either a file containing the ! 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,344 **** .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 functionality is more advantageous and easier from a maintainence viewpoint. .It After installation is complete, a copy of the packing list, --- 342,350 ---- .Ar PRE-INSTALL is that this allows you to write a single .Ar install ! 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, Index: create/pkg_create.1 =================================================================== RCS file: /usr/local/CVSROOT/src/usr.sbin/pkg_install/create/pkg_create.1,v retrieving revision 1.28 diff -c -c -r1.28 pkg_create.1 *** pkg_create.1 1999/08/15 08:47:05 1.28 --- pkg_create.1 1999/08/28 05:33:57 *************** *** 63,69 **** The following command line options are supported: .Bl -tag -width indent .It Fl f Ar packinglist ! Fetch ``packing list'' for package from the file .Ar packinglist or .Cm stdin --- 63,71 ---- The following command line options are supported: .Bl -tag -width indent .It Fl f Ar packinglist ! Fetch ! .Dq packing list ! for package from the file .Ar packinglist or .Cm stdin *************** *** 73,79 **** .Cm - (dash). .It Fl c Ar [-]desc ! Fetch package ``one line description'' from file .Ar desc or, if preceded by .Cm - , --- 75,83 ---- .Cm - (dash). .It Fl c Ar [-]desc ! Fetch package ! .Dq one line description ! from file .Ar desc or, if preceded by .Cm - , *************** *** 136,142 **** .It Fl p Ar prefix Set .Ar prefix ! as the initial directory ``base'' to start from in selecting files for the package. .It Fl k Ar dscript Set --- 140,148 ---- .It Fl p Ar prefix Set .Ar prefix ! as the initial directory ! .Dq base ! to start from in selecting files for the package. .It Fl k Ar dscript Set *************** *** 167,173 **** .It Fl r Ar rscript Set .Ar rscript ! to be the ``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. --- 173,181 ---- .It Fl r Ar rscript Set .Ar rscript ! 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,236 **** .El .Pp .Sh PACKING LIST DETAILS ! The ``packing list'' format (see .Fl f ) is fairly simple, being nothing more than a single column of filenames to include in the --- 238,246 ---- .El .Pp .Sh PACKING LIST DETAILS ! 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,287 **** in the example case .Pa /usr/local . .It Cm "%B" ! Expand to the ``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 the converse of .Cm %B , being in the example case, --- 286,301 ---- in the example case .Pa /usr/local . .It Cm "%B" ! 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 the converse of .Cm %B , being in the example case, *************** *** 302,309 **** 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 been potentially redirected (see .Fl p ) . .It Cm @mode Ar mode --- 316,324 ---- 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 ! .Dq special sequence expansion ! to get at files regardless of where they've been potentially redirected (see .Fl p ) . .It Cm @mode Ar mode Index: delete/pkg_delete.1 =================================================================== RCS file: /usr/local/CVSROOT/src/usr.sbin/pkg_install/delete/pkg_delete.1,v retrieving revision 1.13 diff -c -c -r1.13 pkg_delete.1 *** pkg_delete.1 1999/08/15 08:47:06 1.13 --- pkg_delete.1 1999/08/28 05:41:46 *************** *** 35,47 **** 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 attacks from miscreants who create dangerous package files. .Pp You are advised to verify the competence and identity of those who --- 35,48 ---- 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 ! .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 Index: info/pkg_info.1 =================================================================== RCS file: /usr/local/CVSROOT/src/usr.sbin/pkg_install/info/pkg_info.1,v retrieving revision 1.20 diff -c -c -r1.20 pkg_info.1 *** pkg_info.1 1999/08/15 08:47:07 1.20 --- pkg_info.1 1999/08/28 05:35:46 *************** *** 36,44 **** The .Nm command is used to dump out information for packages, either packed up in ! files or already installed on the system ! with the .Xr pkg_create 1 command. .Sh OPTIONS The following command line options are supported: --- 36,46 ---- The .Nm command is used to dump out information for packages, either packed up in ! 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,60 **** .It Fl p Show the installation prefix for each package. .It Fl q ! Be ``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. --- 56,64 ---- .It Fl p Show the installation prefix for each package. .It Fl q ! 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,108 **** .Ar template as the input to .Xr mktemp 3 ! when creating a ``staging area.'' By default, this is the string .Pa /tmp/instmp.XXXXXX , but it may be necessary to override it in the situation where --- 106,113 ---- .Ar template as the input to .Xr mktemp 3 ! 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 >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message