gnucash-docs maint: Add Preference Online Quotes

Frank H.Ellenberger fell at code.gnucash.org
Mon Feb 5 00:53:43 EST 2018


Updated	 via  https://github.com/Gnucash/gnucash-docs/commit/8460176d (commit)
	from  https://github.com/Gnucash/gnucash-docs/commit/0becd345 (commit)



commit 8460176de7a1bca31658603612a5b6d8cff7e8ba
Author: fell <frank.h.ellenberger at gmail.com>
Date:   Sat Feb 3 22:25:46 2018 +0100

    Add Preference Online Quotes
    
    continuation of commit d983ad9 and 21431e0

diff --git a/help/C/Help_ch_Customize.xml b/help/C/Help_ch_Customize.xml
index 3fe1a7a..b999884 100644
--- a/help/C/Help_ch_Customize.xml
+++ b/help/C/Help_ch_Customize.xml
@@ -793,6 +793,55 @@
       </itemizedlist>
     </sect2>
 
+    <sect2 id="prefs-online-quotes">
+      <title>Online Quotes</title>
+      <figure id="prefs-quotes-fig">
+        <title>The <guimenuitem>Preferences</guimenuitem> window, <guilabel>
+          Online Quotes</guilabel> tab
+        </title>
+        <screenshot id="Prefer-online-quotes">
+          <mediaobject>
+            <imageobject role="html">
+              <imagedata fileref="figures/Help_Pref_Quotes.png"
+                         format="PNG" srccredit="Frank H. Ellenberger" width="510px"></imagedata>
+            </imageobject>
+            <imageobject role="fo">
+              <imagedata fileref="figures/Help_Pref_Quotes.png" format="PNG"
+                         srccredit="Frank H. Ellenberger"></imagedata>
+            </imageobject>
+
+            <textobject>
+              <phrase>The Online Quotes tab</phrase>
+            </textobject>
+          </mediaobject>
+        </screenshot>
+      </figure>
+
+      <para>The <guilabel>Online Quotes</guilabel> tab allows you to set options
+        that affect the fetching of online quotes with the 
+        <acronym>perl</acronym> module <application>Finance::Quote</application>.
+      </para>
+
+      <itemizedlist>
+        <listitem>
+          <para><guilabel>Alpha Vantage API key:</guilabel> To retrieve online quotes from Alphavantage, this key needs to be set. A key can be retrieved from the <ulink url="https://www.alphavantage.co/">Alpha Vantage website</ulink>.
+          </para>
+        </listitem>
+      </itemizedlist>
+
+      <itemizedlist><title>See also:</title>
+        <listitem>
+          <para><xref linkend="fq-sources"/>,
+          </para>
+        </listitem>
+        <listitem>
+        <!-- TODO: create link to id="currency_howto_Auto" -->
+          <para><quote>Automatic Updating Exchange Rates</quote> in the guide.
+          </para>
+        </listitem>
+      </itemizedlist>
+    </sect2>
+
     <sect2 id="prefs-printing">
       <title>Printing</title>
 
diff --git a/help/C/Help_tips-appendix.xml b/help/C/Help_tips-appendix.xml
index ff8f0df..df672f6 100644
--- a/help/C/Help_tips-appendix.xml
+++ b/help/C/Help_tips-appendix.xml
@@ -39,7 +39,7 @@
 		</para>
 	</abstract>
 
-	<sect1>
+	<sect1 id="fq-sources">
 		<title>Finance::Quote Sources</title>
 		<para>There are 3 types of sources of which the first - currency - is
 			hardcoded and responsible to fetch ISO currencies.
diff --git a/help/C/figures/Help_Pref_Quotes.png b/help/C/figures/Help_Pref_Quotes.png
new file mode 100644
index 0000000..2aa6999
Binary files /dev/null and b/help/C/figures/Help_Pref_Quotes.png differ



Summary of changes:
 help/C/Help_ch_Customize.xml        |  49 ++++++++++++++++++++++++++++++++++++
 help/C/Help_tips-appendix.xml       |   2 +-
 help/C/figures/Help_Pref_Quotes.png | Bin 0 -> 32979 bytes
 3 files changed, 50 insertions(+), 1 deletion(-)
 create mode 100644 help/C/figures/Help_Pref_Quotes.png



More information about the gnucash-changes mailing list