CVS commit: pkgsrc/regress/plus_build_version

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

Module Name:    pkgsrc
Committed By:   rillig
Date:           Sat Jan 11 13:04:21 UTC 2020

Modified Files:
        pkgsrc/regress/plus_build_version: spec

Log Message:
regress/plus_build_version: document obvious uses of RCS Ids


To generate a diff of this commit:
cvs rdiff -u -r1.1 -r1.2 pkgsrc/regress/plus_build_version/spec

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

Modified files:

Index: pkgsrc/regress/plus_build_version/spec
diff -u pkgsrc/regress/plus_build_version/spec:1.1 pkgsrc/regress/plus_build_version/spec:1.2
--- pkgsrc/regress/plus_build_version/spec:1.1  Sat Jan 11 12:24:32 2020
+++ pkgsrc/regress/plus_build_version/spec      Sat Jan 11 13:04:21 2020
@@ -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.