diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/apt-get.8.xml | 39 | ||||
| -rw-r--r-- | doc/apt-mark.8.xml | 48 | ||||
| -rw-r--r-- | doc/apt.conf.5.xml | 27 |
3 files changed, 93 insertions, 21 deletions
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml index 920f6b36e..8db2883c4 100644 --- a/doc/apt-get.8.xml +++ b/doc/apt-get.8.xml @@ -85,9 +85,19 @@ <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> + <group choice='req'> + <arg choice='plain'> + =<replaceable>pkg_version_number</replaceable> + </arg> + <arg choice='plain'> + /<replaceable>target_release_name</replaceable> + </arg> + <arg choice='plain'> + /<replaceable>target_release_codename</replaceable> + </arg> + </group> + </arg> </arg> </arg> <arg choice='plain'>build-dep <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> @@ -240,13 +250,22 @@ <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. Source packages are - tracked separately from binary packages via <literal>deb-src</literal> type lines - in the &sources-list; file. This probably will mean that you will not - get the same source as the package you have installed or as you could - install. If the --compile options is specified then the package will be - compiled to a binary .deb using dpkg-buildpackage, if --download-only is - specified then the source package will not be unpacked.</para> + 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 + <literal>pkg/release</literal> syntax, if possible.</para> + + <para>Source packages are tracked separately + from binary packages via <literal>deb-src</literal> type lines + in the &sources-list; file. This means that you will need to add such a line + for each repository you want to get sources from. If you don't do this + 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 + 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> <para>A specific source version can be retrieved by postfixing the source name with an equals and then the version to fetch, similar to the mechanism diff --git a/doc/apt-mark.8.xml b/doc/apt-mark.8.xml index 1b7b02812..f078f2de5 100644 --- a/doc/apt-mark.8.xml +++ b/doc/apt-mark.8.xml @@ -15,7 +15,7 @@ &apt-email; &apt-product; <!-- The last update date --> - <date>2 November 2007</date> + <date>9 August 2009</date> </refentryinfo> <refmeta> @@ -32,11 +32,19 @@ <!-- Arguments --> <refsynopsisdiv> <cmdsynopsis> - <command>apt-mark</command> - <arg><option>-hv</option></arg> - <arg><option>-f=<replaceable>FILENAME</replaceable></option></arg> - <group choice="req"><arg>markauto</arg><arg>unmarkauto</arg></group> - <arg choice="plain" rep="repeat"><replaceable>package</replaceable></arg> + <command>apt-mark</command> + <arg><option>-hv</option></arg> + <arg><option>-f=<replaceable>FILENAME</replaceable></option></arg> + <group choice="plain"> + <arg choice="plain"> + <group choice="req"> + <arg choice="plain">markauto</arg> + <arg choice="plain">unmarkauto</arg> + </group> + <arg choice="plain" rep="repeat"><replaceable>package</replaceable></arg> + </arg> + <arg choice="plain">showauto</arg> + </group> </cmdsynopsis> </refsynopsisdiv> @@ -49,7 +57,8 @@ other packages are installed to satisfy its dependencies, the dependencies are marked as being automatically installed. Once these automatically installed packages are no longer depended on - by any manually installed packages, they will be removed. + by any manually installed packages, they will be removed by e.g. + <command>apt-get</command> or <command>aptitude</command>. </para> <variablelist> <varlistentry><term>markauto</term> @@ -67,16 +76,24 @@ depend on it. </para></listitem> </varlistentry> + + <varlistentry><term>showauto</term> + <listitem><para><literal>showauto</literal> is used to print a + list of manually installed packages with each package on a new line. + </para></listitem> + </varlistentry> </variablelist> </refsect1> <refsect1><title>options</title> <variablelist> - <varlistentry><term><option>-f=<filename>FILENAME</filename></option></term><term><option>--file=<filename>FILENAME</filename></option></term> + <varlistentry> + <term><option>-f=<filename><replaceable>FILENAME</replaceable></filename></option></term> + <term><option>--file=<filename><replaceable>FILENAME</replaceable></filename></option></term> <listitem><para> - Read/Write package stats from <filename>FILENAME</filename> + Read/Write package stats from <filename><replaceable>FILENAME</replaceable></filename> instead of the default location, which is <filename>extended_status</filename> in the directory defined by the Configuration Item: <literal>Dir::State</literal>.</para></listitem> @@ -101,8 +118,19 @@ </variablelist> </refsect1> + <refsect1><title>Files</title> + <variablelist> + <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term> + <listitem><para>Status list of auto-installed packages. + Configuration Item: <literal>Dir::State</literal> + sets the path to the <filename>extended_states</filename> file. + </para></listitem> + </varlistentry> + </variablelist> + </refsect1> + <refsect1><title>See Also</title> - <para>&apt-conf;</para> + <para>&apt-get;,&aptitude;,&apt-conf;</para> </refsect1> <refsect1><title>Diagnostics</title> diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml index 1fe980d28..c0c247ae9 100644 --- a/doc/apt.conf.5.xml +++ b/doc/apt.conf.5.xml @@ -308,6 +308,20 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; </para></listitem> </varlistentry> + <varlistentry><term>CompressionTypes</term> + <listitem><para>List of compression types which are understood by the acquire methods. + Files like <filename>Packages</filename> can be available in various compression formats. + This list defines in which order the acquire methods will try to download these files. + Per default <command>bzip2</command> compressed files will be prefered over + <command>lzma</command>, <command>gzip</command> and uncompressed files. The syntax for + the configuration fileentry is + <synopsis>Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> "<replaceable>Methodname</replaceable>";</synopsis> + e.g. <synopsis>Acquire::CompressionTypes::bz2 "bzip2";</synopsis> + Note that at runtime the <literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will + be checked: If this setting exists the method will only be used if this file exists, e.g. for + the bzip2 method above (the inbuilt) setting is <literallayout>Dir::Bin::bzip2 "/bin/bzip2";</literallayout> + </para></listitem> + </varlistentry> </variablelist> </para> </refsect1> @@ -342,6 +356,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; <para>Binary programs are pointed to by <literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> specifies the location of the method handlers and <literal>gzip</literal>, + <literal>bzip2</literal>, <literal>lzma</literal>, <literal>dpkg</literal>, <literal>apt-get</literal> <literal>dpkg-source</literal> <literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> specify the location of the respective programs.</para> @@ -827,7 +842,17 @@ is commented. </refsect1> <refsect1><title>Files</title> - <para><filename>/etc/apt/apt.conf</filename></para> + <variablelist> + <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> + </variablelist> </refsect1> <refsect1><title>See Also</title> |