po-fetch: Add man page.

Reported by Simon Josefsson in
<https://lists.gnu.org/archive/html/bug-gettext/2025-12/msg00030.html>.

* gettext-tools/man/po-fetch.x: New file.
* gettext-tools/man/po-fetch.1.diff: New file.
* gettext-tools/man/Makefile.am (man_aux): Add po-fetch.x.
(man_MAN1MISC): New variable.
(man_MAN1): Include it.
(man_HTML): Add po-fetch.1.html.
($(man_MAN1MISC)): New rule.
(po-fetch.1, po-fetch.1.html): State dependencies.
* PACKAGING: Update.

diff --git a/.gitignore b/.gitignore
index 13112eac14c2c13ef2d05ebfc9efb8a5b0a49ab4..0b6d71c27cb4153e3892906435ac26ac2a225eb7 100644 (file)
--- a/.gitignore
+++ b/.gitignore
@@ -551,6 +551,8 @@
 /gettext-tools/man/msgunfmt.1.html
 /gettext-tools/man/msguniq.1
 /gettext-tools/man/msguniq.1.html
+/gettext-tools/man/po-fetch.1
+/gettext-tools/man/po-fetch.1.html
 /gettext-tools/man/recode-sr-latin.1
 /gettext-tools/man/recode-sr-latin.1.html
 /gettext-tools/man/spit.1

diff --git a/PACKAGING b/PACKAGING
index 508d623356f48a11634516c4a460ce93e4119aeb..f3e664773455515bd4b7f613b41581c9a38de539 100644 (file)
--- a/PACKAGING
+++ b/PACKAGING
@@ -144,12 +144,14 @@ the following file list.
       $prefix/share/man/man1/xgettext.1
       $prefix/share/man/man1/gettextize.1
       $prefix/share/man/man1/autopoint.1
+      $prefix/share/man/man1/po-fetch.1
       $prefix/share/man/man1/recode*.1
       $prefix/share/man/man1/spit.1
       $prefix/share/doc/gettext/msg*.1.html
       $prefix/share/doc/gettext/xgettext.1.html
       $prefix/share/doc/gettext/gettextize.1.html
       $prefix/share/doc/gettext/autopoint.1.html
+      $prefix/share/doc/gettext/po-fetch.1.html
       $prefix/share/doc/gettext/recode*.1.html
       $prefix/share/doc/gettext/spit.1.html
       $prefix/share/doc/gettext/gettext_*.html

diff --git a/gettext-tools/man/Makefile.am b/gettext-tools/man/Makefile.am
index 67150d860c9c2b9b28837aa03716e83934b55e2d..3ca1c2ff0c32f3c9ecdca0e28e6ac71a90b1a634 100644 (file)
--- a/gettext-tools/man/Makefile.am
+++ b/gettext-tools/man/Makefile.am
@@ -30,7 +30,7 @@ msgattrib.x msgcat.x msgcomm.x msgconv.x msgen.x msgexec.x msgfilter.x \
 msggrep.x msginit.x msgpre.x msguniq.x \
 recode-sr-latin.x \
 spit.x \
-gettextize.x autopoint.x
+gettextize.x autopoint.x po-fetch.x
 
 # Likewise.
 
@@ -44,7 +44,9 @@ man_MAN1WIZARD = \
 gettextize.1
 man_MAN1AUTOTOOLS = \
 autopoint.1
-man_MAN1 = $(man_MAN1SRC) $(man_MAN1WIZARD) $(man_MAN1AUTOTOOLS)
+man_MAN1MISC = \
+po-fetch.1
+man_MAN1 = $(man_MAN1SRC) $(man_MAN1WIZARD) $(man_MAN1AUTOTOOLS) $(man_MAN1MISC)
 man_MANS = $(man_MAN1)
 
 man_HTML = \
@@ -54,9 +56,9 @@ msgexec.1.html msgfilter.1.html msggrep.1.html msginit.1.html msgpre.1.html \
 msguniq.1.html \
 recode-sr-latin.1.html \
 spit.1.html \
-gettextize.1.html autopoint.1.html
+gettextize.1.html autopoint.1.html po-fetch.1.html
 
-EXTRA_DIST += help2man $(man_aux) $(man_MANS) $(man_HTML)
+EXTRA_DIST += help2man $(man_aux) po-fetch.1.diff $(man_MANS) $(man_HTML)
 MAINTAINERCLEANFILES = $(man_MANS) $(man_HTML)
 
 PERL = @PERL@
@@ -140,6 +142,14 @@ $(man_MAN1AUTOTOOLS): help2man $(top_srcdir)/../.version
 
 autopoint.1: autopoint.x ../autotools/autopoint.in
 
+$(man_MAN1MISC): help2man $(top_srcdir)/../.version
+       progname=`echo $@ | sed -e 's/\.in$$//' -e 's/\.1$$//'`; \
+       IN_HELP2MAN=1 $(SHELL) x-to-1 $(UPDATEMODE) "$(PERL)" "$(HELP2MAN)" \
+         ../misc/$${progname} $(srcdir)/$${progname}.x $@
+       patch $@ < $(srcdir)/po-fetch.1.diff
+
+po-fetch.1: po-fetch.x ../misc/po-fetch.in po-fetch.1.diff
+
 
 # Man pages in HTML format.
 
@@ -172,6 +182,7 @@ recode-sr-latin.1.html: recode-sr-latin.1
 spit.1.html: spit.1
 gettextize.1.html: gettextize.1
 autopoint.1.html: autopoint.1
+po-fetch.1.html: po-fetch.1
 
 install-html-local:
        $(MKDIR_P) $(DESTDIR)$(htmldir)

diff --git a/gettext-tools/man/po-fetch.1.diff b/gettext-tools/man/po-fetch.1.diff
new file mode 100644 (file)
index 0000000..6421185
--- /dev/null
+++ b/gettext-tools/man/po-fetch.1.diff
@@ -0,0 +1,22 @@
+--- po-fetch.1.orig    2025-12-30 23:52:39.868363668 +0100
++++ po-fetch.1 2025-12-31 00:01:17.154943411 +0100
+@@ -4,12 +4,15 @@
+ po\-fetch \- fetches a set of PO files from a translation project's site
+ .SH SYNOPSIS
+ .B po-fetch
+-[\fI\,OPTION\/\fR...] \fI\,TP DOMAIN\/\fR
++[\fI\,OPTION\/\fR...] TP \fI\,DOMAIN\/\fR
++.PP
++.B po-fetch
++[\fI\,OPTION\/\fR...] Weblate \fI\,BASE\-URL\/\fR \fI\,PROJECT\/\fR \fI\,COMPONENT\/\fR
++.PP
++.B po-fetch
++[\fI\,OPTION\/\fR...] git \fI\,BASE\-URL\/\fR \fI\,BRANCH\/\fR \fI\,SUBDIR\/\fR
+ .SH DESCRIPTION
+ .\" Add any additional description here
+-.IP
+-po\-fetch [OPTION...] Weblate BASE\-URL PROJECT COMPONENT
+-po\-fetch [OPTION...] git BASE\-URL BRANCH SUBDIR
+ .PP
+ Fetches a set of PO files, produced by translators, from a translation
+ project's site on the internet, and updates the LINGUAS file accordingly.

diff --git a/gettext-tools/man/po-fetch.x b/gettext-tools/man/po-fetch.x
new file mode 100644 (file)
index 0000000..f413c11
--- /dev/null
+++ b/gettext-tools/man/po-fetch.x
@@ -0,0 +1,4 @@
+[NAME]
+po\-fetch \- fetches a set of PO files from a translation project's site
+[DESCRIPTION]
+.\" Add any additional description here