chiark / gitweb /
changelog: Working on 9.0, run gbp-dch
[dgit.git] / po4a / Makefile
1 # dgit document translation machinery
2 #
3 # Translators: there is no need to look at this file.  It contains
4 # complicated machinery which you do not need to understand :-).
5 # See po/README instead.
6
7 # Copyright (C)2018 Ian Jackson
8 #
9 # This program is free software: you can redistribute it and/or modify
10 # it under the terms of the GNU General Public License as published by
11 # the Free Software Foundation, either version 3 of the License, or
12 # (at your option) any later version.
13 #
14 # This program is distributed in the hope that it will be useful,
15 # but WITHOUT ANY WARRANTY; without even the implied warranty of
16 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 # GNU General Public License for more details.
18 #
19 # You should have received a copy of the GNU General Public License
20 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
21
22 # ----- devel docs (translators, pleaee ignore all this) -----
23 #
24 # We use po4a for everything.
25 #
26 # po4a is nicely automatic for all the po handling, and the config
27 # file makes nice documentation, but it really really likes to dirty
28 # the tree.  And we want to automatically list the documents and the
29 # translation languages which it doesn't make easy.
30 #
31 # The approach I have chosen is as follows:
32 #
33 # po4a.cfg
34 #
35 #   This is autogenerated.  But also, we invite translators to add
36 #   their own language to it.  The resulting merge
37 #   conflict/discrepancy will be just an alphabetical ordering
38 #   discrepancy, since our generation script scans the available po
39 #   files.
40 #
41 #   Generation is done by a shell script, ./list-documents.
42 #
43 #   make targets:  po4a.cfg           # many others imply this
44 #                  po4a.cfg.check     # fails if out of date
45 #
46 # *.pot, *.po
47 #
48 #   As far as translators are concerned, generated and maintained by
49 #   po4a and committed to git.  As for the developers, we update this
50 #   occasionally just by running po4a.
51 #
52 #   make targets:  default           } mean
53 #                  pofiles           }  the same
54 #
55 # Translations for translators:
56 #
57 #   make targets:  preview.LANG
58 #                  translated
59 #
60 # Translated document source-language files (eg, translated pod):
61 #
62 #   Like with normal po things, the tools don't like to generate
63 #   output without updating (dirtying) the .po files.  But with po4a
64 #   this is really hard to avoid.  So we use a linkfarming technique.
65 #
66 #   make targets:  translated-only
67 #
68 # Translated output files (roff format, from pod2man):
69 #
70 #   We have sort of lost the usual make rule information by now
71 #   about targets and what to build.  Only po4a knows which
72 #   translated files are supposed to exist.  So we have a shell
73 #   script which reuses the top-level Makefile to run pod2man
74 #   where appropriate, and generate a further even-more-output-ish
75 #   tree.
76 #
77 #   make targets:  install
78 #
79 # Check:
80 #
81 #   make targets:  check
82 #                  pairwise-pocheck.check
83
84
85 default: pofiles
86
87 include ../i18n-common.make
88 PO4A ?= po4a
89
90 all update: translated
91
92 check: po4a.cfg.check pairwise-pocheck.check
93
94 pofiles: po4a.cfg
95         $(PO4A) --no-translations $<
96
97 translated: po4a.cfg
98         $(PO4A) $<
99
100 po4a.cfg: list-documents
101         ./$< $o
102
103 po4a.cfg.check: list-documents
104         ./$< >$@.tmp
105         diff po4a.cfg $@.tmp
106
107 pairwise-pocheck.check:
108         ./pairwise-pocheck
109
110 t = ../.po4a.translated-only
111 p = ../po4a
112
113 translated-only: po4a.cfg pairwise-pocheck.check
114         rm -rf $t && mkdir $t
115         cd $t && ln -s $p/*.po $p/*.pot $p/po4a.cfg .
116         cd $t && $(PO4A) po4a.cfg
117         ! test -d $t/translated || \
118         cp -al --remove-destination $t/translated .
119
120 .po4a.%.cfg: po4a.cfg Makefile
121         $S perl -p -e 's{^(\[po4a_langs\]).*}{$$1 $*};' \
122                 -e 's{:translated/man}{:.$*.translated/man}' \
123                 $< $o
124
125 .PRECIOUS: .po4a.%.cfg
126
127 pairwise-pocheck.%.check:
128         @tclsh /dev/null || printf ':;:; Please run   apt-get install tcl\n'
129         ./pairwise-pocheck $*
130
131 preview.%: .po4a.%.cfg pairwise-pocheck.%.check
132         $S $(PO4A) $<
133         $S ./install-documents >/dev/null .$*.translated $@
134         @ echo '# runes to preview the various final tranlated manpages:'
135         $S find $@ -type f -printf 'man -l %p\n'
136
137 # We can't really use timestamps to drive po4a
138 .PHONY: preview.% translated
139
140 install: translated-only
141         ./install-documents translated $(DESTDIR)