4bd4310 Reworked man pages — HardenedBSD-pkg

modified pkg/pkg-add.1

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

 .\"     @(#)pkg.1
 .\" $FreeBSD$
 .\"
 .Dd April 06, 2011
 .Dd January 23, 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,14 @@ The following options are supported by

 .Nm :
 .Bl -tag -width F1
 .El
 .Sh WARNING
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-create 1 ,

@@ -62,5 +63,3 @@ The following environment 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 23, 2012
 .Dt PKG-AUTOREMOVE 1
 .Os
 .Sh NAME

@@ -35,7 +35,6 @@ The following options are supported by

 .It Fl y
 Assume yes when asked for confirmation before package autoremoval.
 .El
 .Sh WARNING
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :

@@ -50,6 +49,8 @@ the

 flag was specified.
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -66,5 +67,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 23, 2012
 .Dt PKG-BACKUP 1
 .Os
 .Sh NAME

@@ -49,13 +49,14 @@ 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 ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -72,5 +73,3 @@ The following environment 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 23, 2012
 .Os
 .Dt PKG-CREATE 1
 .\" ---------------------------------------------------------------------------

@@ -176,14 +176,8 @@ Specifies an alternative location for the installed package database.

 .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
 .Xr pkg.conf 5 .
 .El
 .\" ---------------------------------------------------------------------------
 .\" .Sh EXAMPLES
 See
 .Xr pkg.conf 5
 .\" ---------------------------------------------------------------------------
 .Sh SEE ALSO
 .Xr pkg 1 ,

@@ -201,17 +195,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 23, 2012
 .Dt PKG-DELETE 1
 .Os
 .Sh NAME

@@ -48,7 +48,6 @@ Treat the package names as regular expressions.

 .It Fl X
 Treat the package names as extended regular expressions.
 .El
 .Sh WARNING
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :

@@ -63,6 +62,8 @@ the

 flag was specified.
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -79,5 +80,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 23, 2012
 .Dt PKG-INFO 1
 .Os
 .Sh NAME

@@ -98,13 +98,14 @@ matching

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

@@ -121,6 +122,3 @@ The following environment 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 23, 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,7 +65,6 @@ Treat the package names as regular expressions.

 .It Fl X
 Treat the package names as extended regular expressions.
 .El
 .Sh WARNING
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :

@@ -76,7 +75,7 @@ When \fBPACKAGESITE\fP is defined

 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
 .Xr pkg.conf 5
 file. Please note that multiple remote repositories is still considered
 highly experimental.
 .It Ev ASSUME_ALWAYS_YES

@@ -89,17 +88,8 @@ the

 flag was specified.
 .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
 See
 .Xr pkg.conf 5
 Please refer to the included sample configuration file for example
 definitions of remote repositories.
 .El
 .Sh SEE ALSO
 .Xr pkg 1 ,

@@ -117,5 +107,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 23, 2012
 .Dt PKG-QUERY 1
 .Os
 .Sh NAME

@@ -127,13 +127,14 @@ 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 ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -150,5 +151,3 @@ The following environment 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 23, 2012
 .Dt PKG-REGISTER 1
 .Os
 .Sh NAME

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

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

@@ -79,5 +80,3 @@ The following environment 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 23, 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,14 @@ The following options are supported by

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

@@ -70,5 +71,3 @@ The following environment 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 23, 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,7 +83,6 @@ origin.

 Displays the installation prefix for each package matching
 .Ar pattern
 .El
 .Sh WARNING
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :

@@ -94,22 +93,12 @@ When \fBPACKAGESITE\fP is defined

 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
 .Xr pkg.conf 5
 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.
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -125,7 +114,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 23, 2012
 .Dt PKG-UPDATE 1
 .Os
 .Sh NAME

@@ -28,25 +28,19 @@

 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 ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :

@@ -57,23 +51,13 @@ When \fBPACKAGESITE\fP is defined

 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
 .Xr pkg.conf 5
 file. Please note that multiple remote repositories is still considered
 highly experimental.
 .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
 See
 .Xr pkg.conf 5
 Please refer to the included sample configuration file for example
 definitions of remote repositories.
 .El
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -90,5 +74,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 23, 2012
 .Dt PKG-UPGRADE 1
 .Os
 .Sh NAME

@@ -42,7 +42,6 @@ The following options are supported by

 .It Fl y
 Assume yes when asked for confirmation before package installation.
 .El
 .Sh WARNING
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :

@@ -68,17 +67,8 @@ the

 flag was specified.
 .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
 See
 .Xr pkg.conf 5
 Please refer to the included sample configuration file for example
 definitions of remote repositories.
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -95,5 +85,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 23, 2012
 .Dt PKG-VERSION 1
 .Os
 .Sh NAME

@@ -86,13 +86,14 @@ 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 ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .El
 .Sh FILES
 See
 .Xr pkg.conf 5
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -109,5 +110,3 @@ The following environment 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 23, 2012
 .Dt PKG-WHICH 1
 .Os
 .Sh NAME

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

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

@@ -56,5 +57,3 @@ The following environment 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 23, 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
 ????
 .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
 ????
 .It \fBclean\fP
 ????
 .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
 ????
 .It \fBupgrade\fP
 Upgrades a package to a newer version.
 .It \fBversion\fP

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

 Queries the database for package(s) that installed a specific
 file.
 .El
 .Sh WARNING
 .\" ---------------------------------------------------------------------------
 .Sh ENVIRONMENT
 The following environment variables affect the execution of
 .Nm :
 .Bl -tag -width ".Ev TMPDIR"
 .It Ev TMPDIR, SQLITE_FORCE_PROXY_LOCKING, PKG_DBDIR
 .Bl -tag -width ".Ev PKG_DBDIR"
 .It Ev PKG_DBDIR
 .El
 See
 .Xr pkg.conf 5
 for explanation.
 .\" ---------------------------------------------------------------------------
 .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
 .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
 See
 .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 +144,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 23, 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.

@@ -72,7 +72,10 @@ repository database. The default value for this file is

 .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.
 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 ASSUME_ALWAYS_YES(boolean)
 This option when enabled
 .Xr pkg 1

@@ -86,17 +89,17 @@ 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)
 ????
 .El
 .Sh WARNING
 .Sh ENVIRONMENT
 The following environment 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
 .Xr pkg.conf 5
 file.
 .Sh FILES
 .Sh SEE ALSO
 .Xr pkg 1 ,
 .Xr pkg-add 1 ,

@@ -111,6 +114,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