refresh the man-page examples
This commit is contained in:
parent
c029a01d00
commit
d1060afc5c
|
@ -287,39 +287,39 @@ symbols will be replaced as follows.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%n \-> name of the port
|
%n -> name of the port
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%p1 \-> Full path (including name) to port taking precedence
|
%p1 -> Full path (including name) to port taking precedence
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%p2 \-> Full path (including name) to port being hidden
|
%p2 -> Full path (including name) to port being hidden
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%v1 \-> Version of port taking precedence
|
%v1 -> Version of port taking precedence
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%v2 \-> Version of port being hidden
|
%v2 -> Version of port being hidden
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%M1 \-> maintainer of port taking precedence
|
%M1 -> maintainer of port taking precedence
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%M2 \-> maintainer of port being hidden
|
%M2 -> maintainer of port being hidden
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%u1 \-> URL of port taking precedence
|
%u1 -> URL of port taking precedence
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%u2 \-> URL of port being hidden
|
%u2 -> URL of port being hidden
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B list [\-v|\-vv] [\-\-path] [\-\-regex] [filter]
|
.B list [\-v|\-vv] [\-\-path] [\-\-regex] [filter]
|
||||||
|
@ -337,27 +337,27 @@ Print formatted port list format string can contain variables, which
|
||||||
are replaced like this:
|
are replaced like this:
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%n \-> name
|
%n -> name
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%p \-> path
|
%p -> path
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%v \-> version
|
%v -> version
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%r \-> release
|
%r -> release
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%d \-> description
|
%d -> description
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%e \-> dependencies
|
%e -> dependencies
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
|
@ -365,7 +365,7 @@ are replaced like this:
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%u \-> URL
|
%u -> URL
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
|
@ -389,7 +389,7 @@ are replaced like this:
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
\ \ \ \(bu
|
\ \ \ \(bu
|
||||||
%i \-> "no" if not installed, "yes" if it's installed and
|
%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
|
up to date and "diff" if it's installed and a new version is in the
|
||||||
ports tree.
|
ports tree.
|
||||||
|
|
||||||
|
@ -690,18 +690,18 @@ Install paper and yasm. Abort with an informative error message if either
|
||||||
package is already installed, allowing you to issue a revised command.
|
package is already installed, allowing you to issue a revised command.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B prt\-get update -fr openssh
|
.B prt\-get update \-fr openssh
|
||||||
Update your current version of openssh, forcing a rebuild even if no version difference is detected.
|
Update your current version of openssh, forcing a rebuild even if no version difference is detected.
|
||||||
Useful if there was a major version change in one of its dependencies, and \fBrevdep openssh\fP
|
Useful if there was a major version change in one of its dependencies, and \fBrevdep openssh\fP
|
||||||
indicates a broken package. :\-)
|
indicates a broken package. :\-)
|
||||||
|
|
||||||
.TP
|
.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
|
.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.
|
(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.
|
If any are absent, search the footprints to determine which ports provide the missing libraries.
|
||||||
|
|
||||||
.TP
|
.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}'
|
.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.
|
Show all the optional dependencies of ffmpeg that are not currently installed.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
|
@ -713,7 +713,7 @@ spend any resources on ffmpeg until all of its optional dependencies are in
|
||||||
place.
|
place.
|
||||||
|
|
||||||
.TP
|
.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
|
.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
|
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
|
user can create the file /etc/prt-get.softdeps containing a line like
|
||||||
.B ffmpeg: x264 x265
|
.B ffmpeg: x264 x265
|
||||||
|
@ -733,12 +733,17 @@ Return a list of all ports whose names start with "mc", "nc", or "pc"
|
||||||
Return a list of all ports having "irc" in their name or description
|
Return a list of all ports having "irc" in their name or description
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B comm -13 <(ls /usr/ports/core) <(prt-get listorphans)
|
.B prt\-get fsearch \-\-full \(dq/usr/etc/*\(dq | awk '/^Found in/ { $0=gensub(/Found in .*\e/(.+):/,\(dq\e\e1\(dq,\(dqg\(dq); print;}'
|
||||||
|
Return a list of all ports that store their configs in /usr/etc. Omit the
|
||||||
|
pipe to awk if you also want a detailed list of the files that matched.
|
||||||
|
|
||||||
|
.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
|
(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
|
shells (like bash) that support process substitution
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B comm -13 <(cat ~/.keepers <(ls /usr/ports/core) | sort) <(prt\-get listorphans) | xargs prt\-get remove
|
.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
|
(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
|
and \fBpkgfoster\fP, but without the safeguard of interactivity. \fBDo not try this on a
|
||||||
mission-critical system.\fP
|
mission-critical system.\fP
|
||||||
|
@ -764,7 +769,7 @@ awk filter in the middle is needed to prevent the command from failing with the
|
||||||
error message "already installed".
|
error message "already installed".
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B comm -3 <(prt\-get printf \(dq%i:%n %v-%r\en\(dq | grep -v ^no | cut -d: -f2 | sort) <(pkginfo -i | sort)
|
.B comm \-3 <(prt\-get printf \(dq%i:%n %v\-%r\en\(dq | grep \-v ^no | cut \-d: \-f2 | sort) <(pkginfo \-i | sort)
|
||||||
(inspired by a bug report from teodor) an alternative to \fBprt\-get diff\fP.
|
(inspired by a bug report from teodor) an alternative to \fBprt\-get diff\fP.
|
||||||
In the output, left-justified lines show the version available in the
|
In the output, left-justified lines show the version available in the
|
||||||
repositories, while indented lines show the version installed. On a
|
repositories, while indented lines show the version installed. On a
|
||||||
|
@ -778,16 +783,16 @@ 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.
|
as the first step in keeping your personal overlay up to date.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B prt\-get printf \(dq%M\et%n\en\(dq | grep ^Tim | wc -l
|
.B prt\-get printf \(dq%M\et%n\en\(dq | grep \-c ^Tim
|
||||||
Count how many ports our most-overworked core team member claims responsibility for.
|
Count how many ports our most-overworked core team member claims responsibility for.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B comm -13 <(prt\-get depends firefox-bin |tail -n +2 |sort) <(prt\-get depends firefox |tail -n +2 |sort)
|
.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
|
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.
|
the first process substitution, and \fBcomm -13\fP will suppress what the two lists have in common.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B prt-get listinst \-\-depsort | xargs prt-get install \-\-install\-root=/mnt
|
.B prt\-get listinst \-\-depsort | xargs prt\-get install \-\-install\-root=/mnt
|
||||||
Sort the list of installed packages by dependencies, and then install all
|
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
|
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
|
pkgadd.conf that you want applied to this operation, either copy it to
|
||||||
|
@ -795,7 +800,7 @@ pkgadd.conf that you want applied to this operation, either copy it to
|
||||||
/etc/pkgadd.conf\(dq to the install command.
|
/etc/pkgadd.conf\(dq to the install command.
|
||||||
|
|
||||||
.TP
|
.TP
|
||||||
.B prt-get list --path --regex '^xorg.*' | grep -v \(dq/usr/ports/xorg\(dq
|
.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.
|
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.)
|
(At the time of writing, this command returned at least two font ports.)
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue
Block a user