Corrected Sphinx reference and the preserved missing-target warning
HTML for this example
Select the code and use your copy shortcut. Changes in this preview are temporary.
<!doctype html><html lang="en"><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Sphinx: corrected target and observed warning</title><style>*{box-sizing:border-box}body{font:16px/1.65 system-ui;color:#26384a;margin:0;padding:20px;max-width:950px}h1{font-size:27px;line-height:1.2}h2{font-size:22px}pre{white-space:pre-wrap;overflow-wrap:anywhere;padding:12px;background:#f2f5f8}svg{max-width:100%;height:auto}table{border-collapse:collapse;width:100%}th,td{padding:8px;text-align:left;border-bottom:1px solid #ccd5dd}a{color:#1f5f98}</style><h1>Sphinx: corrected target and observed warning</h1><p>Fictional document handoff. Reading copy; no work is submitted or saved.</p><p>Actual Sphinx 8.1.3 generated excerpt. A separate bad build failed on missing-packing.</p><section id="document-handoff">
<h1>Document handoff<a class="headerlink" href="#document-handoff" title="Link to this heading">¶</a></h1>
<p>See <a class="reference internal" href="#packing"><span class="std std-ref">Packing</span></a> before sending the package.</p>
</section>
<section id="packing">
<span id="id1"></span><h1>Packing<a class="headerlink" href="#packing" title="Link to this heading">¶</a></h1>
<p>Retain the source record with the package.</p>
</section>
<h2>Actual failed-reference message</h2><pre>WARNING: undefined label: 'missing-packing' [ref.ref]
Actual failed-build exit code: 1</pre><p>The complete native build log remains in the source archive.</p></html>