diff options
Diffstat (limited to 'doc/apt-get.8.xml')
| -rw-r--r-- | doc/apt-get.8.xml | 35 |
1 files changed, 27 insertions, 8 deletions
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index cc4e82255..595ea875d 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -8,6 +8,8 @@ <!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent"> %aptverbatiment; +<!ENTITY % aptvendor SYSTEM "apt-vendor.ent"> +%aptvendor; ]> <refentry> @@ -38,7 +40,7 @@ <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 - library. Several "front-end" interfaces exist, such as &dselect;, + library. Several "front-end" interfaces exist, such as &aptitude;, &synaptic; and &wajig;.</para> <para>Unless the <option>-h</option>, or <option>--help</option> option is given, one of the @@ -215,10 +217,7 @@ <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 - <filename>&cachedir;/archives/partial/</filename>. When APT is used as a - &dselect; method, <literal>clean</literal> is run automatically. - Those who do not use dselect will likely want to run <literal>apt-get clean</literal> - from time to time to free up disk space.</para></listitem> + <filename>&cachedir;/archives/partial/</filename>.</para></listitem> </varlistentry> <varlistentry><term><option>autoclean</option></term> @@ -282,7 +281,7 @@ running APT for the first time; APT itself does not allow broken package dependencies to exist on a system. It is possible that a system's dependency structure can be so corrupt as to require manual intervention - (which usually means using &dselect; or <command>dpkg --remove</command> to eliminate some of + (which usually means using <command>dpkg --remove</command> to eliminate some of the offending packages). Use of this option together with <option>-m</option> may produce an error in some situations. Configuration Item: <literal>APT::Get::Fix-Broken</literal>.</para></listitem> @@ -389,6 +388,18 @@ Configuration Item: <literal>APT::Ignore-Hold</literal>.</para></listitem> </varlistentry> + <varlistentry><term><option>--with-new-pkgs</option></term> + <listitem><para>Allow installing new packages when used in + conjunction with <literal>upgrade</literal>. This is useful if + the update of a installed package requires new dependencies to be + installed. Instead of holding the package back <literal>upgrade</literal> + will upgrade the package and install the new dependencies. Note that + <literal>upgrade</literal> with this option will never remove packages, + only allow adding new ones. + Configuration Item: <literal>APT::Get::Upgrade-Allow-New</literal>. + </para></listitem> + </varlistentry> + <varlistentry><term><option>--no-upgrade</option></term> <listitem><para>Do not upgrade packages; when used in conjunction with <literal>install</literal>, <literal>no-upgrade</literal> will prevent packages on the command line @@ -508,7 +519,15 @@ This is useful for tools like pbuilder. Configuration Item: <literal>APT::Get::AllowUnauthenticated</literal>.</para></listitem> </varlistentry> - + + <varlistentry><term><option>--show-progress</option></term> + <listitem><para>Show user friendly progress information in the + terminal window when packages are installed, upgraded or + removed. For a machine parsable version of this data see + README.progress-reporting in the apt doc directory. + Configuration Item: <literal>DpkgPM::Progress</literal> and <literal>Dpkg::Progress-Fancy</literal>.</para></listitem> + </varlistentry> + &apt-commonoptions; @@ -526,7 +545,7 @@ </refsect1> <refsect1><title>See Also</title> - <para>&apt-cache;, &apt-cdrom;, &dpkg;, &dselect;, &sources-list;, + <para>&apt-cache;, &apt-cdrom;, &dpkg;, &sources-list;, &apt-conf;, &apt-config;, &apt-secure;, The APT User's guide in &guidesdir;, &apt-preferences;, the APT Howto.</para> </refsect1> |