aux/workflow/manpages.sh: Refactor how manpages and translations are made

I didn't like the previous version of aux/workflow/manpages.sh mainly for 2 reasons:
1. its CLI was terrible, ugly and fragile;
2. it mixed handling manpages and handling *translations*.

The first step was to split the translations part to a different file:
aux/workflow/l10n.sh.  Now it has the base logic for running po4a, and
can apply it to manpages.  It is useful for updating translated files
in other scenarios, such as catgets() message catalogs, markdown files,
etc.

After I used the venerable getopts to handle the command line
arguments, and give aux/workflow/manpages.sh a saner interface.

I disliked the fact that aux/workflow/manpages.sh still is being used
for the "install" and "uninstall" targets.  Before this file, the
canonical workflow of "make && make install/uninstall" was 100%
embedded within the Makefile itself.  But now the Makefile calls to an
external script for that.  This isn't a real cost, other than how
obvious the behaviour is for someone looking at the Makefile for the
first time.

I still chose to do it anyway, because there was already too many
things in the Makefile itself, and it was getting worse with time.  I
made sure to never cross the line of relying on an external tool for
the canonical "make && make install/uninstall", and even for
"make check".  Those all work without requiring any extra tool outside
what POSIX defines, such as "sed", "awk", etc.  Despite the cost of
adding this detour from the liner Makefile flow, I found it to be worth
it to call to the external script, as this script can now also be
shared across projects, and the customized Makefile be made simpler.

In other to remove the "-- $(do_subst)" horrendous hack, I chose to use
an inference rule for ".in" files, and remove the "$(do_subst)"
variable altogether.  Now all the files that need to go through sed
should end in ".in", and the Makefile will take care of producing it.
The upside is that this model is much better integrater into make
itself.

Addresses #task-9ee2bbc8-295f-52b7-4104-483869bad017.

1 files changed, 0 insertions, 213 deletions

diff --git a/doc/git-permalink.fr.1 b/doc/git-permalink.fr.1
deleted file mode 100644
index 3dcc01a..0000000
--- a/doc/git-permalink.fr.1
+++ /dev/null
@@ -1,213 +0,0 @@
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.TH GIT\-PERMALINK 1 @DATE@ "git\-permalink @VERSION@" "manual d'utilisateur de git\-permalink"
-
-
-.SH NOM
-
-git\-permalink \- extension Git pour génerér liens web permanent (permalink)
-de fichiers dans un dépôt.
-
-
-.SH SYNOPSIS
-
-\fBgit\-permalink\fP [\fIOPTIONS\fP] \fIFICHIER\fP [\fILINENO\fP]
-
-
-.SH DESCRIPTION
-
-\fBgit\-permalink\fP utilise Git pour prendre a) le commit au \fIHEAD\fP et b) le
-\fIremote.origin.url\fP avec \fBgit\-config\fP(1), et se possible c) un modèle de
-substituition d'URL.  Il utilise ces valeurs pour construire un URL
-\fIpermanent\fP, avec le commit inclus pour garantir la unicitè, e
-optionalement le numeró de la ligne choisi.
-
-\fBgit\-permalink\fP après utilise \fBxdg\-open\fP(1) pour ouvrir l'URL.
-
-.SH OPTIONS
-
-.TP 
-\fB\-p\fP
-Seulement imprimez le lien d'URL web dans la sortie standard (STDOUT),
-n'essayez pas de l'ouvrir avec \fBxdg\-open\fP(1) ou faire quelques choses avec
-lui.  Par défaut cela est désactivé.
-
-.TP 
-\fB\-\-help\fP, \fB\-h\fP
-Affiche message d'aide.
-
-.TP 
-\fB\-\-version\fP, \fB\-V\fP
-Imprime le numeró de version.
-
-
-.SH CONFIGURATION
-
-.SS "RÉFÉRENCES DISTANTES PRISES EN CHARGE"
-
-La liste de références distantes prises en charge est:
-
-.RS
-.IP \(bu
-git.euandreh.xyz (où git\-permalink est hébergé =p)
-.IP \(bu
-sourcehut
-.IP \(bu
-git.kernel.org
-.IP \(bu
-savannah
-.IP \(bu
-notabug
-.IP \(bu
-codeberg
-.IP \(bu
-bitbucket
-.IP \(bu
-pagure
-.IP \(bu
-gitlab
-.IP \(bu
-github
-.RE
-
-Les changements pour ajouter plus de sites d'hébergement de code sont les
-bienvenus!
-
-Regarde
-.UR https://euandreh.xyz/git\-permalink/TODOs.html#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
-#task\-cebc5298\-17ad\-5c60\-dfa5\-a25b66433a3a
-.UE
-pour les discussions et
-plus d'information.
-
-.SS MODÈLES
-
-Si vous souhaitez configurer le modèle de substitution d'URL pour un projet
-que a un références distantes que n'est pas prises en charge, vous utilize
-\fBgit\-config\fP(1).
-
-Il y a deux options de configuration disponible:
-
-.TP 
-\fBgit\-permalink.template\-file\-commit\fP
-Un modèle de substitution d'URL où le nom du \fIfichier\fP est avant, et le
-\fIcommit\fP est après.  cgit utilise cette type d'URL, comme dans:
-
-.nf
-	https://git.euandreh.xyz/fallible/tree/%s?id=%s
-.fi
-
-Dans cet example, le nom du \fIfichier\fP est avant et le \fIcommit\fP est à la
-fin, après le "id=".
-
-.TP 
-\fBgit\-permalink.template\-commit\-file\fP
-Un modèle de substitution d'URL où le \fIcommit\fP est avant, et le nom du
-\fIfichier\fP est après.  sourcehut utilise cette type d'URL, comme dans:
-
-.nf
-	https://git.sr.ht/~sircmpwn/scdoc/tree/%s/item/%s
-.fi
-
-Dans cet example, le \fIcommit\fP est avant dans le chemin de l'URL, et le
-\fIfichier\fP est après.
-
-.P
-Si aucune options n'est pas trouvé par \fBgit\-config\fP(1) et \fBgit\-permalink\fP
-ne peut pas deviner l'URL, cela se termine par une erreur.
-
-
-.SH EXAMPLES
-
-Ouvrez \fIsrc/fold.c\fP d'un projet qui a de référence distante pointée a
-\fIsourcehut\fP:
-
-.nf
-	$ git permalink src/fold.c 125
-	Ouverture de https://git.sr.ht/~sircmpwn/ctools/tree/fbf17d92f5ed1c38983f73df912f051ad0f9ef2d/item/src/fold.c#L125
-.fi
-
-Géneréz un lien des lignes 59 à 94 de \fInongnu/packages/clojure.scm\fP dans un
-projet hébergér sur \fIgitlab\fP, mais seulement imprimez le lien \fIsans\fP
-l'ouvrir avec \fBxdg\-open\fP(1):
-
-.nf
-	$ git permalink \-p nongnu/packages/clojure.scm 59\-94
-	https://gitlab.com/nonguix/nonguix/\-/blob/c9d7f30bcbd3a6e3076e56a972c33963c73c4d58/nongnu/packages/clojure.scm#L59\-94
-.fi
-
-.P
-Configurez un modèle de substitution d'URL, et ouvrir le fichier
-\fIsrc/app_add.c\fP sans choisir un numeró de ligne:
-
-.nf
-	$ git config git\-permalink.template\-file\-commit 'https://git.alpinelinux.org/apk\-tools/tree/%s?id=%s'
-	$ git permalink src/app_add.c
-	Ouverture de https://git.alpinelinux.org/apk\-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3
-.fi
-
-.P
-Ouvrez \fI\-\-help\fP:
-
-.nf
-	$ git permalink \-\- \-\-help
-	Ouverture de https://git.euandreh.xyz/non\-existent\-repository/tree/\-\-help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e
-.fi
-
-.SH "CODES DE SORTIE"
-
-.TP 
-\fB0\fP
-Exécution réussie.
-
-.TP 
-\fB1\fP
-Références distante non prise en charge.  Voir la liste de références prises
-en charge dans RÉFÉRENCES DISTANTES PRISE EN CHARGE, et comme ajouter un à
-partir d'un modèles dans MODÈLES.
-
-.TP 
-\fB2\fP
-Arguments invalides.
-
-
-.SH "VOIR AUSSI"
-
-\fBgit\-config\fP(1)  \fBxdg\-open\fP(1)
-
-
-.SH AUTEURS
-
-.MT eu@euandre.org
-EuAndreh
-.ME
-et les contributeurs.
-
-
-.SH BUGS
-
-.IP \(bu
-Soumettre un bogue dans la
-.MT ~euandreh/public\-inbox@lists.sr.ht
-liste
-de diffusion
-.ME .
-Utilise le sujèt "\f(CR[git\-permalink] BUG ou TASK:
-<description>\fR".
-.IP \(bu
-Parcourir les bogues
-.UR https://euandreh.xyz/git\-permalink/TODOs.html
-en
-ligne
-.UE .
-.IP \(bu
-.UR https://euandreh.xyz/git\-permalink/
-Page d'accueil
-.UE .
-.IP \(bu
-.UR https://lists.sr.ht/~euandreh/public\-inbox?search=%5Bgit\-permalink%5D
-Commentaires et discussions
-.UE .