From fba56d4524e25094cac66f0b289e248a8ed70c5e Mon Sep 17 00:00:00 2001
From: Jeremy Harris <jgh146exb@wizmail.org>
Date: Thu, 30 Jun 2022 17:02:08 +0100
Subject: [PATCH] Docs: bug notes

---
 doc/doc-docbook/spec.xfpt | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index 93a18c846..588afe1d2 100644
--- a/doc/doc-docbook/spec.xfpt
+++ b/doc/doc-docbook/spec.xfpt
@@ -219,6 +219,8 @@
 . at the top level, so we have to put the .chapter directive first.
 
 . These do not turn up in the HTML output, unfortunately.  The PDF does get them.
+. - Worse - they introduce bugus index entries in the HTML, under the
+.  "primary term", a link to the Introduction chapter.
 . /////////////////////////////////////////////////////////////////////////////
 
 .chapter "Introduction" "CHID1"
@@ -348,6 +350,10 @@
   <primary>headers</primary>
   <see><emphasis>header lines</emphasis></see>
 </indexterm>
+. <indexterm role="concept">
+.   <primary>de-tainting</primary>
+.   <see><emphasis>tainted data</emphasis></see>
+. </indexterm>
 
 .literal off
 
-- 
2.30.2