Setup manpage i18n

18 files changed, 274 insertions, 2 deletions

diff --git a/.gitignore b/.gitignore
index d6ef39d..14324c3 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1,5 @@
+!/doc/*.adoc
+/doc/*
 /src/version.go
 /*.bin
 /*.db
diff --git a/Makefile b/Makefile
index bd6143e..dc65110 100644
--- a/Makefile
+++ b/Makefile
@@ -24,7 +24,7 @@ GOLDFLAGS    = -L $(GOLIBDIR)
 
 
 .SUFFIXES:
-.SUFFIXES: .go .a .c .o .bin .bin-check
+.SUFFIXES: .go .a .c .o .bin .bin-check .adoc
 
 .c.o:
 	$(CC) $(CFLAGS) -o $@ -c $<
@@ -37,6 +37,9 @@ GOLDFLAGS    = -L $(GOLIBDIR)
 .a.bin:
 	go tool link    -L $(@D) $(GOLDFLAGS) -o $@ --extldflags '$(LDLIBS)' $<
 
+.adoc:
+	asciidoctor -b manpage -o $@ $<
+
 
 
 all:
@@ -49,6 +52,7 @@ mains.bin              = $(mains.go:.go=.bin)
 functional-tests/lib.a = $(functional-tests/lib.go:.go=.a)
 fuzz-targets/lib.a     = $(fuzz-targets/lib.go:.go=.a)
 benchmarks/lib.a       = $(benchmarks/lib.go:.go=.a)
+manpages.N             = $(manpages.N.adoc:.adoc=)
 
 cgo.go = \
 	src/_cgo_import.go             \
@@ -80,6 +84,7 @@ derived-assets = \
 	$(mains.a)                     \
 	$(mains.bin)                   \
 	$(NAME).bin                    \
+	$(manpages.N)                  \
 
 side-assets = \
 	src/_cgo_export.h              \
@@ -176,6 +181,11 @@ bench: $(benchmarks/main.bin-check)
 
 
 
+i18n:
+	po4a po/po4a.cfg
+
+
+
 ## Remove *all* derived artifacts produced during the build.
 ## A dedicated test asserts that this is always true.
 clean:
@@ -192,7 +202,8 @@ install: all
 
 	cp $(NAME).bin       '$(DESTDIR)$(BINDIR)'/$(NAME)
 	cp src/$(NAME).a     '$(DESTDIR)$(GOLIBDIR)'
-	cp -P $(sources)     '$(DESTDIR)$(SRCDIR)'
+	cp $(sources)        '$(DESTDIR)$(SRCDIR)'
+	mandir install       '$(DESTDIR)$(MANDIR)' $(manpages.N)
 
 ## Uninstalls from $(DESTDIR)$(PREFIX).  This is a perfect mirror
 ## of the "install" target, and removes *all* that was installed.
@@ -203,6 +214,8 @@ uninstall:
 		'$(DESTDIR)$(GOLIBDIR)'/$(NAME).a     \
 		'$(DESTDIR)$(SRCDIR)'                 \
 
+	mandir uninstall '$(DESTDIR)$(MANDIR)' $(manpages.N)
+
 
 
 ALWAYS:
diff --git a/deps.mk b/deps.mk
index e2091e3..a84229e 100644
--- a/deps.mk
+++ b/deps.mk
@@ -12,6 +12,14 @@ mains.go = \
 	tests/fuzz/api/main.go \
 	tests/main.go \
 
+manpages.N.adoc = \
+	doc/gotext.de.0.adoc \
+	doc/gotext.en.0.adoc \
+	doc/gotext.eo.0.adoc \
+	doc/gotext.es.0.adoc \
+	doc/gotext.fr.0.adoc \
+	doc/gotext.pt.0.adoc \
+
 functional-tests/lib.go = \
 	tests/functional/api-usage/gotext.go \
 
diff --git a/doc/gotext.de.0.adoc b/doc/gotext.de.0.adoc
new file mode 100644
index 0000000..ff36446
--- /dev/null
+++ b/doc/gotext.de.0.adoc
@@ -0,0 +1,5 @@
+= gotext(0)
+
+== NAME
+
+gotext - .
diff --git a/doc/gotext.en.0.adoc b/doc/gotext.en.0.adoc
new file mode 100644
index 0000000..ff36446
--- /dev/null
+++ b/doc/gotext.en.0.adoc
@@ -0,0 +1,5 @@
+= gotext(0)
+
+== NAME
+
+gotext - .
diff --git a/doc/gotext.eo.0.adoc b/doc/gotext.eo.0.adoc
new file mode 100644
index 0000000..ff36446
--- /dev/null
+++ b/doc/gotext.eo.0.adoc
@@ -0,0 +1,5 @@
+= gotext(0)
+
+== NAME
+
+gotext - .
diff --git a/doc/gotext.es.0.adoc b/doc/gotext.es.0.adoc
new file mode 100644
index 0000000..ff36446
--- /dev/null
+++ b/doc/gotext.es.0.adoc
@@ -0,0 +1,5 @@
+= gotext(0)
+
+== NAME
+
+gotext - .
diff --git a/doc/gotext.fr.0.adoc b/doc/gotext.fr.0.adoc
new file mode 100644
index 0000000..ff36446
--- /dev/null
+++ b/doc/gotext.fr.0.adoc
@@ -0,0 +1,5 @@
+= gotext(0)
+
+== NAME
+
+gotext - .
diff --git a/doc/gotext.pt.0.adoc b/doc/gotext.pt.0.adoc
new file mode 100644
index 0000000..ff36446
--- /dev/null
+++ b/doc/gotext.pt.0.adoc
@@ -0,0 +1,5 @@
+= gotext(0)
+
+== NAME
+
+gotext - .
diff --git a/mkdeps.sh b/mkdeps.sh
index e8da8a4..dc685ec 100755
--- a/mkdeps.sh
+++ b/mkdeps.sh
@@ -13,8 +13,13 @@ mains() {
 	find src tests -name '*.go' | grep    '/main\.go$'
 }
 
+docs() {
+	find doc/*.adoc
+}
+
 libs  | varlist 'libs.go'
 mains | varlist 'mains.go'
+docs  | varlist 'manpages.N.adoc'
 
 find tests/functional/*/*.go -not -name main.go | varlist 'functional-tests/lib.go'
 find tests/functional/*/main.go                 | varlist 'functional-tests/main.go'
diff --git a/po/de.po b/po/de.po
new file mode 100644
index 0000000..869752c
--- /dev/null
+++ b/po/de.po
@@ -0,0 +1,34 @@
+# German translations for PACKAGE package
+# Copyright (C) 2025 Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# Automatically generated, 2025.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2025-05-10 16:37-0300\n"
+"PO-Revision-Date: 2025-05-10 16:37-0300\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"Language: de\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#. type: Title =
+#: doc/gotext.en.0.adoc:1
+#, no-wrap
+msgid "gotext(0)"
+msgstr ""
+
+#. type: Title ==
+#: doc/gotext.en.0.adoc:3
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: doc/gotext.en.0.adoc:5
+msgid "gotext - ."
+msgstr ""
diff --git a/po/eo.po b/po/eo.po
new file mode 100644
index 0000000..5de7fc8
--- /dev/null
+++ b/po/eo.po
@@ -0,0 +1,34 @@
+# Esperanto translations for PACKAGE package
+# Copyright (C) 2025 Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# Automatically generated, 2025.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2025-05-10 16:37-0300\n"
+"PO-Revision-Date: 2025-05-10 16:37-0300\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"Language: eo\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#. type: Title =
+#: doc/gotext.en.0.adoc:1
+#, no-wrap
+msgid "gotext(0)"
+msgstr ""
+
+#. type: Title ==
+#: doc/gotext.en.0.adoc:3
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: doc/gotext.en.0.adoc:5
+msgid "gotext - ."
+msgstr ""
diff --git a/po/es.po b/po/es.po
new file mode 100644
index 0000000..40dd0b7
--- /dev/null
+++ b/po/es.po
@@ -0,0 +1,34 @@
+# Spanish translations for PACKAGE package
+# Copyright (C) 2025 Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# Automatically generated, 2025.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2025-05-10 16:37-0300\n"
+"PO-Revision-Date: 2025-05-10 16:37-0300\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"Language: es\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#. type: Title =
+#: doc/gotext.en.0.adoc:1
+#, no-wrap
+msgid "gotext(0)"
+msgstr ""
+
+#. type: Title ==
+#: doc/gotext.en.0.adoc:3
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: doc/gotext.en.0.adoc:5
+msgid "gotext - ."
+msgstr ""
diff --git a/po/fr.po b/po/fr.po
new file mode 100644
index 0000000..98e8842
--- /dev/null
+++ b/po/fr.po
@@ -0,0 +1,34 @@
+# French translations for PACKAGE package
+# Copyright (C) 2025 Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# Automatically generated, 2025.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2025-05-10 16:37-0300\n"
+"PO-Revision-Date: 2025-05-10 16:37-0300\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"Language: fr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n > 1);\n"
+
+#. type: Title =
+#: doc/gotext.en.0.adoc:1
+#, no-wrap
+msgid "gotext(0)"
+msgstr ""
+
+#. type: Title ==
+#: doc/gotext.en.0.adoc:3
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: doc/gotext.en.0.adoc:5
+msgid "gotext - ."
+msgstr ""
diff --git a/po/gotext.pot b/po/gotext.pot
new file mode 100644
index 0000000..9edb7a5
--- /dev/null
+++ b/po/gotext.pot
@@ -0,0 +1,34 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2025-05-10 16:37-0300\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#. type: Title =
+#: doc/gotext.en.0.adoc:1
+#, no-wrap
+msgid "gotext(0)"
+msgstr ""
+
+#. type: Title ==
+#: doc/gotext.en.0.adoc:3
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: doc/gotext.en.0.adoc:5
+msgid "gotext - ."
+msgstr ""
diff --git a/po/note.txt b/po/note.txt
new file mode 100644
index 0000000..45279a4
--- /dev/null
+++ b/po/note.txt
@@ -0,0 +1,5 @@
+PO4A-HEADER: mode=eof
+
+
+
+// Generated from po4a(1).
diff --git a/po/po4a.cfg b/po/po4a.cfg
new file mode 100644
index 0000000..bf63376
--- /dev/null
+++ b/po/po4a.cfg
@@ -0,0 +1,5 @@
+[options] --keep 0 --master-charset UTF-8 --localized-charset UTF-8 --addendum-charset UTF-8
+
+[po_directory] po
+
+[type: asciidoc] doc/gotext.en.0.adoc          $lang:doc/gotext.$lang.0.adoc
diff --git a/po/pt.po b/po/pt.po
new file mode 100644
index 0000000..e6dfe21
--- /dev/null
+++ b/po/pt.po
@@ -0,0 +1,34 @@
+# Portuguese translations for PACKAGE package
+# Copyright (C) 2025 Free Software Foundation, Inc.
+# This file is distributed under the same license as the PACKAGE package.
+# Automatically generated, 2025.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"POT-Creation-Date: 2025-05-10 16:37-0300\n"
+"PO-Revision-Date: 2025-05-10 16:37-0300\n"
+"Last-Translator: Automatically generated\n"
+"Language-Team: none\n"
+"Language: pt\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#. type: Title =
+#: doc/gotext.en.0.adoc:1
+#, no-wrap
+msgid "gotext(0)"
+msgstr ""
+
+#. type: Title ==
+#: doc/gotext.en.0.adoc:3
+#, no-wrap
+msgid "NAME"
+msgstr ""
+
+#. type: Plain text
+#: doc/gotext.en.0.adoc:5
+msgid "gotext - ."
+msgstr ""