Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 28 Aug 1999 09:52:12 +0400 (MSD)
From:      "Alexey Zelkin" <phantom@cris.net>
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/13436: [PATCH] pkg_install staff manpages mdoc(7)'fy and description fix
Message-ID:  <199908280552.JAA01550@scorpion.crimea.ua>

next in thread | raw e-mail | index | archive | help

>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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199908280552.JAA01550>