Minor changes in the documentation.

src/main/resources/lang/lang_de.xml

@@ -6,6 +6,7 @@
     <string name="revision">Version</string>
     <string name="date">Datum</string>
     <string name="number">Nr.</string>
+    <string name="settings">Im Folgenden werden die vorhandenen Einstellungen des Simulators beschrieben.</string>
     <string name="attr_dialogTitle">Eigenschaften</string>
     <string name="attr_openCircuit">Anzeigen</string>
     <string name="attr_openCircuitLabel">Enthaltene Schaltung:</string>
@@ -1272,13 +1273,15 @@ Sind evtl. die Namen der Variablen nicht eindeutig?</string>
     <string name="menu_delete_tt">Löscht ausgewählte Elemente</string>
     <string name="menu_edit">Bearbeiten</string>
     <string name="menu_editAttributes">Einstellungen der Schaltung</string>
-    <string name="menu_editAttributes_tt">Diese Attribute beeinflussen das Verhalten der aktuellen Schaltung.
+    <string name="menu_editAttributes_tt">Die Einstellungen der Schaltung beeinflussen das Verhalten der aktuell
+        geöffneten Schaltung.
         So kann z.B. das Erscheiningsbild festgelegt werden, welche die Schaltung annimmt, wenn sie in andere
-        Schaltungen eingebettet wird. Diese Einstellungen werden in der aktuellen Schaltung gespeichert.
+        Schaltungen eingebettet wird. Diese Einstellungen werden mit der Schaltung zusammen gespeichert.
     </string>
     <string name="menu_editSettings">Einstellungen</string>
-    <string name="menu_editSettings_tt">Bearbeitet die globalen Einstellungen des Simulators. Hier können u.a.
+    <string name="menu_editSettings_tt">In den globalen Einstellungen des Simulators werden u.a.
-        Sprache, die zu verwendende Symbolform oder die Pfade externer Tools vorgegeben werden.
+        die Sprache, die für die elementaren Gatter zu verwendende Symbolform oder die Pfade externer
+        Tools vorgegeben.
     </string>
     <string name="menu_element">Stoppen der Simulation</string>
     <string name="menu_element_tt">Stoppt die Simulation und erlaubt das Bearbeiten der Schaltung.</string>

src/main/resources/lang/lang_en.xml

@@ -6,6 +6,7 @@
     <string name="revision">Revision</string>
     <string name="date">Date</string>
     <string name="number">No.</string>
+    <string name="settings">The following describes the available settings of the simulator.</string>
     <string name="attr_dialogTitle">Attributes</string>
     <string name="attr_openCircuit">Open Circuit</string>
     <string name="attr_openCircuitLabel">Included circuit:</string>
@@ -1262,13 +1263,13 @@
     <string name="menu_delete_tt">Delete selected single component or group of components.</string>
     <string name="menu_edit">Edit</string>
     <string name="menu_editAttributes">Circuit specific settings</string>
-    <string name="menu_editAttributes_tt">These settings affect the behavior of the current circuit.
+    <string name="menu_editAttributes_tt">The circuit specific settings affect the behavior of the
-        Thus, e.g. the appearance shape which the circuit assumes when embedded in other circuits.
+        currently open circuit.
-        These settings are stored in the current circuit.</string>
+        Thus, e.g. the shape that represents the circuit when it is embedded in other circuits.
+        These settings are stored together with the circuit.</string>
     <string name="menu_editSettings">Settings</string>
-    <string name="menu_editSettings_tt">Edits the global settings of the simulator.
+    <string name="menu_editSettings_tt">The global settings of the simulator specify, among other
-        Among other things, language, the symbol form to be used or the paths of external tools can be
+        things, the language, the symbol form to be used or the paths of external tools.</string>
-        specified here.</string>
     <string name="menu_element">Stop Simulation</string>
     <string name="menu_element_tt">Stops the simulation and allows to edits the circuit.</string>
     <string name="menu_elements">Components</string>

src/test/java/de/neemann/digital/docu/DocuTest.java

@@ -78,7 +78,7 @@ public class DocuTest extends TestCase {
                 .append("\" library=\"").append(libFile.toURI().toString())
                 .append("\">\n");
 
-        w.append("  <settings name=\"").append(Lang.get("menu_editSettings")).append("\">\n");
+        w.append("  <settings name=\"").append(Lang.get("menu_editSettings")).append("\" descr=\"").append(Lang.get("settings")).append("\">\n");
         w.append("    <main name=\"").append(Lang.get("menu_editSettings")).append("\" descr=\"").append(Lang.get("menu_editSettings_tt")).append("\">\n");
         writeAttributes(w, Settings.getInstance().getKeys());
         w.append("    </main>\n");

src/test/resources/docu/elem2fo.xslt

@@ -89,7 +89,7 @@
 						</fo:basic-link>
 					</fo:block>
 					<fo:block margin-top="2mm" margin-bottom="2mm" font-weight="bold">
-						C <fo:inline padding-left="1mm"><xsl:value-of select="@components"/></fo:inline>
+						C <fo:inline padding-left="2mm"><xsl:value-of select="@components"/></fo:inline>
 					</fo:block>
 					<xsl:apply-templates select="lib" mode="toc"/>
 					<fo:block margin-top="2mm" margin-bottom="2mm" font-weight="bold">
@@ -104,7 +104,7 @@
 					</fo:block>
 					<xsl:apply-templates select="document(@static)/*" mode="full"/>
 
-					<fo:block margin-top="4mm" margin-bottom="4mm" font-size="16pt" font-weight="bold" id="chap_settings">
+					<fo:block page-break-before="always" margin-top="4mm" margin-bottom="4mm" font-size="16pt" font-weight="bold" id="chap_settings">
 						B <fo:inline padding-left="2mm"><xsl:value-of select="settings/@name"/></fo:inline>
 					</fo:block>
 					<xsl:apply-templates select="settings" mode="full"/>
@@ -267,6 +267,9 @@
 	</xsl:template>
 
 	<xsl:template match="settings" mode="full">
+		<fo:block>
+			<xsl:value-of select="@descr"/>
+		</fo:block>
 		<fo:block margin-top="4mm" margin-bottom="4mm" font-size="12pt" font-weight="bold">
 			<xsl:value-of select="main/@name"/>
 		</fo:block>