1 # GNU Guix --- Functional package management for GNU
2 # Copyright © 2016 Eric Bavier <bavier@member.fsf.org>
3 # Copyright © 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 Ludovic Courtès <ludo@gnu.org>
4 # Copyright © 2013 Andreas Enge <andreas@enge.fr>
5 # Copyright © 2016 Taylan Ulrich Bayırlı/Kammer <taylanbayirli@gmail.com>
6 # Copyright © 2016, 2018 Mathieu Lirzin <mthl@gnu.org>
7 # Copyright © 2018, 2021 Julien Lepiller <julien@lepiller.eu>
9 # This file is part of GNU Guix.
11 # GNU Guix is free software; you can redistribute it and/or modify it
12 # under the terms of the GNU General Public License as published by
13 # the Free Software Foundation; either version 3 of the License, or (at
14 # your option) any later version.
16 # GNU Guix is distributed in the hope that it will be useful, but
17 # WITHOUT ANY WARRANTY; without even the implied warranty of
18 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 # GNU General Public License for more details.
21 # You should have received a copy of the GNU General Public License
22 # along with GNU Guix. If not, see <http://www.gnu.org/licenses/>.
24 # If adding a language, update the following variables, and info_TEXINFOS.
25 MANUAL_LANGUAGES
= de es fr pt_BR ru zh_CN
26 COOKBOOK_LANGUAGES
= de fr ko sk
28 # Arg1: A list of languages codes.
29 # Arg2: The file name stem.
30 lang_to_texinfo
= $(foreach lang
,$(1),%D
%/$(2).
$(lang
).texi
)
32 # Automake does not understand GNU Make non-standard extensions,
33 # unfortunately, so we cannot use the above patsubst-based function here.
34 info_TEXINFOS
= %D
%/guix.texi \
41 %D
%/guix-cookbook.texi \
42 %D
%/guix-cookbook.de.texi \
43 %D
%/guix-cookbook.fr.texi \
44 %D
%/guix-cookbook.ko.texi \
45 %D
%/guix-cookbook.sk.texi
48 %D
%/contributing.texi \
52 %D
%/images
/bootstrap-graph.dot \
53 %D
%/images
/bootstrap-packages.dot \
54 %D
%/images
/coreutils-graph.dot \
55 %D
%/images
/coreutils-bag-graph.dot \
56 %D
%/images
/gcc-core-mesboot0-graph.dot \
57 %D
%/images
/service-graph.dot \
58 %D
%/images
/shepherd-graph.dot
60 DOT_VECTOR_GRAPHICS
= \
61 $(DOT_FILES
:%.dot
=%.eps
) \
62 $(DOT_FILES
:%.dot
=%.pdf
)
67 $(DOT_VECTOR_GRAPHICS
) \
68 %D
%/images
/coreutils-size-map.eps \
69 %D
%/environment-gdb.scm \
70 %D
%/package-hello.scm \
71 %D
%/package-hello.json
73 OS_CONFIG_EXAMPLES_TEXI
= \
74 %D
%/os-config-bare-bones.texi \
75 %D
%/os-config-desktop.texi \
76 %D
%/os-config-lightweight-desktop.texi \
77 %D
%/he-config-bare-bones.scm
80 $(call lang_to_texinfo
,$(MANUAL_LANGUAGES
),guix
) \
81 $(call lang_to_texinfo
,$(MANUAL_LANGUAGES
),contributing
) \
82 $(call lang_to_texinfo
,$(COOKBOOK_LANGUAGES
),guix-cookbook
)
84 # Bundle this file so that makeinfo finds it in out-of-source-tree builds.
85 BUILT_SOURCES
+= $(OS_CONFIG_EXAMPLES_TEXI
) $(TRANSLATED_INFO
)
86 EXTRA_DIST
+= $(OS_CONFIG_EXAMPLES_TEXI
) $(TRANSLATED_INFO
)
87 MAINTAINERCLEANFILES
= $(OS_CONFIG_EXAMPLES_TEXI
) $(TRANSLATED_INFO
)
89 PO4A_PARAMS
:= -M UTF-8
-L UTF-8
#master and localized encoding
90 PO4A_PARAMS
+= -k
0 # produce an output even if the translation is not complete
91 PO4A_PARAMS
+= -f texinfo
# texinfo format
93 # When a change to guix.texi occurs, it is not translated immediately.
94 # Because @pxref and @xref commands are references to sections by name, they
95 # should be translated. If a modification adds a reference to a section, this
96 # reference is not translated, which means it references a section that does not
99 $(top_srcdir
)/pre-inst-env
$(GUILE
) --no-auto-compile \
100 "$(top_srcdir)/build-aux/convert-xref.scm" \
104 $(srcdir)/%D
%/guix.
%.texi
: po
/doc
/guix-manual.
%.po
$(srcdir)/%D
%/contributing.
%.texi guix
/build
/po.go
105 -$(AM_V_PO4A
)$(PO4A_TRANSLATE
) $(PO4A_PARAMS
) -m
"%D%/guix.texi" -p
"$<" -l
"$@.tmp"
106 -sed
-i
"s|guix\.info|$$(basename "$@
" | sed 's|texi$$|info|')|" "$@.tmp"
107 -$(AM_V_POXREF
)LC_ALL
=en_US.UTF-8
$(xref_command
)
110 $(srcdir)/%D
%/guix-cookbook.
%.texi
: po
/doc
/guix-cookbook.
%.po guix
/build
/po.go
111 -$(AM_V_PO4A
)$(PO4A_TRANSLATE
) $(PO4A_PARAMS
) -m
"%D%/guix-cookbook.texi" -p
"$<" -l
"$@.tmp"
112 -sed
-i
"s|guix-cookbook\.info|$$(basename "$@
" | sed 's|texi$$|info|')|" "$@.tmp"
113 -$(AM_V_POXREF
)LC_ALL
=en_US.UTF-8
$(xref_command
)
116 $(srcdir)/%D
%/contributing.
%.texi
: po
/doc
/guix-manual.
%.po guix
/build
/po.go
117 -$(AM_V_PO4A
)$(PO4A_TRANSLATE
) $(PO4A_PARAMS
) -m
"%D%/contributing.texi" -p
"$<" -l
"$@.tmp"
118 -$(AM_V_POXREF
)LC_ALL
=en_US.UTF-8
$(xref_command
)
121 %D
%/os-config-
%.texi
: gnu
/system
/examples
/%.tmpl
122 $(AM_V_GEN
)$(MKDIR_P
) "`dirname $@`"; \
125 infoimagedir
= $(infodir)/images
126 dist_infoimage_DATA
= \
127 $(DOT_FILES
:%.dot
=%.png
) \
128 %D
%/images
/coreutils-size-map.png \
129 %D
%/images
/installer-network.png \
130 %D
%/images
/installer-partitions.png \
131 %D
%/images
/installer-resume.png
133 # Ask for warnings about cross-referenced manuals that are not listed in
135 AM_MAKEINFOHTMLFLAGS
= --set-customization-variable CHECK_HTMLXREF
=true
137 # Try hard to obtain an image size and aspect that's reasonable for inclusion
138 # in an Info or PDF document.
140 -Gratio
=.9 -Gnodesep
=.005 -Granksep
=.00005 \
141 -Nfontsize
=9 -Nheight
=.1 -Nwidth
=.1
144 $(AM_V_DOT
)$(DOT
) -Tpng
$(DOT_OPTIONS
) < "$<" > "$(srcdir)/$@.tmp"; \
145 mv
"$(srcdir)/$@.tmp" "$(srcdir)/$@"
148 $(AM_V_DOT
)$(DOT
) -Tpdf
$(DOT_OPTIONS
) < "$<" > "$(srcdir)/$@.tmp"; \
149 mv
"$(srcdir)/$@.tmp" "$(srcdir)/$@"
152 $(AM_V_DOT
)$(DOT
) -Teps
$(DOT_OPTIONS
) < "$<" > "$(srcdir)/$@.tmp"; \
153 mv
"$(srcdir)/$@.tmp" "$(srcdir)/$@"
156 $(AM_V_GEN
)convert
"$<" "$@-tmp.eps"; \
159 # We cannot add new dependencies to `%D%/guix.pdf' & co. (info "(automake)
160 # Extending"). Using the `-local' rules is imperfect, because they may be
161 # triggered after the main rule. Oh, well.
162 pdf-local
: $(DOT_FILES
=%.dot
=$(top_srcdir
)/%.pdf
)
163 info-local
: $(DOT_FILES
=%.dot
=$(top_srcdir
)/%.png
)
164 ps-local
: $(DOT_FILES
=%.dot
=$(top_srcdir
)/%.eps
) \
165 $(top_srcdir
)/%D
%/images
/coreutils-size-map.eps
172 # The man pages are generated using GNU Help2man. In makefiles rules they
173 # depend not on the binary, but on the source files. This usage allows a
174 # manual page to be generated by the maintainer and included in the
175 # distribution without requiring the end-user to have 'help2man' installed.
176 # They are built in $(srcdir) like info manuals.
178 sub_commands_mans
= \
179 $(srcdir)/%D
%/guix-archive
.1 \
180 $(srcdir)/%D
%/guix-build
.1 \
181 $(srcdir)/%D
%/guix-challenge
.1 \
182 $(srcdir)/%D
%/guix-deploy
.1 \
183 $(srcdir)/%D
%/guix-download
.1 \
184 $(srcdir)/%D
%/guix-edit
.1 \
185 $(srcdir)/%D
%/guix-environment
.1 \
186 $(srcdir)/%D
%/guix-gc
.1 \
187 $(srcdir)/%D
%/guix-hash
.1 \
188 $(srcdir)/%D
%/guix-import
.1 \
189 $(srcdir)/%D
%/guix-lint
.1 \
190 $(srcdir)/%D
%/guix-package
.1 \
191 $(srcdir)/%D
%/guix-publish
.1 \
192 $(srcdir)/%D
%/guix-pull
.1 \
193 $(srcdir)/%D
%/guix-refresh
.1 \
194 $(srcdir)/%D
%/guix-size
.1 \
195 $(srcdir)/%D
%/guix-system
.1 \
196 $(srcdir)/%D
%/guix-time-machine
.1 \
197 $(srcdir)/%D
%/guix-weather
.1
199 # Assume that cross-compiled commands cannot be executed.
203 $(srcdir)/%D
%/guix
.1 \
209 LANGUAGE
= $(top_builddir
)/pre-inst-env
$(HELP2MAN
) \
212 HELP2MANFLAGS
= --source
=GNU
--info-page
=$(PACKAGE_TARNAME
)
214 $(srcdir)/%D
%/guix
.1: scripts
/guix.in
$(sub_commands_mans
)
215 -$(AM_V_HELP2MAN
)$(gen_man
) --output
="$@" `basename "$@" .1`
217 # The 'case' ensures the man pages are only generated if the corresponding
218 # source script (the first prerequisite) has been changed. The $(GOBJECTS)
219 # prerequisite is solely meant to force these docs to be made only after all
220 # Guile modules have been compiled.
221 $(srcdir)/%D
%/guix-
%.1: guix
/scripts
/%.scm
$(GOBJECTS
)
223 *$<*) $(AM_V_P
) && set
-x || echo
" HELP2MAN $@"; \
224 $(gen_man
) --output
="$@" "guix $*";; \
231 dist_man1_MANS
+= $(srcdir)/%D
%/guix-daemon
.1
233 $(srcdir)/%D
%/guix-daemon
.1: guix-daemon
$(EXEEXT
)
234 -$(AM_V_HELP2MAN
)$(gen_man
) --output
="$@" `basename "$@" .1`