Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

===================================================================
RCS file: /ftp/cvs/cvsroot/pkgsrc/pkgtools/pkg_install/files/create/pkg_create.1,v
rcsdiff: /ftp/cvs/cvsroot/pkgsrc/pkgtools/pkg_install/files/create/pkg_create.1,v: warning: Unknown phrases like `commitid ...;' are present.
retrieving revision 1.4
retrieving revision 1.5
diff -u -p -r1.4 -r1.5
--- pkgsrc/pkgtools/pkg_install/files/create/pkg_create.1	2003/09/01 16:27:12	1.4
+++ pkgsrc/pkgtools/pkg_install/files/create/pkg_create.1	2003/09/09 13:34:18	1.5
@@ -1,4 +1,4 @@
-.\" $NetBSD: pkg_create.1,v 1.4 2003/09/01 16:27:12 jlam Exp $
+.\" $NetBSD: pkg_create.1,v 1.5 2003/09/09 13:34:18 jlam Exp $
 .\"
 .\" FreeBSD install - a package for the installation and maintenance
 .\" of non-core utilities.
@@ -24,7 +24,7 @@
 .\" [jkh] Took John's changes back and made some additional extensions for
 .\" better integration with FreeBSD's new ports collection.
 .\"
-.Dd January 10, 2003
+.Dd September 2, 2003
 .Dt PKG_CREATE 1
 .Os
 .Sh NAME
@@ -37,28 +37,22 @@
 .Op Fl B Ar build-info-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
+.Op Fl b Ar build-version-file
 .Ek
 .Bk -words
-.Op Fl P Ar dpkgs
+.Op Fl C Ar cpkgs
 .Ek
 .Bk -words
-.Op Fl X Ar excludefile
+.Op Fl D Ar displayfile
 .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 p Ar prefix
+.Op Fl n Ar preserve-file
 .Ek
 .Bk -words
-.Op Fl r Ar rscript
+.Op Fl P Ar dpkgs
 .Ek
 .Bk -words
-.Op Fl s Ar size-pkg-file
+.Op Fl p Ar prefix
+.Ek
+.Bk -words
+.Op Fl r Ar rscript
 .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 f
 .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 i
 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, 
 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 n
 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