Radish alpha
H
HardenedBSD-pkg
rad:z3QDZAW2FAfuLvihrhiyDC9fAD8G9
HardenedBSD Package Manager
Radicle
Git
Commits › 16893e0
Updating pkg-upgrade(1) man page
Marin Atanasov Nikolov committed 14 years ago
commit 16893e0fb742a20cf7693987883180da2184c8cd
parent 29769b0
1 file changed +33 -3
modified pkg/pkg-upgrade.1
@@ -20,12 +20,20 @@
.Os

.Sh NAME

.Nm "pkg upgrade"
- 
.Nd < To be added >
+ 
.Nd performs upgrades of package software distributions

.Sh SYNOPSIS

.Nm

.Sh DESCRIPTION

.Nm
- 
< To be added >
+ 
is used for upgrading of package software distributions.
+ 
.Pp
+ 
Currently only one remote package repository database can be
+ 
used during package upgrades as defined by the environment variable
+ 
\fBPACKAGESITE\fP.
+ 
.Pp
+ 
Soon enough
+ 
.Nm
+ 
will be able to perform package upgrades from multiple repositories.

.Sh OPTIONS

The following options are supported by

.Nm :
@@ -35,9 +43,31 @@ The following options are supported by
.Sh ENVRIOMENT

The following envrioment variables affect the execution of

.Nm :
- 
.Bl -tag -width ".Ev TMPDIR"
+ 
.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

.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.

.Sh SEE ALSO

pkg(1), pkg-create(1), pkg-add(1), pkg-info(1), pkg-register(1), pkg-repo(1),

pkg-update(1), pkg-version(1), pkg-which(1)