a magical makefile, using a collection of submakefiles that are completely reusable without modifications

Signed-off-by: Mattias Andrée <maandree@member.fsf.org>

1 files changed, 106 insertions, 0 deletions

diff --git a/mk/i18n.mk b/mk/i18n.mk
new file mode 100644
index 0000000..526bc1f
--- /dev/null
+++ b/mk/i18n.mk
@@ -0,0 +1,106 @@
+# Copyright (C) 2015  Mattias Andrée <maandree@member.fsf.org>
+# 
+# Copying and distribution of this file, with or without modification,
+# are permitted in any medium without royalty provided the copyright
+# notice and this notice are preserved.  This file is offered as-is,
+# without any warranty.
+
+
+#=== These rules are used for internationalisation. ===#
+
+
+# Enables the rules:
+#   locale          Build all translations.
+#   update-po       Update all .po files for further translation.
+#   install-locale  Install all locales.
+# 
+# "All locales" are those listed in LOCALES.
+# If LOCALES is not defined, this file is ignored.
+# 
+# If WITHOUT_GETTEXT is defined, `locale` and
+# `install-locale` will not do anything.
+
+
+ifdef LOCALES
+
+
+# WHEN TO BUILD, INSTALL, AND UNINSTALL:
+
+all: locale
+everything: locale
+install: install-locale
+install-everything: install-locale
+uninstall: uninstall-locale
+
+
+# BUILD RULES:
+
+# Build all translations.
+ifdef WITHOUT_GETTEXT
+.PHONY: locale
+locale:
+else
+.PHONY: locale
+locale: $(foreach L,$(LOCALES),bin/mo/$(L)/messages.mo)
+endif
+
+# Update all translation files for further translation.
+.PHONY: update-po
+update-po: $(foreach L,$(LOCALES),po/$(L).po)
+
+# Generate template for translations.
+obj/$(_PROJECT).pot: $(foreach S,$(_SRC),src/$(S).c)
+	@$(PRINTF_INFO) '\e[00;01;31mPOT\e[34m %s\e[00m$A\n' "$@"
+	@$(MKDIR) -p obj
+	$(Q)$(CPP) -DUSE_GETTEXT=1 $^ |  \
+	$(XGETTEXT) -o "$@" -Lc --from-code utf-8 --package-name "$(_PROJECT_FULL)"  \
+	--package-version $(_VERSION) --no-wrap --force-po  \
+	--copyright-holder '$(_COPYRIGHT_HOLDER)' - #$Z
+	@$(ECHO_EMPTY)
+
+# Create or update a translation file.
+po/%.po: obj/$(_PROJECT).pot
+	@$(PRINTF_INFO) '\e[00;01;31mPO\e[34m %s\e[00m$A\n' "$@"
+	@$(MKDIR) -p po
+	$(Q)if ! $(TEST) -e $@; then  \
+	  $(MSGINIT) --no-translator --no-wrap -i $< -o $@ -l $*;  \
+	else  \
+	  $(MSGMERGE) --no-wrap -U $@ $<;  \
+	fi #$Z
+	@$(TOUCH) $@
+	@$(ECHO_EMPTY)
+
+# Compile a translation file.
+bin/mo/%/messages.mo: po/%.po
+	@$(PRINTF_INFO) '\e[00;01;31mMO\e[34m %s\e[00m$A\n' "$@"
+	@$(MKDIR) -p bin/mo/$*
+	$(Q)cd bin/mo/$* && $(MSGFMT) ../../../$< #$Z
+	@$(ECHO_EMPTY)
+
+
+# INSTALL RULES:
+
+# Install all locales.
+ifdef WITHOUT_GETTEXT
+.PHONY: install-locale
+install-locale:
+else
+.PHONY: install-locale
+install-locale: $(foreach L,$(LOCALES),bin/mo/$(L)/messages.mo)
+	@$(PRINTF_INFO) '\e[00;01;31mINSTALL\e[34m %s\e[00m\n' "$@"
+	$(Q)$(INSTALL) -dm755 -- $(foreach L,$(LOCALES),"$(DESTDIR)$(LOCALEDIR)/$(L)/LC_MESSAGES")
+	$(Q)$(foreach L,$(LOCALES),$(INSTALL_DATA) bin/mo/$(L)/messages.mo -- "$(DESTDIR)$(LOCALEDIR)/$(L)/LC_MESSAGES/$(PKGNAME).mo" &&) $(TRUE)
+	@$(ECHO_EMPTY)
+endif
+
+
+# UNINSTALL RULES:
+
+# Uninstall all locales.
+.PHONY: uninstall-locale
+uninstall-locale:
+	-$(Q)$(RM) -- $(foreach L,$(LOCALES),"$(DESTDIR)$(LOCALEDIR)/$(L)/LC_MESSAGES/$(PKGNAME).mo")
+
+
+endif
+