Correcting problems in translated configuration files

Correcting some problems in the different translated configuration files based on running the translated configuration files through doxygen as if they were part of the documentation.
As the header / footer part has not yet been translated a dummy header / footer is added during the conversion of and "xml" to a "dox"  (like: `python configgen.py  -doc config_de.xml  > config_de.dox`)

Author: albert-github

src/configgen.py

@@ -19,6 +19,7 @@
 from xml.dom import Node
 import io
 import glob
+import os
 
 messages = {}
 
@@ -1108,9 +1109,14 @@ def main():
         print(" * python configgen.py -doc %s to regenerate this file!" % configFile)
         print(" */")
         # process header
+        foundHeader = False
+        foundFooter = False
         for n in elem.childNodes:
             if n.nodeType == Node.ELEMENT_NODE and n.nodeName == "header":
+                foundHeader = True
                 parseHeaderDoc(n, mode)
+        if not foundHeader:
+            print("/*! \\page %s"%re.sub(".xml",'',os.path.basename(configFile)))
         # generate list with all commands
         commandsList = ()
         for n in elem.childNodes:
@@ -1127,7 +1133,10 @@ def main():
         # process footers
         for n in elem.childNodes:
             if n.nodeType == Node.ELEMENT_NODE and n.nodeName == "footer":
+                foundFooter = True
                 parseFooterDoc(n, mode)
+        if not foundFooter:
+            print("*/")
     elif sys.argv[1] == "-maph":
         print("/* WARNING: This file is generated!")
         print(" * Do not edit this file, but edit %s instead and run" % configFile)

src/i18n/config_de.xml

@@ -199,7 +199,7 @@
     </option>
     <option type="list" id="ALIASES" format="string">
       <docs>
-<![CDATA[Dieses Tag kann verwendet werden, um eine Reihe von Aliasnamen anzugeben, die als Befehle in der Dokumentation fungieren. Ein Alias hat die Form: \verbatim name=wert\endverbatim Zum Beispiel wurde das Hinzufügen von \verbatim "sideeffect=@par Nebeneffekte:^^"\endverbatim es Ihnen ermöglichen, den Befehl \c \sideeffect (oder \c \@sideeffect) in der Dokumentation zu platzieren, was einen benutzerdefinierten Absatz mit der Überschrift "Nebeneffekte:" erzeugt. Beachten Sie, dass Sie im Werteteil eines Alias kein \ref cmdn "\n" einfügen können, um einen Zeilenumbruch einzufügen (in der resultierenden Ausgabe). Sie können `^^` im Werteteil eines Alias einfügen, um einen Zeilenumbruch einzufügen, als ob ein physikalischer Zeilenumbruch in der Originaldatei vorhanden wäre.]]>
+<![CDATA[Dieses Tag kann verwendet werden, um eine Reihe von Aliasnamen anzugeben, die als Befehle in der Dokumentation fungieren. Ein Alias hat die Form: \verbatim name=wert\endverbatim Zum Beispiel wurde das Hinzufügen von \verbatim "sideeffect=@par Nebeneffekte:^^"\endverbatim es Ihnen ermöglichen, den Befehl \c \\sideeffect (oder \c \@sideeffect) in der Dokumentation zu platzieren, was einen benutzerdefinierten Absatz mit der Überschrift "Nebeneffekte:" erzeugt. Beachten Sie, dass Sie im Werteteil eines Alias kein \ref cmdn "\\n" einfügen können, um einen Zeilenumbruch einzufügen (in der resultierenden Ausgabe). Sie können `^^` im Werteteil eines Alias einfügen, um einen Zeilenumbruch einzufügen, als ob ein physikalischer Zeilenumbruch in der Originaldatei vorhanden wäre.]]>
       </docs>
       <docs>
 <![CDATA[
@@ -832,7 +832,12 @@ eine doppelte Maskierung (\c \\\\{ und \c \\\\}) zu verwenden.]]>
     </option>
     <option type="bool" id="USE_HTAGS" defval="0" depends="SOURCE_BROWSER">
       <docs>
-<![CDATA[Wenn das \c USE_HTAGS-Tag auf \c YES gesetzt ist, verweisen die Referenzen auf den Quellcode auf das vom \c htags(1)-Tool generierte HTML anstelle des integrierten Quellcode-Browsers von Doxygen. Das \c htags-Tool ist Teil des globalen Quellcode-Tagging-Systems von GNU (siehe https://www.gnu.org/software/global/global.html). Sie benötigen Version 4.8.6 oder höher. <br>Um es zu verwenden, tun Sie Folgendes: -# Installieren Sie die neueste Version von \c global -# Aktivieren Sie \ref cfg_source_browser "SOURCE_BROWSER" und \c USE_HTAGS in der Konfigurationsdatei -# Stellen Sie sicher, dass \ref cfg_input "INPUT" auf die Wurzel des Quellbaums zeigt -# Führen Sie \c doxygen wie gewohnt aus <br>Doxygen ruft \c htags auf (und das wiederum ruft \c gtags auf), daher müssen diese Tools über die Befehlszeile verfügbar sein (d.h. im Suchpfad). <br>Das Ergebnis: Anstelle des von Doxygen generierten Quellcode-Browsers zeigen die Links zum Quellcode jetzt auf die Ausgabe von \c htags.]]>
+<![CDATA[Wenn das \c USE_HTAGS-Tag auf \c YES gesetzt ist, verweisen die Referenzen auf den Quellcode auf das vom \c htags(1)-Tool generierte HTML anstelle des integrierten Quellcode-Browsers von Doxygen. Das \c htags-Tool ist Teil des globalen Quellcode-Tagging-Systems von GNU (siehe https://www.gnu.org/software/global/global.html). Sie benötigen Version 4.8.6 oder höher. <br>Um es zu verwenden, tun Sie Folgendes:
+-# Installieren Sie die neueste Version von \c global
+-# Aktivieren Sie \ref cfg_source_browser "SOURCE_BROWSER" und \c USE_HTAGS in der Konfigurationsdatei
+-# Stellen Sie sicher, dass \ref cfg_input "INPUT" auf die Wurzel des Quellbaums zeigt
+-# Führen Sie \c doxygen wie gewohnt aus
+<br>Doxygen ruft \c htags auf (und das wiederum ruft \c gtags auf), daher müssen diese Tools über die Befehlszeile verfügbar sein (d.h. im Suchpfad). <br>Das Ergebnis: Anstelle des von Doxygen generierten Quellcode-Browsers zeigen die Links zum Quellcode jetzt auf die Ausgabe von \c htags.]]>
       </docs>
     </option>
     <option type="bool" id="VERBATIM_HEADERS" defval="1">
@@ -1210,7 +1215,10 @@ eine doppelte Maskierung (\c \\\\{ und \c \\\\}) zu verwenden.]]>
     </option>
     <option type="string" id="MATHJAX_CODEFILE" format="string" depends="USE_MATHJAX">
       <docs>
-<![CDATA[Das \c MATHJAX_CODEFILE-Tag kann verwendet werden, um eine Datei mit JavaScript-Code-Stucken anzugeben, die beim Start des MathJax-Codes verwendet werden. Siehe die MathJax-Website für weitere Details: - <a href="https://docs.mathjax.org/en/v2.7/">MathJax version 2</a> - <a href="https://docs.mathjax.org/en/v3.2/">MathJax version 3</a> - <a href="https://docs.mathjax.org/en/v4.0/">MathJax version 4</a>]]>
+<![CDATA[Das \c MATHJAX_CODEFILE-Tag kann verwendet werden, um eine Datei mit JavaScript-Code-Stucken anzugeben, die beim Start des MathJax-Codes verwendet werden. Siehe die MathJax-Website für weitere Details:
+ - <a href="https://docs.mathjax.org/en/v2.7/">MathJax version 2</a>
+ - <a href="https://docs.mathjax.org/en/v3.2/">MathJax version 3</a>
+ - <a href="https://docs.mathjax.org/en/v4.0/">MathJax version 4</a>]]>
       </docs>
       <docs filter="doxyfile,doxywizard">
 <![CDATA[
@@ -1817,7 +1825,14 @@ eine doppelte Maskierung (\c \\\\{ und \c \\\\}) zu verwenden.]]>
     </option>
     <option type="string" id="MERMAID_JS_URL" format="string" defval="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs">
       <docs>
-<![CDATA[Das \c MERMAID_JS_URL-Tag gibt die URL an, von der \c mermaid.js geladen werden soll, wenn clientseitiges Rendering verwendet wird (\c MERMAID_RENDER_MODE ist \c CLIENT_SIDE oder \c AUTO). Der Standardwert verweist auf die neueste Mermaid v11-Version auf dem jsDelivr CDN. \par Beispiele: - Neueste v11 (Standard): <code>https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs</code> - Angeheftete Version: <code>https://cdn.jsdelivr.net/npm/mermaid@11.3.0/dist/mermaid.esm.min.mjs</code> - Lokale Kopie: <code>./mermaid.esm.min.mjs</code> (Benutzer muss Datei im HTML-Ausgabeverzeichnis platzieren) \par Die Standard-CDN-URL erfordert Internetzugang beim Anzeigen der generierten Dokumentation. Für die Offline-Verwendung laden Sie \c mermaid.esm.min.mjs herunter und setzen Sie dies auf einen relativen Pfad, oder verwenden Sie \c MERMAID_RENDER_MODE=CLI, um stattdessen Bilder vorab zu generieren.]]>
+<![CDATA[Das \c MERMAID_JS_URL-Tag gibt die URL an, von der \c mermaid.js geladen werden soll, wenn clientseitiges Rendering verwendet wird (\c MERMAID_RENDER_MODE ist \c CLIENT_SIDE oder \c AUTO). Der Standardwert verweist auf die neueste Mermaid v11-Version auf dem jsDelivr CDN.
+<br>
+Die Standard-CDN-URL erfordert Internetzugang beim Anzeigen der generierten Dokumentation. Für die Offline-Verwendung laden Sie \c mermaid.esm.min.mjs herunter und setzen Sie dies auf einen relativen Pfad, oder verwenden Sie \c MERMAID_RENDER_MODE=CLI, um stattdessen Bilder vorab zu generieren.
+\par Beispiele:
+ - Neueste v11 (Standard): <code>https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs</code>
+ - Angeheftete Version: <code>https://cdn.jsdelivr.net/npm/mermaid@11.3.0/dist/mermaid.esm.min.mjs</code>
+ - Lokale Kopie: <code>./mermaid.esm.min.mjs</code> (Benutzer muss Datei im HTML-Ausgabeverzeichnis platzieren)
+]]>
       </docs>
     </option>
     <option type="list" id="MERMAIDFILE_DIRS" format="dir">