(NFC) distmaker - More comments

diff --git a/distmaker/dists/common.sh b/distmaker/dists/common.sh
index 66d7970218980a26e40c1c3b40c4f6ffbeccc3c0..ad93400ce3e38ca54f06fbb046cb49b0b7d1e464 100644 (file)
--- a/distmaker/dists/common.sh
+++ b/distmaker/dists/common.sh
@@ -257,7 +257,9 @@ function dm_install_cvext() {
   cv dl -b "@https://civicrm.org/extdir/ver=$DM_VERSION|cms=Drupal/$1.xml" --to="$2"
 }
 
+## Export a list of patch files from a git repo
 ## usage: dm_export_patches <src-repo> <out-dir> <range>
+## ex: dm_export_patches "$HOME/src/somerepo" "/tmp/export" 5.1.2..5.1.6
 function dm_export_patches() {
   if [ ! -d "$1" ]; then
     echo "ignore: $1"

diff --git a/distmaker/patchset-baselines.txt b/distmaker/patchset-baselines.txt
index 8c88225718b2059cc8636d13792d00f18c6ce706..ebf6e2c9094c1fe8fbf2c2fc1fcc6fba3870aca6 100644 (file)
--- a/distmaker/patchset-baselines.txt
+++ b/distmaker/patchset-baselines.txt
@@ -1,2 +1,5 @@
-## Branch : Tag-name
+## When exporting patches for a given major-series (e.g. 5.27),
+## we use a fixed reference-point (e.g. `git log $REFPOINT..`).
+##
+## Major Series : Reference-Point (Tag/Commit)
 5.27:5.27.4