--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/docs/cmake/MolkoBuildTranslations.md	Thu Dec 03 09:06:52 2020 +0100
@@ -0,0 +1,37 @@
+# molko_build_translations
+
+Build translations and update them.
+
+## Synopsis
+
+```cmake
+molko_build_translations(
+TARGET              target name
+SOURCES             target sources
+OUTPUTS             output variable
+TRANSLATIONS        list of localizations
+)
+```
+
+Generate target and output commands for NLS (via GNU gettext) support for the
+given *TARGET* name.
+
+The argument *SOURCES* must contain sources to extract gettext keywords, it
+will search for _, N_. The list of *SOURCES* can contain any files, only .c
+and .h will be filtered.
+
+The argument *OUTPUTS* will be set with the generated .mo files in the binary
+directory and installed to *CMAKE_INSTALL_LOCALEDIR*.
+
+The argument *TRANSLATIONS* should contain a list of languages supported in the
+gettext form (ll_LL@variant, see ISO 639 and ISO 3166 for more details).
+
+This macro create a `<TARGET>-po` target that will recreate the .pot file and
+every .po files in the nls/ directory for each language specified in
+*TRANSLATIONS*. Note, if you add a new language into translations but do not
+copy the .pot file, a warning will be issued and you should copy the .pot
+file as the new .po language file.
+
+Since the target is modifying files directly in the source tree they are not
+included in any build process and must be invoked manually.
+