gnucash-docs stable: Multiple changes pushed
Frank H.Ellenberger
fell at code.gnucash.org
Mon Jan 15 20:45:09 EST 2024
Updated via https://github.com/Gnucash/gnucash-docs/commit/80842e12 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/f872c989 (commit)
from https://github.com/Gnucash/gnucash-docs/commit/3911350b (commit)
commit 80842e12436cc18ac3620107d6d56d0fbc3dcef6
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Tue Jan 16 02:44:19 2024 +0100
C, de:Manual:Finance-Quote: Note about Expected Time Commitment
diff --git a/C/manual/ch_Finance-Quote.docbook b/C/manual/ch_Finance-Quote.docbook
index 6704b4f5..6a149bf3 100644
--- a/C/manual/ch_Finance-Quote.docbook
+++ b/C/manual/ch_Finance-Quote.docbook
@@ -154,6 +154,14 @@ SYNOPSIS
is displayed, you will have to continue with this chapter.
</para>
+ <note>
+ <title>Expected Time Commitment</title>
+
+ <simpara>Depending on the quality of your internet connection and CPUs the initial installation can keep your
+ your computer one hour or more busy.
+ </simpara>
+ </note>
+
<para>The process of installing &app-fq; depends on the system. For the different supported systems, you
can follow the instructions below:
</para>
@@ -171,8 +179,8 @@ SYNOPSIS
</simpara>
<tip>
- <simpara>If that fails with <computeroutput>sudo: gnc-fq-update: Command not found</computeroutput>
- enter <userinput>which gnc-fq-update</userinput>. It might return a path like
+ <simpara>If that fails with <computeroutput>sudo: gnc-fq-update: Command not found</computeroutput> enter
+ <userinput>which gnc-fq-update</userinput>. It might return a path like
<computeroutput>/usr/local/bin/gnc-fq-update</computeroutput>. Redo the command with
that returned path: <userinput>sudo /usr/local/bin/gnc-fq-update</userinput>.
</simpara>
diff --git a/de/manual/ch_Finance-Quote.docbook b/de/manual/ch_Finance-Quote.docbook
index 13bbb289..fba2c4ec 100644
--- a/de/manual/ch_Finance-Quote.docbook
+++ b/de/manual/ch_Finance-Quote.docbook
@@ -157,6 +157,14 @@ SYNOPSIS
Wenn nicht, dann gibt Ihnen dieser Abschnitt eine Anleitung zur Installation.
</para>
+ <note>
+ <title>Erwarteter Zeitaufwand</title>
+
+ <simpara>Abhängig von der Qualität Ihrer Internetverbindung und CPUs kann die erstmalige Installation Ihren
+ Computer eine Stunde oder länger beschäftigen.
+ </simpara>
+ </note>
+
<para>Die Installation von &app-fq; unterscheidet sich von einem Betriebssystem zum anderen. Für die
verschiedenen unterstützten Systeme, können Sie die folgenden Anweisungen befolgen:
</para>
@@ -170,16 +178,18 @@ SYNOPSIS
</step>
<step>
- <simpara>Aktualisieren Sie &app-fq; mit <userinput>sudo gnc-fq-update</userinput>. Der Befehl
- kann auch für eine Neuinstallation verwendet werden. Die richtige Syntax ist von der
- jeweiligen Distribution abhängig.
+ <simpara>Aktualisieren Sie &app-fq; mit <userinput>sudo gnc-fq-update</userinput>. Der Befehl kann auch für
+ eine Neuinstallation verwendet werden. Die richtige Syntax ist von der jeweiligen
+ Distribution abhängig.
</simpara>
<tip>
- <simpara>Falls das mit der Meldung <computeroutput>sudo: gnc-fq-update: Befehl nicht gefunden</computeroutput>
- fehlschlägt, geben Sie <userinput>which gnc-fq-update</userinput> ein. Das sollte einen Pfad wie
- <computeroutput>/usr/local/bin/gnc-fq-update</computeroutput> zuückliefern. Wiederholen Sie den Befehl
- mit jenem zurückgelieferten Pfad: <userinput>sudo /usr/local/bin/gnc-fq-update</userinput>.
+ <simpara>Falls das mit der Meldung <computeroutput>sudo: gnc-fq-update: Befehl nicht
+ gefunden</computeroutput> fehlschlägt, geben Sie <userinput>which
+ gnc-fq-update</userinput> ein. Das sollte einen Pfad wie
+ <computeroutput>/usr/local/bin/gnc-fq-update</computeroutput> zuückliefern. Wiederholen
+ Sie den Befehl mit jenem zurückgelieferten Pfad: <userinput>sudo
+ /usr/local/bin/gnc-fq-update</userinput>.
</simpara>
</tip>
</step>
@@ -190,10 +200,11 @@ SYNOPSIS
<envar>PATH</envar> eingetragen ist.
<footnote>
<simpara>Wenn Sie die von Ihrer Distribution bereitgestellten &app; Pakete installiert haben, sollte
- &app-cli; bereits in Ihrem <envar>PATH</envar> sein. Die &app-fq; Version, die von Ihrem Paketmanager
- bereitgestellt wird, kann unter <ulink url="&url-repo;perl:finance-quote/versions">
- <citetitle>&app-fq;-versions</citetitle></ulink> nachgelesen werden oder mit dem info-Befehl
- der Softwareverwaltung überprüft werden.
+ &app-cli; bereits in Ihrem <envar>PATH</envar> sein. Die &app-fq; Version, die von
+ Ihrem Paketmanager bereitgestellt wird, kann unter
+ <ulink url="&url-repo;perl:finance-quote/versions">
+ <citetitle>&app-fq;-versions</citetitle></ulink> nachgelesen werden oder mit dem
+ info-Befehl der Softwareverwaltung überprüft werden.
</simpara>
</footnote>
</simpara>
@@ -290,9 +301,10 @@ SYNOPSIS
</abstract>
<note>
- <para>In &app; Version 4.x und früher wurden die separaten Perl-Programme <userinput>gnc-fq-check</userinput>
- an Stelle von <userinput>gnucash-cli --quote info</userinput> und <userinput>gnc-fq-dump</userinput>
- anstatt <userinput>gnucash-cli --quote dump</userinput> verwendet.
+ <para>In &app; Version 4.x und früher wurden die separaten Perl-Programme
+ <userinput>gnc-fq-check</userinput> an Stelle von <userinput>gnucash-cli --quote
+ info</userinput> und <userinput>gnc-fq-dump</userinput> anstatt <userinput>gnucash-cli
+ --quote dump</userinput> verwendet.
</para>
</note>
@@ -300,9 +312,10 @@ SYNOPSIS
<title>Anzeige der &app-fq; Version und der unterstützten Quellen</title>
<abstract>
- <para>Die Nutzung der Option <replaceable>--quotes info</replaceable> liefert die Versionsnummer des derzeit
- installierten &app-fq; Moduls sowie eine Liste der verfügbaren Quellen. Es informiert Sie
- auch, wenn es ein Problem mit Ihrer Installation gibt und nennt die Gründe dafür.
+ <para>Die Nutzung der Option <replaceable>--quotes info</replaceable> liefert die Versionsnummer des
+ derzeit installierten &app-fq; Moduls sowie eine Liste der verfügbaren Quellen. Es
+ informiert Sie auch, wenn es ein Problem mit Ihrer Installation gibt und nennt die Gründe
+ dafür.
</para>
</abstract>
@@ -314,10 +327,18 @@ SYNOPSIS
<cmdsynopsis>
<command>gnucash-cli</command>
<group choice="req">
- <arg choice="plain">-Q</arg>
- <arg choice="plain">--quotes</arg>
+ <arg choice="plain">
+ -Q
+ </arg>
+
+ <arg choice="plain">
+ --quotes
+ </arg>
</group>
- <arg choice="plain">info</arg>
+
+ <arg choice="plain">
+ info
+ </arg>
</cmdsynopsis>
im Terminal erzeugt die folgende Ausgabe:
</para>
@@ -348,8 +369,8 @@ yahoo_json yahooweb za
</informalexample>
<para>Wenn es ein Problem mit Ihrer Installation gibt, werden Sie darauf hingeweisen. In dem nachfolgend
- aufgeführtem Beispiel wird auf Probleme mit den &app-perl;-Modulen Finance::Quote und JSON::Parse
- hingewiesen:
+ aufgeführtem Beispiel wird auf Probleme mit den &app-perl;-Modulen Finance::Quote und
+ JSON::Parse hingewiesen:
</para>
<informalexample>
@@ -370,9 +391,10 @@ Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
<title>Abfrage von Kursen in einem Terminalfenster</title>
<abstract>
- <para>Die Option <replaceable>--quotes dump</replaceable> liefert Kursdaten für eine Kursquelle und eine Liste
- von Symbolen in einem Format, das für Menschen leicht zu lesen ist. Dies ist nützlich,
- um zu überprüfen, ob eine bestimmte Online-Kursquelle erreichbar ist und Daten liefert.
+ <para>Die Option <replaceable>--quotes dump</replaceable> liefert Kursdaten für eine Kursquelle und eine
+ Liste von Symbolen in einem Format, das für Menschen leicht zu lesen ist. Dies ist
+ nützlich, um zu überprüfen, ob eine bestimmte Online-Kursquelle erreichbar ist und
+ Daten liefert.
</para>
<para>Weiterhin können Sie überprüfen, ob das <xref linkend="tool-ge-Symbol" />, welches Sie für Ihr
@@ -385,8 +407,8 @@ Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
<para>Sie können <userinput>gnucash-cli --quotes dump</userinput> verwenden, um Kursquellen und Symbole
einzeln zu testen, wenn &app; einen Fehler beim Abrufen von Kursen meldet. Der Befehl
zeigt die Felder an, die von &app; genutzt werden. Verwenden Sie die Optionen
- <userinput>gnucash-cli --verbose --quotes dump</userinput>, um alle Informationen zu sehen, die
- &app-fq; von der Kursquelle erhält.
+ <userinput>gnucash-cli --verbose --quotes dump</userinput>, um alle Informationen zu
+ sehen, die &app-fq; von der Kursquelle erhält.
</para>
</tip>
@@ -395,16 +417,36 @@ Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
<cmdsynopsis>
<command>gnucash-cli</command>
<group choice="req">
- <arg choice="plain">-Q</arg>
- <arg choice="plain">--quotes</arg>
+ <arg choice="plain">
+ -Q
+ </arg>
+
+ <arg choice="plain">
+ --quotes
+ </arg>
</group>
- <arg choice="plain">dump</arg>
+
+ <arg choice="plain">
+ dump
+ </arg>
+
<group choice="opt">
- <arg choice="plain">-V</arg>
- <arg choice="plain">--verbose</arg>
+ <arg choice="plain">
+ -V
+ </arg>
+
+ <arg choice="plain">
+ --verbose
+ </arg>
</group>
- <arg choice="plain"><replaceable>Quelle</replaceable></arg>
- <arg choice="plain" rep="repeat"><replaceable>Symbol</replaceable></arg>
+
+ <arg choice="plain">
+ <replaceable>Quelle</replaceable>
+ </arg>
+
+ <arg choice="plain" rep="repeat">
+ <replaceable>Symbol</replaceable>
+ </arg>
</cmdsynopsis>
</para>
@@ -415,8 +457,8 @@ Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
<listitem>
<para>Für den Abruf von Devisenkursen wird die Quelle <userinput>currency</userinput> verwendet, welche
- mindestens zwei <ulink url="&url-wp-de;ISO_4217">ISO 4217</ulink> Währungscodes erfordern;
- die Wechselkurse werden in der ersten Währung angegeben.
+ mindestens zwei <ulink url="&url-wp-de;ISO_4217">ISO 4217</ulink>
+ Währungscodes erfordern; die Wechselkurse werden in der ersten Währung angegeben.
<footnote>
<para>Seit &app-fq; 1.41 ist die Standardquelle für Währungen <quote>Alpha Vantage</quote>. Lesen Sie
auch die Hinweise dazu in <xref linkend="gnc-tbl-fq-currency-source" />.
@@ -464,8 +506,8 @@ $ gnucash-cli --quotes dump yahooweb AAPL
</listitem>
<listitem>
- <para>Mit der Option <userinput>--verbose</userinput> wird eine längere Ausgabe mit allen Datenfeldern von
- &app-fq; zurückgegeben. Dies kann nützlich sein, um Probleme mit einem
+ <para>Mit der Option <userinput>--verbose</userinput> wird eine längere Ausgabe mit allen Datenfeldern
+ von &app-fq; zurückgegeben. Dies kann nützlich sein, um Probleme mit einem
&app-fq; Quellmodul zu beheben.
<informalexample>
<?dbfo pgwide="1"?>
@@ -493,8 +535,8 @@ currency_set_by_fq => 1
<note>
<para>Beachten Sie, dass wir in diesem Fall als Quelle alphavantage verwendet und den
<userinput>ALPHAVANTAGE_API_KEY</userinput> in der Befehlszeile angegeben
- haben. Das ist nicht notwendig, wenn der Schlüssel bereits in &mc.ed.pref;
- <xref linkend="prefs-online-quotes" /> gespeichert ist.
+ haben. Das ist nicht notwendig, wenn der Schlüssel bereits in
+ &mc.ed.pref; <xref linkend="prefs-online-quotes" /> gespeichert ist.
</para>
</note>
</para>
@@ -526,12 +568,14 @@ currency_set_by_fq => 1
</step>
<step>
- <para>Klicken Sie auf die Schaltfläche <guilabel>Wechselkurs abrufen</guilabel> im <xref linkend="trans-win-enter" />.
+ <para>Klicken Sie auf die Schaltfläche <guilabel>Wechselkurs abrufen</guilabel> im
+ <xref linkend="trans-win-enter" />.
</para>
</step>
</procedure>
- <para>Sind die Kursquelle sowie das Symbol richtig eingestellt, wird der aktuelle Kurs in das Feld für den Wechselkurs eingetragen.
+ <para>Sind die Kursquelle sowie das Symbol richtig eingestellt, wird der aktuelle Kurs in das Feld für
+ den Wechselkurs eingetragen.
</para>
</sect2>
commit f872c98901b25564bf12772981c1850c3c3b559e
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Tue Jan 16 01:11:36 2024 +0100
C, de:Manual:Finance-Quote: Tip about 'gnc-fq-update: Command not found'
diff --git a/C/manual/ch_Finance-Quote.docbook b/C/manual/ch_Finance-Quote.docbook
index 9c7ee830..6704b4f5 100644
--- a/C/manual/ch_Finance-Quote.docbook
+++ b/C/manual/ch_Finance-Quote.docbook
@@ -149,9 +149,9 @@ SYNOPSIS
[...]
</screen>
</informalexample>
- If you are now shown documentation, then &app-fq; is already installed and you can
- configure periodical quotes update as described in <xref linkend="fq-auto-quote" />. If no
- documentation is displayed, you will have to continue with this chapter.
+ If you are now shown documentation, then &app-fq; is already installed and you can configure
+ periodical quotes update as described in <xref linkend="fq-auto-quote" />. If no documentation
+ is displayed, you will have to continue with this chapter.
</para>
<para>The process of installing &app-fq; depends on the system. For the different supported systems, you
@@ -169,6 +169,14 @@ SYNOPSIS
<step>
<simpara>Next, update &app-fq; with <userinput>sudo gnc-fq-update</userinput>.
</simpara>
+
+ <tip>
+ <simpara>If that fails with <computeroutput>sudo: gnc-fq-update: Command not found</computeroutput>
+ enter <userinput>which gnc-fq-update</userinput>. It might return a path like
+ <computeroutput>/usr/local/bin/gnc-fq-update</computeroutput>. Redo the command with
+ that returned path: <userinput>sudo /usr/local/bin/gnc-fq-update</userinput>.
+ </simpara>
+ </tip>
</step>
<step>
@@ -176,9 +184,10 @@ SYNOPSIS
already in a directory that is entered in the <envar>PATH</envar> environment variable.
<footnote>
<simpara>If you’ve installed &app; packages provided by your distribution, &app-cli; will be on your
- <envar>PATH</envar>. The &app-fq; version provided by your package manager can be checked
- at <ulink url="&url-repo;perl:finance-quote/versions">
- <citetitle>&app-fq;-versions</citetitle></ulink> or by using your package manager's info command.
+ <envar>PATH</envar>. The &app-fq; version provided by your package manager can be
+ checked at <ulink url="&url-repo;perl:finance-quote/versions">
+ <citetitle>&app-fq;-versions</citetitle></ulink> or by using your package manager's
+ info command.
</simpara>
</footnote>
</simpara>
@@ -186,8 +195,9 @@ SYNOPSIS
<step>
<simpara>If &app-fq; works properly, the command returns the version number of &app-fq; module currently
- installed as well as a list of sources available via the &app-fq; module. It will also inform
- you if there is a problem with your installation or if it is missing, and may suggest a fix.
+ installed as well as a list of sources available via the &app-fq; module. It will also
+ inform you if there is a problem with your installation or if it is missing, and may
+ suggest a fix.
</simpara>
</step>
</procedure>
@@ -266,17 +276,17 @@ SYNOPSIS
<abstract>
<para>&app; provides a commandline facility &app-cli; that one can use with the
- <replaceable>--quotes</replaceable> option in a terminal session to check the
- version and supported source modules, to display the quotes or exchange rates for selected
- securities or currencies, or to update all of the prices in a book without launching the
- GUI.
+ <replaceable>--quotes</replaceable> option in a terminal session to check the version and
+ supported source modules, to display the quotes or exchange rates for selected securities or
+ currencies, or to update all of the prices in a book without launching the GUI.
</para>
</abstract>
<note>
<para>In &app; version 4.x and earlier one used separate perl programs <userinput>gnc-fq-check</userinput>
- instead of <userinput>gnucash-cli --quote info</userinput> and <userinput>gnc-fq-dump</userinput>
- instead of <userinput>gnucash-cli --quote dump</userinput>.
+ instead of <userinput>gnucash-cli --quote info</userinput> and
+ <userinput>gnc-fq-dump</userinput> instead of <userinput>gnucash-cli --quote
+ dump</userinput>.
</para>
</note>
@@ -290,17 +300,26 @@ SYNOPSIS
</para>
</abstract>
- <para>The latest &app-fq; version is &app-fq-vers;. The list of sources that follows depends on the &app-fq; version.
+ <para>The latest &app-fq; version is &app-fq-vers;. The list of sources that follows depends on the
+ &app-fq; version.
</para>
<para>The input of
<cmdsynopsis>
<command>gnucash-cli</command>
<group choice="req">
- <arg choice="plain">-Q</arg>
- <arg choice="plain">--quotes</arg>
+ <arg choice="plain">
+ -Q
+ </arg>
+
+ <arg choice="plain">
+ --quotes
+ </arg>
</group>
- <arg choice="plain">info</arg>
+
+ <arg choice="plain">
+ info
+ </arg>
</cmdsynopsis>
in the terminal produces the following output:
</para>
@@ -357,16 +376,16 @@ Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
particular online quote source is accessible and provides data.
</para>
- <para>You can also check to see if the symbol you want to use for your online
- price retrieval is available at the desired quote source.
+ <para>You can also check to see if the symbol you want to use for your online price retrieval is available
+ at the desired quote source.
</para>
</abstract>
<tip>
- <para>You may use <userinput>gnucash-cli --quotes dump</userinput> to test quote sources and symbols
+ <para>You may use <userinput>gnucash-cli --quotes dump</userinput> to test quote sources and symbols
individually should &app; report an error during quote retrieval. The command will show
- the fields required by &app;; use <userinput>gnucash-cli --verbose --quotes dump</userinput>
- to see all of the information returned by &app-fq;.
+ the fields required by &app;; use <userinput>gnucash-cli --verbose --quotes
+ dump</userinput> to see all of the information returned by &app-fq;.
</para>
</tip>
@@ -375,16 +394,36 @@ Failed to initialize Finance::Quote: missing_modules Finance::Quote JSON::Parse
<cmdsynopsis>
<command>gnucash-cli</command>
<group choice="req">
- <arg choice="plain">-Q</arg>
- <arg choice="plain">--quotes</arg>
+ <arg choice="plain">
+ -Q
+ </arg>
+
+ <arg choice="plain">
+ --quotes
+ </arg>
</group>
- <arg choice="plain">dump</arg>
+
+ <arg choice="plain">
+ dump
+ </arg>
+
<group choice="opt">
- <arg choice="plain">-V</arg>
- <arg choice="plain">--verbose</arg>
+ <arg choice="plain">
+ -V
+ </arg>
+
+ <arg choice="plain">
+ --verbose
+ </arg>
</group>
- <arg choice="plain"><replaceable>Source</replaceable></arg>
- <arg choice="plain" rep="repeat"><replaceable>Symbol</replaceable></arg>
+
+ <arg choice="plain">
+ <replaceable>Source</replaceable>
+ </arg>
+
+ <arg choice="plain" rep="repeat">
+ <replaceable>Symbol</replaceable>
+ </arg>
</cmdsynopsis>
</para>
@@ -489,29 +528,30 @@ currency_set_by_fq => 1
<para>To test if &app-fq; works for currencies inside &app;, do the following:
</para>
- <step>
- <para>create a transaction with the desired commodity in the book currency,
- </para>
- </step>
+ <step>
+ <para>create a transaction with the desired commodity in the book currency,
+ </para>
+ </step>
- <step>
- <para>make a right click on it,
- </para>
- </step>
+ <step>
+ <para>make a right click on it,
+ </para>
+ </step>
- <step>
- <para>select &gmi.ac.ed-ex; in the context menu.
- </para>
- </step>
+ <step>
+ <para>select &gmi.ac.ed-ex; in the context menu.
+ </para>
+ </step>
- <step>
- <para>In the <xref linkend="trans-win-enter" /> window click the <guilabel>Get exchange rate</guilabel> button.
- </para>
- </step>
+ <step>
+ <para>In the <xref linkend="trans-win-enter" /> window click the <guilabel>Get exchange rate</guilabel>
+ button.
+ </para>
+ </step>
</procedure>
- <para>If the exchange rate source and the symbol are set, the current
- rate will be entered in the exchange rate field.
+ <para>If the exchange rate source and the symbol are set, the current rate will be entered in the exchange
+ rate field.
</para>
</sect2>
diff --git a/de/manual/ch_Finance-Quote.docbook b/de/manual/ch_Finance-Quote.docbook
index bd85cb23..13bbb289 100644
--- a/de/manual/ch_Finance-Quote.docbook
+++ b/de/manual/ch_Finance-Quote.docbook
@@ -174,6 +174,14 @@ SYNOPSIS
kann auch für eine Neuinstallation verwendet werden. Die richtige Syntax ist von der
jeweiligen Distribution abhängig.
</simpara>
+
+ <tip>
+ <simpara>Falls das mit der Meldung <computeroutput>sudo: gnc-fq-update: Befehl nicht gefunden</computeroutput>
+ fehlschlägt, geben Sie <userinput>which gnc-fq-update</userinput> ein. Das sollte einen Pfad wie
+ <computeroutput>/usr/local/bin/gnc-fq-update</computeroutput> zuückliefern. Wiederholen Sie den Befehl
+ mit jenem zurückgelieferten Pfad: <userinput>sudo /usr/local/bin/gnc-fq-update</userinput>.
+ </simpara>
+ </tip>
</step>
<step>
Summary of changes:
C/manual/ch_Finance-Quote.docbook | 144 ++++++++++++++++++++++++-------------
de/manual/ch_Finance-Quote.docbook | 128 +++++++++++++++++++++++----------
2 files changed, 186 insertions(+), 86 deletions(-)
More information about the gnucash-changes
mailing list