summaryrefslogtreecommitdiff
path: root/doc/local.mk
diff options
context:
space:
mode:
authorgemmaro <gemmaro.dev@gmail.com>2024-04-14 16:18:52 +0900
committerFlorian Pelz <pelzflorian@pelzflorian.de>2024-06-03 00:27:11 +0200
commitf65bd477b0c7f58004a810cc9ba5f29bc231ee35 (patch)
treee12d595ad7d37ee5b27572ff5b3ffc06f2f2e833 /doc/local.mk
parent2d4af5247057505956e841d396ec78af9f769837 (diff)
build: Use the po4a command for the translation generation.
* configure.ac (Documentation translation): Remove the po4a-translate command. This command has been replaced by the po4a command and are not used from anywhere. * doc/local.mk ($(srcdir)/%D%/guix.%.texi, $(srcdir)/%D%/guix-cookbook.%.texi) ($(srcdir)/%D%/contributing.%.texi): Use the po4a command instead of the po4a-translate for the translation generation. This eliminates the warning of po4a-translate; "po4a-translate is deprecated. The unified po4a(1) program is more convenient and less error prone." (PO4A_PARAMS): Remove the Texinfo format option. This option is specified in the configuration file (po/doc/po4a.cfg). (dummy_pot): Add a variable for the temporary POT file location. Change-Id: I542b934c3c03b8701e9f86823191224f8b0ccf81 Signed-off-by: Florian Pelz <pelzflorian@pelzflorian.de>
Diffstat (limited to 'doc/local.mk')
-rw-r--r--doc/local.mk30
1 files changed, 23 insertions, 7 deletions
diff --git a/doc/local.mk b/doc/local.mk
index 1d94e3c7583..389ca098bd0 100644
--- a/doc/local.mk
+++ b/doc/local.mk
@@ -7,6 +7,7 @@
7# Copyright © 2018, 2021 Julien Lepiller <julien@lepiller.eu> 7# Copyright © 2018, 2021 Julien Lepiller <julien@lepiller.eu>
8# Copyright © 2019 Timothy Sample <samplet@ngyro.com> 8# Copyright © 2019 Timothy Sample <samplet@ngyro.com>
9# Copyright © 2024 Janneke Nieuwenhuizen <janneke@gnu.org> 9# Copyright © 2024 Janneke Nieuwenhuizen <janneke@gnu.org>
10# Copyright © 2024 gemmaro <gemmaro.dev@gmail.com>
10# 11#
11# This file is part of GNU Guix. 12# This file is part of GNU Guix.
12# 13#
@@ -89,10 +90,6 @@ BUILT_SOURCES += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
89EXTRA_DIST += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO) 90EXTRA_DIST += $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
90MAINTAINERCLEANFILES = $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO) 91MAINTAINERCLEANFILES = $(OS_CONFIG_EXAMPLES_TEXI) $(TRANSLATED_INFO)
91 92
92PO4A_PARAMS := -M UTF-8 -L UTF-8 #master and localized encoding
93PO4A_PARAMS += -k 0 # produce an output even if the translation is not complete
94PO4A_PARAMS += -f texinfo # texinfo format
95
96# When a change to guix.texi occurs, it is not translated immediately. 93# When a change to guix.texi occurs, it is not translated immediately.
97# Because @pxref and @xref commands are references to sections by name, they 94# Because @pxref and @xref commands are references to sections by name, they
98# should be translated. If a modification adds a reference to a section, this 95# should be translated. If a modification adds a reference to a section, this
@@ -104,20 +101,39 @@ $(top_srcdir)/pre-inst-env $(GUILE) --no-auto-compile \
104 $@.tmp $< 101 $@.tmp $<
105endef 102endef
106 103
104# If /dev/null is used for this POT file path, a warning will be issued
105# because the path extension is not 'pot'.
106dummy_pot = $(shell mktemp --suffix=.pot)
107
107$(srcdir)/%D%/guix.%.texi: po/doc/guix-manual.%.po $(srcdir)/%D%/contributing.%.texi guix/build/po.go 108$(srcdir)/%D%/guix.%.texi: po/doc/guix-manual.%.po $(srcdir)/%D%/contributing.%.texi guix/build/po.go
108 -$(AM_V_PO4A)$(PO4A_TRANSLATE) $(PO4A_PARAMS) -m "%D%/guix.texi" -p "$<" -l "$@.tmp" 109 -$(AM_V_PO4A)$(PO4A) --no-update \
110 --variable localized="$@.tmp" \
111 --variable master="%D%/guix.texi" \
112 --variable po="$<" \
113 --variable pot=$(dummy_pot) \
114 po/doc/po4a.cfg
109 -sed -i "s|guix\.info|$$(basename "$@" | sed 's|texi$$|info|')|" "$@.tmp" 115 -sed -i "s|guix\.info|$$(basename "$@" | sed 's|texi$$|info|')|" "$@.tmp"
110 -$(AM_V_POXREF)LC_ALL=en_US.UTF-8 $(xref_command) 116 -$(AM_V_POXREF)LC_ALL=en_US.UTF-8 $(xref_command)
111 -mv "$@.tmp" "$@" 117 -mv "$@.tmp" "$@"
112 118
113$(srcdir)/%D%/guix-cookbook.%.texi: po/doc/guix-cookbook.%.po guix/build/po.go 119$(srcdir)/%D%/guix-cookbook.%.texi: po/doc/guix-cookbook.%.po guix/build/po.go
114 -$(AM_V_PO4A)$(PO4A_TRANSLATE) $(PO4A_PARAMS) -m "%D%/guix-cookbook.texi" -p "$<" -l "$@.tmp" 120 -$(AM_V_PO4A)$(PO4A) --no-update \
121 --variable localized="$@.tmp" \
122 --variable master="%D%/guix-cookbook.texi" \
123 --variable po="$<" \
124 --variable pot=$(dummy_pot) \
125 po/doc/po4a.cfg
115 -sed -i "s|guix-cookbook\.info|$$(basename "$@" | sed 's|texi$$|info|')|" "$@.tmp" 126 -sed -i "s|guix-cookbook\.info|$$(basename "$@" | sed 's|texi$$|info|')|" "$@.tmp"
116 -$(AM_V_POXREF)LC_ALL=en_US.UTF-8 $(xref_command) 127 -$(AM_V_POXREF)LC_ALL=en_US.UTF-8 $(xref_command)
117 -mv "$@.tmp" "$@" 128 -mv "$@.tmp" "$@"
118 129
119$(srcdir)/%D%/contributing.%.texi: po/doc/guix-manual.%.po guix/build/po.go 130$(srcdir)/%D%/contributing.%.texi: po/doc/guix-manual.%.po guix/build/po.go
120 -$(AM_V_PO4A)$(PO4A_TRANSLATE) $(PO4A_PARAMS) -m "%D%/contributing.texi" -p "$<" -l "$@.tmp" 131 -$(AM_V_PO4A)$(PO4A) --no-update \
132 --variable localized="$@.tmp" \
133 --variable master="%D%/contributing.texi" \
134 --variable po="$<" \
135 --variable pot=$(dummy_pot) \
136 po/doc/po4a.cfg
121 -$(AM_V_POXREF)LC_ALL=en_US.UTF-8 $(xref_command) 137 -$(AM_V_POXREF)LC_ALL=en_US.UTF-8 $(xref_command)
122 -mv "$@.tmp" "$@" 138 -mv "$@.tmp" "$@"
123 139