[pkgsrc/trunk]: pkgsrc/regress/plus_build_version regress/plus_build_version:...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/08b9b583f03b
branches:  trunk
changeset: 347444:08b9b583f03b
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sat Jan 11 13:04:21 2020 +0000

description:
regress/plus_build_version: document obvious uses of RCS Ids

diffstat:

 regress/plus_build_version/spec |  24 +++++++++++++++++++-----
 1 files changed, 19 insertions(+), 5 deletions(-)

diffs (38 lines):

diff -r 61a0bdb67a97 -r 08b9b583f03b regress/plus_build_version/spec
--- a/regress/plus_build_version/spec   Sat Jan 11 12:41:51 2020 +0000
+++ b/regress/plus_build_version/spec   Sat Jan 11 13:04:21 2020 +0000
@@ -1,15 +1,29 @@
 #! /bin/sh
-# $NetBSD: spec,v 1.1 2020/01/11 12:24:32 rillig Exp $
+# $NetBSD: spec,v 1.2 2020/01/11 13:04:21 rillig Exp $
 
 # This test demonstrates how the RCS Ids from the package files end up in
 # the +BUILD_VERSION file of the binary package.
 #
 # There are several places in pkgsrc that make use of these RCS Ids:
 #
-# * The SHA1 hash for a patch file ignores RCS Id lines.
-# * The RCS Ids end up in the +BUILD_VERSION of the binary package.
-# * The pbulk checks the RCS Ids to see whether the package needs to be
-#   built again.
+# mk/checksum/checksum, search for "NetBSD":
+#      When computing the SHA1 hash for a patch file (before it is applied
+#      to the extracted distfile), the RCS Id lines are ignored.
+#
+# mk/checksum/distinfo.awk, function patchsum:
+#      When generating the patches part of the distinfo file.
+#      Same as in mk/checksum/checksum.
+#
+# mk/pkgformat/pkg/metadata.mk, search for "NetBSD":
+#      The RCS Ids end up in the +BUILD_VERSION of the binary package.
+#
+# pkgtools/pbulk/files/pbulk/scripts/pkg-up-to-date, search for "NetBSD":
+#      RCS Ids from the source package are extracted and then compared
+#      to the RCS Ids from the binary package, to see whether the package
+#      needs to be built again.
+#
+# pkgtools/pkglint/files/distinfo.go, function computePatchSha1Hex:
+#      Same as mk/checksum/checksum.
 #
 # All these places must use the same patterns for extracting the RCS Ids.
 # As of January 2020, they don't.