Add small example of using -- on manpage

8 files changed, 137 insertions, 62 deletions

diff --git a/.gitignore b/.gitignore
index adb2993..35c1e1a 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,2 +1,4 @@
 /public/
 /git-permalink
+/doc/*.mo
+/doc/*.po~
diff --git a/doc/eo.po b/doc/eo.po
index b233953..c93b220 100644
--- a/doc/eo.po
+++ b/doc/eo.po
@@ -6,8 +6,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2021-06-21 15:24-0300\n"
-"PO-Revision-Date: 2021-06-21 15:25-0300\n"
+"POT-Creation-Date: 2021-06-22 12:17-0300\n"
+"PO-Revision-Date: 2021-06-22 12:23-0300\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: eo\n"
@@ -158,8 +158,8 @@ msgstr "La nunaj subtenitaj remotoj estas:"
 #: doc/git-permalink.en.1:52 doc/git-permalink.en.1:54
 #: doc/git-permalink.en.1:56 doc/git-permalink.en.1:58
 #: doc/git-permalink.en.1:60 doc/git-permalink.en.1:62
-#: doc/git-permalink.en.1:164 doc/git-permalink.en.1:171
-#: doc/git-permalink.en.1:176 doc/git-permalink.en.1:180
+#: doc/git-permalink.en.1:171 doc/git-permalink.en.1:178
+#: doc/git-permalink.en.1:183 doc/git-permalink.en.1:187
 #, no-wrap
 msgid "\\(bu"
 msgstr "\\(bu"
@@ -382,33 +382,48 @@ msgid ""
 msgstr ""
 "\t$ git config git-permalink.template-file-commit 'https://git.alpinelinux.org/apk-tools/tree/%s?id=%s'\n"
 "\t$ git permalink src/app_add.c\n"
-"\\Malfermado de https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n"
+"\tMalfermado de https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:133
+msgid "Open file called I<--help>:"
+msgstr "Malfermas I<--help>:"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:137
+#, no-wrap
+msgid ""
+"\t$ git permalink -- --help\n"
+"\tOpening https://git.euandreh.xyz/non-existent-repository/tree/--help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e\n"
+msgstr ""
+"\t$ git permalink -- --help\n"
+"\tMalfermado de https://git.euandreh.xyz/non-existent-repository/tree/--help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e\n"
 
 #. type: SH
-#: doc/git-permalink.en.1:132
+#: doc/git-permalink.en.1:139
 #, no-wrap
 msgid "EXIT STATUS"
 msgstr "ELIRKODOJ"
 
 #. type: TP
-#: doc/git-permalink.en.1:134
+#: doc/git-permalink.en.1:141
 #, no-wrap
 msgid "B<0>"
 msgstr "B<0>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:137
+#: doc/git-permalink.en.1:144
 msgid "Successful execution."
 msgstr "Bona ekzekuto."
 
 #. type: TP
-#: doc/git-permalink.en.1:138
+#: doc/git-permalink.en.1:145
 #, no-wrap
 msgid "B<1>"
 msgstr "B<1>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:142
+#: doc/git-permalink.en.1:149
 msgid ""
 "Unsupported remote.  See the supported list in SUPPORTED REMOTES, and how to "
 "add custom ones in OVERRIDES."
@@ -417,46 +432,46 @@ msgstr ""
 "aldoni ion en SUPERREGOJ."
 
 #. type: TP
-#: doc/git-permalink.en.1:143
+#: doc/git-permalink.en.1:150
 #, no-wrap
 msgid "B<2>"
 msgstr "B<2>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:146
+#: doc/git-permalink.en.1:153
 msgid "Invalid arguments."
 msgstr "Malvalidaj argumentoj."
 
 #. type: SH
-#: doc/git-permalink.en.1:148
+#: doc/git-permalink.en.1:155
 #, no-wrap
 msgid "SEE ALSO"
 msgstr "VIDU ANKAŬ"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:152
+#: doc/git-permalink.en.1:159
 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:154
+#: doc/git-permalink.en.1:161
 #, no-wrap
 msgid "AUTHORS"
 msgstr "AŬTOROJ"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:160
+#: doc/git-permalink.en.1:167
 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:162
+#: doc/git-permalink.en.1:169
 #, no-wrap
 msgid "BUGS"
 msgstr "MISFUNKCIOJ"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:171
+#: doc/git-permalink.en.1:178
 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: "
@@ -467,7 +482,7 @@ msgstr ""
 "E<lt>priskriboE<gt>\\fR\"."
 
 #. type: Plain text
-#: doc/git-permalink.en.1:176
+#: doc/git-permalink.en.1:183
 msgid ""
 "Browse bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<."
 "UE .>"
@@ -476,12 +491,12 @@ msgstr ""
 "rete E<.UE .>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:180
+#: doc/git-permalink.en.1:187
 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:183
+#: doc/git-permalink.en.1:190
 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 6e66a52..9e0f7bb 100644
--- a/doc/fr.po
+++ b/doc/fr.po
@@ -6,8 +6,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2021-06-21 15:24-0300\n"
-"PO-Revision-Date: 2021-06-21 15:25-0300\n"
+"POT-Creation-Date: 2021-06-22 12:17-0300\n"
+"PO-Revision-Date: 2021-06-22 12:19-0300\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: fr\n"
@@ -159,8 +159,8 @@ msgstr "La liste de références distantes prises en charge est:"
 #: doc/git-permalink.en.1:52 doc/git-permalink.en.1:54
 #: doc/git-permalink.en.1:56 doc/git-permalink.en.1:58
 #: doc/git-permalink.en.1:60 doc/git-permalink.en.1:62
-#: doc/git-permalink.en.1:164 doc/git-permalink.en.1:171
-#: doc/git-permalink.en.1:176 doc/git-permalink.en.1:180
+#: doc/git-permalink.en.1:171 doc/git-permalink.en.1:178
+#: doc/git-permalink.en.1:183 doc/git-permalink.en.1:187
 #, no-wrap
 msgid "\\(bu"
 msgstr "\\(bu"
@@ -389,31 +389,46 @@ msgstr ""
 "\t$ git permalink src/app_add.c\n"
 "\tOuverture de https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n"
 
+#. type: Plain text
+#: doc/git-permalink.en.1:133
+msgid "Open file called I<--help>:"
+msgstr "Ouvrez I<--help>:"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:137
+#, no-wrap
+msgid ""
+"\t$ git permalink -- --help\n"
+"\tOpening https://git.euandreh.xyz/non-existent-repository/tree/--help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e\n"
+msgstr ""
+"\t$ git permalink -- --help\n"
+"\tOuverture de https://git.euandreh.xyz/non-existent-repository/tree/--help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e\n"
+
 #. type: SH
-#: doc/git-permalink.en.1:132
+#: doc/git-permalink.en.1:139
 #, no-wrap
 msgid "EXIT STATUS"
 msgstr "CODES DE SORTIE"
 
 #. type: TP
-#: doc/git-permalink.en.1:134
+#: doc/git-permalink.en.1:141
 #, no-wrap
 msgid "B<0>"
 msgstr "B<0>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:137
+#: doc/git-permalink.en.1:144
 msgid "Successful execution."
 msgstr "Exécution réussie."
 
 #. type: TP
-#: doc/git-permalink.en.1:138
+#: doc/git-permalink.en.1:145
 #, no-wrap
 msgid "B<1>"
 msgstr "B<1>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:142
+#: doc/git-permalink.en.1:149
 msgid ""
 "Unsupported remote.  See the supported list in SUPPORTED REMOTES, and how to "
 "add custom ones in OVERRIDES."
@@ -423,46 +438,46 @@ msgstr ""
 "partir d'un modèles dans MODÈLES."
 
 #. type: TP
-#: doc/git-permalink.en.1:143
+#: doc/git-permalink.en.1:150
 #, no-wrap
 msgid "B<2>"
 msgstr "B<2>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:146
+#: doc/git-permalink.en.1:153
 msgid "Invalid arguments."
 msgstr "Arguments invalides."
 
 #. type: SH
-#: doc/git-permalink.en.1:148
+#: doc/git-permalink.en.1:155
 #, no-wrap
 msgid "SEE ALSO"
 msgstr "VOIR AUSSI"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:152
+#: doc/git-permalink.en.1:159
 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:154
+#: doc/git-permalink.en.1:161
 #, no-wrap
 msgid "AUTHORS"
 msgstr "AUTEURS"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:160
+#: doc/git-permalink.en.1:167
 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:162
+#: doc/git-permalink.en.1:169
 #, no-wrap
 msgid "BUGS"
 msgstr "BUGS"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:171
+#: doc/git-permalink.en.1:178
 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: "
@@ -473,7 +488,7 @@ msgstr ""
 "E<lt>descriptionE<gt>\\fR\"."
 
 #. type: Plain text
-#: doc/git-permalink.en.1:176
+#: doc/git-permalink.en.1:183
 msgid ""
 "Browse bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<."
 "UE .>"
@@ -482,12 +497,12 @@ msgstr ""
 "ligne E<.UE .>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:180
+#: doc/git-permalink.en.1:187
 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:183
+#: doc/git-permalink.en.1:190
 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 53af5a1..1747fae 100644
--- a/doc/git-permalink.en.1
+++ b/doc/git-permalink.en.1
@@ -128,6 +128,13 @@ Configure an URL override, and open the file \fIsrc/app_add.c\fR without selecti
 	Opening https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3
 .fi
 
+.P
+Open file called \fI--help\fR:
+
+.nf
+	$ git permalink -- --help
+	Opening https://git.euandreh.xyz/non-existent-repository/tree/--help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e
+.fi
 
 .SH EXIT STATUS
 
diff --git a/doc/git-permalink.eo.1 b/doc/git-permalink.eo.1
index 8fdfe9a..0d799c0 100644
--- a/doc/git-permalink.eo.1
+++ b/doc/git-permalink.eo.1
@@ -142,9 +142,16 @@ specifan linion:
 .nf
 	$ git config git\-permalink.template\-file\-commit 'https://git.alpinelinux.org/apk\-tools/tree/%s?id=%s'
 	$ git permalink src/app_add.c
-\Malfermado de https://git.alpinelinux.org/apk\-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3
+	Malfermado de https://git.alpinelinux.org/apk\-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3
 .fi
 
+.P
+Malfermas \fI\-\-help\fP:
+
+.nf
+	$ git permalink \-\- \-\-help
+	Malfermado de https://git.euandreh.xyz/non\-existent\-repository/tree/\-\-help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e
+.fi
 
 .SH ELIRKODOJ
 
diff --git a/doc/git-permalink.fr.1 b/doc/git-permalink.fr.1
index a9368a2..3dcc01a 100644
--- a/doc/git-permalink.fr.1
+++ b/doc/git-permalink.fr.1
@@ -149,6 +149,13 @@ Configurez un modèle de substitution d'URL, et ouvrir le fichier
 	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"
 
diff --git a/doc/git-permalink.pt.1 b/doc/git-permalink.pt.1
index fa5cf67..5b8ae4a 100644
--- a/doc/git-permalink.pt.1
+++ b/doc/git-permalink.pt.1
@@ -148,6 +148,13 @@ uma linha específica:
 	Abrindo https://git.alpinelinux.org/apk\-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3
 .fi
 
+.P
+Abre o arquivo \fI\-\-help\fP:
+
+.nf
+	$ git permalink \-\- \-\-help
+	Abrindo https://git.euandreh.xyz/non\-existent\-repository/tree/\-\-help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e
+.fi
 
 .SH "CÓDIGO DE SAÍDA"
 
diff --git a/doc/pt.po b/doc/pt.po
index 7c23ef9..dbc9094 100644
--- a/doc/pt.po
+++ b/doc/pt.po
@@ -6,8 +6,8 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: \n"
-"POT-Creation-Date: 2021-06-21 15:24-0300\n"
-"PO-Revision-Date: 2021-06-21 15:24-0300\n"
+"POT-Creation-Date: 2021-06-22 12:17-0300\n"
+"PO-Revision-Date: 2021-06-22 12:18-0300\n"
 "Last-Translator: \n"
 "Language-Team: \n"
 "Language: pt\n"
@@ -159,8 +159,8 @@ msgstr "A lista atual de origens remotas com suporte é:"
 #: doc/git-permalink.en.1:52 doc/git-permalink.en.1:54
 #: doc/git-permalink.en.1:56 doc/git-permalink.en.1:58
 #: doc/git-permalink.en.1:60 doc/git-permalink.en.1:62
-#: doc/git-permalink.en.1:164 doc/git-permalink.en.1:171
-#: doc/git-permalink.en.1:176 doc/git-permalink.en.1:180
+#: doc/git-permalink.en.1:171 doc/git-permalink.en.1:178
+#: doc/git-permalink.en.1:183 doc/git-permalink.en.1:187
 #, no-wrap
 msgid "\\(bu"
 msgstr "\\(bu"
@@ -388,31 +388,46 @@ msgstr ""
 "\t$ git permalink src/app_add.c\n"
 "\tAbrindo https://git.alpinelinux.org/apk-tools/tree/src/app_add.c?id=aeeb119fd8652c044cd5ceebce572b5c716914e3\n"
 
+#. type: Plain text
+#: doc/git-permalink.en.1:133
+msgid "Open file called I<--help>:"
+msgstr "Abre o arquivo I<--help>:"
+
+#. type: Plain text
+#: doc/git-permalink.en.1:137
+#, no-wrap
+msgid ""
+"\t$ git permalink -- --help\n"
+"\tOpening https://git.euandreh.xyz/non-existent-repository/tree/--help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e\n"
+msgstr ""
+"\t$ git permalink -- --help\n"
+"\tAbrindo https://git.euandreh.xyz/non-existent-repository/tree/--help?id=470a9fa9329495cfcbef8cc5e32e3a38d3c3103e\n"
+
 #. type: SH
-#: doc/git-permalink.en.1:132
+#: doc/git-permalink.en.1:139
 #, no-wrap
 msgid "EXIT STATUS"
 msgstr "CÓDIGO DE SAÍDA"
 
 #. type: TP
-#: doc/git-permalink.en.1:134
+#: doc/git-permalink.en.1:141
 #, no-wrap
 msgid "B<0>"
 msgstr "B<0>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:137
+#: doc/git-permalink.en.1:144
 msgid "Successful execution."
 msgstr "Execução bem-sucedida."
 
 #. type: TP
-#: doc/git-permalink.en.1:138
+#: doc/git-permalink.en.1:145
 #, no-wrap
 msgid "B<1>"
 msgstr "B<1>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:142
+#: doc/git-permalink.en.1:149
 msgid ""
 "Unsupported remote.  See the supported list in SUPPORTED REMOTES, and how to "
 "add custom ones in OVERRIDES."
@@ -422,46 +437,46 @@ msgstr ""
 "model em MODELOS."
 
 #. type: TP
-#: doc/git-permalink.en.1:143
+#: doc/git-permalink.en.1:150
 #, no-wrap
 msgid "B<2>"
 msgstr "B<2>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:146
+#: doc/git-permalink.en.1:153
 msgid "Invalid arguments."
 msgstr "Argumentos inválidos."
 
 #. type: SH
-#: doc/git-permalink.en.1:148
+#: doc/git-permalink.en.1:155
 #, no-wrap
 msgid "SEE ALSO"
 msgstr "VEJA TAMBÉM"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:152
+#: doc/git-permalink.en.1:159
 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:154
+#: doc/git-permalink.en.1:161
 #, no-wrap
 msgid "AUTHORS"
 msgstr "AUTORES"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:160
+#: doc/git-permalink.en.1:167
 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:162
+#: doc/git-permalink.en.1:169
 #, no-wrap
 msgid "BUGS"
 msgstr "BUGS"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:171
+#: doc/git-permalink.en.1:178
 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: "
@@ -472,7 +487,7 @@ msgstr ""
 "E<lt>descriçãoE<gt>\\fR\"."
 
 #. type: Plain text
-#: doc/git-permalink.en.1:176
+#: doc/git-permalink.en.1:183
 msgid ""
 "Browse bugs E<.UR https://euandreh.xyz/git-permalink/TODOs.html> online E<."
 "UE .>"
@@ -481,12 +496,12 @@ msgstr ""
 "UE .>"
 
 #. type: Plain text
-#: doc/git-permalink.en.1:180
+#: doc/git-permalink.en.1:187
 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:183
+#: doc/git-permalink.en.1:190
 msgid ""
 "E<.UR https://lists.sr.ht/~euandreh/public-inbox?search=%5Bgit-permalink%5D> "
 "Comments and discussions E<.UE .>"