From 3b379eb79903b4313eece3a424a3c56c7412138c Mon Sep 17 00:00:00 2001
From: Jephte Clain <Jephte.Clain@univ-reunion.fr>
Date: Sat, 1 Mar 2025 19:45:00 +0400
Subject: [PATCH] maj doc

---
 bash/src/pman.conf.sh |  7 -------
 bash/src/pman.sh      |  8 ++++++++
 bin/pdev              | 10 +++++++++-
 bin/prel              | 23 ++++++++++++++++-------
 4 files changed, 33 insertions(+), 15 deletions(-)

diff --git a/bash/src/pman.conf.sh b/bash/src/pman.conf.sh
index b1aec42..c33874c 100644
--- a/bash/src/pman.conf.sh
+++ b/bash/src/pman.conf.sh
@@ -2,20 +2,13 @@
 
 ## configuration par défaut
 
-# branche upstream
 UPSTREAM=
-# branches de développement
 DEVELOP=develop
 FEATURE=wip/
-# branche de préparation de release
 RELEASE=release-
-# branche de release
 MAIN=master
 TAG_PREFIX=
 TAG_SUFFIX=
-# branche de hotfix
 HOTFIX=hotfix-
-# branche de distribution
 DIST=
-# désactiver les releases automatiques?
 NOAUTO=
diff --git a/bash/src/pman.sh b/bash/src/pman.sh
index bd80ac8..a9c4c49 100644
--- a/bash/src/pman.sh
+++ b/bash/src/pman.sh
@@ -5,15 +5,23 @@
 # les branches sont mergées dans cet ordre:
 # upstream --> develop --> [release -->] main --> dist
 #      feature _/                 hotfix _/
+
+# branche upstream
 UPSTREAM=
+# branches de développement
 DEVELOP=develop
 FEATURE=wip/
+# branche de préparation de release
 RELEASE=release-
+# branche de release
 MAIN=master
 TAG_PREFIX=
 TAG_SUFFIX=
+# branche de hotfix
 HOTFIX=hotfix-
+# branche de distribution
 DIST=
+# désactiver les releases automatiques?
 NOAUTO=
 
 CONFIG_VARS=(
diff --git a/bin/pdev b/bin/pdev
index 85106f0..6a2f5d1 100755
--- a/bin/pdev
+++ b/bin/pdev
@@ -134,7 +134,15 @@ SquashMsg=
 [ -z "$PMAN_NO_DELETE" ] && Delete=1 || Delete=
 args=(
     "fusionner la branche source dans la branche destination correspondante"
-    " [source]"
+    " [source]
+
+CONFIGURATION
+Le fichier .pman.conf contient la configuration des branches.Les variables
+supplémentaires suivantes peuvent être définies:
+    AFTER_MERGE_<srcType>
+    AFTER_DELETE_<srcType>
+    AFTER_PUSH_<destType>
+xxxType valant UPSTREAM, DEVELOP, FEATURE, RELEASE, MAIN, HOTFIX, DIST"
     -d:,--chdir:BASEDIR chdir= "répertoire dans lequel se placer avant de lancer les opérations"
     -O:,--origin Origin= "++\
 origine à partir de laquelle les branches distantes sont considérées"
diff --git a/bin/prel b/bin/prel
index 28bc0f0..30a0706 100755
--- a/bin/prel
+++ b/bin/prel
@@ -42,6 +42,9 @@ function create_release_action() {
         merge_hotfix_action "$@"; return $?
     fi
 
+    [ -n "$ManualRelease" ] && ewarn "\
+L'option --no-merge a été forcée puisque ce dépôt ne supporte pas les releases automatiques"
+
     if [ -z "$Version" -a -n "$CurrentVersion" -a -f VERSION.txt ]; then
         Version="$(<VERSION.txt)"
         Tag="$TAG_PREFIX$Version$TAG_SUFFIX"
@@ -182,7 +185,15 @@ CurrentVersion=
 ForceCreate=
 args=(
     "faire une nouvelle release à partir de la branche source"
-    " -v VERSION [source]"
+    " -v VERSION [source]
+
+CONFIGURATION
+Le fichier .pman.conf contient la configuration des branches
+
+Les variables supplémentaires suivantes peuvent être définies:
+    AFTER_CREATE_RELEASE
+    AFTER_MERGE_RELEASE
+    AFTER_PUSH_RELEASE"
     -d:,--chdir:BASEDIR chdir= "répertoire dans lequel se placer avant de lancer les opérations"
     -O:,--origin Origin= "++\
 origine à partir de laquelle les branches distantes sont considérées"
@@ -208,11 +219,11 @@ ne pas pousser les branches vers leur origine après la création de la release"
     --push Push=1 "++\
 pousser les branches vers leur origine après la création de la release.
 c'est l'option par défaut"
-    -v:,--version Version= "\
+    -v:,--version:VERSION Version= "\
 spécifier la version de la release à créer"
     -C,--current-version CurrentVersion=1 "++\
 si aucune version n'est spécifiée, prendre la version présente dans le fichier VERSION.txt"
-    -f:,--force-create ForceCreate= "\
+    -f,--force-create ForceCreate= "\
 forcer la création de la release même si le tag correspond à la version existe déjà"
 )
 parse_args "$@"; set -- "${args[@]}"
@@ -223,10 +234,8 @@ load_branches all
 load_config "$MYNAME"
 load_branches current "$1"; shift
 
-if [ -n "$Merge" -a -n "$NOAUTO" ]; then
-    ewarn "L'option --no-merge a été forcée puisque ce dépôt ne supporte pas les releases automatiques"
-    Merge=
-fi
+[ -n "$Merge" -a -n "$NOAUTO" ] && ManualRelease=1 || ManualRelease=
+[ -n "$ManualRelease" ] && Merge=
 [ -z "$Merge" ] && Push=
 
 CantPush=