possibility of a system-wide gameshell.sh, with specific manpage

When calling a self extracting archive gameshell.sh, it can be extracted
in several places. (Save files are created in the same place.)

- With the flag -W DIR, the archive is extracted in DIR.

- If the archive (possibly a save file) is inside a directory without
  the full rwx permissions, the archive is extracted inside
  $HOME/.gameshell
  That way, a global gameshell.sh can be used for all users of a system,
  and each user will get a personal savefile.

- In other cases, the archive is extracted next to the self-extracting
  file.

This is documented in a new gameshell.sh.1 manpage (only in English).
This man page is available from within Gameshell (not very useful) but
could be installed in standard man page directories if Gameshell is
installed globally.

Author: phyver

i18n/en.po

@@ -1,12 +1,4 @@
 # AUTOMATICALLY GENERATED -- DO NOT EDIT
-#, sh-format
-msgid   "$GSH_ROOT/i18n/gsh-full-help/en.txt"
-msgstr  "$GSH_ROOT/i18n/gsh-full-help/en.txt"
-
-#, sh-format
-msgid   "$GSH_ROOT/i18n/gsh-help/en.txt"
-msgstr  "$GSH_ROOT/i18n/gsh-help/en.txt"
-
 #, sh-format
 msgid   "$GSH_ROOT/i18n/gameshell-init-msg-short/en.txt"
 msgstr  "$GSH_ROOT/i18n/gameshell-init-msg-short/en.txt"
@@ -19,6 +11,14 @@ msgstr  "$GSH_ROOT/i18n/gameshell-init-msg/en.txt"
 msgid   "$GSH_ROOT/i18n/gameshell-welcome/en.txt"
 msgstr  "$GSH_ROOT/i18n/gameshell-welcome/en.txt"
 
+#, sh-format
+msgid   "$GSH_ROOT/i18n/gsh-full-help/en.txt"
+msgstr  "$GSH_ROOT/i18n/gsh-full-help/en.txt"
+
+#, sh-format
+msgid   "$GSH_ROOT/i18n/gsh-help/en.txt"
+msgstr  "$GSH_ROOT/i18n/gsh-help/en.txt"
+
 #, sh-format
 msgid   "$GSH_ROOT/i18n/start-full-help/en.txt"
 msgstr  "$GSH_ROOT/i18n/start-full-help/en.txt"

i18n/fr.po

@@ -3,14 +3,6 @@ msgstr  "Content-Type: text/plain; charset=UTF-8\n"
         "Content-Transfer-Encoding: 8bit\n"
         "Plural-Forms: nplurals=2; plural=n>1;\n"
 
-#, sh-format
-msgid   "$GSH_ROOT/i18n/gsh-full-help/en.txt"
-msgstr  "$GSH_ROOT/i18n/gsh-full-help/fr.txt"
-
-#, sh-format
-msgid   "$GSH_ROOT/i18n/gsh-help/en.txt"
-msgstr  "$GSH_ROOT/i18n/gsh-help/fr.txt"
-
 #, sh-format
 msgid   "$GSH_ROOT/i18n/gameshell-init-msg-short/en.txt"
 msgstr  "$GSH_ROOT/i18n/gameshell-init-msg-short/fr.txt"
@@ -23,6 +15,14 @@ msgstr  "$GSH_ROOT/i18n/gameshell-init-msg/fr.txt"
 msgid   "$GSH_ROOT/i18n/gameshell-welcome/en.txt"
 msgstr  "$GSH_ROOT/i18n/gameshell-welcome/fr.txt"
 
+#, sh-format
+msgid   "$GSH_ROOT/i18n/gsh-full-help/en.txt"
+msgstr  "$GSH_ROOT/i18n/gsh-full-help/fr.txt"
+
+#, sh-format
+msgid   "$GSH_ROOT/i18n/gsh-help/en.txt"
+msgstr  "$GSH_ROOT/i18n/gsh-help/fr.txt"
+
 #, sh-format
 msgid   "$GSH_ROOT/i18n/start-full-help/en.txt"
 msgstr  "$GSH_ROOT/i18n/start-full-help/fr.txt"

i18n/gsh-full-help/en.txt

@@ -36,7 +36,7 @@ gsh auto
 
 gsh goto [N]
   directly go to mission N
-  (Note: no password necessary if N is a previous mission)
+  (Note: no password necessary if N is an earlier mission)
 
 gsh skip
   give up on the current mission and go to the next one
@@ -79,7 +79,7 @@ gsh hardreset
   reset the current mission by restarting the shell
 
 gsh HELP
-  this message
+  show advanced usage status, with all existing Gameshell commands
 
 gsh log [-v]
   show the log file of gsh commands

i18n/gsh-full-help/fr.txt

@@ -80,7 +80,7 @@ gsh hardreset
   ré-initialise la mission en cours en redémarrant le shell
 
 gsh HELP
-  affiche ce message
+  affiche un message d'aide complet, avec toutes les commandes Gameshell existantes
 
 gsh log [-v]
   affiche le fichier de log des commandes gsh

i18n/it.po

@@ -13,14 +13,6 @@ msgstr  "Project-Id-Version: \n"
         "Plural-Forms: nplurals=2; plural=(n != 1);\n"
         "X-Generator: Lokalize 22.04.1\n"
 
-#, sh-format
-msgid   "$GSH_ROOT/i18n/gsh-full-help/en.txt"
-msgstr  "$GSH_ROOT/i18n/gsh-full-help/it.txt"
-
-#, sh-format
-msgid   "$GSH_ROOT/i18n/gsh-help/en.txt"
-msgstr  "$GSH_ROOT/i18n/gsh-help/it.txt"
-
 #, sh-format
 msgid   "$GSH_ROOT/i18n/gameshell-init-msg-short/en.txt"
 msgstr  "$GSH_ROOT/i18n/gameshell-init-msg-short/it.txt"
@@ -33,6 +25,14 @@ msgstr  "$GSH_ROOT/i18n/gameshell-init-msg/it.txt"
 msgid   "$GSH_ROOT/i18n/gameshell-welcome/en.txt"
 msgstr  "$GSH_ROOT/i18n/gameshell-welcome/it.txt"
 
+#, sh-format
+msgid   "$GSH_ROOT/i18n/gsh-full-help/en.txt"
+msgstr  "$GSH_ROOT/i18n/gsh-full-help/it.txt"
+
+#, sh-format
+msgid   "$GSH_ROOT/i18n/gsh-help/en.txt"
+msgstr  "$GSH_ROOT/i18n/gsh-help/it.txt"
+
 #, sh-format
 msgid   "$GSH_ROOT/i18n/start-full-help/en.txt"
 msgstr  "$GSH_ROOT/i18n/start-full-help/it.txt"

i18n/source/Makefile

@@ -0,0 +1,15 @@
+all: gsh-commands gameshell
+
+gsh-commands:
+	make -C ./gsh-commands
+
+gameshell:
+	make -C ./gameshell
+
+install: all
+	make -C ./gameshell install
+	make -C ./gsh-commands install
+
+
+.PHONY: all gsh-commands gameshell
+

i18n/source/gameshell/Makefile

@@ -0,0 +1,36 @@
+MANPATH = ../../../man
+HELPPATH = ../..
+
+LANGS = en
+MANPAGES = $(addsuffix .1, $(LANGS))
+
+clean = sed -f ../clean.sed
+include_files = awk -f ../include_files.awk
+
+all: $(MANPAGES)
+
+install: all
+	@mkdir -p $(MANPATH)/man1/
+	for file in ??.1; do mkdir -p $(MANPATH)/$${file%.1}/man1/; cp "$$file" "$(MANPATH)/$${file%.1}/man1/gameshell.sh.1"; done
+	mv $(MANPATH)/en/man1/* $(MANPATH)/man1/
+	rmdir $(MANPATH)/en/man1/
+
+%.txt: %/*.txt
+	$(include_files) $*/man_gameshell.txt > $@
+
+# NOTE: english man page should go to the default man/man1 directory
+en.1: en.txt
+	a2x --doctype manpage --format manpage $<
+	@mkdir -p $(MANPATH)/man1/
+	mv gameshell.sh.1 $@
+
+# NOTE: translated man pages should go to the man/LANGUAGE/man1 directory
+%.1: %.txt
+	a2x --doctype manpage --format manpage $<
+	@mkdir -p $(MANPATH)/$*/man1/
+	mv gameshell.sh.1 $@
+
+clean:
+	rm -f *.1 *.html *.txt
+
+.PHONY: clean all