Radish alpha
H
HardenedBSD-pkg
rad:z3QDZAW2FAfuLvihrhiyDC9fAD8G9
HardenedBSD Package Manager
Radicle
Git
Commits › daff500
Add some manpage examples
Bryan Drewery committed 12 years ago
commit daff5009b5920386723bd97535a9c56ba481eaf6
parent 8cf1ad8
3 files changed +105 -7
modified pkg/pkg-query.8
@@ -15,7 +15,7 @@
.\"     @(#)pkg.8

.\" $FreeBSD$

.\"
- 
.Dd March 31, 2013
+ 
.Dd May 18, 2013

.Dt PKG-QUERY 8

.Os

.Sh NAME
@@ -291,6 +291,33 @@ See
.Xr pkg.conf 5 .

.Sh EXIT STATUS

.Ex -std
+ 
.Sh EXAMPLES
+ 
List all installed packages by name-version:
+ 
.Dl $ pkg query %n-%v
+ 
.Pp
+ 
List all dependencies for a package by origin:
+ 
.Dl $ pkg query %do subversion
+ 
.Pp
+ 
List all dependencies by package name-version:
+ 
.Dl $ pkg query %dn-%dv subversion
+ 
.Pp
+ 
List all reverse dependencies for a package:
+ 
.Dl $ pkg query %ro perl
+ 
.Pp
+ 
List all files and their known checksums for a package:
+ 
.Dl $ pkg query '%Fp %Fs' perl
+ 
.Pp
+ 
List all files for all packages:
+ 
.Dl $ pkg query '%o: %F'
+ 
.Pp
+ 
List all packages with no reverse dependencies:
+ 
.Dl $ pkg query -e '%#r = 0' %o
+ 
.Pp
+ 
List non-automatic packages:
+ 
.Dl $ pkg query -e '%a = 0' %o
+ 
.Pp
+ 
List automatic packages:
+ 
.Dl $ pkg query -e '%a = 1' %o

.Sh SEE ALSO

.Xr pkg.conf 5 ,

.Xr pkg 8 ,
modified pkg/pkg-set.8
@@ -15,7 +15,7 @@
.\"     @(#)pkg.8

.\" $FreeBSD$

.\"
- 
.Dd February 25, 2013
+ 
.Dd May 18, 2013

.Dt PKG-SET 8

.Os

.Sh NAME
@@ -91,18 +91,30 @@ This involes moving the origin from
.Sy lang/perl5.12

to

.Sy lang/perl5.14 :
- 
.Dl # pkg set -o lang/perl5.12:lang/perl5.14
+ 
.Dl % pkg set -o lang/perl5.12:lang/perl5.14
+ 
.Dl % pkg install -Rf lang/perl5.14

.Pp

Upgrade ruby from 1.8 to 1.9.

This involes moving the origin from

.Sy lang/ruby18

to

.Sy lang/ruby19 :
- 
.Dl # pkg set -o lang/ruby18:lang/ruby19
+ 
.Dl % pkg set -o lang/ruby18:lang/ruby19
+ 
.Dl % pkg install -Rf lang/ruby19

.Pp

Move the origin libglut to freeglut, and then reinstall everything depending on glut to use the new shared library:
- 
.Dl # pkg set -o graphics/libglut:graphics/freeglut
- 
.Dl # pkg install -Rf graphics/freeglut
+ 
.Dl % pkg set -o graphics/libglut:graphics/freeglut
+ 
.Dl % pkg install -Rf graphics/freeglut
+ 
.Pp
+ 
Change a package from automatic to non-automatic, which will prevent
+ 
.Ic autoremove
+ 
from removing it:
+ 
.Dl % pkg set -A 0 perl-5.14
+ 
.Pp
+ 
Change a package from non-automatic to automatic, which will make
+ 
.Ic autoremove
+ 
allow it be removed once nothing depends on it:
+ 
.Dl % pkg set -A 1 perl-5.14

.Sh SEE ALSO

.Xr pkg.conf 5 ,

.Xr pkg 8 ,
modified pkg/pkg.8
@@ -15,7 +15,7 @@
.\"     @(#)pkg.8

.\" $FreeBSD$

.\"
- 
.Dd May 16, 2013
+ 
.Dd May 18, 2013

.Dt PKG 8

.Os

.\" ---------------------------------------------------------------------------
@@ -210,6 +210,62 @@ is in
See

.Xr pkg.conf 5 .

.\" ---------------------------------------------------------------------------
+ 
.Sh EXAMPLES
+ 
Search for a package:
+ 
.Dl $ pkg search perl
+ 
.Pp
+ 
Install a package:
+ 
.Dl Installing must specify a unique origin or version otherwise it will try installing all matches.
+ 
.Pp
+ 
.Dl % pkg install perl-5.14
+ 
.Pp
+ 
List installed packages:
+ 
.Dl $ pkg info
+ 
.Pp
+ 
Upgrade from remote repository:
+ 
.Dl % pkg upgrade
+ 
.Pp
+ 
Change the origin for an installed package:
+ 
.Dl % pkg set -o lang/perl5.12:lang/perl5.14
+ 
.Dl % pkg install -Rf lang/perl5.14
+ 
.Pp
+ 
List non-automatic packages:
+ 
.Dl $ pkg query -e '%a = 0' %o
+ 
.Pp
+ 
List automatic packages:
+ 
.Dl $ pkg query -e '%a = 1' %o
+ 
.Pp
+ 
Delete an installed package:
+ 
.Dl % pkg delete perl-5.14
+ 
.Pp
+ 
Remove unneeded dependencies:
+ 
.Dl % pkg autoremove
+ 
.Pp
+ 
Change a package from automatic to non-automatic, which will prevent
+ 
.Ic autoremove
+ 
from removing it:
+ 
.Dl % pkg set -A 0 perl-5.14
+ 
.Pp
+ 
Change a package from non-automatic to automatic, which will make
+ 
.Ic autoremove
+ 
allow it be removed once nothing depends on it:
+ 
.Dl % pkg set -A 1 perl-5.14
+ 
.Pp
+ 
Create package file from an installed package:
+ 
.Dl % pkg create -o /usr/ports/packages/All perl-5.14
+ 
.Pp
+ 
Determine which package installed a file:
+ 
.Dl $ pkg which /usr/local/bin/perl
+ 
.Pp
+ 
Audit installed packages for security advisories:
+ 
.Dl $ pkg audit
+ 
.Pp
+ 
Check installed packages for checksum mismatches:
+ 
.Dl # pkg check -s -a
+ 
.Pp
+ 
Check for missing dependencies:
+ 
.Dl # pkg check -d -a
+ 
.\" ---------------------------------------------------------------------------

.Sh SEE ALSO

.Xr SBUF 9 ,

.Xr elf 3 ,
@@ -245,6 +301,9 @@ See
.Xr pkg-version 8 ,

.Xr pkg-which 8 ,

.Xr pthread 3
+ 
.Pp
+ 
To build your own package set for one or multiple servers see
+ 
.Em ports-mgmt/poudriere

.\" ---------------------------------------------------------------------------

.Sh HISTORY

The