diff options
Diffstat (limited to 'doc/apt-get.8.xml')
| -rw-r--r-- | doc/apt-get.8.xml | 143 |
1 files changed, 25 insertions, 118 deletions
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index fd1cd2540..e4c72188a 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -18,7 +18,7 @@ &apt-email; &apt-product; <!-- The last update date --> - <date>08 November 2008</date> + <date>2012-05-21T00:00:00Z</date> </refentryinfo> <refmeta> @@ -33,91 +33,8 @@ <refpurpose>APT package handling utility -- command-line interface</refpurpose> </refnamediv> - <!-- Arguments --> - <refsynopsisdiv> - <cmdsynopsis> - <command>apt-get</command> - <arg><option>-sqdyfmubV</option></arg> - <arg> - <option>-o= - <replaceable>config_string</replaceable> - </option> - </arg> - <arg> - <option>-c= - <replaceable>config_file</replaceable> - </option> - </arg> - <arg> - <option>-t=</option> - <arg choice='plain'> - <replaceable>target_release</replaceable> - </arg> - </arg> - <arg> - <option>-a=</option> - <arg choice='plain'> - <replaceable>default_architecture</replaceable> - </arg> - </arg> - - - <group choice="req"> - <arg choice='plain'>update</arg> - <arg choice='plain'>upgrade</arg> - <arg choice='plain'>dselect-upgrade</arg> - <arg choice='plain'>dist-upgrade</arg> - <arg choice='plain'>install - <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable> - <arg> - <group choice='req'> - <arg choice='plain'> - =<replaceable>pkg_version_number</replaceable> - </arg> - <arg choice='plain'> - /<replaceable>target_release</replaceable> - </arg> - </group> - </arg> - </arg> - </arg> - <arg choice='plain'>remove <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg choice='plain'>purge <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg choice='plain'>source - <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable> - <arg> - <group choice='req'> - <arg choice='plain'> - =<replaceable>pkg_version_number</replaceable> - </arg> - <arg choice='plain'> - /<replaceable>target_release</replaceable> - </arg> - </group> - </arg> - </arg> - </arg> - <arg choice='plain'>build-dep <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg choice='plain'>check</arg> - <arg choice='plain'>clean</arg> - <arg choice='plain'>autoclean</arg> - <arg choice='plain'>autoremove</arg> - <arg choice='plain'> - <group choice='req'> - <arg choice='plain'>-v</arg> - <arg choice='plain'>--version</arg> - </group> - </arg> - <arg choice='plain'> - <group choice='req'> - <arg choice='plain'>-h</arg> - <arg choice='plain'>--help</arg> - </group> - </arg> - </group> - </cmdsynopsis> - </refsynopsisdiv> - + &synopsis-command-apt-get; + <refsect1><title>Description</title> <para><command>apt-get</command> is the command-line tool for handling packages, and may be considered the user's "back-end" to other tools using the APT @@ -128,7 +45,7 @@ commands below must be present.</para> <variablelist> - <varlistentry><term>update</term> + <varlistentry><term><option>update</option></term> <listitem><para><literal>update</literal> is used to resynchronize the package index files from their sources. The indexes of available packages are fetched from the location(s) specified in <filename>/etc/apt/sources.list</filename>. @@ -140,7 +57,7 @@ of the package files cannot be known in advance.</para></listitem> </varlistentry> - <varlistentry><term>upgrade</term> + <varlistentry><term><option>upgrade</option></term> <listitem><para><literal>upgrade</literal> is used to install the newest versions of all packages currently installed on the system from the sources enumerated in <filename>/etc/apt/sources.list</filename>. Packages currently installed with @@ -153,7 +70,7 @@ available.</para></listitem> </varlistentry> - <varlistentry><term>dselect-upgrade</term> + <varlistentry><term><option>dselect-upgrade</option></term> <listitem><para><literal>dselect-upgrade</literal> is used in conjunction with the traditional Debian packaging front-end, &dselect;. <literal>dselect-upgrade</literal> @@ -163,7 +80,7 @@ packages).</para></listitem> </varlistentry> - <varlistentry><term>dist-upgrade</term> + <varlistentry><term><option>dist-upgrade</option></term> <listitem><para><literal>dist-upgrade</literal> in addition to performing the function of <literal>upgrade</literal>, also intelligently handles changing dependencies with new versions of packages; <command>apt-get</command> has a "smart" conflict @@ -176,7 +93,7 @@ overriding the general settings for individual packages.</para></listitem> </varlistentry> - <varlistentry><term>install</term> + <varlistentry><term><option>install</option></term> <listitem> <para><literal>install</literal> is followed by one or more packages desired for installation or upgrading. @@ -230,7 +147,7 @@ with a '^' or '$' character, or create a more specific regular expression.</para></listitem> </varlistentry> - <varlistentry><term>remove</term> + <varlistentry><term><option>remove</option></term> <listitem><para><literal>remove</literal> is identical to <literal>install</literal> except that packages are removed instead of installed. Note the removing a package leaves its configuration files in system. If a plus sign is appended to the package @@ -238,16 +155,16 @@ installed instead of removed.</para></listitem> </varlistentry> - <varlistentry><term>purge</term> + <varlistentry><term><option>purge</option></term> <listitem><para><literal>purge</literal> is identical to <literal>remove</literal> except that packages are removed and purged (any configuration files are deleted too).</para></listitem> </varlistentry> - <varlistentry><term>source</term> + <varlistentry><term><option>source</option></term> <listitem><para><literal>source</literal> causes <command>apt-get</command> to fetch source packages. APT will examine the available packages to decide which source package to fetch. It will then find and download into the current directory the - newest available version of that source package while respect the + newest available version of that source package while respecting the default release, set with the option <literal>APT::Default-Release</literal>, the <option>-t</option> option or per package with the <literal>pkg/release</literal> syntax, if possible.</para> @@ -277,25 +194,25 @@ tar balls.</para></listitem> </varlistentry> - <varlistentry><term>build-dep</term> + <varlistentry><term><option>build-dep</option></term> <listitem><para><literal>build-dep</literal> causes apt-get to install/remove packages in an attempt to satisfy the build dependencies for a source package. By default the dependencies are satisfied to build the package natively. If desired a host-architecture can be specified with the <option>--host-architecture</option> option instead.</para></listitem> </varlistentry> - <varlistentry><term>check</term> + <varlistentry><term><option>check</option></term> <listitem><para><literal>check</literal> is a diagnostic tool; it updates the package cache and checks for broken dependencies.</para></listitem> </varlistentry> - <varlistentry><term>download</term> + <varlistentry><term><option>download</option></term> <listitem><para><literal>download</literal> will download the given binary package into the current directory. </para></listitem> </varlistentry> - <varlistentry><term>clean</term> + <varlistentry><term><option>clean</option></term> <listitem><para><literal>clean</literal> clears out the local repository of retrieved package files. It removes everything but the lock file from <filename>&cachedir;/archives/</filename> and @@ -305,7 +222,7 @@ from time to time to free up disk space.</para></listitem> </varlistentry> - <varlistentry><term>autoclean</term> + <varlistentry><term><option>autoclean</option></term> <listitem><para>Like <literal>clean</literal>, <literal>autoclean</literal> clears out the local repository of retrieved package files. The difference is that it only removes package files that can no longer be downloaded, and are largely @@ -315,17 +232,17 @@ erased if it is set to off.</para></listitem> </varlistentry> - <varlistentry><term>autoremove</term> + <varlistentry><term><option>autoremove</option></term> <listitem><para><literal>autoremove</literal> is used to remove packages that were automatically installed to satisfy dependencies for other packages and are now no longer needed.</para></listitem> </varlistentry> - <varlistentry><term>changelog</term> + <varlistentry><term><option>changelog</option></term> <listitem><para><literal>changelog</literal> downloads a package changelog and displays it through <command>sensible-pager</command>. The server name and base directory is defined in the <literal>APT::Changelogs::Server</literal> - variable (e. g. <ulink>http://packages.debian.org/changelogs</ulink> for - Debian or <ulink>http://changelogs.ubuntu.com/changelogs</ulink> for + variable (e. g. <ulink url="http://packages.debian.org/changelogs">packages.debian.org/changelogs</ulink> for + Debian or <ulink url="http://changelogs.ubuntu.com/changelogs">changelogs.ubuntu.com/changelogs</ulink> for Ubuntu). By default it displays the changelog for the version that is installed. However, you can specify the same options as for @@ -480,9 +397,10 @@ </varlistentry> <varlistentry><term><option>--only-upgrade</option></term> - <listitem><para>Do not install new packages; When used in conjunction with <literal>install</literal>, - <literal>only-upgrade</literal> will prevent packages on the command line - from being upgraded if they are not already installed. + <listitem><para>Do not install new packages; When used in conjunction + with <literal>install</literal>, <literal>only-upgrade</literal> will + install upgrades for already installed packages only and ignore requests + to install new packages. Configuration Item: <literal>APT::Get::Only-Upgrade</literal>.</para></listitem> </varlistentry> @@ -617,16 +535,5 @@ <refsect1><title>Diagnostics</title> <para><command>apt-get</command> returns zero on normal operation, decimal 100 on error.</para> </refsect1> - <refsect1> - <title>ORIGINAL AUTHORS</title> - <para>&apt-author.jgunthorpe;</para> - </refsect1> - <refsect1> - <title>CURRENT AUTHORS</title> - <para> - &apt-author.team; - </para> - &apt-qapage; - </refsect1> &manbugs; </refentry> |