[pkgsrc/trunk]: pkgsrc/doc/guide doc/guide: document why autogenerated IDs ar...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/ffd25dd377ce
branches:  trunk
changeset: 411916:ffd25dd377ce
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun Feb 23 18:09:36 2020 +0000

description:
doc/guide: document why autogenerated IDs are forbidden

diffstat:

 doc/guide/Makefile |  4 +++-
 1 files changed, 3 insertions(+), 1 deletions(-)

diffs (18 lines):

diff -r 7db61b9ece74 -r ffd25dd377ce doc/guide/Makefile
--- a/doc/guide/Makefile        Sun Feb 23 18:07:10 2020 +0000
+++ b/doc/guide/Makefile        Sun Feb 23 18:09:36 2020 +0000
@@ -1,4 +1,4 @@
-# $NetBSD: Makefile,v 1.60 2020/02/23 17:43:20 rillig Exp $
+# $NetBSD: Makefile,v 1.61 2020/02/23 18:09:36 rillig Exp $
 
 DISTNAME=              pkgsrc-guide-${PKGVERSION}
 CATEGORIES=            # empty
@@ -83,6 +83,8 @@
        ${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."
+       # These IDs generate unnecessary changes to the generated files,
+       # when they are committed to pkgsrc/doc/ and htdocs.
 
 do-install:
 .if !empty(OUTPUTS:Mhtml) || !empty(OUTPUTS:Mhtml-split)