doc/git-permalink.*.1: Add `EXIT STATUS` section; mention `STDOUT` in `-p` option

7 files changed, 256 insertions, 56 deletions

diff --git a/doc/eo.po b/doc/eo.po
index 9e7864a..cc6cc56 100644
--- a/doc/eo.po
+++ b/doc/eo.po
@@ -6,8 +6,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2021-06-19 10:19-0300\n"
-"PO-Revision-Date: 2021-06-19 10:19-0300\n"
+"POT-Creation-Date: 2021-06-21 14:44-0300\n"
+"PO-Revision-Date: 2021-06-21 15:05-0300\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: eo\n"
@@ -107,11 +107,11 @@ msgstr "B<-p>"
 #. type: Plain text
 #: doc/git-permalink.en.1:27
 msgid ""
-"Only print the web URL link, don't try to open it with B<xdg-open>(1) or do "
-"anything else.  By default this is turned off."
+"Only print the web URL link to STDOUT, don't try to open it with B<xdg-"
+"open>(1) or do anything else.  By default this is turned off."
 msgstr ""
-"Nur presas la ligon, ne provas malfermi ĝin kun B<xdg-open>(1) aŭ fari ion "
-"alian.  Defaŭlte ĉi tio estas malŝaltita."
+"Nur presas la ligon per norma eligo (STDOUT), ne provas malfermi ĝin kun "
+"B<xdg-open>(1) aŭ fari ion alian.  Defaŭlte ĉi tio estas malŝaltita."
 
 #. type: TP
 #: doc/git-permalink.en.1:28
@@ -241,8 +241,8 @@ msgstr "La nunaj subtenitaj remotoj estas:"
 #: doc/git-permalink.en.1:82 doc/git-permalink.en.1:84
 #: doc/git-permalink.en.1:86 doc/git-permalink.en.1:88
 #: doc/git-permalink.en.1:90 doc/git-permalink.en.1:92
-#: doc/git-permalink.en.1:147 doc/git-permalink.en.1:154
-#: doc/git-permalink.en.1:159 doc/git-permalink.en.1:163
+#: doc/git-permalink.en.1:163 doc/git-permalink.en.1:170
+#: doc/git-permalink.en.1:175 doc/git-permalink.en.1:179
 #, no-wrap
 msgid "\\(bu"
 msgstr "\\(bu"
@@ -381,33 +381,76 @@ msgstr ""
 #. type: SH
 #: doc/git-permalink.en.1:131
 #, no-wrap
+msgid "EXIT STATUS"
+msgstr "ELIRKODOJ"
+
+#. type: TP
+#: doc/git-permalink.en.1:133
+#, no-wrap
+msgid "B<0>"
+msgstr "B<0>"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:136
+msgid "Successful execution."
+msgstr "Bona ekzekuto."
+
+#. type: TP
+#: doc/git-permalink.en.1:137
+#, no-wrap
+msgid "B<1>"
+msgstr "B<1>"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:141
+msgid ""
+"Unsupported remote.  See the supported list in SUPPORTED REMOTES, and how to "
+"add custom ones in OVERRIDES."
+msgstr ""
+"Nesubtenita remoto.  Vidu la subtenitoj en SUBTENITAJ REMOTOJ, kaŭ kiel "
+"aldoni ion en SUPERREGOJ."
+
+#. type: TP
+#: doc/git-permalink.en.1:142
+#, no-wrap
+msgid "B<2>"
+msgstr "B<2>"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:145
+msgid "Invalid arguments."
+msgstr "Malvalidaj argumentoj."
+
+#. type: SH
+#: doc/git-permalink.en.1:147
+#, no-wrap
 msgid "SEE ALSO"
 msgstr "VIDU ANKAŬ"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:135
+#: doc/git-permalink.en.1:151
 msgid "B<git-config>(1)  B<xdg-open>(1)"
 msgstr "B<git-config>(1)  B<xdg-open>(1)"
 
 #. type: SH
-#: doc/git-permalink.en.1:137
+#: doc/git-permalink.en.1:153
 #, no-wrap
 msgid "AUTHORS"
 msgstr "AŬTOROJ"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:143
+#: doc/git-permalink.en.1:159
 msgid "E<.MT eu@euandre.org> EuAndreh E<.ME> and contributors."
 msgstr "E<.MT eu@euandre.org> EuAndreh E<.ME> kaj la kontribuuloj."
 
 #. type: SH
-#: doc/git-permalink.en.1:145
+#: doc/git-permalink.en.1:161
 #, no-wrap
 msgid "BUGS"
 msgstr "MISFUNKCIOJ"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:154
+#: doc/git-permalink.en.1:170
 msgid ""
 "Report bugs to the E<.MT ~euandreh/public-inbox@lists.sr.ht> mailing list E<."
 "ME .> Use the subject \"\\f(CR[git-permalink] BUG or TASK: "
@@ -418,7 +461,7 @@ msgstr ""
 "E<lt>priskriboE<gt>\\fR\"."
 
 #. type: Plain text
-#: doc/git-permalink.en.1:159
+#: doc/git-permalink.en.1:175
 msgid ""
 "Browse bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<."
 "UE .>"
@@ -427,12 +470,12 @@ msgstr ""
 "rete E<.UE .>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:163
+#: doc/git-permalink.en.1:179
 msgid "E<.UR https://euandreh.xyz/git-permalink/> Homepage E<.UE .>"
 msgstr "E<.UR https://euandreh.xyz/git-permalink/> Ĉefpaĝo E<.UE .>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:166
+#: doc/git-permalink.en.1:182
 msgid ""
 "E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> "
 "Comments and discussions E<.UE .>"
diff --git a/doc/fr.po b/doc/fr.po
index 22a05ee..45599cd 100644
--- a/doc/fr.po
+++ b/doc/fr.po
@@ -6,8 +6,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2021-06-19 10:19-0300\n"
-"PO-Revision-Date: 2021-06-19 10:20-0300\n"
+"POT-Creation-Date: 2021-06-21 14:44-0300\n"
+"PO-Revision-Date: 2021-06-21 14:56-0300\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: fr\n"
@@ -107,11 +107,12 @@ msgstr "B<-p>"
 #. type: Plain text
 #: doc/git-permalink.en.1:27
 msgid ""
-"Only print the web URL link, don't try to open it with B<xdg-open>(1) or do "
-"anything else.  By default this is turned off."
+"Only print the web URL link to STDOUT, don't try to open it with B<xdg-"
+"open>(1) or do anything else.  By default this is turned off."
 msgstr ""
-"Seulement imprimez le lien d'URL web, n'essayez pas de l'ouvrir avec B<xdg-"
-"open>(1) ou faire quelques choses avec lui.  Par défaut cela est désactivé."
+"Seulement imprimez le lien d'URL web dans la sortie standard (STDOUT), "
+"n'essayez pas de l'ouvrir avec B<xdg-open>(1) ou faire quelques choses avec "
+"lui.  Par défaut cela est désactivé."
 
 #. type: TP
 #: doc/git-permalink.en.1:28
@@ -242,8 +243,8 @@ msgstr "La liste de références distantes prises en charge est:"
 #: doc/git-permalink.en.1:82 doc/git-permalink.en.1:84
 #: doc/git-permalink.en.1:86 doc/git-permalink.en.1:88
 #: doc/git-permalink.en.1:90 doc/git-permalink.en.1:92
-#: doc/git-permalink.en.1:147 doc/git-permalink.en.1:154
-#: doc/git-permalink.en.1:159 doc/git-permalink.en.1:163
+#: doc/git-permalink.en.1:163 doc/git-permalink.en.1:170
+#: doc/git-permalink.en.1:175 doc/git-permalink.en.1:179
 #, no-wrap
 msgid "\\(bu"
 msgstr "\\(bu"
@@ -385,33 +386,77 @@ msgstr ""
 #. type: SH
 #: doc/git-permalink.en.1:131
 #, no-wrap
+msgid "EXIT STATUS"
+msgstr "CODES DE SORTIE"
+
+#. type: TP
+#: doc/git-permalink.en.1:133
+#, no-wrap
+msgid "B<0>"
+msgstr "B<0>"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:136
+msgid "Successful execution."
+msgstr "Exécution réussie."
+
+#. type: TP
+#: doc/git-permalink.en.1:137
+#, no-wrap
+msgid "B<1>"
+msgstr "B<1>"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:141
+msgid ""
+"Unsupported remote.  See the supported list in SUPPORTED REMOTES, and how to "
+"add custom ones in OVERRIDES."
+msgstr ""
+"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."
+
+#. type: TP
+#: doc/git-permalink.en.1:142
+#, no-wrap
+msgid "B<2>"
+msgstr "B<2>"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:145
+msgid "Invalid arguments."
+msgstr "Arguments invalides."
+
+#. type: SH
+#: doc/git-permalink.en.1:147
+#, no-wrap
 msgid "SEE ALSO"
 msgstr "VOIR AUSSI"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:135
+#: doc/git-permalink.en.1:151
 msgid "B<git-config>(1)  B<xdg-open>(1)"
 msgstr "B<git-config>(1)  B<xdg-open>(1)"
 
 #. type: SH
-#: doc/git-permalink.en.1:137
+#: doc/git-permalink.en.1:153
 #, no-wrap
 msgid "AUTHORS"
 msgstr "AUTEURS"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:143
+#: doc/git-permalink.en.1:159
 msgid "E<.MT eu@euandre.org> EuAndreh E<.ME> and contributors."
 msgstr "E<.MT eu@euandre.org> EuAndreh E<.ME> et les contributeurs."
 
 #. type: SH
-#: doc/git-permalink.en.1:145
+#: doc/git-permalink.en.1:161
 #, no-wrap
 msgid "BUGS"
 msgstr "BUGS"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:154
+#: doc/git-permalink.en.1:170
 msgid ""
 "Report bugs to the E<.MT ~euandreh/public-inbox@lists.sr.ht> mailing list E<."
 "ME .> Use the subject \"\\f(CR[git-permalink] BUG or TASK: "
@@ -422,7 +467,7 @@ msgstr ""
 "E<lt>descriptionE<gt>\\fR\"."
 
 #. type: Plain text
-#: doc/git-permalink.en.1:159
+#: doc/git-permalink.en.1:175
 msgid ""
 "Browse bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<."
 "UE .>"
@@ -431,12 +476,12 @@ msgstr ""
 "ligne E<.UE .>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:163
+#: doc/git-permalink.en.1:179
 msgid "E<.UR https://euandreh.xyz/git-permalink/> Homepage E<.UE .>"
 msgstr "E<.UR https://euandreh.xyz/git-permalink/> Page d'accueil E<.UE .>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:166
+#: doc/git-permalink.en.1:182
 msgid ""
 "E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> "
 "Comments and discussions E<.UE .>"
diff --git a/doc/git-permalink.en.1 b/doc/git-permalink.en.1
index cfa28a8..2392340 100644
--- a/doc/git-permalink.en.1
+++ b/doc/git-permalink.en.1
@@ -22,7 +22,7 @@ It then uses those values to build a permalink URL, with the commit included on
 
 .TP
 \fB-p\fR
-Only print the web URL link, don't try to open it with \fBxdg-open\fR(1) or do anything else.
+Only print the web URL link to STDOUT, don't try to open it with \fBxdg-open\fR(1) or do anything else.
 By default this is turned off.
 
 .TP
@@ -128,6 +128,22 @@ Configure an URL override, and open the file \fIsrc/app_add.c\fR without selecti
 .fi
 
 
+.SH EXIT STATUS
+
+.TP
+.B 0
+Successful execution.
+
+.TP
+.B 1
+Unsupported remote.
+See the supported list in SUPPORTED REMOTES, and how to add custom ones in OVERRIDES.
+
+.TP
+.B 2
+Invalid arguments.
+
+
 .SH SEE ALSO
 
 \fBgit-config\fR(1)
diff --git a/doc/git-permalink.eo.1 b/doc/git-permalink.eo.1
index a419764..75d963d 100644
--- a/doc/git-permalink.eo.1
+++ b/doc/git-permalink.eo.1
@@ -31,8 +31,8 @@ elektita.
 
 .TP 
 \fB\-p\fP
-Nur presas la ligon, ne provas malfermi ĝin kun \fBxdg\-open\fP(1) aŭ fari ion
-alian.  Defaŭlte ĉi tio estas malŝaltita.
+Nur presas la ligon per norma eligo (STDOUT), ne provas malfermi ĝin kun
+\fBxdg\-open\fP(1) aŭ fari ion alian.  Defaŭlte ĉi tio estas malŝaltita.
 
 .TP 
 \fB\-\-help\fP, \fB\-h\fP
@@ -145,6 +145,22 @@ specifan linion:
 .fi
 
 
+.SH ELIRKODOJ
+
+.TP 
+\fB0\fP
+Bona ekzekuto.
+
+.TP 
+\fB1\fP
+Nesubtenita remoto.  Vidu la subtenitoj en SUBTENITAJ REMOTOJ, kaŭ kiel
+aldoni ion en SUPERREGOJ.
+
+.TP 
+\fB2\fP
+Malvalidaj argumentoj.
+
+
 .SH "VIDU ANKAŬ"
 
 \fBgit\-config\fP(1)  \fBxdg\-open\fP(1)
diff --git a/doc/git-permalink.fr.1 b/doc/git-permalink.fr.1
index ae2f96f..0a006ba 100644
--- a/doc/git-permalink.fr.1
+++ b/doc/git-permalink.fr.1
@@ -31,9 +31,9 @@ optionalement le numeró de la ligne choisi.
 
 .TP 
 \fB\-p\fP
-Seulement imprimez le lien d'URL web, n'essayez pas de l'ouvrir avec
-\fBxdg\-open\fP(1) ou faire quelques choses avec lui.  Par défaut cela est
-désactivé.
+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
@@ -149,6 +149,23 @@ Configurez un modèle de substitution d'URL, et ouvrir le fichier
 .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)
diff --git a/doc/git-permalink.pt.1 b/doc/git-permalink.pt.1
index 06d4745..11b89a5 100644
--- a/doc/git-permalink.pt.1
+++ b/doc/git-permalink.pt.1
@@ -31,8 +31,9 @@ sua unicidade, e opcionalmente o número da linha selecionada.
 
 .TP 
 \fB\-p\fP
-Somento imprime o link da URL web, não tenta abrí\-lo com \fBxdg\-open\fP(1) ou
-fazer qualquer coisa com ele.  Por padrão isso está desligado.
+Somento imprime o link da URL web na saída padrão (STDOUT), não tenta
+abrí\-lo com \fBxdg\-open\fP(1) ou fazer qualquer coisa com ele.  Por padrão isso
+está desligado.
 
 .TP 
 \fB\-\-help\fP, \fB\-h\fP
@@ -147,6 +148,23 @@ uma linha específica:
 .fi
 
 
+.SH "CÓDIGO DE SAÍDA"
+
+.TP 
+\fB0\fP
+Execução bem\-sucedida.
+
+.TP 
+\fB1\fP
+Sem suporte à origem remota.  Veja a lista de quais tem suporte em ORIGENS
+REMOTAS COM SUPORTE, e como adicionar origens customizadas a parteir de um
+model em MODELOS.
+
+.TP 
+\fB2\fP
+Argumentos inválidos.
+
+
 .SH "VEJA TAMBÉM"
 
 \fBgit\-config\fP(1)  \fBxdg\-open\fP(1)
diff --git a/doc/pt.po b/doc/pt.po
index 36f050c..0b34880 100644
--- a/doc/pt.po
+++ b/doc/pt.po
@@ -6,8 +6,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2021-06-19 10:19-0300\n"
-"PO-Revision-Date: 2021-06-20 13:34-0300\n"
+"POT-Creation-Date: 2021-06-21 14:44-0300\n"
+"PO-Revision-Date: 2021-06-21 14:49-0300\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: pt\n"
@@ -107,11 +107,12 @@ msgstr "B<-p>"
 #. type: Plain text
 #: doc/git-permalink.en.1:27
 msgid ""
-"Only print the web URL link, don't try to open it with B<xdg-open>(1) or do "
-"anything else.  By default this is turned off."
+"Only print the web URL link to STDOUT, don't try to open it with B<xdg-"
+"open>(1) or do anything else.  By default this is turned off."
 msgstr ""
-"Somento imprime o link da URL web, não tenta abrí-lo com B<xdg-open>(1) ou "
-"fazer qualquer coisa com ele.  Por padrão isso está desligado."
+"Somento imprime o link da URL web na saída padrão (STDOUT), não tenta abrí-"
+"lo com B<xdg-open>(1) ou fazer qualquer coisa com ele.  Por padrão isso está "
+"desligado."
 
 #. type: TP
 #: doc/git-permalink.en.1:28
@@ -242,8 +243,8 @@ msgstr "A lista atual de origens remotas com suporte é:"
 #: doc/git-permalink.en.1:82 doc/git-permalink.en.1:84
 #: doc/git-permalink.en.1:86 doc/git-permalink.en.1:88
 #: doc/git-permalink.en.1:90 doc/git-permalink.en.1:92
-#: doc/git-permalink.en.1:147 doc/git-permalink.en.1:154
-#: doc/git-permalink.en.1:159 doc/git-permalink.en.1:163
+#: doc/git-permalink.en.1:163 doc/git-permalink.en.1:170
+#: doc/git-permalink.en.1:175 doc/git-permalink.en.1:179
 #, no-wrap
 msgid "\\(bu"
 msgstr "\\(bu"
@@ -384,33 +385,77 @@ msgstr ""
 #. type: SH
 #: doc/git-permalink.en.1:131
 #, no-wrap
+msgid "EXIT STATUS"
+msgstr "CÓDIGO DE SAÍDA"
+
+#. type: TP
+#: doc/git-permalink.en.1:133
+#, no-wrap
+msgid "B<0>"
+msgstr "B<0>"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:136
+msgid "Successful execution."
+msgstr "Execução bem-sucedida."
+
+#. type: TP
+#: doc/git-permalink.en.1:137
+#, no-wrap
+msgid "B<1>"
+msgstr "B<1>"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:141
+msgid ""
+"Unsupported remote.  See the supported list in SUPPORTED REMOTES, and how to "
+"add custom ones in OVERRIDES."
+msgstr ""
+"Sem suporte à origem remota.  Veja a lista de quais tem suporte em ORIGENS "
+"REMOTAS COM SUPORTE, e como adicionar origens customizadas a parteir de um "
+"model em MODELOS."
+
+#. type: TP
+#: doc/git-permalink.en.1:142
+#, no-wrap
+msgid "B<2>"
+msgstr "B<2>"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:145
+msgid "Invalid arguments."
+msgstr "Argumentos inválidos."
+
+#. type: SH
+#: doc/git-permalink.en.1:147
+#, no-wrap
 msgid "SEE ALSO"
 msgstr "VEJA TAMBÉM"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:135
+#: doc/git-permalink.en.1:151
 msgid "B<git-config>(1)  B<xdg-open>(1)"
 msgstr "B<git-config>(1)  B<xdg-open>(1)"
 
 #. type: SH
-#: doc/git-permalink.en.1:137
+#: doc/git-permalink.en.1:153
 #, no-wrap
 msgid "AUTHORS"
 msgstr "AUTORES"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:143
+#: doc/git-permalink.en.1:159
 msgid "E<.MT eu@euandre.org> EuAndreh E<.ME> and contributors."
 msgstr "E<.MT eu@euandre.org> EuAndreh E<.ME> e colaboradores."
 
 #. type: SH
-#: doc/git-permalink.en.1:145
+#: doc/git-permalink.en.1:161
 #, no-wrap
 msgid "BUGS"
 msgstr "BUGS"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:154
+#: doc/git-permalink.en.1:170
 msgid ""
 "Report bugs to the E<.MT ~euandreh/public-inbox@lists.sr.ht> mailing list E<."
 "ME .> Use the subject \"\\f(CR[git-permalink] BUG or TASK: "
@@ -421,7 +466,7 @@ msgstr ""
 "E<lt>descriçãoE<gt>\\fR\"."
 
 #. type: Plain text
-#: doc/git-permalink.en.1:159
+#: doc/git-permalink.en.1:175
 msgid ""
 "Browse bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<."
 "UE .>"
@@ -430,12 +475,12 @@ msgstr ""
 "UE .>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:163
+#: doc/git-permalink.en.1:179
 msgid "E<.UR https://euandreh.xyz/git-permalink/> Homepage E<.UE .>"
 msgstr "E<.UR https://euandreh.xyz/git-permalink/> Página inicial E<.UE .>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:166
+#: doc/git-permalink.en.1:182
 msgid ""
 "E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> "
 "Comments and discussions E<.UE .>"