[pkgsrc/trunk]: pkgsrc/doc/guide doc/guide: fix autogenerated HTML IDs

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/dbf3c3fbe865
branches:  trunk
changeset: 411914:dbf3c3fbe865
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun Feb 23 17:43:20 2020 +0000

description:
doc/guide: fix autogenerated HTML IDs

diffstat:

 doc/guide/Makefile         |   5 ++++-
 doc/guide/files/devfaq.xml |  24 ++++++++++++------------
 2 files changed, 16 insertions(+), 13 deletions(-)

diffs (115 lines):

diff -r 009ea750997a -r dbf3c3fbe865 doc/guide/Makefile
--- a/doc/guide/Makefile        Sun Feb 23 17:29:31 2020 +0000
+++ b/doc/guide/Makefile        Sun Feb 23 17:43:20 2020 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.59 2020/01/06 21:34:31 leot Exp $
+# $NetBSD: Makefile,v 1.60 2020/02/23 17:43:20 rillig Exp $
 
 DISTNAME=              pkgsrc-guide-${PKGVERSION}
 CATEGORIES=            # empty
@@ -80,6 +80,9 @@
 
 post-build:
        @${RM} -f ${WRKSRC}/pkgsrc.tmp.html
+       ${RUN} cd ${WRKSRC};                                            \
+       ${GREP} 'idm[0-9][0-9][0-9][0-9][0-9]' ./*.html || exit 0;      \
+       ${FAIL_MSG} "[post-build] HTML files contain generated IDs."
 
 do-install:
 .if !empty(OUTPUTS:Mhtml) || !empty(OUTPUTS:Mhtml-split)
diff -r 009ea750997a -r dbf3c3fbe865 doc/guide/files/devfaq.xml
--- a/doc/guide/files/devfaq.xml        Sun Feb 23 17:29:31 2020 +0000
+++ b/doc/guide/files/devfaq.xml        Sun Feb 23 17:43:20 2020 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: devfaq.xml,v 1.14 2016/06/11 18:14:42 rillig Exp $ -->
+<!-- $NetBSD: devfaq.xml,v 1.15 2020/02/23 17:43:20 rillig Exp $ -->
 
 <chapter id="devfaq"> <?dbhtml filename="devfaq.html"?>
 <title>Frequently Asked Questions</title>
@@ -9,10 +9,10 @@
        and if you still don't have the answer, ask on the
        <literal>pkgsrc-users</literal> mailing list.</para>
 
-<qandaset>
+<qandaset id="devfaq.qandaset">
 <qandaentry id="devfaq.makeflags">
 
-       <question><para>What is the difference between
+       <question id="devfaq.makeflags.q"><para>What is the difference between
        <varname>MAKEFLAGS</varname>, <varname>.MAKEFLAGS</varname> and
        <varname>MAKE_FLAGS</varname>?</para></question>
 
@@ -25,7 +25,7 @@
 </qandaentry>
 <qandaentry id="devfaq.make">
 
-       <question><para>What is the difference between
+       <question id="devfaq.make.q"><para>What is the difference between
        <varname>MAKE</varname>, <varname>GMAKE</varname> and
        <varname>MAKE_PROGRAM</varname>?</para></question>
 
@@ -40,7 +40,7 @@
 </qandaentry>
 <qandaentry id="devfaq.cc">
 
-       <question><para>What is the difference between
+       <question id="devfaq.cc.q"><para>What is the difference between
        <varname>CC</varname>, <varname>PKG_CC</varname> and
        <varname>PKGSRC_COMPILER</varname>?</para></question>
 
@@ -55,7 +55,7 @@
 </qandaentry>
 <qandaentry id="devfaq.bl3flags">
 
-       <question><para>What is the difference between
+       <question id="devfaq.bl3flags.q"><para>What is the difference between
        <varname>BUILDLINK_LDFLAGS</varname>,
        <varname>BUILDLINK_LDADD</varname> and
        <varname>BUILDLINK_LIBS</varname>?</para></question>
@@ -65,7 +65,7 @@
 </qandaentry>
 <qandaentry id="devfaq.bl3prefix">
 
-       <question><para>Why does <command>make show-var
+       <question id="devfaq.bl3prefix.q"><para>Why does <command>make show-var
        VARNAME=BUILDLINK_PREFIX.<replaceable>foo</replaceable></command>
        say it's empty?</para></question>
 
@@ -78,7 +78,7 @@
 </qandaentry>
 <qandaentry id="devfaq.master_sites">
 
-       <question><para>What does
+       <question id="devfaq.master_sites.q"><para>What does
        <code>${MASTER_SITE_SOURCEFORGE:=package/}</code> mean? I
        don't understand the <code>:=</code> inside
        it.</para></question>
@@ -99,7 +99,7 @@
 </qandaentry>
 <qandaentry id="devfaq.mailinglists">
 
-       <question><para>Which mailing lists are there for package
+       <question id="devfaq.mailinglists.q"><para>Which mailing lists are there for package
        developers?</para></question>
 
        <answer><variablelist>
@@ -128,7 +128,7 @@
 </qandaentry>
 <qandaentry id="devfaq.documentation">
 
-       <question><para>Where is the pkgsrc
+       <question id="devfaq.documentation.q"><para>Where is the pkgsrc
        documentation?</para></question>
 
        <answer><para>There are many places where you can find
@@ -181,8 +181,8 @@
 </qandaentry>
 
 <qandaentry id="devfaq.too-much-time">
-<question><para>I have a little time to kill.  What shall I
-do?</para></question>
+<question id="devfaq.too-much-time.q"><para>I have a little time to kill. 
+What shall I do?</para></question>
 
 <answer><para>This is not really an FAQ yet, but here's the answer
 anyway.</para>