diff options
Diffstat (limited to 'doc/apt-get.8.xml')
| -rw-r--r-- | doc/apt-get.8.xml | 138 |
1 files changed, 108 insertions, 30 deletions
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 2ea6ea1d4..c63011b2a 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -15,7 +15,7 @@ &apt-email; &apt-product; <!-- The last update date --> - <date>29 February 2004</date> + <date>30 October 2008</date> </refentryinfo> <refmeta> @@ -33,22 +33,67 @@ <refsynopsisdiv> <cmdsynopsis> <command>apt-get</command> - <arg><option>-hvs</option></arg> - <arg><option>-o=<replaceable>config string</replaceable></option></arg> - <arg><option>-c=<replaceable>file</replaceable></option></arg> + <arg><option>-vsqdyfmubV</option></arg> + <arg> + <option>-o= + <replaceable>config_string</replaceable> + </option> + </arg> + <arg> + <option>-c= + <replaceable>config_file</replaceable> + </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> + </group> + </arg> + <group choice="req"> - <arg>update</arg> - <arg>upgrade</arg> - <arg>dselect-upgrade</arg> - <arg>install <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>remove <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>purge <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>source <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>build-dep <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>check</arg> - <arg>clean</arg> - <arg>autoclean</arg> - <arg>autoremove</arg> + <arg choice='plain'>update</arg> + <arg choice='plain'>upgrade</arg> + <arg choice='plain'>dselect-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_name</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> + =<replaceable>pkg_version_number</replaceable> + </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'>-h</arg> + <arg choice='plain'>--help</arg> + </group> + </arg> </group> </cmdsynopsis> </refsynopsisdiv> @@ -111,17 +156,25 @@ </varlistentry> <varlistentry><term>install</term> - <listitem><para><literal>install</literal> is followed by one or more packages desired for - installation. Each package is a package name, not a fully qualified - filename (for instance, in a Debian GNU/Linux system, libc6 would be the - argument provided, not <literal>libc6_1.9.6-2.deb</literal>) All packages required - by the package(s) specified for installation will also be retrieved and - installed. The <filename>/etc/apt/sources.list</filename> file is used to locate - the desired packages. If a hyphen is appended to the package name (with - no intervening space), the identified package will be removed if it is - installed. Similarly a plus sign can be used to designate a package to - install. These latter features may be used to override decisions made by - apt-get's conflict resolution system.</para> + <listitem> + <para> + <literal>install</literal> is followed by one or more + packages desired for installation or upgrading. + Each package is a package name, not a fully qualified + filename (for instance, in a Debian GNU/Linux system, + libc6 would be the argument provided, not + <literal>libc6_1.9.6-2.deb</literal>). All packages required + by the package(s) specified for installation will also + be retrieved and installed. + The <filename>/etc/apt/sources.list</filename> file is + used to locate the desired packages. If a hyphen is + appended to the package name (with no intervening space), + the identified package will be removed if it is installed. + Similarly a plus sign can be used to designate a + package to install. These latter features may be used + to override decisions made by apt-get's conflict + resolution system. + </para> <para>A specific version of a package can be selected for installation by following the package name with an equals and the version of the package @@ -133,6 +186,17 @@ <para>Both of the version selection mechanisms can downgrade packages and must be used with care.</para> + <para>This is also the target to use if you want to upgrade one or + more already-installed packages without upgrading every package + you have on your system. Unlike the "upgrade" target, which + installs the newest version of all currently installed packages, + "install" will install the newest version of only the package(s) + specified. Simply provide the name of the package(s) you wish + to upgrade, and if a newer version is available, it (and its + dependencies, as described above) will be downloaded and + installed. + </para> + <para>Finally, the &apt-preferences; mechanism allows you to create an alternative installation policy for individual packages.</para> @@ -222,6 +286,11 @@ &apt-cmdblurb; <variablelist> + <varlistentry><term><option>--no-install-recommends</option></term> + <listitem><para>Do not consider recommended packages as a dependency for installing. + Configuration Item: <literal>APT::Install-Recommends</literal>.</para></listitem> + </varlistentry> + <varlistentry><term><option>-d</option></term><term><option>--download-only</option></term> <listitem><para>Download only; package files are only retrieved, not unpacked or installed. Configuration Item: <literal>APT::Get::Download-Only</literal>.</para></listitem> @@ -450,7 +519,7 @@ </varlistentry> <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term> - <listitem><para>APT configuration file fragments + <listitem><para>APT configuration file fragments. Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem> </varlistentry> @@ -495,7 +564,16 @@ <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; + &apt-qapage; + </para> + </refsect1> &manbugs; - </refentry> |