share/aux/cases/*/aux/{ci/report.sh,po4a-cfg}.sh: Update and improve help string

1 files changed, 30 insertions, 2 deletions

diff --git a/share/aux/cases/cp_if/aux/po4a-cfg.sh b/share/aux/cases/cp_if/aux/po4a-cfg.sh
index 11e51aa..7813f28 100755
--- a/share/aux/cases/cp_if/aux/po4a-cfg.sh
+++ b/share/aux/cases/cp_if/aux/po4a-cfg.sh
@@ -3,13 +3,41 @@ set -eu
 
 usage() {
 	cat <<-'EOF'
-		FIXME
+		Usage:
+		  aux/po4a-cfg.sh > po/po4a.cfg
+		  aux/po4a-cfg.sh -h
 	EOF
 }
 
 help() {
 	cat <<-'EOF'
-		FIXME
+
+
+		Options:
+		  -h, --help    show this message
+
+
+		Discover translatable files in the repository (via
+		git-ls-files(1)) that have '.en.' or '/en/' in their name and
+		emit the configuration file to be used with po4a(1).
+
+
+		Examples:
+
+		  Setup i18n on a new repository:
+
+		    $ mkdir po
+		    $ touch po/pt.po
+		    $ touch po/"$(basename "$PWD")".pot
+		    $ aux/po4a-cfg.sh > po/po4a.cfg
+		    $ po4a po/po4a.cfg
+
+
+		  Conditionally update the configuration in a Makefile:
+
+		    po/po4a.cfg: ALWAYS
+		    	@sh aux/po4a-cfg.sh | ifnew $@
+		    	po4a $@
 	EOF
 }