prt-get/doc/prt-get.8

.\" man page for prt-get
.\" original work by Johannes Winkelmann, jw at tks6 dot net
.\" 
.\" extended in 2013 by Alan Mizrahi, alan at mizrahi dot com dot ve
.\" and in 2023 by John McQuah, jmcquah at disroot dot org
.\" 
.\" .PU
.TH "prt-get" "8" "" "" ""
.SH "NAME"
.LP 
prt\-get \- an advanced package management tool to be used with
pkgutils from CRUX (see http://www.crux.nu)
.SH "SYNOPSIS"
.B prt\-get command [options] <arguments>
.br 
.SH "DESCRIPTION"
prt-get is a package management tool which provides additional
functionality to the CRUX package management system. It works with the
local ports tree and is therefore fully compatible with ports(8) and
pkgmk(8)/pkgadd(8)/pkgrm(8). It offers the following features:

.PP
.TP 
\ \ \ \(bu
abstract ports installation/update from file system

.TP 
\ \ \ \(bu
install/update a list of packages with one command

.TP 
\ \ \ \(bu
list dependencies for a list of packages

.TP 
\ \ \ \(bu
show information about ports

.TP 
\ \ \ \(bu
search within the ports

.PP 

What prt-get basically does is build, install/upgrade, and remove packages, 
using pkgmk, pkgadd, and pkgrm. Additionally, you don't have be in the port's
directory to call prt-get. prt-get will search for the respective port
itself in a list of directories specified in /etc/prt-get.conf. This
allows you to just install or update a package, without caring where
it actually is located on your file system.

.PP 

prt-get also lets you search for ports by name,
find information about ports (without installing them of course),
or print the dependencies of a port (as a space- or newline-separated list, 
or a formatted tree). Note that dependencies are no
requirement for crux packages and therefore not always accurate.

.PP 

prt-get has a test mode so you can see what effect an install/update
operation would have. Use the --test switch for this (more details in
the \fBOPTIONS\fP section below).

.SH "RETURN VALUE"
prt-get returns 0 on success and a non-zero value otherwise (exact
value -> meaning mapping to be determined...)

.SH "COMMANDS"
prt-get uses so-called commands, which always have to be the first 
non-option argument passed. This is very similar to
.B cvs(1).
[command] can be one of the following:


.TP 
.B install [\-\-margs] [\-\-aargs] [\-\-log] [\-\-nodeps] [\-\-softdeps] <package1> [<package2> ...]
Install or update the packages given on the command line. Note that you can do 
this from any directory. Pass the --nodeps flag to prevent \fBprt\-get\fP from
resolving dependencies and injecting any needed packages into the list of targets.
Pass the --softdeps flag if you want the dependency resolver to also consider
the "Optional" relationships among the packages given on the command line.

.TP 
.B depinst [\-\-margs] [\-\-aargs] [\-\-log] [\-\-softdeps] <package1> [<package2> ...]
Basically a synonym for install (without the --nodeps flag).

.TP 
.B update [\-\-margs] [\-\-aargs]  [\-\-log] [\-\-softdeps] <package1> [<package2> ...]
Basically a synonym for install. Earlier versions of \fBprt\-get\fP did not 
adjust the \fBpkgadd(8)\fP arguments on a package-by-package basis, but
applied "install mode" or "update mode" to the entire transaction. This 
version of \fBprt\-get\fP interprets the install command less rigidly, and tries 
to sync all affected ports with their repository versions unless instructed 
otherwise (using \fBprt\-get lock\fP, the --prefer-higher option, or the 
prt-get.aliases file).

.TP 
.B remove <package1> [<package2> ...]
Remove packages listed in this order

.TP 
.B sysup [\-\-softdeps] [\-\-nodeps] [\-\-prefer\-higher] [\-\-strict\-diff]
Update all installed packages which are outdated. Sorts by hard dependencies
by default. Passing the --softdeps switch tells \fBprt\-get\fP to also consider
optional dependencies when sorting. Passing the --nodeps switch tells prt-get 
not to sort by dependencies at all.

.B Note:
If a port has acquired new dependencies since its last successful build,
those new dependencies \fIwill\fP be injected into the transaction. An elegant
description of this new behaviour is "prt-get no more silently assumes that
the user didn't want a particular dependency" [1]. You can still disable the
automatic dependency injection by passing the --nodeps switch. Other
ways to fine-tune the selection of ports that are included in a \fBsysup\fP are the
commands \fBlock\fP and \fBunlock\fP, the prt-get.aliases file, and the
mutually exclusive switches --prefer-higher, --strict-diff (documented below).

[1] https://lists.crux.nu/pipermail/crux/2008-June/001784.html

.TP 
.B lock <package1> [<package2>...]
Exclude these packages from being updated in a
.B sysup
operation.

.TP 
.B unlock <package1> [<package2>...] 
Remove lock from these packages

.TP 
.B listlocked [\-v|\-vv]
List names of packages which are locked. As always,
.B \-v
will additionally show the version, and
.B \-vv
also includes the description from the Pkgfile. Note that the
.B \-vv
switch will slow down the operation remarkably.

.TP 
.B diff [\-\-all] [\-\-prefer\-higher] [<package1> <package2> ...]
Show differences between installed packages and ports in the ports
tree. Package names passed as argument will truncate the output to 
show only those packages. It's also possible to use shell-like
.B wildcards
for the diff command. Make sure you escape where needed. Locked
packages are only displayed if you use the --all switch. If you want
to see only diffs which have a lower version installed than the one in
the ports tree, use the --prefer-higher option.

.TP 
.B quickdiff [\-\-prefer\-higher]
Print a simple list of packages which have a different version in the
ports tree than what is installed. The output is sorted alphabetically, 
but you can generate a (larger) list sorted by dependencies using
.B prt\-get quickdep $(prt\-get quickdiff).

If you want to see only diffs which have a lower version installed than
the one in the ports tree, use the --prefer-higher option.

.TP 
.B search [\-v|\-vv] [\-\-path] [\-\-regex] <expr>
Search the ports tree for
.B expr
in their name

.TP 
.B dsearch [\-v|\-vv] [\-\-path]  [\-\-regex] <expr>
Search the ports tree (both name and description) for the pattern
.B expr
(which can be a shell-like wildcard pattern or a regexp). The search in
the description is not case sensitive. Note that this requires prt-get
to read every Pkgfile, which makes it rather slow; if you like searching
by description, consider using the cache functionality, so you only have to 
read every Pkgfile when the ports tree is updated.

.TP 
.B fsearch [\-\-full] [\-\-regex] <pattern>
Search the ports tree for
.B pattern
as file name in their footprint. When called without '--full', strips
the directories from the file names before matching. Pattern can be a 
shell-like wildcard pattern (e.g. prt-get fsearch "*.h") or a regular
expression (e.g. prt-get fsearch --regex 'liblz(o2|ma).*')

.TP 
.B info <port>
Print available info for a port 

.TP 
.B path <port>
Print the path of a port

.TP 
.B readme <port>
Print the port's README file if it exists; if set, uses $PAGER

.TP 
.B depends [\-\-softdeps] <package1> [<package2> ...]
Print a recursive list of dependencies needed to install the packages passed
as argument. It shows a list of the dependencies that were found in the 
ports tree, plus a list of the dependencies that could not be found. Pass 
the --softdeps flag if you want the sorting algorithm to consider 
optional dependencies too.

.TP 
.B quickdep [\-\-softdeps] <package1> [<package2> ...]
Same output as \fBdepends\fP, but separated by spaces rather than newlines, and
stripped of any dependencies that could not be found in the ports tree.
Useful in case the list of dependencies is too large to fit on one screen, or
if you don't want to filter out manually the ports that are invalid targets for
installation. For example, instead of
.B prt\-get depinst xorg-server
you might micromanage the process as follows:
.B for i in $(prt\-get quickdep xorg-server); do prt\-get install \-fr \-\-nodeps $i; done
which ensures that the latest version of each dependency is built.

Note: It might be useful to run
.B prt\-get depends <package1> | grep \(dq\-\- missing packages\(dq
as a first step, in order to ensure that your ports tree has everything needed 
for successful builds.

.TP 
.B deptree [\-\-softdeps] <package>
Print a tree of the dependencies of the package
.B <package>. 
Pass the --softdeps flag to also show the installed packages that might have been
eagerly linked when
.B <package>
or its dependencies were compiled.
Subtrees already shown are marked with '-->' to save some space. In
order to show them all, add the --all switch.

.SH ""

.TP 
.B dependent [\-\-recursive] [\-\-softdeps] [\-\-all] <package>
Print a list of ports whose "Depends on:" line contains
.B <package>
(or its dependents, if --recursive is passed). Use the --softdeps flag to also
search the "Optional:" lines for \fB<package>\fP .
 
By default, output is restricted to ports that are installed. To see all the 
dependencies, add the --all switch. Use --tree to get a nicely indented list.

.TP 
.B dup [\-v] [format]
List ports which can be found in multiple directories configured in
\fB/etc/prt\-get.conf\fP.
Use the \fB\-v\fP switch to see a verbose report, which will show for each
dup the port that takes precedence, and the port that is hidden (including
full path and version info). The verbose switch is basically an alias for a
particular combination of the recognized format symbols, namely

.B '* %n\en   %p1 %v1 precedes over\en  %p2 %v2\en'.

You can customize the output by passing a different format string, whose 
symbols will be replaced as follows.

.TP 
\ \ \ \(bu
%n -> name of the port

.TP 
\ \ \ \(bu
%p1 -> full path (including name) to port taking precedence

.TP 
\ \ \ \(bu
%p2 -> full path (including name) to port being hidden

.TP 
\ \ \ \(bu
%v1 -> version of port taking precedence

.TP
\ \ \ \(bu
%v2 -> version of port being hidden

.TP 
\ \ \ \(bu
%M1 -> maintainer of port taking precedence

.TP
\ \ \ \(bu
%M2 -> maintainer of port being hidden

.TP 
\ \ \ \(bu
%u1 -> URL of port taking precedence

.TP
\ \ \ \(bu
%u2 -> URL of port being hidden

.TP 
.B list [\-v|\-vv] [\-\-path] [\-\-regex] [filter]
List ports available in the ports tree. It's basically the same as
.B ports \-l
but looks in all directories specified in
.B /etc/prt\-get.conf.
It's also possible to use shell-like
.B wildcards
for the list command. Make sure you escape where needed

.TP 
.B printf <format string1> [\-\-sort=<format string2>] [\-\-filter=<filter>]
Print formatted port list. Format string can contain variables, which
are replaced like this:
.TP 
\ \ \ \(bu
%n -> name

.TP 
\ \ \ \(bu
%p -> path

.TP
\ \ \ \(bu
%v -> version

.TP 
\ \ \ \(bu
%r -> release

.TP 
\ \ \ \(bu
%d -> description

.TP 
\ \ \ \(bu
%e -> dependencies

.TP 
\ \ \ \(bu
%P -> optional dependencies

.TP 
\ \ \ \(bu
%u -> URL

.TP 
\ \ \ \(bu
%M -> maintainer

.TP 
\ \ \ \(bu
%R -> readme ("yes"/"no")

.TP 
\ \ \ \(bu
%E -> pre-install script ("yes"/"no")

.TP 
\ \ \ \(bu
%O -> post-install script ("yes"/"no")

.TP 
\ \ \ \(bu
%l -> is locked ("yes"/"no")

.TP 
\ \ \ \(bu
%i -> "no" if not installed, "yes" if it's installed and
up to date and "diff" if it's installed and a new version is in the
ports tree.

Use "\en" and "\et" to format your output (no additional format codes
supported). The optional format string2 can contain the same variables
as format string1 and is used to sort the output. You can specify a
.B wildcard filter
to filter by package name.


.TP 
.B listinst [\-v|\-vv] [\-\-regex] [\-\-depsort] [filter]
List installed ports. It's basically the same as
.B pkginfo \-i,
but omits version when called without verbose (-v, -vv) switch. Plus
it is notably faster in my tests. -v adds version information, -vv
adds version and description.
.B Warning:
-vv will slow down the process because it requires prt-get to scan
both the ports database and the ports tree.
It's also possible to use shell-like
.B wildcards
for the listinst command. Make sure you escape where needed. By default
it's sorted alphabetically; use the --depsort switch to sort by
dependencies.

.TP 
.B listorphans [\-v|\-vv|\-\-softdeps]
List installed ports which do not appear in the "Depends on:" line of
any other port currently installed. Pass the --softdeps flag to also exclude 
ports that are listed as optional dependencies of currently-installed ports.
Output appears alphabetically separated by newlines, making it suitable for 
process substitution as shown in the
.B EXAMPLES
section below. Note that some core ports might be runtime
dependencies despite their absence in the "Depends on:" line; 
see \fBPkgfile(5)\fP for an explanation of this practice. 

.TP 
.B isinst <package1> [<package2> ...]
Check whether each package given on the command line is installed. Output in 
the case of multiple arguments is separated by newlines, suitable for 
processing by awk or grep. Similar to
.B pkginfo \-i|grep \-E '^(package1|package2|...)'
but does not print the version information. This command has a return value of 
0 if all packages given as argument are installed, otherwise a return value 
greater than 0.

.TP
.B current <package1> [<package2> ...]
Shows the currently-installed version of <package>, or a message
that <package> is not installed.

.TP
.B ls [\-\-path] <package>
Print out a listing of the port's directory

.TP
.B cat <package> [<file>]
Print to stdout (or $PAGER, if set) the contents of <file> in the port's
directory. If <file> is not specified, 'Pkgfile' is used.

.TP
.B edit <package> [<file>]
Edit the file using the editor specified in the $EDITOR environment variable.
If <file> is not specified, 'Pkgfile' is used.

.TP 
.B help
Show a help screen

.TP 
.B dumpconfig
Dump the configuration to the current terminal 

.TP 
.B version 
Show the current version of prt-get

.TP 
.B cache
Create a cache file from the ports tree to be used by prt-get using the
--cache option. Remember to run prt-get cache each time you update the
ports tree.

.SH "OPTIONS"

The following options are primarily useful for install/update transactions.

.TP
.B \-g, \-\-group
Stop install or update operation if one package fails (patch by Alan Mizrahi)

.TP
.B \-f, \-fi
Force install; Implies 'pkgadd -f'; same as --aargs=-f

.TP
.B \-fr
Force rebuild, Implies 'pkgmk -f'; same as --margs=-f

.TP
.B \-us
Update signature, implies 'pkgmk -us'; same as --margs=-us

.TP
.B \-is
Ignore signature, implies 'pkgmk -is'; same as --margs=-is

.TP
.B \-uf
Update footprint, implies 'pkgmk -uf'; same as --margs=-uf

.TP
.B \-if
Ignore footprint, implies 'pkgmk -if'; same as --margs=-if

.TP
.B \-ns
No stripping, implies 'pkgmk -ns'; same as --margs=-ns

.TP
.B \-kw
Keep working directory, implies 'pkgmk -kw'; same as --margs=-kw

.TP 
.B \-\-margs="...", e.g. \-\-margs="\-im"
additional arguments to be passed to pkgmk;
note that \-d is already passed to pkgmk anyway

.TP 
.B \-\-aargs="...", e.g. \-\-aargs="\-f"
additional arguments to be passed to pkgadd

.TP 
.B \-\-rargs="..."
arguments to be passed to pkgrm; currently not used, implemented for
future uses and consistency reasons

.TP
.B \-\-ignore=<package1,package2,...>
Don't install these packages, even if they're listed as dependencies

.TP
.B \-\-nodeps
Leave the list of requested packages as-is, without sorting by dependencies
or injecting missing dependencies.

.TP
.B \-\-softdeps
Consider optional dependencies when determining the order in which to build
the packages passed as arguments (in \fBinstall\fP or \fBsysup\fP operations).
Also affects the output of \fBdeptree\fP, \fBdependent\fP, and \fBlistorphans\fP.

.TP 
.B \-\-cache
Use cache file for this command

.TP 
.B \-\-test
Dry run, don't actually install anything. Mostly interesting for
.B prt\-get install, prt\-get update, prt\-get sysup

.TP 
.B \-\-pre\-install
Execute pre-install script if it's there

.TP 
.B \-\-post\-install
Execute post-install script if it's there

.TP 
.B \-\-install\-scripts
Execute pre-install and post-install script if they're there.

The options --pre-install, --post-install, and --install-scripts offer a
convenient way to temporarily override the prt-get.conf directive 'runscripts
no', which was the historical default. Starting with CRUX 3.7, prt-get.conf is
being shipped with 'runscripts yes'. To override this default at the command
line, you have to pass the more cumbersome option --config-set=\(dqrunscripts
no\(dq, or point prt-get to an alternative configuration file using
--config=<file>. (see below for the documentation of these options)

.TP
.B \-\-install\-root=<dir>
Use <dir> as root directory for your installation; allows you to install 
the requested packages onto a different directory than '/'. In daily usage, 
this option is not required; it's primarily interesting if you're developing 
an independent installation.

Pre- and post-install scripts will not be executed if the requested 
root directory lacks a copy of the ports tree. So if you're maintaining an
installation mounted somewhere different than '/', it's not enough to put
the line 'runscripts yes' in your prt-get.conf; you also have to ensure that the
pre- and post-install scripts can be found in the same location relative to <dir>.

The setting for --install-root determines which package database is used for 
reading/writing (so <dir>/var/lib/pkg/db must exist), and where the pkg.tar.?z 
archives get unpacked, but the relevant prt-get.conf and ports tree are those 
on the parent filesystem. Therefore it is not necessary for <dir> to contain 
its own copy of the ports tree (unless 'runscripts yes' is desired, as
explained above). But each \fBpkgmk(8)\fP process will take place on the parent
filesystem, inspecting \fIthe parent filesystem\fP's environment for
information about installed ports and available shared libraries. The
\fBpkgmk(8)\fP process might therefore draw the wrong conclusions about what
functionality should be enabled for an installation to <dir>. If the parent
filesystem is more richly populated than <dir>, with respect to installed
packages, then the built package might exhibit breakage when \fBpkgadd\fP
unpacks it into <dir>.

When setting --install-root=<dir>, install or update commands might behave
unexpectedly if <dir>/etc/pkgadd.conf exists and is different from
/etc/pkgadd.conf . In order to preserve the \fBpkgadd.conf(5)\fP settings from
host system, append the option --aargs='-c /etc/pkgadd.conf' to your \fBprt\-get
install\fP command, or just copy the desired directives into
<dir>/etc/pkgadd.conf .

.TP 
.B \-\-log
Write build output to log file. Basically a convenient alias for
\fB\-\-config\-set=\(dqwritelog enabled\(dq\fP. Note that there is no similar
alias allowing you to temporarily override the configuration directive
\(dqwritelog enabled\(dq; you have to resort to \fB\-\-config\-set=\(dqwritelog
disabled\(dq\fP if that is your intention.

.TP 
.B \-\-no-std-config
Don't parse the default configuration file

.TP 
.B \-\-config-prepend=<string>
Prepend <string> to configuration

.TP 
.B \-\-config-append=<string>
Append <string> to configuration

.TP 
.B \-\-config-set=<string>
Set <string> in configuration, overriding configuration file

.TP 
.B \-\-config=<file>
Use <file> to read configuration directives, rather than /etc/prt-get.conf.

.SH ""

The following options are primarily useful for non-install (information-seeking) 
transactions, although some of them affect the behaviour of install/upgrade 
transactions as well.

.TP 
.B \-v, \-vv
(verbosity level) Show version of a port (-v), or show both version
and description (-vv). Passing more than one of these options is equivalent 
to -vv.

.TP
.B \-\-path
Show path info for the ports found by a search or a dependency calculation

.TP
.B \-\-regex
Interpret filter and search pattern as regular expression

.TP
.B \-\-prefer\-higher, \-ph
Make prt-get parse the version strings and prefer the higher version,
even if the one found in the ports tree is lower. Also used during
a sysup operation.

.TP
.B \-\-strict\-diff, \-sd
Override the 'preferhigher' configuration option. Equivalent to
.B \-\-config\-set=\(dqpreferhigher no\(dq



.SH "CONFIGURATION"
.TP 
See man prt-get.conf(5)

.SH "EXAMPLES"
.TP 
.B prt\-get install irssi
Download, build and install irssi (and any of its missing dependencies), with
one simple command

.TP 
.B prt\-get install --nodeps jasper
Install jasper, without trying to resolve dependencies.

.TP
.B prt\-get update --softdeps webkitgtk
Get the latest version of webkitgtk, rebuilding any of its outdated dependencies
(hard and soft) in the optimal order.

.TP 
.B prt\-get update -fr openssh
Update your current version of openssh, forcing a rebuild even if no version 
difference is detected.
Useful if there was a major soversion change in one of its dependencies, 
and \fBrevdep openssh\fP indicates a broken package. :-)

.TP
.B MISSLIBS=$(revdep \-vvv mpv | awk \-v FS=: '/(missing library)/ {print $3}'); [ \-n \(dq${MISSLIBS[@]}\(dq ] && for i in ${MISSLIBS[@]}; do prt\-get fsearch $i; done
(adapted from a script by ppetrov^) Check for the presence of the runtime libraries needed by mpv.
If any are absent, search the footprints to determine which ports provide the missing libraries.

.TP
.B ls /usr/pkgmk/packages/*.tar.gz | sed 's/.*\e///; s/#.*//;' | xargs prt\-get isinst | grep 'not installed'
Determine whether there are any packages (in a shared output directory) that
have since been uninstalled, or were never installed after a successful run
of \fBpkgmk\fP.

.TP
.B prt\-get printf '%i:%p:%n\en' | awk \-v FS=: '/^diff:\e/usr\e/ports\e/core/ { print $3 }' | xargs prt\-get update
Basically a \fBsysup\fP operation, but restricted to the core collection.
Because core ports are often omitted from the dependency line if they aren't
dynamically linked in, the \fBsysup\fP sorting algorithm might not put them
at the front of the queue. Run this command before a regular \fBsysup\fP in
order to ensure that core ports are updated first.

.TP
.B prt\-get isinst $(prt\-get info ffmpeg | awk \-v FS=: '/^Optional/ {gsub(/,/,\(dq \(dq,$2); print $2}') | awk \-v FS=\(dq \(dq '/not installed/ {print $2}'
Show all the optional dependencies of ffmpeg that are not currently installed.

.TP
.B prt\-get isinst $(prt\-get info ffmpeg | awk \-v FS=: '/^Optional/ {gsub(/,/,\(dq \(dq,$2); print $2}') | awk \-v FS=\(dq \(dq '/not installed/ {print $2}' | xargs prt\-get depinst \-\-group \-\-softdeps ffmpeg
Extension of the above. Installs ffmpeg and all its optional dependencies, in
the order that guarantees a maximal feature set. The --group flag tells
\fBprt\-get\fP to abort the operation if any port fails to build, so as not to
spend any resources on ffmpeg until all of its optional dependencies are in
place.

.TP
.B prt\-get isinst $(if grep \-qE '^ffmpeg:' /etc/prt\-get.softdeps 2>/dev/null; then grep \-E '^ffmpeg:' /etc/prt\-get.softdeps | cut \-d: \-f2 | tr ',' ' '; else prt-get info ffmpeg | awk \-v FS=: '/^Optional/ {gsub(/,/,\(dq \(dq,$2); print $2}'; fi) | awk \-v FS=\(dq \(dq '/not installed/ {print $2}' | xargs prt\-get depinst \-\-group \-\-softdeps ffmpeg
Extension of the above (addressing a use case envisioned by ivandi). The
user can create the file /etc/prt-get.softdeps containing a line like
.B ffmpeg: x264 x265
and then the above command will perform a depinst --group operation to
ensure that at least x264 and x265 (but not necessarily any of the other
optional dependencies) are present before trying to build ffmpeg. In the
absence of such a .softdeps config, the operation reverts to the behaviour
of the preceding example (maximal feature set). Implementing Gentoo USE
flags with such an awkward one-liner might draw criticism from advocates of
the KISS principle.

.TP 
.B prt\-get search \-\-regex '^(m|n|p)c.*'
Return a list of all ports whose names start with "mc", "nc", or "pc"

.TP
.B prt\-get dsearch irc
Return a list of all ports having "irc" in their name or description

.TP
.B comm -13 <(ls /usr/ports/core) <(prt-get listorphans)
(based on comments from Romster and jue) Filter out the core ports from the list of orphans, in
shells (like bash) that support process substitution

.TP
.B comm -13 <(cat ~/.keepers <(ls /usr/ports/core) | sort) <(prt\-get listorphans) | xargs prt\-get remove
(system-hosing extension of the above) A one-liner inspired by \fBpkg\-clean\fP
and \fBpkgfoster\fP, but without the safeguard of interactivity.
\fBDo not try this on a mission-critical system.\fP

.TP
.B prt\-get isinst $(prt\-get quickdep $(prt\-get quickdiff)) | awk '/not installed/ {print $2}'
(adapted from a comment by Fun) After updating your ports tree, print out a 
list of dependencies that were not needed the last time you built your 
currently-installed ports, but are needed now by the newer versions of 
these ports. The output of this command is sorted by dependencies, therefore
suitable for piping to \fBxargs prt\-get install\fP.

.TP
.B prt\-get isinst $(prt\-get quickdep i3) | awk '/not installed/ { print $2 }' | xargs prt\-get depinst \-\-softdeps \-\-test
(inspired by a troubleshooting session with hestia) Assemble a set of install
targets needed to build the i3 window manager; sort the list, respecting both
hard and soft dependencies; then print how the installation would proceed. The
awk filter in the middle is needed to prevent the command from failing with the
error message "already installed".

.TP
.B prt\-get printf \(dq%p\et%u\en\(dq | grep myrepo | cut \-f 2
Print the upstream URL for each port in the collection \(dqmyrepo\(dq, 
perhaps as the first step in keeping your personal overlay up to date.

.TP
.B for u in $(prt\-get printf \(dq%M:%p/%n\en\(dq | grep \-i ^unmaintained | cut \-d: \-f2); do cd ${u%/*}; printf \(dq||%s || \(dq ${u##*/}; git log ${u##*/} | head \-n 5 | awk \-v FS=: '/^Date/ { printf(\(dq%s ||\en\(dq,$2); }'; done
Generate a table of unmaintained ports and the dates of their most recent
commit, using PmWiki syntax (left-justified port names, centered dates).

.TP 
.B comm \-13 <(prt\-get depends firefox\-bin |tail \-n +2 |sort) <(prt\-get depends firefox |tail \-n +2 |sort)
Find the build-time dependencies of firefox. Runtime dependencies would 
also appear in the list generated by the first process substitution, and 
\fBcomm \-13\fP will suppress what the two lists have in common.

.TP
.B prt\-get listinst \-\-depsort | xargs prt\-get install \-\-install\-root=/mnt
Sort the list of installed packages by dependencies, and then install all
those packages onto a backup filesystem (mounted at /mnt). If you have a 
customized pkgadd.conf that you want applied to this operation, either copy 
it to /mnt/etc where pkgadd will be looking for it, or pass the additional 
option \-\-aargs=\(dq\-c /etc/pkgadd.conf\(dq to the install command.

.TP
.B  prt\-get list \-\-path \-\-regex '^xorg.*' | grep \-v \(dq/usr/ports/xorg\(dq
Show the ports whose names begin with xorg, but which appear outside the 
xorg port collection.
(At the time of writing, this command returned at least two font ports.)

.SH "AUTHORS"
Johannes Winkelmann <jw@tks6.net>, and others cited inline
.SH "SEE ALSO"
prt-get.conf(5), prt-cache(8), Pkgfile(5), pkgmk(8), pkgadd(8), ports(8)