docs update

tf/about/annotate.html

@@ -298,7 +298,7 @@ <h3 id="recommended-practice">Recommended practice</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/annotate.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/annotate.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/annotate.md

tf/about/annotateBrowser.html

@@ -267,7 +267,7 @@ <h1 id="programming">Programming</h1>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/annotateBrowser.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/annotateBrowser.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/annotateBrowser.md

tf/about/apps.html

@@ -115,7 +115,7 @@ <h3 id="two-contexts">Two contexts</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/apps.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/apps.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/apps.md

tf/about/background.html

@@ -155,7 +155,7 @@ <h2 id="history">History</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/background.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/background.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/background.md

tf/about/browser.html

@@ -174,7 +174,7 @@ <h3 id="unicode-in-excel-csvs">UNICODE in Excel CSVs</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/browser.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/browser.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/browser.md

tf/about/clientmanual.html

@@ -565,7 +565,7 @@ <h1 id="credits">Credits</h1>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/clientmanual.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/clientmanual.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/clientmanual.md

tf/about/code.html

@@ -98,7 +98,7 @@ <h2 id="writing">Writing</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/code.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/code.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/code.md

tf/about/corpora.html

@@ -351,7 +351,7 @@ <h3 id="extra-data">Extra data</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/corpora.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/corpora.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/corpora.md

tf/about/datamodel.html

@@ -265,7 +265,7 @@ <h2 id="serializing-and-pre-computing">Serializing and pre-computing</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/datamodel.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/datamodel.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/datamodel.md

tf/about/datasharing.html

@@ -362,7 +362,7 @@ <h3 id="more-modules-at-the-same-time">More modules at the same time</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/datasharing.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/datasharing.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/datasharing.md

tf/about/displaydesign.html

@@ -151,7 +151,7 @@ <h3 id="output">Output</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/displaydesign.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/displaydesign.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/displaydesign.md

tf/about/faq.html

@@ -161,7 +161,7 @@ <h3 id="github-rate-limit-exceeded">GitHub Rate Limit Exceeded!</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/faq.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/faq.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/faq.md

tf/about/fileformats.html

@@ -158,7 +158,7 @@ <h3 id="single-values">Single values</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/fileformats.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/fileformats.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/fileformats.md

tf/about/index.html

@@ -33,7 +33,7 @@ <h1 id="documents">Documents</h1>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/__init__.py#L1-L5" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/__init__.py#L1-L5" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 # Documents

tf/about/install.html

@@ -108,7 +108,7 @@ <h4 id="note-for-linux-users">Note for Linux users</h4>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/install.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/install.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/install.md

tf/about/manual.html

@@ -390,7 +390,7 @@ <h2 id="keyboard-shortcuts">Keyboard shortcuts</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/manual.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/manual.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/manual.md

tf/about/optimizations.html

@@ -187,7 +187,7 @@ <h3 id="edge-features">Edge features</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/optimizations.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/optimizations.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/optimizations.md

tf/about/releases.html

@@ -43,6 +43,18 @@ <h1 id="release-notes">Release notes</h1>
 </code></pre>
 <h2 id="12">12</h2>
 <h3 id="124">12.4</h3>
+<h4 id="1245">12.4.5</h4>
+<p>2024-05-13</p>
+<p>Fix in the autodownload by TF.
+When TF downloads the <code>complete.zip</code> of a corpus and extracts it, it does not remove
+previously exisiting files in the directories in which the data files land.
+That pre-existing material can interfere in surprising ways with the resulting dataset,
+as Christian Højgaard experienced (thanks Christian for reporting it and taking
+the time to help me pinpoint the culprit).</p>
+<p>The fix is that TF first inspects the <code>complete.zip</code> and determines what the
+folders are in which the file <code>__checkout__.txt</code> exists. These are the folders
+that do not tolerate pre-existing material. The will be deleted before extracting the
+zip file.</p>
 <h4 id="12434">12.4.3,4</h4>
 <p>2024-05-08</p>
 <ul>
@@ -396,7 +408,7 @@ <h2 id="older-releases">Older releases</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/releases.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/releases.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/releases.md
@@ -470,6 +482,7 @@ <h1>Index</h1>
 <li><a href="#release-notes">Release notes</a><ul>
 <li><a href="#12">12</a><ul>
 <li><a href="#124">12.4</a><ul>
+<li><a href="#1245">12.4.5</a></li>
 <li><a href="#12434">12.4.3,4</a></li>
 <li><a href="#1242">12.4.2</a></li>
 <li><a href="#1241">12.4.1</a></li>

tf/about/releasesold.html

@@ -3430,7 +3430,7 @@ <h5 id="changed">Changed</h5>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/releasesold.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/releasesold.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/releasesold.md

tf/about/searchdesign.html

@@ -477,7 +477,7 @@ <h3 id="small-first-strategy">Small-first strategy</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/searchdesign.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/searchdesign.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/searchdesign.md

tf/about/searchusage.html

@@ -776,7 +776,7 @@ <h5 id="implementation">Implementation</h5>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/searchusage.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/searchusage.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/searchusage.md

tf/about/tests.html

@@ -71,7 +71,7 @@ <h2 id="relations">Relations</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/tests.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/tests.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/tests.md

tf/about/use.html

@@ -90,7 +90,7 @@ <h2 id="tf-api">TF API</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/use.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/use.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/use.md

tf/about/usefunc.html

@@ -419,7 +419,7 @@ <h2 id="prevent-data-loading">Prevent data loading</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/usefunc.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/usefunc.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/usefunc.md

tf/about/variants.html

@@ -438,7 +438,7 @@ <h3 id="the-stack">The stack</h3>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/variants.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/variants.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/variants.md

tf/about/volumes.html

@@ -323,7 +323,7 @@ <h2 id="reflection">Reflection</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/about/volumes.py#L1-L3" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/about/volumes.py#L1-L3" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 .. include:: ../docs/about/volumes.md

tf/advanced/annotate.html

@@ -34,7 +34,7 @@ <h1 class="title">Module <code>tf.advanced.annotate</code></h1>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/advanced/annotate.py#L1-L26" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/advanced/annotate.py#L1-L26" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">&#34;&#34;&#34;
 Enable manual annotation APIs.
@@ -84,7 +84,7 @@ <h2 id="parameters">Parameters</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/advanced/annotate.py#L17-L26" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/advanced/annotate.py#L17-L26" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">def annotateApi(app):
     &#34;&#34;&#34;Produce the interchange functions API.
@@ -106,7 +106,7 @@ <h2 id="parameters">Parameters</h2>
 <details class="source">
 <summary>
 <span>Expand source code</span>
-<a href="https://github.com/annotation/text-fabric/blob/81c7208eecee1adac51470e747edd3781135e950/tf/advanced/annotate.py#L13-L14" class="git-link">Browse git</a>
+<a href="https://github.com/annotation/text-fabric/blob/703d3977ff845baafe67bbbaa3a678e8deb2b911/tf/advanced/annotate.py#L13-L14" class="git-link">Browse git</a>
 </summary>
 <pre><code class="python">def makeNer(app):
     return NER(app)</code></pre>