gnucash-docs maint: manual ch_Finance-Quote: further improvements

Frank H.Ellenberger fell at code.gnucash.org
Sat Sep 24 16:06:52 EDT 2022


Updated	 via  https://github.com/Gnucash/gnucash-docs/commit/f2ea7510 (commit)
	from  https://github.com/Gnucash/gnucash-docs/commit/f0fa8a2d (commit)



commit f2ea7510b2af7f4d42c807eb6b432574f3d169f5
Author: Christian Wehling <christian.wehling at web.de>
Date:   Thu Aug 25 20:36:11 2022 +0200

    manual ch_Finance-Quote: further improvements
    
    * Spelling mistake corrected
    * Program calls under Windows improved
    * Adjust the width of <screen> elements.

diff --git a/manual/C/ch_Finance-Quote.xml b/manual/C/ch_Finance-Quote.xml
index 1e0ba3cc..969c5402 100644
--- a/manual/C/ch_Finance-Quote.xml
+++ b/manual/C/ch_Finance-Quote.xml
@@ -58,9 +58,12 @@ Translators:
 
     <para>To check if &app-perl; is already installed on your system, call the command
       <userinput>perl -v</userinput> in the terminal.
+<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
+    <informalexample><?dbfo pgwide="1"?>
 <screen language="console">$ perl -v
 This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-thread-multi
 </screen>
+    </informalexample>
       If you are shown the version number of the &app-perl; interpreter, skip the next details
       and continue instead with <xref linkend="finance-quote-install" />.
     </para>
@@ -125,7 +128,7 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
 
     <tip>
       <para>Afterwards it’s a good idea to include the folder where &app; is installed,
-        under &win; e.g. <userinput>c:\Programme<replaceable> (x86)</replaceable>gnucash\bin</userinput>,
+        under &win; e.g. <userinput><replaceable>C:\Program Files (x86)\gnucash\bin</replaceable></userinput>,
         to your <envar>PATH</envar> environment variable.
         This way it’s easier for you to use some <xref linkend="finance-quote-helper" /> when needed.
         Please refer to the documentation for your operating system for more information.
@@ -139,6 +142,8 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
     <para>To determine if the &app-perl; module &app-fq; is already installed on your system, type
       <userinput>perldoc Finance::Quote</userinput> in a terminal window and check to see if there is
       any documentation
+<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
+    <informalexample><?dbfo pgwide="1"?>
 <screen language="console">
 $ perldoc Finance::Quote
 NAME
@@ -147,6 +152,7 @@ NAME
 SYNOPSIS
        [...]
 </screen>
+    </informalexample>
       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.
@@ -179,21 +185,11 @@ SYNOPSIS
       </step>
 
       <step>
-        <simpara>Next, update with <userinput>sudo gnc-fq-update</userinput> or <userinput>su -c gnc-fq-update</userinput>
-          with root privileges &app-fq; It depends on your distribution.
+        <simpara>Next, update with <userinput>sudo gnc-fq-update</userinput>
+          or <userinput>su -c gnc-fq-update</userinput> with root privileges
+          &app-fq;. It depends on your distribution. For more information,
+          see the next chapter at <xref linkend="gnc-fq-update" />.
         </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.
-            </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.
-        </para>
       </step>
 
       <step>
@@ -216,12 +212,13 @@ SYNOPSIS
       <step>
         <simpara>Install &app-xcode;
           <footnote>
-            <para>&app-xcode; is an optional tool from your
-              &mac; distribution DVD, but also at <ulink url="&url-ap-dev;xcode/" />
-              the application is also available.
+            <para>You can install &app-xcode; from the App Store or install the
+              much smaller Xcode command line tools by running <userinput>
+              sudo xcode-select --install</userinput> from a Terminal.app prompt.
             </para>
           </footnote>
-         if it is not installed.
+         if it is not installed. It contains devel tools, which are required
+         by CPAN to build and test the needed &app-fq; modules.
         </simpara>
       </step>
 
@@ -255,11 +252,11 @@ SYNOPSIS
     <title>Helper Scripts for Update and Diagnostics</title>
 
     <abstract>
-      <para>&app; provides several utilities that support you in your daily work with &app-fq;.
-        So there is a script with which you can check your symbols for the securities. Other
-        scripts perform the initial installation or keep &app-fq; up to date.
-        &app-fq; software module. These programs have names that begin with gnc-fq-*, and are
-        themselves written in the &app-perl; programming language. 
+      <para>&app; provides several utilities that will help you select the
+        correct symbols and verification for the desired online
+        quote source. Another script performs the first-time
+        installation or keeps &app-fq; up to date.
+        And finally, tools for error analysis are also available.
       </para>
     </abstract>
 
@@ -274,18 +271,13 @@ SYNOPSIS
         </simpara>
       </step>
 
-      <step>
-        <simpara>Change to the drive containing the &app; program files —usually C drive—
-          if that is not already the current drive.
-        </simpara>
-      </step>
-
       <step>
         <simpara>Since, as previously recommended, the GnuCash directory was entered in the <envar>PATH</envar>
           envinronment variable, prefix any gnc-fq-xxx &app-perl; script command with
           <quote>Perl</quote> and a space, e.g. <userinput>perl gnc-fq-check</userinput>.
-          Otherweise you have to execute the command e.g. <userinput>perl c:\Program Files
-          <replaceable> (x86)</replaceable>\gnucash\bin\gnc-fq-check</userinput>.
+          Otherwise you have to execute the command e.g. <userinput><replaceable>
+          C:\strawberry-perl\bin\</replaceable>perl.exe <replaceable>C:\Program Files (x86)\gnucash\bin\
+          </replaceable>gnc-fq-check</userinput>.
         </simpara>
       </step>
     </procedure>
@@ -300,33 +292,33 @@ SYNOPSIS
         </para>
       </abstract>
 
-      <formalpara>
-        <title>Example with broken dependency</title>
-
-        <para>
+<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
+      <informalexample><?dbfo pgwide="1"?>
 <screen language="console">
-$ gnc-fq-check 
-Can't locate Mozilla/CA.pm in @INC (you may need to install the Mozilla::CA module) (@INC contains:
-/usr/lib/perl5/site_perl/5.30.1/x86_64-linux-thread-multi /usr/lib/perl5/site_perl/5.30.1
-/usr/lib/perl5/vendor_perl/5.30.1/x86_64-linux-thread-multi /usr/lib/perl5/vendor_perl/5.30.1
-/usr/lib/perl5/5.30.1/x86_64-linux-thread-multi /usr/lib/perl5/5.30.1 /usr/lib/perl5/site_perl)
+$ gnc-fq-check
+Can't locate Mozilla/CA.pm in @INC (you may need to install the Mozilla::CA module)
+(@INC contains: /usr/lib/perl5/site_perl/5.30.1/x86_64-linux-thread-multi /usr/
+lib/perl5/site_perl/5.30.1 /usr/lib/perl5/vendor_perl/5.30.1/x86_64-linux-thread-multi
+/usr/lib/perl5/vendor_perl/5.30.1 /usr/lib/perl5/5.30.1/x86_64-linux-thread-multi
+/usr/lib/perl5/5.30.1 /usr/lib/perl5/site_perl)
 at /usr/lib/perl5/vendor_perl/5.30.1/Finance/Quote/Tiaacref.pm line 33.
 Compilation failed in require at (eval 303) line 1.
 BEGIN failed--compilation aborted at (eval 303) line 1.
  at /usr/local/bin/gnc-fq-check line 91.
-("1.47" "adig" "aex" "aiahk" "alphavantage" "amfiindia" "asegr" "asia" "asx" "australia" "bamosz"
-"bet" "bmonesbittburns" "bourso" "brasil" "bse" "bsero" "canada" "canadamutual" "citywire" "cominvest"
-"cse" "deka" "dutch" "dwsfunds" "europe" "fetch_live_currencies" "fidelity" "fidelity_direct"
-"fidelityfixed" "financecanada" "finanzpartner" "finland" "fool" "france" "ftfunds" "ftportfolios"
-"ftportfolios_direct" "fundlibrary" "goldmoney" "greece" "hex" "hu" "hufund" "hungary" "hustock"
-"indiamutual" "known_currencies" "lerevenu" "maninv" "morningstar" "morningstarjp" "mstaruk" "nasdaq"
-"nyse" "nz" "nzx" "platinum" "romania" "seb_funds" "sixfunds" "sixshares" "stockhousecanada_fund"
-"tdefunds" "tdwaterhouse" "tiaacref" "tnetuk" "troweprice" "troweprice_direct" "trustnet" "tsp" "tsx"
-"uk_unit_trusts" "ukfunds" "unionfunds" "usa" "usfedbonds" "vanguard" "vwd" "yahoo" "yahoo_asia"
-"yahoo_australia" "yahoo_brasil" "yahoo_europe" "yahoo_json" "yahoo_nz" "yahoo_yql" "za" "za_unittrusts")
+("1.47" "adig" "aex" "aiahk" "alphavantage" "amfiindia" "asegr" "asia" "asx"
+"australia" "bamosz" "bet" "bmonesbittburns" "bourso" "brasil" "bse" "bsero" "canada"
+"canadamutual" "citywire" "cominvest" "cse" "deka" "dutch" "dwsfunds" "europe"
+"fetch_live_currencies" "fidelity" "fidelity_direct" "fidelityfixed" "financecanada"
+"finanzpartner" "finland" "fool" "france" "ftfunds" "ftportfolios" "ftportfolios_direct"
+"fundlibrary" "goldmoney" "greece" "hex" "hu" "hufund" "hungary" "hustock" "indiamutual"
+"known_currencies" "lerevenu" "maninv" "morningstar" "morningstarjp" "mstaruk" "nasdaq"
+"nyse" "nz" "nzx" "platinum" "romania" "seb_funds" "sixfunds" "sixshares"
+"stockhousecanada_fund" "tdefunds" "tdwaterhouse" "tiaacref" "tnetuk" "troweprice"
+"troweprice_direct" "trustnet" "tsp" "tsx" "uk_unit_trusts" "ukfunds" "unionfunds"
+"usa" "usfedbonds" "vanguard" "vwd" "yahoo" "yahoo_asia" "yahoo_australia"
+"yahoo_brasil" "yahoo_europe" "yahoo_json" "yahoo_nz" "yahoo_yql" "za" "za_unittrusts")
 </screen>
-        </para>
-      </formalpara>
+      </informalexample>
 
       <para>The first part is the error message about a missing &app-perl;-modul Mozilla/CA.pm. At the end in
         parentheses is the normal output of the currently installed &app-fq; version<footnote>
@@ -358,6 +350,19 @@ BEGIN failed--compilation aborted at (eval 303) line 1.
         <para>This program needs superuser or administrative privileges to succeed in &lin; or &mac; but not in &win;.
         </para>
       </note>
+
+      <para><userinput>gnc-fq-update</userinput> 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.
+      </para>
     </sect2>
 
     <sect2 id="gnc-fq-dump">
@@ -377,9 +382,8 @@ BEGIN failed--compilation aborted at (eval 303) line 1.
       
       <tip>
         <para>With <userinput>gnc-fq-dump</userinput> you can check symbols faster than from &app;
-          if an error occurs during the retrieval with &app;, because the output of the script
-          is better suited for analysis and not all working symbols are retrieved each time,
-          if you use <guibutton>Get Quotes</guibutton> in the <xref linkend="tool-price" />.
+          if an error occurs during the retrieval with &app;. This might save you from running
+          &app; with debug logging enabled while checking a nonworking symbol.
         </para>
       </tip>
 
@@ -436,10 +440,10 @@ BEGIN failed--compilation aborted at (eval 303) line 1.
     <sect2 id="gnc-fq-helper">
       <title>gnc-fq-helper</title>
 
-      <para>This is a script that is used to retrieve quotes and does not need to be
-        operated by the user. Should the retrieval of a course in &app; result in
-        failures, this script can be used to perform diagnostics and help developers
-        decide if the error is in &app; or &app-fq;.
+      <para>This is a script that &app; uses to retrieve quotes and not usually
+        useful for the user to run. Should the retrieval of a symbol in &app;
+        result in failures, this script can be used to perform diagnostics
+        and help developers decide if the error is in &app; or &app-fq;.
       </para>
     </sect2>
   </sect1>
diff --git a/manual/de/ch_Finance-Quote.xml b/manual/de/ch_Finance-Quote.xml
index 6475c8a4..7fe6a542 100644
--- a/manual/de/ch_Finance-Quote.xml
+++ b/manual/de/ch_Finance-Quote.xml
@@ -45,7 +45,7 @@ Translators:
     </para>
   </note>
 
-  <para>Sie können diesen Schritt auch weglassen und Ihre Aktienkurse weiterhin manuell aktualisieren.
+  <para>Sie können diesen Schritt auch weglassen und Ihre Kurse weiterhin manuell aktualisieren.
   </para>
 
   <sect1 id="finance-quote-perl-install">
@@ -59,9 +59,12 @@ Translators:
 
     <para>Um zu überprüfen ob auf Ihrem System &app-perl; bereits installiert ist, rufen Sie den Befehl
       <userinput>perl -v</userinput> im Terminal auf.
+<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
+    <informalexample><?dbfo pgwide="1"?>
 <screen language="console">$ perl -v
 This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-thread-multi
 </screen>
+    </informalexample>
       Wird Ihnen die Versionsnummer des &app-perl;-Interpreters angezeigt, dann überspringen Sie
       die nächsten Angaben und fahren Sie stattdessen mit <xref linkend="finance-quote-install" /> fort.
     </para>
@@ -128,8 +131,8 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
 
     <tip>
       <para>Es empfiehlt sich anschließend, das Verzeichnis in dem &app; installiert ist, unter &win;
-        z.B. <userinput>c:\Programme<replaceable> (x86)</replaceable>\gnucash\bin</userinput>, zu Ihrer
-        <envar>PATH</envar>-Umgebungsvariable hinzuzufügen. Auf diese Weise ist es für einfacher, bei Bedarf die
+        z.B. <userinput><replaceable>C:\Programme (x86)\gnucash\bin</replaceable></userinput>, zu Ihrer
+        <envar>PATH</envar>-Umgebungsvariable hinzuzufügen. Auf diese Weise ist es für Sie einfacher, bei Bedarf die
         <xref linkend="finance-quote-helper" /> zu nutzen. Hierzu informieren Sie sich bitte in
         den Unterlagen zu Ihrem Betriebssystem.
       </para>
@@ -142,6 +145,8 @@ This is perl 5, version 30, subversion 0 (v5.30.0) built for x86_64-linux-gnu-th
     <para>Um festzustellen, ob das &app-perl;-Modul &app-fq; bereits auf Ihrem System verfügbar ist, geben
       Sie <userinput>perldoc Finance::Quote</userinput> in einem Terminalfenster ein. Wird Ihnen jetzt
       eine Dokumentation in dieser Form
+<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
+    <informalexample><?dbfo pgwide="1"?>
 <screen language="console">
 $ perldoc Finance::Quote
 NAME
@@ -150,6 +155,7 @@ NAME
 SYNOPSIS
        [...]
 </screen>
+    </informalexample>
       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 gibt Ihnen dieser Abschnitt eine Anleitung zur Installation.
@@ -184,21 +190,9 @@ SYNOPSIS
       <step>
         <simpara>Als nächstes aktualisieren Sie mit <userinput>sudo gnc-fq-update</userinput> oder
           <userinput>su -c gnc-fq-update</userinput> mit Root-Rechten &app-fq;. Die richtige Syntax
-          ist von der jeweiligen Distribution abhängig.
+          ist von der jeweiligen Distribution abhängig. Weitere Informationen finden Sie im nächsten
+          Kapitel unter <xref linkend="gnc-fq-update" />.
         </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.
-            </simpara>
-          </footnote>
-          Modul gestartet um die Installation vorzunehmen. Wenn Sie das CPAN zum ersten Mal starten,
-          müssen Sie es konfigurieren, wobei Sie auf den meisten Systemen jedoch
-          die Standardvorgaben akzeptieren und die erste Frage <computeroutput>Are you ready for
-          manual configuration? [yes]</computeroutput> mit <userinput>no</userinput> beantworten können,
-          damit &app-fq; erfolgreich installiert wird.
-        </para>
       </step>
 
       <step>
@@ -221,10 +215,13 @@ SYNOPSIS
       <step>
         <simpara>Installieren Sie &app-xcode;
           <footnote>
-            <para>&app-xcode; ist ein optionales Element auf Ihrer &mac; Distributions-DVD, aber auch unter
-              <ulink url="&url-ap-dev;xcode/" /> ist das Werkzeug erhältlich.
+            <para>Sie können &app-xcode; aus dem App Store installieren oder Sie installieren die
+              viel kleineren Xcode-Befehlszeilentools, indem Sie <userinput>
+              sudo xcode-select --install</userinput> in einer Terminal.app Eingabeaufforderung
+              ausführen.
             </para>
-          </footnote>, falls noch nicht geschehen.
+          </footnote>, falls noch nicht geschehen. Es enthält Entwicklungswerkzeuge, die von CPAN
+          benötigt werden, um die benötigten &app-fq; Module zu bauen und zu testen.
         </simpara>
       </step>
 
@@ -260,12 +257,11 @@ SYNOPSIS
     <title>Hilfsprogramme zur Symbolsuche und Aktualisierung</title>
 
     <abstract>
-      <para>&app; stellt mehrere Hilfsprogramme zur Verfügung, die Sie bei der täglichen
-        Arbeit mit &app-fq; unterstützen. So gibt es ein Skript, mit dem Sie Ihre Symbole
-        für die Wertpapiere überprüfen können. Weitere Skripte führen die erstmalige
-        Installation durch oder halten &app-fq; auf einem aktuellen Stand.
-        Diese Programme haben Namen, die mit gnc-fq-* beginnen, und sind in der
-        Programmiersprache &app-perl; geschrieben.
+      <para>&app; bietet Hilfsprogramme, die Sie bei der Auswahl der
+        richtigen Symbole und der Verifikation für die gewünschte Online-
+        Kursquelle unterstützen. Ein weiteres Skript führt die erstmalige
+        Installation durch oder bringt &app-fq; auf den aktuellen Stand.
+        Und letztendlich stehen auch Tools zur Fehleranalyse bereit.
       </para>
     </abstract>
 
@@ -280,19 +276,14 @@ SYNOPSIS
         </simpara>
       </step>
 
-      <step>
-        <simpara>Wechseln Sie zu dem Laufwerk, das die &app; Programmdateien enthält —normalerweise das
-          Laufwerk C— wenn dies nicht bereits das aktuelle Laufwerk ist.
-        </simpara>
-      </step>
-
       <step>
         <simpara>Da, wie zuvor empfohlen, das &app;-Verzeichnis in die <envar>PATH</envar>
           Umgebungsvariable eingetragen wurde, müssen Sie jetzt nur noch jedem gnc-fq-xxx
           &app-perl; Skriptbefehl <quote>Perl</quote> und ein Leerzeichen voranstellen,
           z.B. <userinput>perl gnc-fq-check</userinput>.
-          Andernfalls müssen Sie den Befehl in der Form <userinput>perl c:\Programme
-          <replaceable> (x86)</replaceable>\gnucash\bin\gnc-fq-check</userinput> ausführen.
+          Andernfalls müssen Sie den Befehl in der Form <userinput><replaceable>
+          C:\strawberry-perl\bin\</replaceable>perl.exe <replaceable>C:\Programme (x86)\gnucash\bin\
+          </replaceable>gnc-fq-check</userinput> ausführen.
         </simpara>
       </step>
     </procedure>
@@ -307,33 +298,33 @@ SYNOPSIS
         </para>
       </abstract>
 
-      <formalpara>
-        <title>Beispiel mit defekten Abhängigkeit zu weiteren Softwarepaketen</title>
-
-        <para>
+<!-- Fixme: https://bugs.gnucash.org/show_bug.cgi?id=798618 -->
+      <informalexample><?dbfo pgwide="1"?>
 <screen language="console">
-$ gnc-fq-check 
-Can't locate Mozilla/CA.pm in @INC (you may need to install the Mozilla::CA module) (@INC contains:
-/usr/lib/perl5/site_perl/5.30.1/x86_64-linux-thread-multi /usr/lib/perl5/site_perl/5.30.1
-/usr/lib/perl5/vendor_perl/5.30.1/x86_64-linux-thread-multi /usr/lib/perl5/vendor_perl/5.30.1
-/usr/lib/perl5/5.30.1/x86_64-linux-thread-multi /usr/lib/perl5/5.30.1 /usr/lib/perl5/site_perl)
+$ gnc-fq-check
+Can't locate Mozilla/CA.pm in @INC (you may need to install the Mozilla::CA module)
+(@INC contains: /usr/lib/perl5/site_perl/5.30.1/x86_64-linux-thread-multi /usr/
+lib/perl5/site_perl/5.30.1 /usr/lib/perl5/vendor_perl/5.30.1/x86_64-linux-thread-multi
+/usr/lib/perl5/vendor_perl/5.30.1 /usr/lib/perl5/5.30.1/x86_64-linux-thread-multi
+/usr/lib/perl5/5.30.1 /usr/lib/perl5/site_perl)
 at /usr/lib/perl5/vendor_perl/5.30.1/Finance/Quote/Tiaacref.pm line 33.
 Compilation failed in require at (eval 303) line 1.
 BEGIN failed--compilation aborted at (eval 303) line 1.
  at /usr/local/bin/gnc-fq-check line 91.
-("1.47" "adig" "aex" "aiahk" "alphavantage" "amfiindia" "asegr" "asia" "asx" "australia" "bamosz"
-"bet" "bmonesbittburns" "bourso" "brasil" "bse" "bsero" "canada" "canadamutual" "citywire" "cominvest"
-"cse" "deka" "dutch" "dwsfunds" "europe" "fetch_live_currencies" "fidelity" "fidelity_direct"
-"fidelityfixed" "financecanada" "finanzpartner" "finland" "fool" "france" "ftfunds" "ftportfolios"
-"ftportfolios_direct" "fundlibrary" "goldmoney" "greece" "hex" "hu" "hufund" "hungary" "hustock"
-"indiamutual" "known_currencies" "lerevenu" "maninv" "morningstar" "morningstarjp" "mstaruk" "nasdaq"
-"nyse" "nz" "nzx" "platinum" "romania" "seb_funds" "sixfunds" "sixshares" "stockhousecanada_fund"
-"tdefunds" "tdwaterhouse" "tiaacref" "tnetuk" "troweprice" "troweprice_direct" "trustnet" "tsp" "tsx"
-"uk_unit_trusts" "ukfunds" "unionfunds" "usa" "usfedbonds" "vanguard" "vwd" "yahoo" "yahoo_asia"
-"yahoo_australia" "yahoo_brasil" "yahoo_europe" "yahoo_json" "yahoo_nz" "yahoo_yql" "za" "za_unittrusts")
+("1.47" "adig" "aex" "aiahk" "alphavantage" "amfiindia" "asegr" "asia" "asx"
+"australia" "bamosz" "bet" "bmonesbittburns" "bourso" "brasil" "bse" "bsero" "canada"
+"canadamutual" "citywire" "cominvest" "cse" "deka" "dutch" "dwsfunds" "europe"
+"fetch_live_currencies" "fidelity" "fidelity_direct" "fidelityfixed" "financecanada"
+"finanzpartner" "finland" "fool" "france" "ftfunds" "ftportfolios" "ftportfolios_direct"
+"fundlibrary" "goldmoney" "greece" "hex" "hu" "hufund" "hungary" "hustock" "indiamutual"
+"known_currencies" "lerevenu" "maninv" "morningstar" "morningstarjp" "mstaruk" "nasdaq"
+"nyse" "nz" "nzx" "platinum" "romania" "seb_funds" "sixfunds" "sixshares"
+"stockhousecanada_fund" "tdefunds" "tdwaterhouse" "tiaacref" "tnetuk" "troweprice"
+"troweprice_direct" "trustnet" "tsp" "tsx" "uk_unit_trusts" "ukfunds" "unionfunds"
+"usa" "usfedbonds" "vanguard" "vwd" "yahoo" "yahoo_asia" "yahoo_australia"
+"yahoo_brasil" "yahoo_europe" "yahoo_json" "yahoo_nz" "yahoo_yql" "za" "za_unittrusts")
 </screen>
-        </para>
-      </formalpara>
+      </informalexample>
 
       <para>Der erste Teil ist die Fehlermeldung über ein fehlendes &app-perl;-Modul Mozilla/CA.pm. Am Ende in
         Klammern steht die normale Ausgabe der aktuell installierten &app-fq;-Version<footnote>
@@ -360,7 +351,6 @@ BEGIN failed--compilation aborted at (eval 303) line 1.
               &mc.start.win-install-fq; ausführen.
             </para>
           </note>
-
         </para>
       </abstract>
 
@@ -369,6 +359,20 @@ BEGIN failed--compilation aborted at (eval 303) line 1.
           oder Administratorrechte, aber nicht in &win;.
         </para>
       </note>
+
+      <para><userinput>gnc-fq-update</userinput> startet &app-perl;s Standardmodul
+        <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>
+        um die Installation vorzunehmen. Wenn Sie CPAN zum ersten Mal verwenden,
+        müssen Sie es konfigurieren, wobei Sie auf den meisten Systemen jedoch
+        die Standardvorgaben akzeptieren und die erste Frage <computeroutput>Are you ready for
+        manual configuration? [yes]</computeroutput> mit <userinput>no</userinput> beantworten können,
+        damit &app-fq; erfolgreich installiert wird.
+      </para>
     </sect2>
 
     <sect2 id="gnc-fq-dump">
@@ -387,11 +391,10 @@ BEGIN failed--compilation aborted at (eval 303) line 1.
       </para>
       
       <tip>
-        <para>Mit <userinput>gnc-fq-dump</userinput> können Sie Symbole schneller als aus &app; heraus
-          überprüfen, wenn während des Abrufs mit &app; ein Fehler auftritt, weil sich die Ausgabe
-          des Skripts besser zur Analyse eignet und nicht jedesmal alle funktionierenden Symbole
-          ebenfalls mit abgerufen werden, falls man <xref linkend="tool-ge-pricedb-getQuotes" />
-          in der <xref linkend="tool-price" /> verwendet.
+        <para>Mit <userinput>gnc-fq-dump</userinput> können Sie Symbole schneller als aus
+          &app; heraus überprüfen, wenn während des Abrufs mit &app; ein Fehler auftritt.
+          Dies kann Sie davor bewahren, &app; mit aktiviertem Debug-Logging laufen zu
+          lassen, während Sie ein nicht funktionierendes Symbol überprüfen.
         </para>
       </tip>
 
@@ -447,10 +450,11 @@ BEGIN failed--compilation aborted at (eval 303) line 1.
     <sect2 id="gnc-fq-helper">
       <title>gnc-fq-helper</title>
 
-      <para>Dies ist ein Skript, das &app; zum Abrufen von Kursen verwendet und musss nicht
-        vom Benutzer bedient werden. Sollte der Abruf eines Kurses in &app; zu einem
-        Fehlverhalten führen, kann mit diesem Skript eine Diagnose durchgeführt werden und
-        hilft Entwicklern bei der Entscheidung, ob der Fehler in &app; oder &app-fq; liegt.
+      <para>Dies ist ein Skript, das &app; zum Abrufen von Kursen verwendet und musss
+        normalerweise vom Benutzer nicht verwendet werden. Sollte der Abruf eines
+        Kurses in &app; zu einem Fehlverhalten führen, kann mit diesem Skript eine
+        Diagnose durchgeführt werden und hilft Entwicklern bei der Entscheidung,
+        ob der Fehler in &app; oder &app-fq; liegt.
       </para>
     </sect2>
   </sect1>



Summary of changes:
 manual/C/ch_Finance-Quote.xml  | 124 ++++++++++++++++++++------------------
 manual/de/ch_Finance-Quote.xml | 134 +++++++++++++++++++++--------------------
 2 files changed, 133 insertions(+), 125 deletions(-)



More information about the gnucash-changes mailing list