src/nls-global.mk

   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
  28 include $(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.
  32 ifdef WANTED_LANGUAGES
  33 LANGUAGES = $(filter $(WANTED_LANGUAGES), $(AVAIL_LANGUAGES))
  34 else
  35 LANGUAGES = $(AVAIL_LANGUAGES)
  36 endif
  37
  38 PO_FILES = $(addprefix po/, $(addsuffix .po, $(LANGUAGES)))
  39 ALL_PO_FILES = $(addprefix po/, $(addsuffix .po, $(AVAIL_LANGUAGES)))
  40 MO_FILES = $(addprefix po/, $(addsuffix .mo, $(LANGUAGES)))
  41
  42 ifdef XGETTEXT
  43 XGETTEXT += -ctranslator --copyright-holder='PostgreSQL Global Development Group' --msgid-bugs-address=pgsql-bugs@lists.postgresql.org --no-wrap --sort-by-file --package-name='$(CATALOG_NAME) (PostgreSQL)' --package-version='$(MAJORVERSION)'
  44 endif
  45
  46 ifdef MSGMERGE
  47 MSGMERGE += --no-wrap --previous --sort-by-file
  48 endif
  49
  50 # _ is defined in c.h, so it's global
  51 GETTEXT_TRIGGERS += _
  52 GETTEXT_FLAGS    += _:1:pass-c-format
  53
  54
  55 # common settings that apply to backend and all backend modules
  56 BACKEND_COMMON_GETTEXT_TRIGGERS = \
  57     $(FRONTEND_COMMON_GETTEXT_TRIGGERS) \
  58     errmsg errmsg_plural:1,2 \
  59     errdetail errdetail_log errdetail_plural:1,2 \
  60     errhint \
  61     errcontext \
  62     XactLockTableWait:4 \
  63     MultiXactIdWait:6 \
  64     ConditionalMultiXactIdWait:6
  65 BACKEND_COMMON_GETTEXT_FLAGS = \
  66     $(FRONTEND_COMMON_GETTEXT_FLAGS) \
  67     errmsg:1:c-format errmsg_plural:1:c-format errmsg_plural:2:c-format \
  68     errdetail:1:c-format errdetail_log:1:c-format errdetail_plural:1:c-format errdetail_plural:2:c-format \
  69     errhint:1:c-format \
  70     errcontext:1:c-format
  71
  72 FRONTEND_COMMON_GETTEXT_FILES = $(top_srcdir)/src/common/logging.c
  73
  74 FRONTEND_COMMON_GETTEXT_TRIGGERS = \
  75     pg_log_fatal pg_log_error pg_log_warning pg_log_info pg_log_generic:2 pg_log_generic_v:2
  76
  77 FRONTEND_COMMON_GETTEXT_FLAGS = \
  78     pg_log_fatal:1:c-format pg_log_error:1:c-format pg_log_warning:1:c-format pg_log_info:1:c-format pg_log_generic:2:c-format pg_log_generic_v:2:c-format
  79
  80
  81 all-po: $(MO_FILES)
  82
  83 %.mo: %.po
  84         $(MSGFMT) $(MSGFMT_FLAGS) -o $@ $<
  85
  86 ifeq ($(word 1,$(GETTEXT_FILES)),+)
  87 po/$(CATALOG_NAME).pot: $(word 2, $(GETTEXT_FILES)) $(MAKEFILE_LIST)
  88 ifdef XGETTEXT
  89         $(XGETTEXT) -D $(srcdir) -D . -n $(addprefix -k, $(GETTEXT_TRIGGERS)) $(addprefix --flag=, $(GETTEXT_FLAGS)) -f $<
  90 else
  91         @echo "You don't have 'xgettext'."; exit 1
  92 endif
  93 else # GETTEXT_FILES
  94 po/$(CATALOG_NAME).pot: $(GETTEXT_FILES) $(MAKEFILE_LIST)
  95 # Change to srcdir explicitly, don't rely on $^.  That way we get
  96 # consistent #: file references in the po files.
  97 ifdef XGETTEXT
  98         $(XGETTEXT) -D $(srcdir) -D . -n $(addprefix -k, $(GETTEXT_TRIGGERS)) $(addprefix --flag=, $(GETTEXT_FLAGS)) $(GETTEXT_FILES)
  99 else
 100         @echo "You don't have 'xgettext'."; exit 1
 101 endif
 102 endif # GETTEXT_FILES
 103         @$(MKDIR_P) $(dir $@)
 104         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 >$@
 105         rm messages.po
 106
 107
 108 # catalog name extensions must match behavior of PG_TEXTDOMAIN() in c.h
 109 install-po: all-po installdirs-po
 110 ifneq (,$(LANGUAGES))
 111         for lang in $(LANGUAGES); do \
 112           $(INSTALL_DATA) po/$$lang.mo '$(DESTDIR)$(localedir)'/$$lang/LC_MESSAGES/$(CATALOG_NAME)$(SO_MAJOR_VERSION)-$(MAJORVERSION).mo || exit 1; \
 113         done
 114 endif
 115
 116 installdirs-po:
 117         $(if $(LANGUAGES),$(MKDIR_P) $(foreach lang, $(LANGUAGES), '$(DESTDIR)$(localedir)'/$(lang)/LC_MESSAGES),:)
 118
 119 uninstall-po:
 120         $(if $(LANGUAGES),rm -f $(foreach lang, $(LANGUAGES), '$(DESTDIR)$(localedir)'/$(lang)/LC_MESSAGES/$(CATALOG_NAME)$(SO_MAJOR_VERSION)-$(MAJORVERSION).mo),:)
 121
 122
 123 clean-po:
 124         $(if $(MO_FILES),rm -f $(MO_FILES))
 125         @$(if $(wildcard po/*.po.new),rm -f po/*.po.new)
 126         rm -f po/$(CATALOG_NAME).pot
 127
 128
 129 init-po: po/$(CATALOG_NAME).pot
 130
 131
 132 # For performance reasons, only calculate these when the user actually
 133 # requested update-po or a specific file.
 134 ifneq (,$(filter update-po %.po.new,$(MAKECMDGOALS)))
 135 ALL_LANGUAGES := $(shell find $(top_srcdir) -name '*.po' -print | sed 's,^.*/\([^/]*\).po$$,\1,' | LC_ALL=C sort -u)
 136 all_compendia := $(shell find $(top_srcdir) -name '*.po' -print | LC_ALL=C sort)
 137 else
 138 ALL_LANGUAGES = $(AVAIL_LANGUAGES)
 139 all_compendia = FORCE
 140 FORCE:
 141 endif
 142
 143 ifdef WANTED_LANGUAGES
 144 ALL_LANGUAGES := $(filter $(WANTED_LANGUAGES), $(ALL_LANGUAGES))
 145 endif
 146
 147 update-po: $(ALL_LANGUAGES:%=po/%.po.new)
 148
 149 $(AVAIL_LANGUAGES:%=po/%.po.new): po/%.po.new: po/%.po po/$(CATALOG_NAME).pot $(all_compendia)
 150         $(MSGMERGE) --lang=$* $(word 1, $^) $(word 2,$^) -o $@ $(addprefix --compendium=,$(filter %/$*.po,$(wordlist 3,$(words $^),$^)))
 151
 152 # For languages not yet available, merge against oneself, to pick
 153 # up translations from the compendia.  (Merging against /dev/null
 154 # doesn't work so well; it inserts the headers from the first-named
 155 # compendium.)
 156 po/%.po.new: po/$(CATALOG_NAME).pot $(all_compendia)
 157         $(MSGMERGE) --lang=$* $(word 1,$^) $(word 1,$^) -o $@ $(addprefix --compendium=,$(filter %/$*.po,$(wordlist 2,$(words $^),$^)))
 158
 159
 160 all: all-po
 161 install: install-po
 162 installdirs: installdirs-po
 163 uninstall: uninstall-po
 164 clean distclean maintainer-clean: clean-po
 165
 166 .PHONY: all-po install-po installdirs-po uninstall-po clean-po \
 167         init-po update-po