Radish alpha
H
HardenedBSD Package Manager
Radicle
Git (anonymous pull)
Log in to clone via SSH
Clean up some grammar and formatting in pkg.conf(5).
Brad Davis committed 10 years ago
commit 74199f0309968671c8bbc1190065377226b573eb
parent 8dbe75a2d5e443cf5b3d74e43bd3f981094464fc
1 file changed +19 -14
modified docs/pkg.conf.5
@@ -15,7 +15,7 @@
.\"     @(#)pkg.1
.\" $FreeBSD$
.\"
-
.Dd February 8, 2015
+
.Dd June 19, 2015
.Dt PKG.CONF 5
.Os
.Sh NAME
@@ -157,11 +157,12 @@ Default: INDEX-N where
is the OS major version number.
.It Cm IP_VERSION: integer
Restrict network access to specified IP version.
-
Could be 4 for IPv4, 6 for IPv6 or any other value for system default.
-
Repositories or command line options could override this setting.
+
4 will only allow IPv4 and 6 will only allow IPv6.
+
Any other value will use the system default.
+
Repositories or command line options can override this setting.
Default: 0.
.It Cm LOCK_RETRIES: integer
-
Retries performed to obtain a lock.
+
Number of attempts to obtain a lock before giving up and exiting.
Default: 5.
.It Cm LOCK_WAIT: integer
Wait time in seconds to regain a lock if it is not available.
@@ -187,7 +188,7 @@ Default:
When set to a
.Sy true
value, make
-
.Xr pkg_create 8
+
.Xr pkg-create 8
use verbose mode as standard.
Default:
.Sy false
@@ -265,7 +266,7 @@ Default: YES.
Run pre-/post-installation action scripts.
Default: YES.
.It Cm SAT_SOLVER: string
-
Experimental: tells pkg to use and external SAT solver.
+
Experimental: tells pkg to use an external SAT solver.
Default: not set.
.It Cm SQLITE_PROFILE: boolean
Profile SQLite queries.
@@ -274,7 +275,7 @@ Default: NO.
Directory which the ssh subsystem will be restricted to.
Default: not set.
.It Cm SYSLOG: boolean
-
Log all the installation/deinstallation/upgrade operation via
+
Log all of the installation/deinstallation/upgrade operations via
.Xr syslog 3 .
Default: YES.
.It Cm UNSET_TIMESTAMP: boolean
@@ -360,13 +361,14 @@ only. (default: NONE)
This should be set to a path containing known signatures for the repository.
.It Cm IP_VERSION: integer
Restrict network access to specified IP version.
-
Could be 4 for IPv4, 6 for IPv6 or any other value for system default.
+
4 will only allow IPv4 and 6 will only allow IPv6.
+
Any other value will use the system default.
This option overrides the global setting with the same name and can be
overwritten by a command line option.
Default: 0.
.It Cm PRIORITY: integer
Set the priority of the repository.
-
Higher values are prefered.
+
Higher values are preferred.
Default: 0
.El
.El
@@ -395,9 +397,9 @@ you should use a
or
.Dv pkg+https://
(etc.) URL scheme.
-
Using
+
Using an
.Dv http://
-
URLS implies that the hostname part is a simple hostname according to
+
URL implies that the hostname part is a simple hostname according to
RFC 2616, and is no longer accepted.
.Pp
When
@@ -459,7 +461,7 @@ with this content:
FreeBSD: { enabled: NO }
.Ed
.Pp
-
Repositories are processedin the order they are found on the
+
Repositories are processed in the order they are found on the
.Sy REPOS_DIR
search path, with individual repository configuration files in the
same directory processed in alphabetical order.
@@ -496,7 +498,8 @@ FreeBSD: {
    mirror_type: "srv"
}
.Ed
-
Example for pkg.conf
+
.Pp
+
Example for pkg.conf:
.Bd -literal -offset indent
pkg_dbdir: "/var/db/pkg"
pkg_cachedir: "/var/cache/pkg"
@@ -518,13 +521,14 @@ alias: {
    nonauto: "query -e '%a == 0' '%n-%v'"
}
.Ed
+
.Pp
To bootstrap
.Xr pkg 8
using a private repository (Assuming a
.Xr pkg 7
new enough to support the
.Cm bootstrap
-
command.)
+
command.):
.Bd -literal -offset indent
# cat > /usr/local/etc/pkg/repos/example.conf <<EOF
example: {
@@ -539,6 +543,7 @@ EOF
# env PACKAGESITE='http://pkgrepo.example.com/${ABI}' \
    /usr/sbin/pkg bootstrap
.Ed
+
.Pp
Note that
.Xr pkg 7
uses