FreeBSD Manual Pages
PKG-ANNOTATE(8) System Manager's Manual PKG-ANNOTATE(8) NAME pkg annotate -- add, modify or delete arbitrary annotations from pack- ages SYNOPSIS pkg annotate [-qy] -A|M [-Cgix] pkg-name tag [value] pkg annotate [-qy] -S|D [-Cgix] pkg-name tag pkg annotate [-qy] -a -A|M tag [value] pkg annotate [-qy] -a -S|D tag pkg annotate [--{quiet,yes}] --{add|modify} [--{case-sensitive,case-insensitive,glob,regex}] pkg-name tag [value] pkg annotate [--{quiet,yes}] --{show|delete} [--{case-sensitive,case-insensitive,glob,regex}] pkg-name tag pkg annotate [--{quiet,yes}] --all --{add|modify} tag [value] pkg annotate [--{quiet,yes}] --all --{show|delete} tag DESCRIPTION pkg annotate is used to add, modify, delete or show package annota- tions. These are freeform tag-value pairs which may contain any arbi- trary text. Tags must be unique per package, but there is no restric- tion on what text values may be attached to them. The tag is always specified on the command line, but when adding or modifying an annotation, the value may be supplied either on the com- mand line or as a text stream on stdin. OPTIONS The following options are supported by pkg annotate: -a, --all Annotate all installed packages. -A, --add The operation is to add a new annotation. Attempting to add an annotation with a tag that already applies to that package is an error, but this will not cause pkg annotate to exit before attempting to apply the annotation to all remaining matched packages. -C, --case-sensitive Make the standard or the regular expression (-x) matching against pkg-name case sensitive. -D, --delete The operation is to delete an annotation. Only the tag needs to be specified. Attempting to delete an annotation which does not exist on a package is an error, but this will not prevent pkg annotate carrying on to delete the annotation from all matched packages. -g, --glob Treat pkg-name as a shell glob pattern. -i, --case-insensitive Make the standard or the regular expression (-x) matching against pkg-name case insensitive. This is the default, unless modified by setting CASE_SENSITIVE_MATCH to true in pkg.conf. -M, --modify The operation is to modify a previously existing annotation. Functionally, this behaves similarly to -A except that it will succeed irrespective of whether the tag already applies to all the matched packages. -q, --quiet Operate quietly: do not output anything other than confirmatory questions. -S, --show Display the annotation identified by tag for each matched pack- age. -x, --regex Treat pkg-name as a regular expression according to the "mod- ern" or "extended" syntax of re_format(7). -y, --yes Assume "yes" as the answer to all questions. ENVIRONMENT The following environment variables affect the execution of pkg annotate. See pkg.conf(5) for further description. PKG_DBDIR DEFAULT_ALWAYS_YES ASSUME_ALWAYS_YES CASE_SENSITIVE_MATCH FILES See pkg.conf(5). EXAMPLES Annotate the nginx package with the tag foo and a value of bar: # pkg annotate -A nginx foo bar View all annotations on a package: $ pkg info nginx Remove the annotation: # pkg annotate -D nginx foo Show all packages with the foo annotation: # pkg annotate --all --show foo SEE ALSO pkg_create(3), pkg_printf(3), pkg_repo_create(3), pkg_repos(3), pkg-keywords(5), pkg-lua-script(5), pkg-repository(5), pkg-script(5), pkg-triggers(5), pkg.conf(5), pkg(8), pkg-add(8), pkg-alias(8), pkg-audit(8), pkg-autoremove(8), pkg-check(8), pkg-clean(8), pkg-config(8), pkg-create(8), pkg-delete(8), pkg-fetch(8), pkg-info(8), pkg-install(8), pkg-key(8), pkg-lock(8), pkg-query(8), pkg-register(8), pkg-repo(8), pkg-repositories(8), pkg-rquery(8), pkg-search(8), pkg-set(8), pkg-shell(8), pkg-shlib(8), pkg-ssh(8), pkg-stats(8), pkg-triggers(8), pkg-update(8), pkg-updating(8), pkg-upgrade(8), pkg-version(8), pkg-which(8) FreeBSD Ports 14.quarterly May 17, 2014 PKG-ANNOTATE(8)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | EXAMPLES | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pkg-annotate&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>