apt(1) [mojave man page]
apt(1) General Commands Manual apt(1) NAME
apt - annotation processing tool SYNOPSIS
apt [ -classpath classpath ] [ -sourcepath sourcepath ] [ -d directory ] [ -s directory ] [ -factorypath path ] [ -factory class ] [ -print ] [ -nocompile ] [ -A [ key [ =val ] ] ] [ javac option ] sourcefiles [ @files ] DESCRIPTION
The tool apt, annotation processing tool, includes a set of new reflective APIs and supporting infrastructure to process program annota- tions. The apt reflective APIs provide a build-time, source-based, read-only view of program structure. These reflective APIs are designed to cleanly model the JavaTM programming language's type system after the addition of generics. First, apt runs annotation processors that can produce new source code and other files. Next, apt can cause compilation of both original and generated source files, easing develop- ment. The reflective APIs and other APIs used to interact with the tool are subpackages of com.sun.mirror. A fuller discussion of how the tool operates as well as instructions for developing with apt are in Getting Started with apt at http://java.sun.com/j2se/1.5.0/docs/guide/apt/GettingStarted.html. PARAMETERS
Options may be in any order. For a discussion of parameters which apply to a specific option, see OPTIONS below. sourcefiles Zero or more source files to be processed. @files One or more files that list source files or other options. OPTIONS
apt specific options -s dir Specify the directory root under which processor-generated source files will be placed; files are placed in subdirectories based on package namespace. -nocompile Do not compile sources files to class files. -print Print out textual representation of specified types; perform no annotation processing or compilation. -A[key[=val]] Options to pass to annotation processors -- these are not interpreted by apt directly, but are made available for use by individual processors -factorypath path Specify where to find annotation processor factories; if this option is used, the classpath is not searched for factories. -factory classname Name of annotation processor factory to use; bypasses default discovery process Options shared with javac -d dir Specify where to place processor and javac generated class files -cp path or -classpath path Specify where to find user class files and annotation processor factories. If -factorypath is given, the classpath is not searched for factories. Consult the javac(1) man page for information on javac options. NOTES
The apt tool and its associated APIs may be changed or superseded in future j2se releases. SEE ALSO
javac(1) java(1) 13 June 2004 apt(1)
Check Out this Related Man Page
APT-SHOW-VERSIONS(1p) User Contributed Perl Documentation APT-SHOW-VERSIONS(1p) NAME
apt-show-versions - Lists available package versions with distribution DESCRIPTION
apt-show-versions parses the dpkg status file and the APT lists for the installed and available package versions and distribution and shows upgrade options within the specific distribution of the selected package. This is really useful if you have a mixed stable/testing environment and want to list all packages which are from testing and can be upgraded in testing. apt-show-versions uses caching for the status information of installed and available packages. If you run apt-show-versions as root the cache is updated as needed. If you run as non-root uses the newest available information, but can't update the cache. If you run as root with the option -i the cache is initialized or updated only. SYNOPSIS
apt-show-versions [-h] [[-p] package name] [-a] [-b] OPTIONS
If you don't give any options the status of all installed packages is printed. -p package, --package=package Print available and installed versions for specified package. You can also specify a package name without the option -p. If -p and a package name are missing, all installed packages are displayed. -r, --regex interpret package from option -p as a regex. -R, --regex-all like --regex, but also show matching packages which are not installed -u, --upgradeable Print only upgradeable packages -a, --allversions Print all available versions of the selected packages -b, --brief Print only package_name/distribution for upgradeable packages -v, --verbose Prints out messages about which Package files are parsed. -i, --initialize Initialize or update package cache only (as root). Do this every time when the status of the installed or available packages has changed. Initialization is done automatically on installation of the package and via a cron.daily job. -stf file, --status-file=file Use file as the dpkg status file instead of /var/lib/dpkg/status -ld directory, --list-dir=directory Use directory as path to apt's list files instead of /var/state/apt/lists/ or /var/lib/apt/lists/ -h, --help Prints out command-line help. EXIT CODES
0 No error 1 Wrong usage 2 apt-show-versions has been called with exactly one package and upgradeable option set, but package is uptodate. As no output has been requested, this case gets signaled using the exit code. 255 Unspecified error EXAMPLES
If you want to know for all your installed packages whether they are uptodate or upgradeable, use: apt-show-versions If you want to have a list of all upgradeable packages: apt-show-versions -u To get a list of all available versions of libc6: apt-show-versions -a -p libc6 To get information about several packages: apt-show-versions dpkg apt apt-show-versions -r ^texlive To upgrade all packages in testing: apt-get install `apt-show-versions -u -b | fgrep testing` AUTHOR
Christoph Martin, martin@uni-mainz.de SEE ALSO
apt(8), dpkg(1) perl v5.14.2 2012-10-26 APT-SHOW-VERSIONS(1p)