Deployed d4abcb5 with MkDocs version: 1.6.1

reference/configuration/download/index.html

@@ -2783,12 +2783,16 @@ bitrate alone, with those same Atmos/descriptive rules still applied.</p>
 <td>At least one audio language matches.</td>
 </tr>
 <tr>
+<td><code>audio_contain_all</code></td>
+<td>Every listed language must be present in the audio.</td>
+</tr>
+<tr>
 <td><code>subs_contain</code></td>
 <td>At least one subtitle language matches.</td>
 </tr>
 <tr>
 <td><code>subs_contain_all</code></td>
-<td>Every listed language must be present.</td>
+<td>Every listed language must be present in the subtitles.</td>
 </tr>
 <tr>
 <td><code>dual</code> / <code>multi</code> / <code>dubbed</code></td>
@@ -2797,12 +2801,12 @@ bitrate alone, with those same Atmos/descriptive rules still applied.</p>
 </tbody>
 </table>
 <p>Each language condition takes one language tag or a list of them. A list matches when <strong>any</strong>
-entry matches, except <code>subs_contain_all</code>, which needs them all. An entry that is not a valid
-language tag (for example <code>japanese</code>) never matches. A tag with a region matches only that
-variant, so <code>audio: es-419</code> does not match <code>es-ES</code> audio. <code>dual</code>, <code>multi</code> and <code>dubbed</code> take a bare
-<code>true</code> or <code>false</code>, not a quoted string. unshackle skips a rule with a condition name it does
-not know, or with any other value in a boolean condition. It logs a warning in each of these
-cases and tries the next rule.</p>
+entry matches, except <code>audio_contain_all</code> and <code>subs_contain_all</code>, which need them all. An empty
+list never matches. An entry that is not a valid language tag (for example <code>japanese</code>) never
+matches. A tag with a region matches only that variant, so <code>audio: es-419</code> does not match
+<code>es-ES</code> audio. <code>dual</code>, <code>multi</code> and <code>dubbed</code> take a bare <code>true</code> or <code>false</code>, not a quoted string.
+unshackle skips a rule with a condition name it does not know, or with any other value in a
+boolean condition. It logs a warning in each of these cases and tries the next rule.</p>
 <p><code>dual</code>, <code>multi</code> and <code>dubbed</code> carry the same meaning as the
 <a href="#dual_multi_mode">filename variables of those names</a>. Pair one with a language to name a
 release yourself, in place of the fixed <code>DUAL</code>, <code>MULTi</code> and <code>DUBBED</code> text. A rule that names
@@ -2819,6 +2823,22 @@ release yourself, in place of the fixed <code>DUAL</code>, <code>MULTi</code> an
 </span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="w">      </span><span class="nt">dual</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
 </span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="w">      </span><span class="nt">tag</span><span class="p">:</span><span class="w"> </span><span class="s">"THAIDUAL"</span>
 </span></code></pre></div>
+<p>unshackle examines the rules in order, so put a rule that needs more languages before a rule that
+needs fewer. Here, a release with both French dubs gets <code>VF2</code>, not <code>VFQ</code>:</p>
+<div class="language-yaml highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nt">language_tags</span><span class="p">:</span>
+</span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="w">  </span><span class="nt">rules</span><span class="p">:</span>
+</span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">audio_contain_all</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">fr-FR</span><span class="p p-Indicator">,</span><span class="w"> </span><span class="nv">fr-CA</span><span class="p p-Indicator">]</span>
+</span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w">      </span><span class="nt">tag</span><span class="p">:</span><span class="w"> </span><span class="s">"VF2"</span>
+</span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">audio</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">fr-CA</span>
+</span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="w">      </span><span class="nt">tag</span><span class="p">:</span><span class="w"> </span><span class="s">"VFQ"</span>
+</span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="w">    </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">audio</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">fr-FR</span>
+</span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="w">      </span><span class="nt">tag</span><span class="p">:</span><span class="w"> </span><span class="s">"VFF"</span>
+</span></code></pre></div>
+<div class="admonition tip">
+<p class="admonition-title">Give regional tags in an <code>_all</code> list</p>
+<p>A tag without a region also matches a regional track, so one <code>fr-CA</code> track satisfies both
+entries of <code>[fr, fr-CA]</code>. Use <code>[fr-FR, fr-CA]</code> to require two different tracks.</p>
+</div>
 <div class="admonition note">
 <p class="admonition-title">Put <code>{lang_tag}</code> where you want the name</p>
 <p>These rules fill <code>{lang_tag}</code>. To use your own name in place of the fixed text, keep
@@ -2881,7 +2901,7 @@ release yourself, in place of the fixed <code>DUAL</code>, <code>MULTi</code> an
 </div>
 </div>
 </div>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="nt">dual_multi_mode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">strict</span>
+<div class="language-yaml highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="nt">dual_multi_mode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">strict</span>
 </span></code></pre></div>
 <div class="admonition note">
 <p class="admonition-title">Dialects count as one language</p>
@@ -2929,7 +2949,7 @@ probes the two highest and the two lowest bitrates first:</p>
 unshackle does not probe ISM tracks. Each probe makes one to three small requests: the 64 KiB
 fragment, plus the playlist of an HLS track or the header of a one-file track. The probes run in
 parallel, with no more at a time than <code>--workers</code> (or <code>dl.workers</code>) sets for a track download.</p>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="nt">hdr10plus_probe</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
+<div class="language-yaml highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="nt">hdr10plus_probe</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">true</span>
 </span></code></pre></div>
 <p>A remote server probes its tracks before it sends them, so the setting on the server applies to
 remote downloads and to the REST API.</p>
@@ -2962,7 +2982,7 @@ same peak and letterbox area. They differ in the scene average, which the TV use
 </tr>
 </tbody>
 </table>
-<div class="language-yaml highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="nt">generate_dv_mode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v29</span>
+<div class="language-yaml highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="nt">generate_dv_mode</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">v29</span>
 </span></code></pre></div>
 <p>The setting applies on the machine that runs the hybrid step: the client for a remote download, the
 server for a REST API job.</p>