Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Sort options; use Fl x instead of Ar -x; use Pq/Sq.

This commit is contained in:
wiz 2003-09-08 09:11:12 +00:00
parent 76b6c930a4
commit b897232ac9
1 changed files with 60 additions and 43 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

103
usr.sbin/pkg_install/create/pkg_create.1
View File

@ -1,4 +1,4 @@
.\" $NetBSD: pkg_create.1,v 1.38 2003/09/08 08:57:56 wiz Exp $
.\" $NetBSD: pkg_create.1,v 1.39 2003/09/08 09:11:12 wiz Exp $
.\"
.\" FreeBSD install - a package for the installation and maintenance
.\" of non-core utilities.
@ -37,28 +37,22 @@
.Op Fl B Ar build-info-file
.Ek
.Bk -words
.Op Fl b Ar build-version-file
.Ek
.Bk -words
.Op Fl C Ar cpkgs
.Ek
.Bk -words
.Op Fl D Ar displayfile
.Ek
.Bk -words
.Op Fl K Ar pkg_dbdir
.Ek
.Bk -words
.Op Fl P Ar dpkgs
.Ek
.Bk -words
.Op Fl X Ar excludefile
.Ek
.Bk -words
.Op Fl b Ar build-version-file
.Op Fl I Ar realprefix
.Ek
.Bk -words
.Op Fl i Ar iscript
.Ek
.Bk -words
.Op Fl I Ar realprefix
.Op Fl K Ar pkg_dbdir
.Ek
.Bk -words
.Op Fl k Ar dscript
@ -70,24 +64,30 @@
.Op Fl m Ar mtreefile
.Ek
.Bk -words
.Op Fl n Ar preserve-file
.Ek
.Bk -words
.Op Fl P Ar dpkgs
.Ek
.Bk -words
.Op Fl p Ar prefix
.Ek
.Bk -words
.Op Fl r Ar rscript
.Ek
.Bk -words
.Op Fl s Ar size-pkg-file
.Ek
.Bk -words
.Op Fl S Ar size-all-file
.Ek
.Bk -words
.Op Fl n Ar preserve-file
.Op Fl s Ar size-pkg-file
.Ek
.Bk -words
.Op Fl t Ar template
.Ek
.Bk -words
.Op Fl X Ar excludefile
.Ek
.Bk -words
.Fl c Ar comment
.Ek
.Bk -words
@ -140,7 +140,9 @@ and is meant as a convenient shorthand for specifying multiple
.Cm @pkgcfl
directives in the packing list (see PACKING LIST DETAILS section below).
.It Fl c Ar [-]desc
Fetch package ``one line description'' from file
Fetch package
.Pq one line description
from file
.Ar desc
or, if preceded by
.Cm - ,
@ -159,7 +161,9 @@ the argument itself.
.It Fl E
Add an empty views file to the package.
.It Fl f Ar packlist
Fetch ``packing list'' for package from the file
Fetch
.Pq packing list
for package from the file
.Ar packlist
or
.Cm stdin
@ -226,9 +230,17 @@ where
is the name of the first directory named by a
.Cm @cwd
directive.
.It Fl n Ar preserve-file
The file is used to denote that the package should not be deleted.
This is intended for use where the deletion of packages may present
a bootstrap problem.
.It Fl O
Go into a `packing list Only' mode.
This is used to do `fake pkg_add' operations when a package is installed.
Go into a
.Pq packing list only
mode.
This is used to do
.Pq fake pkg_add
operations when a package is installed.
In such cases, it is necessary to know what the final, adjusted packing
list will look like.
.It Fl P Ar dpkgs
@ -246,7 +258,9 @@ directives.
.It Fl p Ar prefix
Set
.Ar prefix
as the initial directory ``base'' to start from in selecting files for
as the initial directory
.Pq base
to start from in selecting files for
the package.
.It Fl R
Re-order any directories in the pkg/PLIST file into reverse alphabetic
@ -255,26 +269,24 @@ parent directories.
.It Fl r Ar rscript
Set
.Ar rscript
to be the ``requirements'' procedure for the package.
to be the
.Pq 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.
.It Fl S Ar size-all-file
Store the given file for later querying with the
.Xr pkg_info 1
.Ar -S
.Fl S
flag.
The file is expected to contain the size (in bytes) of all files of
this package plus any required packages added up and stored as a
ASCII string, terminated by a newline.
.It Fl n Ar preserve-file
The file is used to denote that the package should not be deleted.
This is intended for use where the deletion of packages may present
a bootstrap problem.
.It Fl s Ar size-pkg-file
Store the given file for later querying with the
.Xr pkg_info 1
.Ar -s
.Fl s
flag.
The file is expected to contain the the size (in bytes) of all files of
this package added up and stored as a ASCII string, terminated by a newline.
@ -289,7 +301,9 @@ but it may be necessary to override it in the situation where
space in your
.Pa /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.
.It Fl U
@ -307,15 +321,13 @@ argument to
.Cm tar
when creating final package.
See
.Cm tar
man page (or run
.Cm tar
with
.Fl -help
flag) for further information on using this flag.
.Xr tar 1
for further information on using this flag.
.El
.Sh PACKING LIST DETAILS
The ``packing list'' format (see
The
.Pq packing list
format (see
.Fl f )
is fairly simple, being
nothing more than a single column of filenames to include in the
@ -366,13 +378,17 @@ 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
.Pq 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
.Pq filename
part of the fully qualified name, or
the converse of
.Cm \&%B ,
being in the example case,
@ -394,8 +410,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
.Pq special sequence expansion
to get at files regardless of where they've
been potentially redirected (see
.Fl p ) .
.It Cm @mode Ar mode
@ -525,12 +542,12 @@ command first appeared in
.Fx .
.Sh AUTHORS
.Bl -tag -width indent -compact
.It "Jordan Hubbard"
.It Jordan Hubbard
most of the work
.It "John Kohl"
.It John Kohl
refined it for
.Nx
.It "Hubert Feyrer"
.It Hubert Feyrer
.Nx
wildcard dependency processing, pkgdb, pkg size recording etc.
.El