CVS commit: pkgsrc/doc/guide

["Roland Illig" <rillig%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   rillig
Date:           Sun Feb 23 17:43:20 UTC 2020

Modified Files:
        pkgsrc/doc/guide: Makefile
        pkgsrc/doc/guide/files: devfaq.xml

Log Message:
doc/guide: fix autogenerated HTML IDs


To generate a diff of this commit:
cvs rdiff -u -r1.59 -r1.60 pkgsrc/doc/guide/Makefile
cvs rdiff -u -r1.14 -r1.15 pkgsrc/doc/guide/files/devfaq.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/doc/guide/Makefile
diff -u pkgsrc/doc/guide/Makefile:1.59 pkgsrc/doc/guide/Makefile:1.60
--- pkgsrc/doc/guide/Makefile:1.59      Mon Jan  6 21:34:31 2020
+++ pkgsrc/doc/guide/Makefile   Sun Feb 23 17:43:20 2020
@@ -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 @@ do-build:
 
 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)

Index: pkgsrc/doc/guide/files/devfaq.xml
diff -u pkgsrc/doc/guide/files/devfaq.xml:1.14 pkgsrc/doc/guide/files/devfaq.xml:1.15
--- pkgsrc/doc/guide/files/devfaq.xml:1.14      Sat Jun 11 18:14:42 2016
+++ pkgsrc/doc/guide/files/devfaq.xml   Sun Feb 23 17:43:20 2020
@@ -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>