gnucash-docs maint: Multiple changes pushed

Frank H.Ellenberger fell at code.gnucash.org
Sat Dec 18 17:14:10 EST 2021


Updated	 via  https://github.com/Gnucash/gnucash-docs/commit/4acfd582 (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/83053c25 (commit)
	from  https://github.com/Gnucash/gnucash-docs/commit/58741f7e (commit)



commit 4acfd58206615ac1fe850c93290b663fe05377ff
Merge: 58741f7e 83053c25
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date:   Sat Dec 18 23:12:36 2021 +0100

    Merge PR #242 into maint


commit 83053c2550f484145e06304f2f6afd953fe4b2bf
Author: Christian Wehling <christian.wehling at web.de>
Date:   Sat Dec 18 22:39:30 2021 +0100

    F::Q - further improvements

diff --git a/manual/C/ch_Finance-Quote.xml b/manual/C/ch_Finance-Quote.xml
index 1b218d69..2310aee1 100644
--- a/manual/C/ch_Finance-Quote.xml
+++ b/manual/C/ch_Finance-Quote.xml
@@ -14,7 +14,7 @@ Translators:
 -->
 <chapter id="finance-quote"
          xmlns:xi="http://www.w3.org/2001/XInclude">
-  <title>The Online Quote update</title>
+  <title>Setting up the Online Quote update</title>
 
   <para>If you have more than a couple of commodities, you will tire of having to update their quotes
     constantly. &app; has the ability to automatically download the most recent quote for your
@@ -27,10 +27,16 @@ Translators:
 
     <para>To determine if the &app-perl; module &app-fq; is already installed on your system, type
       <command>perldoc Finance::Quote</command> in a terminal window and check to see if there is
-      any documentation available. If you are now shown documentation, then &app-fq; is already
-      installed and you can configure periodical quotes update as described in
-      <xref linkend="finance-quote-scheduler" />. If no documentation is displayed, you will have to
-      continue with this chapter.
+      any documentation
+<screen>NAME
+    Finance::Quote - Get stock and mutual fund quotes from various exchanges
+
+SYNOPSIS
+       [...]
+</screen>
+      available. If you are now shown documentation, then &app-fq; is already installed and you can
+      configure periodical quotes update as described in <xref linkend="finance-quote-scheduler" />.
+      If no documentation is displayed, you will have to continue with this chapter.
     </para>
 
     <itemizedlist>
@@ -79,7 +85,8 @@ Translators:
 
       <step>
         <simpara>Run the <command>gnc-fq-check</command> command to verify that the program is already in a directory
-          that is entered in the PATH environment variable.<footnote>
+          that is entered in the PATH environment variable.
+          <footnote>
             <simpara>If you’ve installed &app; packages provided by your distribution,
               <filename>gnc-fq-check</filename> must be on your PATH. The currentness of your
               distribution can be checked under
@@ -89,19 +96,14 @@ Translators:
           </footnote>
         </simpara>
 
-        <substeps>
-          <step>
-            <simpara>If <filename>gnc-fq-check</filename> is not in your PATH, search the folder where &app; is installed
-              and change to that directory.
-            </simpara>
-          </step>
-
-          <step>
-            <simpara>It is a good idea to include the current directory in the PATH environment variable. Please refer to
-              the documentation for your distribution for more information.
-            </simpara>
-          </step>
-        </substeps>
+        <tip>
+          <simpara>If <filename>gnc-fq-check</filename> is not in your PATH, perhaps because you built the application
+            yourself using unusual paths, search the folder where &app; is installed, e.g. with the
+            command <command>which gnc-fq-check</command>, and change to that directory. It is a
+            good idea to include the current directory in the PATH environment variable. Please
+            refer to the documentation for your distribution for more information.
+          </simpara>
+        </tip>
       </step>
 
       <step>
@@ -109,14 +111,16 @@ Translators:
           with root privileges &app-fq; It depends on your distribution.
         </simpara>
 
-        <para>This will launch a &app-perl; <acronym><ulink url="&url-cpan;">CPAN</ulink></acronym><footnote>
-            <simpara>See <ulink url="&url-cpan;misc/cpan-faq.html">CPAN Frequently Asked Questions</ulink> for
-              details.
+        <para>This will launch a &app-perl; <acronym><ulink url="&url-cpan;">CPAN</ulink></acronym>
+          <footnote>
+            <simpara>See <ulink url="&url-cpan;misc/cpan-faq.html">CPAN Frequently Asked Questions</ulink> for details.
             </simpara>
-          </footnote>module internally. When you launch the CPAN module for the first time, you must setup and configure
-          it. However, on the most systems if you accept the default settings or answer the first
-          question <computeroutput>Are you ready for manual configuration? [yes]</computeroutput>
-          with <userinput>no</userinput>, you will be able to install &app-fq; successfully.
+          </footnote>
+          module internally. When you launch the CPAN module for the first time, you must setup and
+          configure it. However, on the most systems if you accept the default settings or answer
+          the first question <computeroutput>Are you ready for manual configuration?
+          [yes]</computeroutput> with <userinput>no</userinput>, you will be able to install
+          &app-fq; successfully.
         </para>
       </step>
 
@@ -165,15 +169,13 @@ Translators:
       </step>
 
       <step>
-        <simpara>Run<menuchoice>
+        <simpara>Run
+          <menuchoice>
             <guimenu>Start</guimenu> <guisubmenu>&app;</guisubmenu> <guimenuitem>Install Online
             Price Retrieval</guimenuitem>
-          </menuchoice>.
+          </menuchoice>
+          . This is a small utility that installs &app-fq; for you.
         </simpara>
-
-        <para>The &win; installer from the <ulink url="&url-www;download.phtml">&app; homepage</ulink>. also comes
-          with a small utility that installs &app-fq; for you.
-        </para>
       </step>
     </procedure>
   </sect1>
@@ -182,7 +184,8 @@ Translators:
     <title>Configuring for Getting Online Quotes Periodically</title>
 
     <para>The command <command>gnucash-cli --quotes get
-      <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></command><footnote>
+      <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></command>
+      <footnote>
         <simpara>The Online Quotes Retrieval command has been changed from &app; 4.0. The old command
           <command>gnucash --add-price-quotes
           <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></command> is
@@ -190,13 +193,15 @@ Translators:
           upgraded from &app; 3.11 or previous version, it is recommended to use the new command
           <command>gnucash-cli</command>.
         </simpara>
-      </footnote>can be used to fetch the current quotes of your stocks and write them directly into your &app;-data
-      file.
+      </footnote>
+      can be used to fetch the current quotes of your stocks and write them directly into your
+      &app;-data file.
     </para>
 
     <para>The file specified <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename> will
       depend on the name and location of your data file. This can be determined by the name
-      displayed in the top frame of the &app; window, before the <quote>-</quote>.<tip>
+      displayed in the top frame of the &app; window, before the <quote>-</quote>.
+      <tip>
         <para>The file name can also be found under <guimenu>File</guimenu> in the recently opened file list. If
           you place the mouse over the menu item with the number 1 in the list of recently opened
           files, the complete file name is displayed in the <guilabel>status bar</guilabel>.
@@ -221,11 +226,17 @@ Translators:
       </step>
 
       <step>
-        <para>Add the following line to your crontab:<informalexample>
+        <para>Add the following line to your crontab:
+          <informalexample>
 <screen>0 16 * * 5 gnucash-cli --quotes get <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
-          </informalexample><warning>
-            <para>If there is no X session running on your computer at the time of the quote request, you must do the
-              call as follows instead:<screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT; gnucash-cli --quotes get <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
+          </informalexample>
+          <warning>
+            <para>If there is no graphic session that has already started the dbus, running on your computer at the
+              time of the quote request, you must do the entry as follows instead:
+<screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT;
+gnucash-cli --quotes get <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
+              (Do not copy the line breaks into the crontab, they were inserted here only for the
+              purpose of readability).
             </para>
           </warning>
         </para>
@@ -239,10 +250,12 @@ Translators:
       </para>
 
       <step>
-        <simpara>Select<menuchoice>
+        <simpara>Select
+          <menuchoice>
             <guimenu>Start</guimenu><guisubmenu>Windows Administrative
             Tools</guisubmenu><guimenuitem>Task Scheduler</guimenuitem>
-          </menuchoice>.
+          </menuchoice>
+          .
         </simpara>
       </step>
 
diff --git a/manual/de/ch_Finance-Quote.xml b/manual/de/ch_Finance-Quote.xml
index bbfc343f..b6322644 100644
--- a/manual/de/ch_Finance-Quote.xml
+++ b/manual/de/ch_Finance-Quote.xml
@@ -14,7 +14,7 @@ Translators:
 -->
 <chapter id="finance-quote"
          xmlns:xi="http://www.w3.org/2001/XInclude">
-  <title>Die Online-Kursaktualisierung</title>
+  <title>Die Online-Kursaktualisierung einrichten</title>
 
   <para>Wenn Sie mehr als ein paar Devisen und Wertpapiere besitzen, werden Sie es bald leid sein, die Kurse
     ständig per Hand aktualisieren zu müssen. &app; bietet Ihnen die Möglichkeit, automatisch den
@@ -27,9 +27,16 @@ Translators:
 
     <para>Um festzustellen, ob das &app-perl;-Modul &app-fq; bereits auf Ihrem System installiert ist, geben
       Sie <command>perldoc Finance::Quote</command> in einem Terminalfenster ein. Wird Ihnen jetzt
-      eine Dokumentation angezeigt, dann ist &app-fq; installiert und Sie können, wie in
+      eine Dokumentation in dieser Form
+<screen>NAME
+    Finance::Quote - Get stock and mutual fund quotes from various exchanges
+
+SYNOPSIS
+       [...]
+</screen>
+      angezeigt, dann ist &app-fq; installiert und Sie können, wie in
       <xref linkend="finance-quote-scheduler" /> beschrieben, den automatisierten Kursabruf
-      konfigurieren. Wenn nicht, dann müssen Sie sich mit diesem Kapitel weiter beschäftigen.
+      konfigurieren. Wenn nicht, dann gibt Ihnen dieser Abschnitt eine Anleitung zur Installation.
     </para>
 
     <itemizedlist>
@@ -80,7 +87,8 @@ Translators:
 
       <step>
         <simpara>Führen Sie den Befehl <command>gnc-fq-check</command> aus, um zu überprüfen, ob das Programm
-          bereits in einem Verzeichnis liegt, welches in der Umgebungsvariable PATH eingetragen ist.<footnote>
+          bereits in einem Verzeichnis liegt, welches in der Umgebungsvariable PATH eingetragen ist.
+          <footnote>
             <simpara>Wenn Sie die von Ihrer Distribution bereitgestellten &app; Pakete installiert haben, sollte
               <filename>gnc-fq-check</filename> bereits in Ihrem PATH sein. Die Aktualität ihrer
               Distribution können Sie unter
@@ -90,19 +98,15 @@ Translators:
           </footnote>
         </simpara>
 
-        <substeps>
-          <step>
-            <simpara>Wenn <filename>gnc-fq-check</filename> nicht in Ihrem PATH ist, suchen Sie den Ordner, in dem &app;
-              installiert ist und wechseln in dieses Verzeichnis.
-            </simpara>
-          </step>
-
-          <step>
-            <simpara>Es bietet sich an, das aktuelle Verzeichnis in der PATH-Umgebungsvariable aufzunehmen. Hierzu
-              informieren Sie sich bitte in den Unterlagen zu Ihrer Distribution.
-            </simpara>
-          </step>
-        </substeps>
+        <tip>
+          <simpara>Wenn <command>gnc-fq-check</command> nicht in Ihrem PATH ist, vielleicht weil Sie die Anwendung
+            selbst gebaut und dabei ungewöhnliche Pfade verwendet haben, suchen Sie den Ordner in
+            dem &app; installiert ist, z.B. mit dem Befehl <command>which gnc-fq-check</command>,
+            und wechseln in dieses Verzeichnis. Es bietet sich an, das aktuelle Verzeichnis in der
+            PATH-Umgebungsvariable aufzunehmen. Hierzu informieren Sie sich bitte in den Unterlagen
+            zu Ihrer Distribution.
+          </simpara>
+        </tip>
       </step>
 
       <step>
@@ -111,15 +115,16 @@ Translators:
           jeweiligen Distribution abhängig.
         </simpara>
 
-        <para>Dadurch wird ein internes &app-perl;
-          <acronym><ulink url="&url-cpan;">CPAN</ulink></acronym><footnote>
-            <simpara>Siehe <ulink url="&url-cpan;misc/cpan-faq.html">CPAN Frequently Asked Questions</ulink>
-              für weitere Informationen.
+        <para>Dadurch wird ein internes &app-perl; <acronym><ulink url="&url-cpan;">CPAN</ulink></acronym>
+          <footnote>
+            <simpara>Siehe <ulink url="&url-cpan;misc/cpan-faq.html">CPAN Frequently Asked Questions</ulink> für weitere
+              Informationen.
             </simpara>
-          </footnote>Modul gestartet um die Installation vorzunehmen. Wenn Sie das CPAN zum ersten Mal starten, müssen
-          Sie es einrichten und konfigurieren. Auf den meisten Systemen können Sie jedoch die
-          Standardeinstellungen akzeptieren und die erste Frage <computeroutput>Are you ready for
-          manual configuration? [yes]</computeroutput> mit <userinput>no</userinput> beantworten
+          </footnote>
+          Modul gestartet um die Installation vorzunehmen. Wenn Sie das CPAN zum ersten Mal starten,
+          müssen Sie es einrichten und konfigurieren. Auf den meisten Systemen können Sie jedoch
+          die Standardeinstellungen akzeptieren und die erste Frage <computeroutput>Are you ready
+          for manual configuration? [yes]</computeroutput> mit <userinput>no</userinput> beantworten
           damit &app-fq; erfolgreich installiert wird.
         </para>
       </step>
@@ -170,16 +175,13 @@ Translators:
       </step>
 
       <step>
-        <simpara>Führen Sie<menuchoice>
+        <simpara>Führen Sie
+          <menuchoice>
             <guimenu>Start</guimenu> <guisubmenu>&app;</guisubmenu> <guimenuitem>Online-Preisabfrage
             installieren</guimenuitem>
-          </menuchoice>aus.
+          </menuchoice>
+          aus. Dies ist ein kleines Hilfsprogramm, das &app-fq; für Sie installiert.
         </simpara>
-
-        <para>Das &win;-Installationsprogramm von der <ulink url="&url-www;download.phtml">&app; Homepage</ulink>
-          wird zusätzlich mit einem kleinen Hilfsprogramm geliefert, das &app-fq; für Sie
-          installiert.
-        </para>
       </step>
     </procedure>
   </sect1>
@@ -188,7 +190,8 @@ Translators:
     <title>Automatisierte Abfrage von Online-Kursen</title>
 
     <para>Mit dem Kommando <command>gnucash-cli --quotes get
-      <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></command><footnote>
+      <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></command>
+      <footnote>
         <simpara>Der Befehl für den Online-Kursabruf wurde ab &app; 4.0 geändert. Der alte Befehl <command>gnucash
           --add-price-quotes
           <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename></command> ist
@@ -197,14 +200,16 @@ Translators:
           durchgeführt haben, wird empfohlen, den neuen Befehl <command>gnucash-cli</command> zu
           verwenden.
         </simpara>
-      </footnote>können Sie die aktuellen Kurse Ihrer Devisen und Wertpapiere abrufen und direkt in ihre
+      </footnote>
+      können Sie die aktuellen Kurse Ihrer Devisen und Wertpapiere abrufen und direkt in ihre
       &app;-Datendatei schreiben.
     </para>
 
     <para>Die angegebene Datei <filename><replaceable>${HOME}/gnucash-filename</replaceable></filename> ist
       abhängig von dem Namen und dem Speicherort Ihrer Datendatei. Dies lässt sich anhand des
       Namens feststellen, der im oberen Rahmen des &app; Fensters vor dem <quote>-</quote> angezeigt
-      wird.<tip>
+      wird.
+      <tip>
         <para>Der Dateiname ist auch in der Liste der zuletzt geöffneten Dateien im
           <guimenu>Datei</guimenu>-Menü zu finden. Wenn Sie den Mauszeiger über dem Menüeintrag
           mit der Nummer 1 in der Liste der zuletzt geöffneten Dateien platzieren, wird in der
@@ -232,11 +237,18 @@ Translators:
       </step>
 
       <step>
-        <para>Fügen Sie die folgende Zeile in Ihre crontab ein:<informalexample>
+        <para>Fügen Sie die folgende Zeile in Ihre crontab ein:
+          <informalexample>
 <screen>0 16 * * 5 gnucash-cli --quotes get <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
-          </informalexample><warning>
-            <para>Läuft auf Ihrem Rechner zu dem Zeitpunkt des Kursabrufs keine X-Session, so müssen Sie den Aufruf
-              stattdessen wie folgt ausführen:<screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT; gnucash-cli --quotes get <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
+          </informalexample>
+          <warning>
+            <para>Läuft auf Ihrem Rechner zu dem Zeitpunkt des Kursabrufs keine graphische Benutzeroberfläche, die
+              bereits den dbus gestartet hat, so müssen Sie den Eintrag stattdessen wie folgt
+              vornehmen:
+<screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT;
+gnucash-cli --quotes get <replaceable>${HOME}/gnucash-filename</replaceable> > /dev/null 2>&1</screen>
+              (Die Zeilenumbrüche nicht in die crontab übernehmen, die wurden hier nur zum Zwecke
+              der Lesbarkeit eingefügt.)
             </para>
           </warning>
         </para>
@@ -250,9 +262,11 @@ Translators:
       </para>
 
       <step>
-        <simpara>Wählen Sie<menuchoice>
+        <simpara>Wählen Sie
+          <menuchoice>
             <guimenu>Start</guimenu><guisubmenu>Systemsteuerung</guisubmenu><guimenuitem>Aufgabenplanung</guimenuitem>
-          </menuchoice>.
+          </menuchoice>
+          .
         </simpara>
       </step>
 



Summary of changes:
 manual/C/ch_Finance-Quote.xml  | 97 ++++++++++++++++++++++++------------------
 manual/de/ch_Finance-Quote.xml | 96 +++++++++++++++++++++++------------------
 2 files changed, 110 insertions(+), 83 deletions(-)



More information about the gnucash-changes mailing list