summaryrefslogtreecommitdiff
path: root/doc/apt-cache.8.xml
diff options
context:
space:
mode:
authorDavid Kalnischkies <david@kalnischkies.de>2016-08-16 20:08:29 +0200
committerDavid Kalnischkies <david@kalnischkies.de>2016-08-17 14:12:25 +0200
commit8bd823d0a1f7e08ad94a7110bb118f73348133a1 (patch)
tree29d2b2920123653c02bded8a6f8faf66dd69e8e8 /doc/apt-cache.8.xml
parente289907f5e7241034cb0d37055dc2cba4e3a19af (diff)
add --with-source option and Packages/Sources support
We support "./foobar.deb" as a way to install a deb file directly. Recently .changes files were added. This highlights a problem as you can't add the changes file without also trying to install all of them. Now, it could also be handy to add entire Packages/Sources files to perhaps get a bunch of packages in without installing them all implicitly. This commit introduces --with-source which allows to add *.deb, *.changes, *.dsc, source-dirs, Packages & Sources files (the later can also be compressed) without also installing them.
Diffstat (limited to 'doc/apt-cache.8.xml')
-rw-r--r--doc/apt-cache.8.xml15
1 files changed, 15 insertions, 0 deletions
diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml
index 4e2de26bc..66f608b13 100644
--- a/doc/apt-cache.8.xml
+++ b/doc/apt-cache.8.xml
@@ -350,6 +350,21 @@ Reverse Provides:
Configuration Item: <literal>APT::Cache::Installed</literal>.</para></listitem>
</varlistentry>
+ <varlistentry><term><option>--with-source</option> <option>&synopsis-param-filename;</option></term>
+ <listitem><para>
+ Adds the given file as a source for metadata. Can be repeated to add multiple files.
+ Supported are currently <literal>*.deb</literal>, <literal>*.dsc</literal>,
+ <literal>*.changes</literal>, <literal>Sources</literal> and
+ <literal>Packages</literal> files as well as source package directories.
+ Files are matched based on their name only, not their content!</para>
+ <para><literal>Sources</literal> and <literal>Packages</literal> can be compressed in any
+ format apt supports as long as they have the correct extension. If you need to store
+ multiple of these files in one directory you can prefix a name of your choice with the
+ last character being an underscore ("<literal>_</literal>"). Example: my.example_Packages.xz</para>
+ <para>Note that these sources are treated as trusted (see &apt-secure;).
+ Configuration Item: <literal>APT::Sources::With</literal>.</para></listitem>
+ </varlistentry>
+
&apt-commonoptions;
</variablelist>