diff options
| author | David Kalnischkies <david@kalnischkies.de> | 2015-09-14 13:18:29 +0200 |
|---|---|---|
| committer | David Kalnischkies <david@kalnischkies.de> | 2015-09-14 15:22:19 +0200 |
| commit | 24e8f24e1e94ec3816b0bfc7a05d1c4e3f73248e (patch) | |
| tree | 0d40411af7333733aa11b56516a065892b6d7148 /doc/sources.list.5.xml | |
| parent | 63c7141275c8c5c0f6e60f5242785e50cabaf2a0 (diff) | |
add by-hash sources.list option and document all of by-hash
This changes the semantics of the option (which is renamed too) to be a
yes/no value with the special additional value "force" as this allows
by-hash to be disabled even if the repository indicates it would be
supported and is more in line with our other yes/no options like pdiff
which disable themselves if no support can be detected.
The feature wasn't documented so far and hasn't reached a (un)stable
release yet, so changing it without trying too hard to keep
compatibility seems okay.
Diffstat (limited to 'doc/sources.list.5.xml')
| -rw-r--r-- | doc/sources.list.5.xml | 16 |
1 files changed, 16 insertions, 0 deletions
diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml index 276e7d46f..71447e84f 100644 --- a/doc/sources.list.5.xml +++ b/doc/sources.list.5.xml @@ -239,6 +239,22 @@ deb-src [ option1=value1 option2=value2 ] uri suite [component1] [component2] [. <literal>yes</literal>. </para></listitem> + <listitem><para><option>By-Hash</option> (<option>by-hash</option>) + can have the value "yes", "no" or "force" and controls if APT + should try to acquire indexes via an URI constructed from a + hashsum of the expected file instead of using the well-known + stable filename of the index. Using this can avoid hashsum + mismatches, but requires a supporting mirror. The value + "yes"/"no" activates/disables the use of this feature if this + source indicates support for it, while "force" will enable the + feature regardless of what the source indicates. + Defaults to the value of the option of the same name for a + specific index file defined in the + <option>Acquire::IndexTargets</option> scope, which itself + defaults to the value of configuration option + <option>Acquire::By-Hash</option> which defaults to + <literal>yes</literal>. + </para></listitem> </itemizedlist> |