1b0efde Merge pull request #126 from toddnni/master — HardenedBSD-pkg

modified FAQ.md

@@ -15,6 +15,9 @@ Table of Contents

 * [Does `pkg repo` include symlinked packages?](#9)
 * [How do I know if I have packages with the same origin?](#10)
 * [How to start working with multi-repos in pkgng?](#11)
 * [Why `pkg create` is slow?](#12)
 * [Does pkgng work wit portaudit?](#13)
 * [When will pkgng be the default package manager?](#14)
 <a name="1"></a>
 ### Q: Is there an equivalent for pkg-orphan/pkg_cutleaves with pkgng?

@@ -48,9 +51,7 @@ New flags are: `pkg info -d` for depends on, and `pkg info -r` for reverse depen

 Currently not, but it is in the todo list.
 <a name="7"></a>
 ### Q: How pkgng deals with dependencies?
 If `pkgA-1.0` depends on `pkgB-1.0` and `pkgB-1.0` is updated to `pkgB-2.0`, will `pkgA` notice the change?
 ### Q: How pkgng deals with dependencies? If `pkgA-1.0` depends on `pkgB-1.0` and `pkgB-1.0` is updated to `pkgB-2.0`, will `pkgA` notice the change?
 Yes, `pkgA` will automatically notice the change.

@@ -71,12 +72,26 @@ The default hierarchy has lots of symlinks which should just be ignored and thus

 <a name="10"></a>
 ### Q: How do I know if I have packages with the same origin?
 Hee is how to do that:
 Here is how to do that:
     sh -c 'find . -name "*.txz" -exec pkg query -f {} %o \;' | sort | uniq -d
 <a name="11"></a>
 ### Q: How to start working with multi-repos in pkgng?
 Please refer to the [README](https://github.com/pkgng/pkgng/blob/master/README.md#multirepos), which explains
 how to enable and get started with multi-repos in pkgng.
 Please refer to the [README](https://github.com/pkgng/pkgng/blob/master/README.md#multirepos), which explains how to enable and get started with multi-repos in pkgng.
 <a name="12"></a>
 ### Q: Why `pkg create` is slow?
 The number one reason is the XZ compression, which is slow.
 <a name="13"></a>
 ### Q: Does pkgng work with portaudit?
 No, pkgng uses internal `pkg audit` command.
 <a name="14"></a>
 ### Q: When will pkgng be the default package manager of FreeBSD?
 Possibly in version 9.1.

modified pkg/pkg-add.1

@@ -15,12 +15,12 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd April 06, 2011
 .Dd January 24, 2012
 .Dt PKG-ADD 1
 .Os
 .Sh NAME
 .Nm "pkg add"
 .Nd Registeres a package and installs it on the system
 .Nd Registers a package and installs it on the system
 .Sh SYNOPSIS
 .Nm
 .Ar <pkg-name>

@@ -28,9 +28,9 @@

 .Ar <url>://<pkg-name>
 .Sh DESCRIPTION
 .Nm
 installs a package from either a local source or remote one.
 installs a package from either a local source or a remote one.
 .Pp
 When installing from remote source you need to specify
 When installing from a remote source you need to specify
 the protocol to use when fetching the package.
 .Pp
 Currently supported protocols are FTP, HTTP and HTTPS.

@@ -39,13 +39,21 @@ The following options are supported by

 .Nm :
 .Bl -tag -width F1
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It Ev ASSUME_ALWAYS_YES
 .It Ev HANDLE_RC_SCRIPTS
 .It Ev PKG_DBDIR
 .El
 .P
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-create 1 ,

@@ -62,5 +70,3 @@ The following envrioment variables affect the execution of

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-autoremove.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd July 26, 2011
 .Dd January 24, 2012
 .Dt PKG-AUTOREMOVE 1
 .Os
 .Sh NAME

@@ -35,21 +35,20 @@ The following options are supported by

 .It Fl y
 Assume yes when asked for confirmation before package autoremoval.
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev ASSUME_ALWAYS_YES"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It Ev ASSUME_ALWAYS_YES
 When this option is set to
 .Fa YES
 pkgng will automatically assume "yes" to all questions
 which require confirmation before doing anything, as if it
 the
 .Fl y
 flag was specified.
 .It Ev HANDLE_RC_SCRIPTS
 .It Ev PKG_DBDIR
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -66,5 +65,3 @@ flag was specified.

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-backup.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd July 26, 2011
 .Dd January 24, 2012
 .Dt PKG-BACKUP 1
 .Os
 .Sh NAME

@@ -49,13 +49,18 @@ in order to restore the local package database. Useful in case of a database

 crash of lost to restore your database from previously made backup.
 This option is currently not implemented.
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It PKG_DBDIR
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -72,5 +77,3 @@ The following envrioment variables affect the execution of

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-create.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd June 07, 2011
 .Dd January 24, 2012
 .Os
 .Dt PKG-CREATE 1
 .\" ---------------------------------------------------------------------------

@@ -169,21 +169,19 @@ entry but for directories.

 .\" ---------------------------------------------------------------------------
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev PKG_DBDIR"
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It Ev PKG_DBDIR
 Specifies an alternative location for the installed package database.
 .It Ev PLIST_KEYWORDS_DIR
 .It Ev PORTSDIR
 .El
 .\" ---------------------------------------------------------------------------
 .Sh FILES
 .Bl -tag -width ".Pa /etc/pkg.conf"
 .It Pa /etc/pkg.conf
 System-wide configuration file. This file format and available configuration
 options are described in
 See
 .Xr pkg.conf 5 .
 .El
 .\" ---------------------------------------------------------------------------
 .\" .Sh EXAMPLES
 .\" ---------------------------------------------------------------------------
 .Sh SEE ALSO
 .Xr pkg 1 ,

@@ -201,17 +199,3 @@ options are described in

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .\" ---------------------------------------------------------------------------
 .Sh HISTORY
 The
 .Nm
 command first appeared in
 .Fx \" TODO: Put release there
 .\" ---------------------------------------------------------------------------
 .Sh AUTHORS AND CONTRIBUTORS
 .An Baptiste Daroussin Aq bapt@FreeBSD.org
 .An Julien Laffaye Aq jlaffaye@FreeBSD.org
 .An Philippe Pepiot Aq phil@philpep.org
 .An Will Andrews Aq will@FreeBSD.org
 .\" ---------------------------------------------------------------------------
 .\" .Sh BUGS

modified pkg/pkg-delete.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd April 06, 2011
 .Dd January 24, 2012
 .Dt PKG-DELETE 1
 .Os
 .Sh NAME

@@ -48,21 +48,20 @@ Treat the package names as regular expressions.

 .It Fl X
 Treat the package names as extended regular expressions.
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev ASSUME_ALWAYS_YES"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It Ev ASSUME_ALWAYS_YES
 When this option is set to
 .Fa YES
 pkgng will automatically assume "yes" to all questions
 which require confirmation before doing anything, as if it
 the
 .Fl y
 flag was specified.
 .It Ev HANDLE_RC_SCRIPTS
 .It Ev PKG_DBDIR
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -79,5 +78,3 @@ flag was specified.

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-info.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd Aug 23, 2011
 .Dd January 24, 2012
 .Dt PKG-INFO 1
 .Os
 .Sh NAME

@@ -98,13 +98,18 @@ matching

 Displays information from the package archive
 .Ar <pkg-file>
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It PKG_DBDIR
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -121,6 +126,3 @@ The following envrioment variables affect the execution of

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5 ,
 .Xr pkg-repositories 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-install.1

@@ -15,12 +15,12 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd July 26, 2011
 .Dd January 24, 2012
 .Dt PKG-INSTALL 1
 .Os
 .Sh NAME
 .Nm "pkg install"
 .Nd install packages from remote package repositories
 .Nd installs packages from remote package repositories
 .Sh SYNOPSIS
 .Nm
 .Op Fl ygxX

@@ -65,41 +65,23 @@ Treat the package names as regular expressions.

 .It Fl X
 Treat the package names as extended regular expressions.
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev PACKAGESITE"
 .It Ev PACKAGESITE
 When \fBPACKAGESITE\fP is defined
 .Nm
 will only use the remote repository to which it points. Otherwise
 .Nm
 will work on multiple repositories as listed in the
 .Pa /etc/pkg/repositories
 file. Please note that multiple remote repositories is still considered
 highly experimental.
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It Ev ASSUME_ALWAYS_YES
 When this option is set to
 .Fa YES
 pkgng will automatically assume "yes" to all questions
 which require confirmation before doing anything, as if it
 the
 .Fl y
 flag was specified.
 .It Ev HANDLE_RC_SCRIPTS
 .It Ev PACKAGESITE
 .It Ev PKG_CACHEDIR
 .It Ev PKG_DBDIR
 .It Ev PKG_MULTIREPOS
 .El
 .Sh FILES
 .Bl -tag -width -".Pa /etc/pkg/repositories"
 .It Pa /etc/pkg/repositories
 Global repositories file. This file contains a pair of
 .Fa name = url
 entries, each describing a remote repository, from which
 .Nm
 can fetch and install packages. The file format of the file
 is the same as described in
 .Xr pkg.conf 5
 Please refer to the included sample configuration file for example
 definitions of remote repositories.
 See
 .Xr pkg.conf 5 .
 .El
 .Sh SEE ALSO
 .Xr pkg 1 ,

@@ -117,5 +99,3 @@ definitions of remote repositories.

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-query.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd Sep 15, 2011
 .Dd January 24, 2012
 .Dt PKG-QUERY 1
 .Os
 .Sh NAME

@@ -127,13 +127,18 @@ Expands to the list of groups needed by the matched package.

 .It \fB%S\fB
 Expands to the list of scripts for the matching packages - install, deinstall, etc.
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .IT PKG_DBDIR
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -150,5 +155,3 @@ The following envrioment variables affect the execution of

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-register.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd April 06, 2011
 .Dd January 24, 2012
 .Dt PKG-REGISTER 1
 .Os
 .Sh NAME

@@ -30,8 +30,7 @@

 .Fl i Ar <input-path>
 .Sh DESCRIPTION
 .Nm
 is used for registering a package into the local package
 database
 is used for registering a package into the local package database.
 .Sh OPTIONS
 The following options are supported by
 .Nm :

@@ -56,13 +55,18 @@ Specifies the package input path.

 .Pp
 < To be completed >
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It PKG_DBDIR
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -79,5 +83,3 @@ The following envrioment variables affect the execution of

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-repo.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd April 06, 2011
 .Dd January 24, 2012
 .Dt PKG-REPO 1
 .Os
 .Sh NAME

@@ -37,7 +37,7 @@ When

 is invoked it will create a package database file (repo.sqlite)
 which then can be used for remote package installations
 from
 .Xr pkg-install 1
 .Xr pkg-install 1 .
 .Pp
 When you want to create a package database repository you need to
 specify at least the directory which contains packages in

@@ -47,13 +47,18 @@ The following options are supported by

 .Nm :
 .Bl -tag -width F1
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It PUBKEY
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -70,5 +75,3 @@ The following envrioment variables affect the execution of

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-search.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd Aug 23, 2011
 .Dd January 24, 2012
 .Dt PKG-SEARCH 1
 .Os
 .Sh NAME

@@ -33,13 +33,13 @@

 .Sh DESCRIPTION
 .Nm
 is used for searching in the remote package repositories
 and displays the requested information for the matching
 and it displays the requested information for the matching
 packages.
 .Pp
 .Nm
 will search for the given pattern in the remote package
 repositories, which are defined in the
 .Fa /etc/pkg/repositories
 .Xr pkg.conf 5
 file.
 .Sh OPTIONS
 The following options are supported by

@@ -83,33 +83,19 @@ origin.

 Displays the installation prefix for each package matching
 .Ar pattern
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev PACKAGESITE"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It Ev PACKAGESITE
 When \fBPACKAGESITE\fP is defined
 .Nm
 will only use the remote repository to which it points. Otherwise
 .Nm
 will work on multiple repositories as listed in the
 .Pa /etc/pkg/repositories
 file.
 .El
 .Sh FILES
 .Bl -tag -width -".Pa /etc/pkg/repositories"
 .It Pa /etc/pkg/repositories
 Global repositories file. This file contains a pair of
 .Fa name = url
 entries, each describing a remote repository, from which
 .Nm
 will search for the specified pattern. The file format of the file is
 described in the
 .Xr pkg-repositories 5
 man page.
 .It Ev PKG_MULTIREPOS
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -125,7 +111,4 @@ man page.

 .Xr pkg-upgrade 1 ,
 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5 ,
 .Xr pkg-repositories 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS
 .Xr pkg.conf 5

modified pkg/pkg-update.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd April 06, 2011
 .Dd January 24, 2012
 .Dt PKG-UPDATE 1
 .Os
 .Sh NAME

@@ -28,52 +28,33 @@

 is used for updating from remote package repository databases.
 .Pp
 The remote repository databases to be updated are defined in the
 .Pa /etc/pkg/repositories
 .Xr pkg.conf 5
 file.
 A remote package repository definition is in the form of
 .Fa name = url
 where
 .Ar url
 points to the remote location of the package repository.
 .Pp
 It is always a good idea to update your remote package
 repositories before doing a remote install via
 .Xr pkg-install 1
 or upgrades via
 .Xr pkg-upgrade 1
 .Xr pkg-upgrade 1 .
 .Sh OPTIONS
 The following options are supported by
 .Nm :
 .Bl -tag -width F1
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev PACKAGESITE"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It Ev PACKAGESITE
 When \fBPACKAGESITE\fP is defined
 .Nm
 will only use the remote repository to which it points. Otherwise
 .Nm
 will work on multiple repositories as listed in the
 .Pa /etc/pkg/repositories
 file. Please note that multiple remote repositories is still considered
 highly experimental.
 .It Ev PKG_DBDIR
 .It Ev PKG_MULTIREPOS
 .El
 .Sh FILES
 .Bl -tag -width -".Pa /etc/pkg/repositories"
 .It Pa /etc/pkg/repositories
 Global repositories file. This file contains a pair of
 .Fa name = url
 entries, each describing a remote repository, from which
 .Nm
 will fetch. The file format of the file
 is the same as described in
 .Xr pkg.conf 5
 Please refer to the included sample configuration file for example
 definitions of remote repositories.
 .El
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -90,5 +71,3 @@ definitions of remote repositories.

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-upgrade.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd April 06, 2011
 .Dd January 24, 2012
 .Dt PKG-UPGRADE 1
 .Os
 .Sh NAME

@@ -42,43 +42,23 @@ The following options are supported by

 .It Fl y
 Assume yes when asked for confirmation before package installation.
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev PACKAGESITE"
 .It Ev PACKAGESITE
 When \fBPACKAGESITE\fP is defined
 .Nm
 will only use the remote repository to which it points. Otherwise
 .Nm
 will work on multiple repositories as listed in the
 .Pa /etc/pkg/repositories
 file. Please note that multiple remote repositories is still considered
 highly experimental. Currently multiple package repositories is not
 implemented yet in
 .Nm
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It Ev ASSUME_ALWAYS_YES
 When this option is set to
 .Fa YES
 pkgng will automatically assume "yes" to all questions
 which require confirmation before doing anything, as if it
 the
 .Fl y
 flag was specified.
 .It Ev HANDLE_RC_SCRIPTS
 .It Ev PACKAGESITE
 .It Ev PKG_CACHEDIR
 .It Ev PKG_DBDIR
 .It Ev PKG_MULTIREPOS
 .El
 .Sh FILES
 .Bl -tag -width -".Pa /etc/pkg/repositories"
 .It Pa /etc/pkg/repositories
 Global repositories file. This file contains a pair of
 .Fa name = url
 entries, each describing a remote repository, from which
 .Nm
 can fetch and upgrade packages. The file format of the file
 is the same as described in
 .Xr pkg.conf 5
 Please refer to the included sample configuration file for example
 definitions of remote repositories.
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -95,5 +75,3 @@ definitions of remote repositories.

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-version.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd April 06, 2011
 .Dd January 24, 2012
 .Dt PKG-VERSION 1
 .Os
 .Sh NAME

@@ -86,13 +86,19 @@ can also be used in `filter mode':

 When one of the arguments is `-', standard input is used, and lines
 with matching package names/patterns are echoed to standard output.
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It PKG_DBDIR
 .It PORTSDIR
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -109,5 +115,3 @@ The following envrioment variables affect the execution of

 .Xr pkg-create 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg-which.1

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd April 06, 2011
 .Dd January 24, 2012
 .Dt PKG-WHICH 1
 .Os
 .Sh NAME

@@ -33,13 +33,18 @@ The following commands are supported by

 .Nm :
 .Bl -tag -width F1
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm .
 See
 .Xr pkg.conf 5
 for further description.
 .Bl -tag -width ".Ev NO_DESCRIPTIONS"
 .It PKG_DBDIR
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5 .
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -56,5 +61,3 @@ The following envrioment variables affect the execution of

 .Xr pkg-version 1 ,
 .Xr pkg-create 1 ,
 .Xr pkg.conf 5
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS

modified pkg/pkg.1

@@ -15,23 +15,26 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd July 25, 2011
 .Dd January 24, 2012
 .Dt PKG 1
 .Os
 .\" ---------------------------------------------------------------------------
 .Sh NAME
 .Nm pkg
 .Nd a utility for manipulating packages
 .\" ---------------------------------------------------------------------------
 .Sh SYNOPSIS
 .Nm
 .Op Fl v
 .Op Fl d
 .Op Fl j Ao jail name or id Ac | Fl c Ao chroot path Ac
 .Ao command Ac Ao Ar flags Ac
 .\" ---------------------------------------------------------------------------
 .Sh DESCRIPTION
 provides an interface for manupulating packages - registering,
 adding, removing and upgrading of packages.
 .\" ---------------------------------------------------------------------------
 .Sh OPTIONS
 .Pp
 The following options are supported by
 .Nm:
 .Bl -tag -width indent

@@ -51,6 +54,7 @@ will chroot in the

 .Ao chroot path Ac
 Environment
 .El
 .\" ---------------------------------------------------------------------------
 .Sh COMMANDS
 The following commands are supported by
 .Nm :

@@ -58,36 +62,51 @@ The following commands are supported by

 .It \fBhelp\fP Ar <command>
 Displays usage information of the specified command.
 .It \fBadd\fP
 Install a package from either a local source or a remote one.
 Installs a package from either a local source or a remote one.
 .Pp
 When installing from remote source you need to specify the
 protocol to use when fetching the package.
 .Pp
 Currently supported protocols are FTP, HTTP and HTTPS.
 .It \fBaudit\fP
 < To be added >
 .It \fBautoremove\fP
 Deletes packages not depended on by anyother packages and that were
 automatically installed.
 .It \fBinstall\fP
 Installs a package from a remote package repository.
 If a package is found in more than one remote repositories,
 then installation happens from the first one. If a package
 fails to fetch from the remote repository the next one in
 the list is tried, until the package is fetched.
 .It \fBbackup\fP
 Dumps the local package database to a file specified on the command-line.
 .It \fBcheck\fP
 < To be added >
 .It \fBclean\fP
 < To be added >
 .It \fBcreate\fP
 Creates a package
 .It \fBdelete\fP
 Deletes a package from the database and the system.
 .It \fBinfo\fP
 Displays information about installed packages.
 .It \fBinstall\fP
 Installs a package from a remote package repository.
 If a package is found in more than one remote repositories,
 then installation happens from the first one. If a package
 fails to fetch from the remote repository the next one in
 the list is tried, until the package is fetched.
 .It \fBquery\fP
 Is used for displaying information about packages.
 .It \fBregister\fP
 Registers a package in the database.
 .It \fBrepo\fP
 Creates a package repository.
 .Pp
 < To be completed >
 .It \fBsearch\fP
 Will search for the given pattern in the remote package
 repositories.
 .It \fBupdate\fP
 Update the available remote repositories as listed in
 .Pa /etc/pkg/repositories
 .Xr pkg.conf 5 .
 .It \fBupdating\fP
 < To be added >
 .It \fBupgrade\fP
 Upgrades a package to a newer version.
 .It \fBversion\fP

@@ -96,32 +115,17 @@ Upgrades a package to a newer version.

 Queries the database for package(s) that installed a specific
 file.
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .It Ev TMPDIR, SQLITE_FORCE_PROXY_LOCKING, PKG_DBDIR
 .El
 .\" ---------------------------------------------------------------------------
 .Sh ENVIRONMENT
 The list of environment variables that affect the execution of
 .Nm
 is in
 .Xr pkg.conf 5 .
 .\" ---------------------------------------------------------------------------
 .Sh FILES
 .Bl -tag -width ".Pa /etc/pkg.conf"
 .It Pa /etc/pkg.conf
 System-wide configuration file. This file format and available configuration
 options are described in
 See
 .Xr pkg.conf 5 .
 .El
 .Bl -tag -width ".Pa /etc/pkg/repositories"
 .It Pa /etc/pkg/repositories
 Global repositories file. This file contains a pair of
 .Fa name = url
 entries, each describing a remote repository, from which
 .Nm
 can fetch and install packages. The file format of the file
 is the same as described in
 .Xr pkg.conf 5
 Please refer to the included sample configuration file for example
 definitions of remote repositories.
 .El
 .\" ---------------------------------------------------------------------------
 .Sh SEE ALSO
 .Xr pkg-autoremove 1 ,
 .Xr pkg-search 1 ,

@@ -136,5 +140,19 @@ definitions of remote repositories.

 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Xr pkg.conf 5
 .\" ---------------------------------------------------------------------------
 .Sh HISTORY
 The
 .Nm
 command first appeared in
 .Fx \" TODO: Put release there
 .\" ---------------------------------------------------------------------------
 .Sh AUTHORS AND CONTRIBUTORS
 .An Baptiste Daroussin Aq bapt@FreeBSD.org
 .An Julien Laffaye Aq jlaffaye@FreeBSD.org
 .An Philippe Pepiot Aq phil@philpep.org
 .An Will Andrews Aq will@FreeBSD.org
 .An Marin Atanasov Nikolov Aq dnaeon@gmail.com
 .\" ---------------------------------------------------------------------------
 .Sh BUGS
 There might be some left.

modified pkg/pkg.conf.5

@@ -15,7 +15,7 @@

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd Dec 10, 2011
 .Dd January 24, 2012
 .Dt PKG.CONF 5
 .Os
 .Sh NAME

@@ -29,7 +29,7 @@ is the system-wide configuration file used by the

 tools.
 .Pp
 The default location of this file is
 .Fa /etc/pkg.conf
 .Fa /usr/local/etc/pkg.conf
 .Pp
 Lines in the file beginning with a "#" are comments
 and are ignored.

@@ -49,54 +49,52 @@ and

 .Sh OPTIONS
 The following options can be defined in
 .Nm :
 .Bl -tag -width F1
 .It Cm PACKAGESITE(string)
 Specifies the remote location to use
 when fetching the database file and packages.
 .It Cm PKG_DBDIR(string)
 Specifies the directory to use for storing the package
 database files. The default value for this option is
 .Fa /var/db/pkg
 .It Cm PKG_CACHEDIR(string)
 Specifies the cache directory for packages. The default value
 for this option is
 .Fa /var/cache/pkg
 .It Cm PORTSDIR(string)
 Specifies the location to the Ports directory. The default value
 for this option is
 .Fa /usr/ports
 .It Cm PUBKEY(string)
 Specifies the location to the public RSA key used for signing the
 repository database. The default value for this file is
 .Fa /etc/ssl/pkg.conf
 .It Cm HANDLE_RC_SCRIPTS(boolean)
 This option when enabled
 will automatically perform start/stop of services during package
 installation and deinstallation. By default this option is disabled.
 .Bl -tag -width ".Cm ASSUME_ALWAYS_YES(boolean)"
 .It Cm ASSUME_ALWAYS_YES(boolean)
 This option when enabled
 When this option is enabled
 .Xr pkg 1
 will automatically assume "yes" to all questions
 which require user confirmation before doing anything, as if it
 the
 .Fl y
 flag was specified. By default this option is disabled.
 .It Cm PUBKEY(string)
 Specifies the location to the public RSA key used for signing the
 repository database. The default value for this file is
 .Fa /etc/ssl/pkg.conf
 .It Cm HANDLE_RC_SCRIPTS(boolean)
 This option when enabled
 will automatically perform start/stop of services during package
 installation and deinstallation. Services are started on installation only
 if they are enabled in
 .Fa /etc/rc.conf .
 By default this option is disabled.
 .It Cm PACKAGESITE(string)
 Specifies the remote location to use
 when fetching the database file and packages.
 .It Cm PKG_CACHEDIR(string)
 Specifies the cache directory for packages. The default value
 for this option is
 .Fa /var/cache/pkg
 .It Cm PKG_DBDIR(string)
 Specifies the directory to use for storing the package
 database files. The default value for this option is
 .Fa /var/db/pkg
 .It Cm PKG_MULTIREPOS(boolean)
 This option when enabled will tell
 .Xr pkg 1
 to work in mutliple repositories mode. For example repositories
 definitions, please have a look at the sample configuration file.
 .It Cm PLIST_KEYWORS_DIR(string)
 < To be added >
 .It Cm PORTSDIR(string)
 Specifies the location to the Ports directory. The default value
 for this option is
 .Fa /usr/ports
 .El
 .Sh WARNING
 .Sh ENVRIOMENT
 The following envrioment variables affect the execution of
 .Xr pkg 1
 .Pp
 An environment variable with the name of the configuration file
 always overrides the value of an option set in
 .Fa /etc/pkg.conf
 file.
 .Sh FILES
 .Sh ENVIRONMENT
 An environment variable with the same name as the option in the configuration
 file always overrides the value of an option set in the file.
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -111,6 +109,4 @@ file.

 .Xr pkg-update 1 ,
 .Xr pkg-upgrade 1 ,
 .Xr pkg-version 1 ,
 .Xr pkg-which 1 ,
 .Sh AUTHORS AND CONTRIBUTORS
 .Sh BUGS
 .Xr pkg-which 1