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