1# src/nls-global.mk
2
3# Common rules for Native Language Support (NLS)
4#
5# If some subdirectory of the source tree wants to provide NLS, it
6# needs to contain a file 'nls.mk' with the following make variable
7# assignments:
8#
9# CATALOG_NAME          -- name of the message catalog (xxx.po); probably
10#                          name of the program
11# AVAIL_LANGUAGES       -- list of languages that are provided/supported
12# GETTEXT_FILES         -- list of source files that contain message strings
13# GETTEXT_TRIGGERS      -- (optional) list of functions that contain
14#                          translatable strings
15# GETTEXT_FLAGS         -- (optional) list of gettext --flag arguments to mark
16#                          function arguments that contain C format strings
17#                          (functions must be listed in TRIGGERS and FLAGS)
18#
19# That's all, the rest is done here, if --enable-nls was specified.
20#
21# The only user-visible targets here are 'init-po', to make an initial
22# "blank" catalog from program sources, and 'update-po', which is to
23# be called if the messages in the program source have changed, in
24# order to merge the changes into the existing .po files.
25
26
27# existence checked by Makefile.global; otherwise we won't get here
28include $(srcdir)/nls.mk
29
30# If user specified the languages he wants in --enable-nls=LANGUAGES,
31# filter out the rest.  Else use all available ones.
32ifdef WANTED_LANGUAGES
33LANGUAGES = $(filter $(WANTED_LANGUAGES), $(AVAIL_LANGUAGES))
34else
35LANGUAGES = $(AVAIL_LANGUAGES)
36endif
37
38PO_FILES = $(addprefix po/, $(addsuffix .po, $(LANGUAGES)))
39ALL_PO_FILES = $(addprefix po/, $(addsuffix .po, $(AVAIL_LANGUAGES)))
40MO_FILES = $(addprefix po/, $(addsuffix .mo, $(LANGUAGES)))
41
42ifdef XGETTEXT
43XGETTEXT += -ctranslator --copyright-holder='PostgreSQL Global Development Group' --msgid-bugs-address=pgsql-bugs@postgresql.org --no-wrap --sort-by-file --package-name='$(CATALOG_NAME) (PostgreSQL)' --package-version='$(MAJORVERSION)'
44endif
45
46ifdef MSGMERGE
47MSGMERGE += --no-wrap --previous --sort-by-file
48endif
49
50# _ is defined in c.h, so it's global
51GETTEXT_TRIGGERS += _
52GETTEXT_FLAGS    += _:1:pass-c-format
53
54
55# common settings that apply to backend and all backend modules
56BACKEND_COMMON_GETTEXT_TRIGGERS = \
57    errmsg errmsg_plural:1,2 \
58    errdetail errdetail_log errdetail_plural:1,2 \
59    errhint \
60    errcontext \
61    XactLockTableWait:4 \
62    MultiXactIdWait:6 \
63    ConditionalMultiXactIdWait:6
64BACKEND_COMMON_GETTEXT_FLAGS = \
65    errmsg:1:c-format errmsg_plural:1:c-format errmsg_plural:2:c-format \
66    errdetail:1:c-format errdetail_log:1:c-format errdetail_plural:1:c-format errdetail_plural:2:c-format \
67    errhint:1:c-format \
68    errcontext:1:c-format
69
70
71all-po: $(MO_FILES)
72
73%.mo: %.po
74	$(MSGFMT) $(MSGFMT_FLAGS) -o $@ $<
75
76ifeq ($(word 1,$(GETTEXT_FILES)),+)
77po/$(CATALOG_NAME).pot: $(word 2, $(GETTEXT_FILES)) $(MAKEFILE_LIST)
78ifdef XGETTEXT
79	$(XGETTEXT) -D $(srcdir) -D . -n $(addprefix -k, $(GETTEXT_TRIGGERS)) $(addprefix --flag=, $(GETTEXT_FLAGS)) -f $<
80else
81	@echo "You don't have 'xgettext'."; exit 1
82endif
83else # GETTEXT_FILES
84po/$(CATALOG_NAME).pot: $(GETTEXT_FILES) $(MAKEFILE_LIST)
85# Change to srcdir explicitly, don't rely on $^.  That way we get
86# consistent #: file references in the po files.
87ifdef XGETTEXT
88	$(XGETTEXT) -D $(srcdir) -D . -n $(addprefix -k, $(GETTEXT_TRIGGERS)) $(addprefix --flag=, $(GETTEXT_FLAGS)) $(GETTEXT_FILES)
89else
90	@echo "You don't have 'xgettext'."; exit 1
91endif
92endif # GETTEXT_FILES
93	@$(MKDIR_P) $(dir $@)
94	sed -e '1,18 { s/SOME DESCRIPTIVE TITLE./LANGUAGE message translation file for $(CATALOG_NAME)/;s/PACKAGE/PostgreSQL/g;s/VERSION/$(MAJORVERSION)/g;s/YEAR/'`date +%Y`'/g; }' messages.po >$@
95	rm messages.po
96
97
98# catalog name extensions must match behavior of PG_TEXTDOMAIN() in c.h
99install-po: all-po installdirs-po
100ifneq (,$(LANGUAGES))
101	for lang in $(LANGUAGES); do \
102	  $(INSTALL_DATA) po/$$lang.mo '$(DESTDIR)$(localedir)'/$$lang/LC_MESSAGES/$(CATALOG_NAME)$(SO_MAJOR_VERSION)-$(MAJORVERSION).mo || exit 1; \
103	done
104endif
105
106installdirs-po:
107	$(if $(LANGUAGES),$(MKDIR_P) $(foreach lang, $(LANGUAGES), '$(DESTDIR)$(localedir)'/$(lang)/LC_MESSAGES),:)
108
109uninstall-po:
110	$(if $(LANGUAGES),rm -f $(foreach lang, $(LANGUAGES), '$(DESTDIR)$(localedir)'/$(lang)/LC_MESSAGES/$(CATALOG_NAME)$(SO_MAJOR_VERSION)-$(MAJORVERSION).mo),:)
111
112
113clean-po:
114	$(if $(MO_FILES),rm -f $(MO_FILES))
115	@$(if $(wildcard po/*.po.new),rm -f po/*.po.new)
116	rm -f po/$(CATALOG_NAME).pot
117
118
119init-po: po/$(CATALOG_NAME).pot
120
121
122# For performance reasons, only calculate these when the user actually
123# requested update-po or a specific file.
124ifneq (,$(filter update-po %.po.new,$(MAKECMDGOALS)))
125ALL_LANGUAGES := $(shell find $(top_srcdir) -name '*.po' -print | sed 's,^.*/\([^/]*\).po$$,\1,' | LC_ALL=C sort -u)
126all_compendia := $(shell find $(top_srcdir) -name '*.po' -print | LC_ALL=C sort)
127else
128ALL_LANGUAGES = $(AVAIL_LANGUAGES)
129all_compendia = FORCE
130FORCE:
131endif
132
133ifdef WANTED_LANGUAGES
134ALL_LANGUAGES := $(filter $(WANTED_LANGUAGES), $(ALL_LANGUAGES))
135endif
136
137update-po: $(ALL_LANGUAGES:%=po/%.po.new)
138
139$(AVAIL_LANGUAGES:%=po/%.po.new): po/%.po.new: po/%.po po/$(CATALOG_NAME).pot $(all_compendia)
140	$(MSGMERGE) --lang=$* $(word 1, $^) $(word 2,$^) -o $@ $(addprefix --compendium=,$(filter %/$*.po,$(wordlist 3,$(words $^),$^)))
141
142# For languages not yet available, merge against oneself, to pick
143# up translations from the compendia.  (Merging against /dev/null
144# doesn't work so well; it inserts the headers from the first-named
145# compendium.)
146po/%.po.new: po/$(CATALOG_NAME).pot $(all_compendia)
147	$(MSGMERGE) --lang=$* $(word 1,$^) $(word 1,$^) -o $@ $(addprefix --compendium=,$(filter %/$*.po,$(wordlist 2,$(words $^),$^)))
148
149
150all: all-po
151install: install-po
152installdirs: installdirs-po
153uninstall: uninstall-po
154clean distclean maintainer-clean: clean-po
155
156.PHONY: all-po install-po installdirs-po uninstall-po clean-po \
157        init-po update-po
158