@@ -353,7 +353,8 @@ OPTS=$( getopt -l no-db-update,\

                   conf:,\

                   database:,\

                   progrès-génération:\

-                  progrès-update: \

+                  progrès-update:,\

+                  help \

                   -- "$@" )

 eval set --$OPTS

@@ -361,47 +362,61 @@ eval set --$OPTS

 while [[ $# -gt 0 ]]; do

     case "$1" in

         "--no-db-update")

+#|ne met pas à jour la base de données

             no_db_update=$true_flag;;

         "--db-update-only")

+#|ne génère pas de fichier de résultat

             db_update_only=$true_flag;;

         "--cible")

+#<nom court du groupe>|génère un comparatif pour ce groupe (par défaut LREM)

             groupe="${2^^}"

             shift;;

         "--ref")

+#<nom court du groupe>|compare avec ce groupe (par défaut GDR)

             groupe_ref="${2^^}"

             shift;;

         "--député")

+#<nom>|filtre la cible sur un-e député-e sur le groupe cible (par défaut LREM). <nom> est insensible à la casse. Tout ou partie du nom ou du prénom peut être donné, espace compris. Caractère % utilisé comme caractère joker. Si aucune correspondance n'est trouvée avec un-e député-é, sortie en erreur. Si plusieurs député-e-s correspondent la liste est affichée et sortie en erreur.

             depute=$true_flag

             nom="$2"

             shift;;

         "--premier-scrutin")

+#<numéro>|commence la génération du résultat à partir du scrutin <numéro>

             no_db_update=$true_flag

             first="$2"

             shift;;

         "--dernier-scrutin")

+#<numéro>|termine la génération du résultat au scrutin <numéro>

             no_db_update=$true_flag

             last="$2"

             shift;;

         "--période")

+#<jj/mm/aaaa:JJ/MM/AAAA>|génère un résultat pour les scrutins allant de jj/mm/aaaa à JJ/MM/AAAA

             periode=$true_flag

             no_db_update=$true_flag

             periode_value="$2"

             shift;;

         "--liste-députés-du-groupe")

+#<nom court du groupe>|liste les député-e-s du groupe <nom court du groupe> sur la mandature

             liste_deputes=$true_flag

             liste_deputes_value="${2^^}"

             shift;;

         "--liste-députés")

+#|liste tou-te-s les député-e-s de la mandature

             liste_deputes=$true_flag;;

         "--liste-dossiers")

+#|affiche une liste numérotée des dossiers et sort

             liste_dossiers=$true_flag;;

         "--dossier")

+#<numéro>|génère un résultat pour le dossier numéroté <numéro>

             dossier=$true_flag

             dossier_value="$2"

             shift;;

         "--dossiers")

+#|sélection interactive du dossier

             dossier=$true_flag;;

         "--conf")

+#<fichier>|indique le chemin vers le fichier de configuration. Par défaut "{_}.conf"

             test -r "$2" || {

                 echo "config introuvable $2" >&2

                 options_error=$true_flag

@@ -409,6 +424,7 @@ while [[ $# -gt 0 ]]; do

             config_file="$2"

             shift;;

         "--database")

+#<fichier>|indique le chemin vers la base de données SQLite3 contenant les informations. Par défaut "{_}.db"

             test -r "$2" && file -b "$2" | grep -q '^SQLite 3.x database' || {

                 echo "erreur sur option database: fichier '$2' introuvable ou pas une base SQLite 3" >&2

                 options_error=$true_flag

@@ -416,11 +432,23 @@ while [[ $# -gt 0 ]]; do

             database="$2"

             shift;;

         "--progrès-génération")

+#<chiffre>|affiche de la progression de la génération du fichier tous les <chiffre>%. Par défaut 5

             generation_progress="$2"

             shift;;

         "--progrès-update")

+#<chiffre>|affiche de la progression de la mise à jour de la base de données tous les <chiffre>%. Par défaut 1

             update_progress="$2"

             shift;;

+        "--help")

+#|affiche cette aide et quitte

+            echo "$0 [options]"

+            echo "génère un classeur ODS pour comparer les scrutins publics de la 15ème mandature à l'Assemblée Nationale"

+            echo

+            sed -rn '/^ *"--.+"\)/N; s/^ *"(--.+)"\)\n#(.+)$/\1|\2/p' "$0" \

+                | awk -F'|' -v marge='  ' -v prog="$0" '{

+                    printf("%s %s\n" marge "%s\n\n", $1, $2, gensub("\\. ", "\\\n" marge, "g", gensub("\\{_\\}", prog, "g", $3)))

+                }'

+            exit;;

     esac

     shift

 done