apacheconfig: améliorer l'affichage de l'aide et support du répertoire .apacheconfig

apacheconfig

@@ -10,6 +10,14 @@ USAGE
     $scriptname [options]
 
 OPTIONS
+    --help-template
+        Afficher toutes les options qui concernent la gestion des templates
+    --help-files
+        Afficher une description des fichiers qui peuvent se trouver dans le
+        répertoire local
+    --help-deploy
+        Afficher l'aide sur les options avancées pour le déploiement
+
 Les options suivantes servent à mettre à jour la configuration apache dans un
 répertoire de référence appelé répertoire local, avant son déploiement.
     -d, --destdir DESTDIR
@@ -21,35 +29,62 @@ répertoire de référence appelé répertoire local, avant son déploiement.
         Copier les templates spécifiés dans le répertoire local s'il n'y
         existent pas déjà. Les templates ayant l'extension '.template' doivent
         être demandés explicitement. Sinon, ils sont ignorés.
-    -z, --unmerge
-        Supprimer les fichiers du répertoire local s'ils n'ont pas été modifiés
-        par rapport aux templates.
-    -C, --clean
-        Supprimer les répertoires vides dans le répertoire local. Peut être
-        utile après -z
-    -g, --diff
-        Afficher les différences entre les templates et les fichiers du
-        répertoire local.
-    --list-vars
-        Afficher pour information les valeurs par défaut des variables de
-        template.
-    --write-vars
-        Ecrire dans le fichier .apacheconfig les valeurs par défaut des
-        variables, ce qui permet après édition du fichier d'éviter de les
-        spécifier à chaque fois avec l'option -v
-        Le fichier n'est pas écrasé s'il existe déjà.
-    -v, --var NAME=VALUE
-        Spécifier la valeur d'une variable. Il est possible de spécifier des
-        valeurs qui ne sont pas dans la liste prédéfinie. Par défaut, il s'agit
-        d'une variable de template, utilisée pour mettre à jour la copie locale
-        d'un template avec l'option --merge
-        Dans le fichier .apacheconfig, les valeurs des variables de template
-        n'est pas censée changer. Lors de la copie des templates avec --merge,
-        chaque occurence de @@VAR@@ dans un template est remplacée dans la copie
-        locale par la valeur de la variable de template VAR
-        Les variables dynamiques sont remplacées lors du déploiement du fichier
-        avec l'option --update
 
+Les options suivantes permettent de déployer les fichiers du répertoire local.
+IMPORTANT: les fonctions de déploiement ne sont pour le moment supportées que
+sur debian
+    -u, --update, --deploy
+        Mettre à jour la configuration système à partir du répertoire local.
+        Lors du déploiement de la configuration, les valeurs de variables
+        dynamiques sont remplacées dans les fichiers destination.
+    -r, --certsdir CERTSDIR
+        Spécifier le cas échéant le répertoire contenant les certificats à
+        déployer."
+}
+function __templatectl_display_help() { display_help; }
+function display_template_help() {
+    uecho "\
+Les options suivantes servent à mettre à jour la configuration apache dans un
+répertoire de référence appelé répertoire local, avant son déploiement.
+
+-d, --destdir DESTDIR
+    Spécifier le répertoire local dans lequel copier la configuration apache.
+-l, --list
+    Lister les templates disponibles.
+-m, --merge
+    Copier les templates spécifiés dans le répertoire local s'il n'y existent
+    pas déjà. Les templates ayant l'extension '.template' doivent être demandés
+    explicitement. Sinon, ils sont ignorés.
+-z, --unmerge
+    Supprimer les fichiers du répertoire local s'ils n'ont pas été modifiés par
+    rapport aux templates.
+-C, --clean
+    Supprimer les répertoires vides dans le répertoire local. Peut être utile
+    après -z
+-g, --diff
+    Afficher les différences entre les templates et les fichiers du répertoire
+    local.
+--list-vars
+    Afficher pour information les valeurs par défaut des variables de template.
+--write-vars
+    Ecrire dans le fichier .apacheconfig les valeurs par défaut des variables,
+    ce qui permet après édition du fichier d'éviter de les spécifier à chaque
+    fois avec l'option -v
+    Le fichier n'est pas écrasé s'il existe déjà.
+-v, --var NAME=VALUE
+    Spécifier la valeur d'une variable. Il est possible de spécifier des valeurs
+    qui ne sont pas dans la liste prédéfinie. Par défaut, c'est une variable de
+    template, utilisée pour mettre à jour la copie locale d'un template avec
+    l'option --merge
+    Dans le fichier .apacheconfig, les valeurs des variables de template n'est
+    pas censée changer. Lors de la copie des templates avec --merge, chaque
+    occurence de @@VAR@@ dans un template est remplacée dans la copie locale par
+    la valeur de la variable de template VAR
+    Les variables dynamiques sont remplacées lors du déploiement du fichier avec
+    l'option --update"
+}
+function display_files_help() {
+    uecho "\
 Le répertoire local peut contenir les fichiers et répertoires suivants, qui sont
 tous optionnels:
 
@@ -83,48 +118,38 @@ tous optionnels:
   Les fichiers de ce répertoire sont de la forme NAME-certs.conf et chacun d'eux
   correspondant en principe à un fichier NAME.ssl.conf dans sites/
 - RewriteRules/ le répertoire qui contient la configuration de réécriture. Tous
-  les fichiers RewriteRules*.conf de ce répertoire sont copiés dans /etc/apache2
+  les fichiers RewriteRules*.conf de ce répertoire sont copiés dans /etc/apache2"
-
+}
-Les options suivantes permettent de déployer les fichiers du répertoire local.
+function display_deploy_help() {
-IMPORTANT: les fonctions de déploiement ne sont pour le moment supportées que
+    uecho "\
-sur debian
+Les options suivantes sont des options avancées pour le déploiment des fichiers:
-    -u, --update, --deploy
+
-        Mettre à jour la configuration système à partir du répertoire local.
+--confdir CONFDIR
-        Lors du déploiement de la configuration, les valeurs de variables
+    Spécifier l'emplacement des fichiers de configuration apache ainsi que les
-        dynamiques sont remplacées dans les fichiers destination.
+    fichiers 'modules.conf' et 'sites.conf'. Par défaut, prendre le répertoire
-    -r, --certsdir CERTSDIR
+    local.
-        Spécifier le cas échéant le répertoire contenant les certificats à
+--modulesdir MODULESDIR
-        déployer.
+    Spécifier l'emplacement des fichiers de configuration des modules. Par
-
+    défaut, utiliser DESTDIR/modules si ce répertoire existe.
-OPTIONS AVANCEES
+--sitesdir SITESDIR
-    --confdir CONFDIR
+    Spécifier l'emplacement des fichiers de configuration des sites. Par défaut,
-        Spécifier l'emplacement des fichiers de configuration apache ainsi que
+    utiliser DESTDIR/sites si ce répertoire existe.
-        les fichiers 'modules.conf' et 'sites.conf'. Par défaut, prendre le
+--cgibindir CGIBINDIR
-        répertoire local.
+    Spécifier l'emplacement des scripts cgi à installer. Par défaut, utiliser
-    --modulesdir MODULESDIR
+    DESTDIR/cgi-bin si ce répertoire existe.
-        Spécifier l'emplacement des fichiers de configuration des modules. Par
+--wwwdir WWWDIR
-        défaut, utiliser DESTDIR/modules si ce répertoire existe.
+    Spécifier l'emplacement des fichiers du serveur web. Par défaut, utiliser
-    --sitesdir SITESDIR
+    DESTDIR/www si ce répertoire existe.
-        Spécifier l'emplacement des fichiers de configuration des sites. Par
+--certsconfdir CERTSCONFDIR
-        défaut, utiliser DESTDIR/sites si ce répertoire existe.
+    Spécifier l'emplacement des fichiers de configuration des certificats. Par
-    --cgibindir CGIBINDIR
+    défaut, utiliser DESTDIR/certsconf si ce répertoire existe. Il faut alors
-        Spécifier l'emplacement des scripts cgi à installer. Par défaut,
+    spécifier aussi CERTSDIR, l'emplacement des certificats à installer.
-        utiliser DESTDIR/cgi-bin si ce répertoire existe.
+--rrdir RRDIR
-    --wwwdir WWWDIR
+    Spécifier l'emplacement des fichiers de réécriture. Par défaut, utiliser
-        Spécifier l'emplacement des fichiers du serveur web. Par défaut,
+    DESTDIR/RewriteRules si ce répertoire existe.
-        utiliser DESTDIR/www si ce répertoire existe.
+--no-restart
-    --certsconfdir CERTSCONFDIR
+    Ne pas redémarrer apache en cas de modification de la configuration"
-        Spécifier l'emplacement des fichiers de configuration des certificats.
-        Par défaut, utiliser DESTDIR/certsconf si ce répertoire existe. Il faut
-        alors spécifier aussi CERTSDIR, l'emplacement des certificats à
-        installer.
-    --rrdir RRDIR
-        Spécifier l'emplacement des fichiers de réécriture. Par défaut,
-        utiliser DESTDIR/RewriteRules si ce répertoire existe.
-    --no-restart
-        Ne pas redémarrer apache en cas de modification de la configuration"
 }
-function __templatectl_display_help() { display_help; }
 
 # Valeurs par défaut des variables de template
 DEFAULT_TEMPLATE_VARS=(
@@ -144,7 +169,7 @@ function parent_apacheconfig() {
     local dir="$(pwd)" dirname
     
     while true; do
-        dirname="$(basename -- "$dir")"
+        setx dirname=basename -- "$dir"
         if [ "$dir" == / ]; then
             # s'arrêter à la racine
             return 1
@@ -154,8 +179,11 @@ function parent_apacheconfig() {
         elif [ "$dirname" == apacheconfig ]; then
             echo "$dir"
             return 0
+        elif [ "$dirname" == .apacheconfig ]; then
+            echo "$dir"
+            return 0
         fi
-        dir="$(dirname -- "$dir")"
+        setx dir=dirname -- "$dir"
     done
 }
 
@@ -204,6 +232,9 @@ __certsconfdir=
 __rrdir=
 __restart=1
 __TEMPLATECTL_SUPPLOPTS=(
+    --help-template '$exit_with display_template_help'
+    --help-files '$exit_with display_files_help'
+    --help-deploy '$exit_with display_deploy_help'
     -v:,--var: __vars
     --list-vars __list_vars=1
     --write-vars __write_vars=1
@@ -219,8 +250,7 @@ __TEMPLATECTL_SUPPLOPTS=(
     --restart __restart=1
     --no-restart __restart=
 )
-__templatectl_parseopts "$@" && \
+__templatectl_parseopts "$@" && set -- "${args[@]}" || die "$args"
-    set -- "${args[@]}" || die "$args"
 
 # répertoire de template
 setx __templatectl_srcdir=templatesrc apacheconfig
@@ -230,6 +260,8 @@ __autocreate=
 if [ -z "$__templatectl_destdir" ]; then
     if [ -d apacheconfig ]; then
         __templatectl_destdir=apacheconfig
+    elif [ -d .apacheconfig ]; then
+        __templatectl_destdir=.apacheconfig
     elif setx __templatectl_destdir=parent_apacheconfig; then
         estepn "Sélection automatique de $(ppath "$__templatectl_destdir")"
     elif [ -e apacheconfig ]; then