1 files changed, 10 insertions, 0 deletions

diff --git a/Makefile b/Makefile
index c73498c3..24f3de50 100644
--- a/Makefile
+++ b/Makefile
@@ -1,9 +1,15 @@
+# This file is in the public domain.
+
+# All: build HTML pages in all languages and compile the
+# TypeScript logic in web-common.
 all: locale template
         cd web-common && tsc
 
+# Extract translateable strings from jinga2 templates.
 locale/messages.pot: *.j2
         pybabel extract -F locale/babel.map -o locale/messages.pot .
 
+# Update translation (.po) files with new strings.
 locale-update: locale/messages.pot
         pybabel update -i locale/messages.pot -d locale -l en --previous
         pybabel update -i locale/messages.pot -d locale -l de --previous
@@ -13,6 +19,7 @@ locale-update: locale/messages.pot
 
         if grep -nA1 '#-#-#-#-#' locale/*/LC_MESSAGES/messages.po; then echo -e "\nERROR: Conflicts encountered in PO files.\n"; exit 1; fi
 
+# Compile translation files for use.
 locale-compile:
         pybabel compile -d locale -l en --use-fuzzy
         pybabel compile -d locale -l de --use-fuzzy
@@ -20,7 +27,10 @@ locale-compile:
         pybabel compile -d locale -l it --use-fuzzy
         pybabel compile -d locale -l es --use-fuzzy
 
+# Process everything related to gettext translations.
 locale: locale-update locale-compile
 
+# Run the jinga2 templating engine to expand templates to HTML
+# incorporating translations.
 template: locale-compile
         ./template.sh