X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/b74d2d3af3238210bfafe57562d3670327918cd9..eb3947c6510042c054a319d8053821faf7244dea:/doc/apt-get.8.xml?ds=sidebyside diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 8db2883c4..57306c03f 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -5,6 +5,9 @@ <!ENTITY % aptent SYSTEM "apt.ent"> %aptent; +<!ENTITY % aptverbatiment SYSTEM "apt-verbatim.ent"> +%aptverbatiment; + ]> <refentry> @@ -21,6 +24,7 @@ <refmeta> <refentrytitle>apt-get</refentrytitle> <manvolnum>8</manvolnum> + <refmiscinfo class="manual">APT</refmiscinfo> </refmeta> <!-- Man page title --> @@ -45,18 +49,10 @@ </option> </arg> <arg> - <option>-t=</option> - <group choice='req'> - <arg choice='plain'> - <replaceable>target_release_name</replaceable> - </arg> - <arg choice='plain'> - <replaceable>target_release_number_expression</replaceable> - </arg> - <arg choice='plain'> - <replaceable>target_release_codename</replaceable> - </arg> - </group> + <option>-t=</option> + <arg choice='plain'> + <replaceable>target_release</replaceable> + </arg> </arg> <group choice="req"> @@ -72,10 +68,7 @@ =<replaceable>pkg_version_number</replaceable> </arg> <arg choice='plain'> - /<replaceable>target_release_name</replaceable> - </arg> - <arg choice='plain'> - /<replaceable>target_release_codename</replaceable> + /<replaceable>target_release</replaceable> </arg> </group> </arg> @@ -91,10 +84,7 @@ =<replaceable>pkg_version_number</replaceable> </arg> <arg choice='plain'> - /<replaceable>target_release_name</replaceable> - </arg> - <arg choice='plain'> - /<replaceable>target_release_codename</replaceable> + /<replaceable>target_release</replaceable> </arg> </group> </arg> @@ -125,7 +115,7 @@ <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;, - &aptitude;, &synaptic;, &gnome-apt; and &wajig;.</para> + &aptitude;, &synaptic; and &wajig;.</para> <para>Unless the <option>-h</option>, or <option>--help</option> option is given, one of the commands below must be present.</para> @@ -252,7 +242,7 @@ fetch. It will then find and download into the current directory the newest available version of that source package while respect the default release, set with the option <literal>APT::Default-Release</literal>, - the <option>-t</option> option or per package with with the + the <option>-t</option> option or per package with the <literal>pkg/release</literal> syntax, if possible.</para> <para>Source packages are tracked separately @@ -262,7 +252,7 @@ you will properly get another (newer, older or none) source version than the one you have installed or could install.</para> - <para>If the <option>--compile</option> options is specified + <para>If the <option>--compile</option> option is specified then the package will be compiled to a binary .deb using <command>dpkg-buildpackage</command>, if <option>--download-only</option> is specified then the source package will not be unpacked.</para> @@ -332,8 +322,8 @@ <varlistentry><term><option>-f</option></term><term><option>--fix-broken</option></term> <listitem><para>Fix; attempt to correct a system with broken dependencies in place. This option, when used with install/remove, can omit any packages - to permit APT to deduce a likely solution. Any Package that are specified - must completely correct the problem. The option is sometimes necessary when + to permit APT to deduce a likely solution. If packages are specified, + these have to completely correct the problem. The option is sometimes necessary when 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 @@ -383,14 +373,14 @@ Configuration Item: <literal>APT::Get::Simulate</literal>.</para> <para>Simulation run as user will deactivate locking (<literal>Debug::NoLocking</literal>) - automatical. Also a notice will be displayed indicating that this is only a simulation, - if the option <literal>APT::Get::Show-User-Simulation-Note</literal> is set (Default: true) - Neigther NoLocking nor the notice will be triggered if run as root (root should know what + automatic. Also a notice will be displayed indicating that this is only a simulation, + if the option <literal>APT::Get::Show-User-Simulation-Note</literal> is set (Default: true). + Neither NoLocking nor the notice will be triggered if run as root (root should know what he is doing without further warnings by <literal>apt-get</literal>).</para> <para>Simulate prints out a series of lines each one representing a dpkg operation, Configure (Conf), - Remove (Remv), Unpack (Inst). Square brackets indicate broken packages with + Remove (Remv), Unpack (Inst). Square brackets indicate broken packages and empty set of square brackets meaning breaks that are of no consequence (rare).</para></listitem> </varlistentry> @@ -443,6 +433,13 @@ Configuration Item: <literal>APT::Get::Upgrade</literal>.</para></listitem> </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. + Configuration Item: <literal>APT::Get::Only-Upgrade</literal>.</para></listitem> + </varlistentry> + <varlistentry><term><option>--force-yes</option></term> <listitem><para>Force yes; This is a dangerous option that will cause apt to continue without prompting if it is doing something potentially harmful. It @@ -465,7 +462,7 @@ <varlistentry><term><option>--purge</option></term> <listitem><para>Use purge instead of remove for anything that would be removed. An asterisk ("*") will be displayed next to packages which are - scheduled to be purged. <option>remove --purge</option> is equivalent for + scheduled to be purged. <option>remove --purge</option> is equivalent to the <option>purge</option> command. Configuration Item: <literal>APT::Get::Purge</literal>.</para></listitem> </varlistentry> @@ -557,50 +554,11 @@ <refsect1><title>Files</title> <variablelist> - <varlistentry><term><filename>/etc/apt/sources.list</filename></term> - <listitem><para>Locations to fetch packages from. - Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem> - </varlistentry> - - <varlistentry><term><filename>/etc/apt/apt.conf</filename></term> - <listitem><para>APT configuration file. - Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem> - </varlistentry> - - <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term> - <listitem><para>APT configuration file fragments. - Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem> - </varlistentry> - - <varlistentry><term><filename>/etc/apt/preferences</filename></term> - <listitem><para>Version preferences file. - This is where you would specify "pinning", - i.e. a preference to get certain packages - from a separate source - or from a different version of a distribution. - Configuration Item: <literal>Dir::Etc::Preferences</literal>.</para></listitem> - </varlistentry> - - <varlistentry><term><filename>&cachedir;/archives/</filename></term> - <listitem><para>Storage area for retrieved package files. - Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem> - </varlistentry> - - <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term> - <listitem><para>Storage area for package files in transit. - Configuration Item: <literal>Dir::Cache::Archives</literal> (implicit partial). </para></listitem> - </varlistentry> - - <varlistentry><term><filename>&statedir;/lists/</filename></term> - <listitem><para>Storage area for state information for each package resource specified in - &sources-list; - Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem> - </varlistentry> - - <varlistentry><term><filename>&statedir;/lists/partial/</filename></term> - <listitem><para> Storage area for state information in transit. - Configuration Item: <literal>Dir::State::Lists</literal> (implicit partial).</para></listitem> - </varlistentry> + &file-sourceslist; + &file-aptconf; + &file-preferences; + &file-cachearchives; + &file-statelists; </variablelist> </refsect1>