gnucash-docs master: Multiple changes pushed

Frank H.Ellenberger fell at code.gnucash.org
Thu Mar 15 05:47:08 EDT 2018


Updated	 via  https://github.com/Gnucash/gnucash-docs/commit/d553796f (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/5cbccec5 (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/ec5aed74 (commit)
	 via  https://github.com/Gnucash/gnucash-docs/commit/b4c948c2 (commit)
	from  https://github.com/Gnucash/gnucash-docs/commit/9afce47d (commit)



commit d553796fe818b19cdb96b763335e8196b1715896
Merge: 9afce47 5cbccec
Author: fell <frank.h.ellenberger at gmail.com>
Date:   Thu Mar 15 10:41:25 2018 +0100

    Merge branch 'maint'


commit 5cbccec5062d38b5ee17f680457bdd7f99add238
Author: fell <frank.h.ellenberger at gmail.com>
Date:   Thu Oct 5 03:21:31 2017 +0200

    Bug 784638 - sect1 Help-Window in Help_ch_GettingHelp describes an
    outdated version of yelp's GUI
    
    and further review of that chapter

diff --git a/help/C/Help_ch_GettingHelp.xml b/help/C/Help_ch_GettingHelp.xml
index 8228472..d940810 100644
--- a/help/C/Help_ch_GettingHelp.xml
+++ b/help/C/Help_ch_GettingHelp.xml
@@ -19,8 +19,7 @@
 <chapter id="Getting-Help">
  <title id="Using-Help">Using This Document & Getting Help</title>
 
-   <para>This document is organized in two dimensions;</para>
-
+   <para>This document is organized in two dimensions:
     <itemizedlist>
      <listitem>
       <para>From the GUI (Graphical User Interface) explaining the available options and their functions,
@@ -31,9 +30,7 @@
       <para>By classifying Operations, Tasks, or Functions based on whether it is an Account, Transaction,
        Reporting or other oriented operation. <!--Examples are <xref linkend="setup-accounts"></xref>,
        <xref linkend="ch_Common_Trans_Ops"></xref>, <xref linkend="Reports"></xref>  .-->
-       Examples are;</para>
-
-       <itemizedlist>
+       Examples are: <itemizedlist>
         <listitem>
          <para> Account Actions - <xref linkend="setup-accounts"></xref></para>
         </listitem>
@@ -54,44 +51,40 @@
          <para> Customization - <xref linkend="custom-gnucash"></xref></para>
         </listitem>
        </itemizedlist>
-
+      </para>
      </listitem>
 
     </itemizedlist>
+   </para>
+
 
   <sect1 id="Help-Window">
    <title>Accessing Help</title>
 
-<!--    <para>The <application>&app;</application> Help Window uses YELP to display DOCBOOK versions of the help documents that are installed
-     with <application>&app;</application>.</para>-->
-
-    <para>This window is accessed by going to the <guimenu>Help</guimenu> menu and selecting either the <guimenuitem>Tutorial and Concepts
-     Guide</guimenuitem> or the <guimenuitem>Contents (F1)</guimenuitem>.  <xref linkend="AccTree-help-menu"></xref></para>
-
-    <para>The Help Window has a <emphasis>Toolbar</emphasis> for navigation. The <emphasis>Toolbar</emphasis> is described below;</para>
-
-     <itemizedlist>
-      <listitem>
-       <para><guibutton>Back</guibutton> Used to navigate to topics previously viewed. </para>
-      </listitem>
-
-      <listitem>
-       <para><guibutton>Forward</guibutton> Used to navigate to topics previously viewed.</para>
-      </listitem>
-
-      <listitem>
-       <para><guibutton>Help</guibutton> Used to access various GNOME Help files.</para>
-      </listitem>
-
-      <listitem>
-       <para><guibutton>Search</guibutton> Enter search term to search GNOME Help files.  Does not search <application>&app;</application>
-        Help file.</para>
-      </listitem>
-     </itemizedlist>
-
-    <para>The right side of the Help Window displays the currently opened help page. The left side of the Help
-     Window contains the help Topics list tab. Selecting one of the help topics will load that page on the right
-     side.</para>
+<!--    -->
+
+    <para>When <application>&app;</application> is running and this documentation is installed, this window is accessed by <itemizedlist>
+      <listitem><para>pressing the <keycap>F1</keycap> key or</para></listitem>
+      <listitem><para>selecting from the menu
+        <menuchoice><guimenu><accel>H</accel>elp</guimenu><guimenuitem><accel>C</accel>ontents</guimenuitem></menuchoice>.</para></listitem>
+      <listitem><para><menuchoice><guimenu><accel>H</accel>elp</guimenu><guimenuitem>Tutorial and Concepts Guide</guimenuitem></menuchoice>
+        will open the other part of this documentation.</para></listitem>
+      <listitem><para>In most dialogs the <guibutton><accel>H</accel>elp</guibutton> button will lead you directly to the page which decribes that dialog.</para></listitem>
+    </itemizedlist></para>
+    <para>The complete help menu is explained in <xref linkend="AccTree-help-menu"></xref>.</para>
+
+    <variablelist spacing="compact">
+      <title>Operating System and Help Viewer</title>
+      <para>Depending on your operating system we use different programs to display this help document:</para>
+      
+      <varlistentry><term><systemitem class="osname">Linux</systemitem></term>
+        <listitem><simpara>Gnome <application>Yelp</application></simpara></listitem></varlistentry>
+      <varlistentry><term><systemitem class="osname">MacOS</systemitem></term>
+        <listitem><simpara>default web browser</simpara></listitem></varlistentry>
+      <varlistentry><term><systemitem class="osname">Windows</systemitem></term>
+        <listitem><simpara>Windows help viewer</simpara></listitem></varlistentry>
+    </variablelist>
+    <para>See their respective manuals to get help about help.</para> 
 
    <sect2 id="tutorial">
     <title><application>&app;</application> Tutorial and Concepts Guide</title>
@@ -102,14 +95,18 @@
       <guilabel>Welcome to &app;!</guilabel> menu.</para>
 
      <para>To open this Guide manually go to <menuchoice><guimenu>Help</guimenu>
-      <guimenuitem>Tutorial and Concepts Guide</guimenuitem></menuchoice>.</para>
+      <guimenuitem>Tutorial and Concepts Guide</guimenuitem></menuchoice> or press  
+      <keycombo action='simul'><keycap>Ctrl</keycap><keycap>H</keycap></keycombo>.</para>
 
-     <para>It is strongly recommended to read this guide if you are new to
-      <application>&app;</application> or unfamiliar with accounting concepts.</para>
+     <important><para>It is strongly recommended to read this guide if you are new to
+      <application>&app;</application> or unfamiliar with accounting concepts.</para></important>
    </sect2>
+
    <sect2 id="wiki">
      <title><application>&app;</application> Wiki</title>
-     <para>An immense amount of less-formal documenation, both of
+     <!-- Translators: if wiki pages in your language exist, add or replace the links in this section
+          see also https://wiki.gnucash.org/wiki/Special:Categories for your language or region code -->
+     <para>An immense amount of less-formal, but often more recent documenation, both of
      <application>&app;</application> itself and its maintenance and
      development may be found in the <ulink
      url="https://wiki.gnucash.org/wiki"><application>&app;</application>
@@ -122,17 +119,20 @@
 
    <sect2 id="more_help">
     <title><application>&app;</application> On-line Assistance</title>
+     <!-- Translators: if a mailing list in your language exists, add or replace the links in this section
+          see https://lists.gnucash.org/mailman/listinfo/ -->
 
     <bridgehead>Mailing List</bridgehead><para>The primary source of user support is the <ulink
-    url="mailto:gnucash-user at gnucash.org">user mailing list</ulink>. If
+    url="mailto:gnucash-user at gnucash.org">user mailing list</ulink>. If English is not your primary language,
+    see <ulink url="https://wiki.gnucash.org/wiki/Mailing_Lists#User_Lists">wiki:user mailing lists</ulink>for local lists. If
     you prefer a web forum-like presentation, you can use it via <ulink
     url="http://gnucash.1415818.n4.nabble.com/GnuCash-User-f1415819.html">Nabble</ulink>. One must <ulink
     url="https://lists.gnucash.org/mailman/listinfo/gnucash-user">subscribe</ulink>
     before posting, even if using Nabble.</para>
 
-    <bridgehead>IRC</bridgehead><para>Several of the developers
-    monitor the #gnucash channel at irc.gnome.org. They're usually
-    doing something else, too, and of course aren't always at their
+    <bridgehead>IRC</bridgehead><para>Several of the developers and experienced users
+    monitor the <ulink url="irc://irc.gnome.org#gnucash">#gnucash channel at irc.gnome.org</ulink>.
+    They're usuall doing something else, too, and of course aren't always at their
     computers. Log in, ask your question, and stay logged in; it may
     be several hours before your question is noticed and responded
     to. To see if you missed anything <ulink

commit ec5aed74c3278e8e29858b5e9f708412f68f5c29
Author: fell <frank.h.ellenberger at gmail.com>
Date:   Thu Mar 15 06:26:25 2018 +0100

    Replace outdated online quote sources by link to Help Tips

diff --git a/help/C/Help_ch_Account-Actions.xml b/help/C/Help_ch_Account-Actions.xml
index 34cdfdc..a9f85db 100644
--- a/help/C/Help_ch_Account-Actions.xml
+++ b/help/C/Help_ch_Account-Actions.xml
@@ -291,7 +291,7 @@
           </listitem>
 
           <listitem>
-            <para>If on-line updating of the commodity price is needed.</para>
+            <para>If online updating of the commodity price is needed.</para>
           </listitem>
         </itemizedlist>
 
@@ -423,9 +423,9 @@
            </note>
            </para>
 
-       <sect3 id="Online-price-setup"><title>Steps to enable On-line price updating</title>
+       <sect3 id="Online-price-setup"><title>Steps to enable Online price updating</title>
 
-           <itemizedlist>
+           <orderedlist>
             <listitem><para><application>&app;</application> relies on an external tool to retrieve online quotes. This
               tool is a Perl module named <quote>Finance::Quote</quote> and has to be installed
               on your computer independently from <application>&app;</application>. The first step in enabling online price
@@ -441,14 +441,14 @@
             the various supported systems, you can follow these guidelines:</para>
 
             <itemizedlist>
-             <listitem><para><guilabel>Linux:</guilabel> Most linux distributions (like
+             <listitem><para><systemitem class="osname">Linux</systemitem>: Most linux distributions (like
               Fedora, openSuse, Mandriva, Ubuntu, and so on) have a package in their software
               repositories for the <application>Finance::Quote</application> perl module. So in most cases, you can
               simply use your preferred package manager (yum, apt, rpm, synaptics, yast,...)
               to install the module. The name of the package may vary from one distribution to
               another. It’s often called something like <quote>perl-Finance-Quote</quote>.</para></listitem>
 
-             <listitem><para><guilabel>Windows:</guilabel> <application>Finance::Quote</application> on Windows requires perl
+             <listitem><para><systemitem class="osname">Windows</systemitem>: <application>Finance::Quote</application> on Windows requires perl
               to be installed already. If you haven’t done so, you should first install ActivePerl, or more recently,
               Strawberry Perl.</para>
 
@@ -456,7 +456,7 @@
               install <application>Finance::Quote</application> for you. You can find it in the Start Menu under the <application>&app;</application>
               group and is called <quote>Install Online Price Retrieval</quote>.</para></listitem>
 
-             <listitem><para><guilabel>Mac OS X:</guilabel> If you have installed <application>&app;</application>
+             <listitem><para><systemitem class="osname">Mac OS X</systemitem>: If you have installed <application>&app;</application>
               from the installer found on the <application>&app;</application> home page, <application>Finance::Quote</application> is already
               installed for you.</para></listitem>
 
@@ -468,9 +468,9 @@
                <listitem><para>Locate the folder where <application>&app;</application> is installed by searching for <quote>gnc-fq-update</quote>
                 (without the quotes).</para></listitem>
 
-               <listitem><para>Change to that directory, open a root shell and run the command <quote>gnc-fq-update</quote>
-                (without the quotation marks). This will launch a Perl CPAN update session that will go out onto the
-                Internet and install the <application>Finance::Quote</application> module on your system. The gnc-fq-update program is interactive,
+               <listitem><para>Change to that directory, open a root shell and run the command <command>gnc-fq-update</command>.
+                This will launch a Perl CPAN update session that will go out onto the
+                Internet and install the <application>Finance::Quote</application> module and its dependencies on your system. The gnc-fq-update program is interactive,
                 however, with most systems you should be able to answer <quote>no</quote> to the first question:
                 <quote>Are you ready for manual configuration? [yes]</quote> and the update will continue automatically
                 from that point.</para>
@@ -480,7 +480,7 @@
              </listitem>
             </itemizedlist>
 
-             <para>After installation is complete, you should run the <quote>gnc-fq-dump</quote> test program, in the
+             <para>After installation is complete, you should run the <quote>gnc-fq-check</quote> test program, in the
               same directory, distributed with <application>&app;</application> to test if <application>Finance::Quote</application> is installed and working properly.</para>
 
              <note>
@@ -504,7 +504,7 @@
             <listitem>
               <para>Create the mutual fund or stock with either the <guilabel>Security Editor</guilabel> for existing stock/funds or the
                <guilabel>New Security/Currency</guilabel> dialog for a new stock/fund.</para>
-              <para>Select <guilabel>Get On-line Quotes:</guilabel>, <guilabel>Type of Quote Source</guilabel> and
+              <para>Select <guilabel>Get Online Quotes</guilabel>, <guilabel>Type of Quote Source</guilabel> and
               <guilabel>Timezone.</guilabel></para>
 
               <para>Online currency quotes require that the check-box for Online quotes and the timezone be
@@ -513,8 +513,8 @@
 
           <itemizedlist>
             <listitem>
-              <para><guilabel>Get On-line Quotes:</guilabel> This check-box is to enable this security/fund to
-               have quotes downloaded from an on-line source.</para>
+              <para><guilabel>Get Online Quotes</guilabel> This check-box is to enable this security/fund to
+               have quotes downloaded from an online source.</para>
             </listitem>
 
             <listitem>
@@ -524,9 +524,7 @@
                information from the specified source.</para>
 
                <para>After selecting the type of source for price quotes, select a quote source from the pull-down menu.
-               Currently among the supported quote sources are; Yahoo, Yahoo Europe, Fidelity
-               Investments, T. Rowe Price, the Vanguard Group, the Australian Stock Exchange
-               (ASX) and TIAA-CREF.</para>
+               For details on currently supported sources see <xref linkend="fq-sources"></xref>.</para>
 
                <note><para>Note that Yahoo will provide price quotes for many mutual
                funds including Fidelity, T.Rowe Price and Vanguard, and that the quoted prices
@@ -544,7 +542,7 @@
 
             <listitem>
               <para><guilabel>Timezone for these quotes:</guilabel> Select the timezone for the source of the
-               on-line quotes you are receiving. For example, Yahoo normally quotes Eastern
+               online quotes you are receiving. For example, Yahoo normally quotes Eastern
                timezone, so choose America/New York if you use that quote source.</para>
             </listitem>
           </itemizedlist>
@@ -562,7 +560,7 @@
             <listitem>
               <para>Check the latest price for the selected security.</para>
             </listitem>
-          </itemizedlist>
+          </orderedlist>
 
           <para>If you wish to update price quotes from the command line, you can do so by
            the following command:</para>
@@ -845,7 +843,7 @@
         <para>The <emphasis>Summary Bar</emphasis> at the bottom of the Account Register Window indicates the amounts
          of <guilabel>Present</guilabel> (Balance), <guilabel>Future</guilabel> (Balance), <guilabel>Cleared</guilabel>
          (Transactions), <guilabel>Reconciled</guilabel> (Transactions) and
-         <guilabel>Projected Minimum</guilabel>. On-line account information can be used to
+         <guilabel>Projected Minimum</guilabel>. Online account information can be used to
          mark which transactions the bank has processed by changing the <guilabel>R</guilabel> (reconciliation status)
          column in the register from <guilabel>n</guilabel> (new) to <guilabel>c</guilabel> (cleared). The bank statement is then used
          with the <guilabel>Reconcile</guilabel> window to reconcile the account which changes the <guilabel>R</guilabel> field to

commit b4c948c2ddab8d3a30553b7e1b2cbe60d76f1b68
Author: fell <frank.h.ellenberger at gmail.com>
Date:   Thu Mar 15 06:22:41 2018 +0100

    Update Help Tips to commit c0fd3b3, which was adjusted for
    Finance::Quote 1.47

diff --git a/help/C/Help_tips-appendix.xml b/help/C/Help_tips-appendix.xml
index e2c9b55..57add03 100644
--- a/help/C/Help_tips-appendix.xml
+++ b/help/C/Help_tips-appendix.xml
@@ -1,15 +1,14 @@
 <!--
       (Do not remove this comment block.)
-  Version: 2.6.13
-   Last modified: August 08th 2016 (reflect updates by F::Q 1.38)
-        modified: April 11th 2013 (reflect bugfixes by F::Q 1.18)
+  Version: 2.6.20
+   Last modified: see <releaseinfo>
         modified: September 21th 2012
         modified: March 15th 2007
         modified: August 12th 2006
         modified: February 28th 2005
 
    Maintainers:
-                Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
+                Frank H. Ellenberger <frank.h.ellenberger at gmail.com> 2013-18
 	  Previous: Chris Lyttle <chris at wilddev.net>
 	  			Neil Williams <linux at codehelp.co.uk>
 
@@ -23,7 +22,8 @@
 <appendix id="tips">
 	<appendixinfo>
 		<releaseinfo>
-			&app; Version 2.6.11 + Finance::Quote Version 1.38, February 2016
+			&app; Version 2.6.20 + Finance::Quote Version 1.47, March 2018
+            <!-- Version 2.6.11 + Finance::Quote Version 1.38, February 2016, FEll -->
 			<!-- Version 2.4.11 + Finance::Quote Version 1.18, April 2013, FEll -->
 			<!-- Version 1.0, December 2006 -->
 		</releaseinfo>
@@ -68,7 +68,7 @@
 						</row>
 					</thead>
 
-					<tbody>
+					<tbody valign='middle'>
 						<row>
 							<entry>
 								<para>Currency</para>
@@ -77,8 +77,9 @@
 								<para>currency</para>
 							</entry>
 							<entry>
-								<para> In 2012 happened a modification on the website.
-									Make sure, you updated F::Q to version 1.18.
+								<para> End of 2017 the provider changed.
+									Make sure, you updated F::Q to version 1.47
+                                    and follow the instructions at Alphavantage below.
 								</para>
 							</entry>
 						</row>
@@ -109,7 +110,35 @@
 						</row>
 					</thead>
 
-					<tbody>
+					<tbody valign='middle'>
+                        <row>
+                            <entry>
+                                <para>Alphavantage, US</para>
+                            </entry>
+                            <entry>
+                                <para>alphavantage</para>
+                            </entry>
+                            <entry>
+                                <para>You need to 
+                                    <orderedlist spacing="compact">
+                                        <listitem><para>register at <ulink url="https://www.alphavantage.co" />,</para></listitem>
+                                        <listitem><para>enter your key in 
+                                          <link linkend="prefs-online-quotes">
+                                            <menuchoice>
+                                              <guimenu><accel>E</accel>dit</guimenu>
+                                              <guimenuitem>Pr<accel>e</accel>ferences</guimenuitem>
+                                              <guilabel>Online Quotes</guilabel>
+                                            </menuchoice>
+                                          </link>.</para>
+                                        </listitem>
+                                        <listitem><para>To use him also with <command>gnc-fq-<replaceable>*</replaceable></command>
+                                           commands you should <emphasis>set an environment variable</emphasis>.
+                                           Please consult the manual of your OS or command shell.</para>
+                                        </listitem>
+                                    </orderedlist>
+                                 </para>
+                            </entry>
+                        </row>
 						<row>
 							<entry>
 								<para>Amsterdam Euronext eXchange, NL</para>
@@ -118,8 +147,8 @@
 								<para>aex</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.aex.nl" /></para>
-								<para>includes Futures and Options</para>
+								<para><ulink url="https://www.aex.nl" /></para>
+								<para>includes former sources AEX-<quote>Futures</quote> and -<quote>Options</quote></para>
 							</entry>
 						</row>
 						<row>
@@ -130,7 +159,7 @@
 								<para>aiahk</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.aia.com.hk" /></para>
+								<para><ulink url="https://www.aia.com.hk" /></para>
 							</entry>
 						</row>
 						<row>
@@ -141,7 +170,7 @@
 								<para>amfiindia</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.amfiindia.com" /></para>
+								<para><ulink url="https://www.amfiindia.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -152,7 +181,7 @@
 								<para>asegr</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.ase.gr" /></para>
+								<para><ulink url="https://www.ase.gr" /></para>
 							</entry>
 						</row>
 						<row>
@@ -163,7 +192,7 @@
 								<para>asx</para>
 							</entry>
                             <entry>
-                              <para><ulink url="http://www.asx.com.au" /></para>
+                              <para><ulink url="https://www.asx.com.au" /></para>
                                 <!-- <note><title>Known Issues</title>...</note> uses too much space-->
                               <para>Requires F::Q 1.41, but unfortunately the ASX website is only working sometimes.
                                 And then only with a small no of stocks in 1 go. From final comment on:
@@ -180,7 +209,7 @@
 								<para>bamosz</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.bamosz.hu" /></para>
+								<para><ulink url="https://www.bamosz.hu" /></para>
 							</entry>
 						</row>
 						<row>
@@ -191,7 +220,7 @@
 								<para>bmonesbittburns</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://bmonesbittburns.com" /></para>
+								<para><ulink url="https://bmonesbittburns.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -202,7 +231,7 @@
 								<para>bsero</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.bvb.ro" /></para>
+								<para><ulink url="https://www.bvb.ro" /></para>
 							</entry>
 						</row>
 						<row>
@@ -213,7 +242,7 @@
 								<para>bse or bet</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.bet.hu" /></para>
+								<para><ulink url="https://www.bet.hu" /></para>
 							</entry>
 						</row>
 						<row>
@@ -224,7 +253,7 @@
 								<para>citywire</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://citywire.co.uk" /></para>
+								<para><ulink url="https://citywire.co.uk" /></para>
 							</entry>
 						</row>
 						<row>
@@ -235,7 +264,7 @@
 								<para>cse</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.cse.lk" />
+								<para><ulink url="https://www.cse.lk" />
 								</para>
 							</entry>
 						</row>
@@ -247,8 +276,8 @@
 								<para>cominvest</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.cominvest-am.de" /></para>
-								<para>Obsolete, update: <ulink url="http://eggert.org/software/Comdirect.pm" />
+								<para><ulink url="https://www.cominvest-am.de" /></para>
+								<para>Obsolete, update: <ulink url="https://eggert.org/software/Comdirect.pm" />
 								</para>
 							</entry>
 						</row>
@@ -260,7 +289,7 @@
 								<para>deka</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.deka.de" /></para>
+								<para><ulink url="https://www.deka.de" /></para>
 							</entry>
 						</row>
 						<row>
@@ -271,7 +300,7 @@
 								<para>dwsfunds</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.dws.de" /></para>
+								<para><ulink url="https://www.dws.de" /></para>
 							</entry>
 						</row>
 						<row>
@@ -282,7 +311,7 @@
 								<para>za_unittrusts</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.equinox.co.za" /></para>
+								<para><ulink url="https://www.equinox.co.za" /></para>
 							</entry>
 						</row>
 						<row>
@@ -293,9 +322,20 @@
 								<para>fidelity_direct</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.fidelity.com"  /></para>
+								<para><ulink url="https://www.fidelity.com" /></para>
 							</entry>
 						</row>
+                        <row>
+                            <entry>
+                                <para>Fidelity Fixed, US</para>
+                            </entry>
+                            <entry>
+                                <para>fidelityfixed</para>
+                            </entry>
+                            <entry>
+                                <para><ulink url="https://www.fidelity.com/fixed-income-bonds/overview" /></para>
+                            </entry>
+                        </row>
 						<row>
 							<entry>
 								<para>Finance Canada</para>
@@ -304,7 +344,7 @@
 								<para>financecanada</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://finance.canada.com" /></para>
+								<para><ulink url="https://finance.canada.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -315,7 +355,7 @@
 								<para>ftfunds</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://funds.ft.com" /></para>
+								<para><ulink url="https://funds.ft.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -326,7 +366,7 @@
 								<para>finanzpartner</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.finanzpartner.de" /></para>
+								<para><ulink url="https://www.finanzpartner.de" /></para>
 							</entry>
 						</row>
 						<row>
@@ -337,7 +377,7 @@
 								<para>ftportfolios_direct</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.ftportfolios.com" /></para>
+								<para><ulink url="https://www.ftportfolios.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -348,7 +388,7 @@
 								<para>fundlibrary</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.fundlibrary.com" /></para>
+								<para><ulink url="https://www.fundlibrary.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -359,7 +399,7 @@
 								<para>goldmoney</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.goldmoney.com" /></para>
+								<para><ulink url="https://www.goldmoney.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -370,7 +410,7 @@
 								<para>hex</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.hex.com" /></para>
+								<para><ulink url="https://www.hex.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -381,7 +421,7 @@
 								<para>maninv</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.maninvestments.com.au" /></para>
+								<para><ulink url="https://www.maninvestments.com.au" /></para>
 							</entry>
 						</row>
 						<row>
@@ -392,7 +432,7 @@
 								<para>mstaruk</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://morningstar.co.uk" /></para>
+								<para><ulink url="https://morningstar.co.uk" /></para>
 							</entry>
 						</row>
 						<row>
@@ -403,7 +443,7 @@
 								<para>morningstarjp</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.morningstar.co.jp" /></para>
+								<para><ulink url="https://www.morningstar.co.jp" /></para>
 							</entry>
 						</row>
 						<row>
@@ -414,7 +454,7 @@
 								<para>morningstar</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.morningstar.se" /></para>
+								<para><ulink url="https://www.morningstar.se" /></para>
 							</entry>
 						</row>
 						<row>
@@ -425,7 +465,7 @@
 								<para>fool</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.fool.com" /></para>
+								<para><ulink url="https://www.fool.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -436,7 +476,7 @@
 								<para>nzx</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.nzx.com" /></para>
+								<para><ulink url="https://www.nzx.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -447,7 +487,7 @@
 								<para>bourso</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.boursorama.com" /></para>
+								<para><ulink url="https://www.boursorama.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -458,7 +498,7 @@
 								<para>lerevenu</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://bourse.lerevenu.com" /></para>
+								<para><ulink url="https://bourse.lerevenu.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -469,7 +509,7 @@
 								<para>platinum</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.platinum.com.au" /></para>
+								<para><ulink url="https://www.platinum.com.au" /></para>
 							</entry>
 						</row>
 						<row>
@@ -480,7 +520,7 @@
 								<para>sixfunds</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.six-swiss-exchange.com" /></para>
+								<para><ulink url="https://www.six-swiss-exchange.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -491,7 +531,7 @@
 								<para>sixshares</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.six-swiss-exchange.com" /></para>
+								<para><ulink url="https://www.six-swiss-exchange.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -502,8 +542,8 @@
 								<para>seb_funds</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.seb.se" /></para>
-								<para>Consult <ulink url="http://taz.vv.sebank.se/cgi-bin/pts3/pow/Fonder/kurser/kurslista_body.asp" /> for all available funds.</para>
+								<para><ulink url="https://www.seb.se" /></para>
+								<para>Consult <ulink url="https://taz.vv.sebank.se/cgi-bin/pts3/pow/Fonder/kurser/kurslista_body.asp" /> for all available funds.</para>
 							</entry>
 						</row>
 						<row>
@@ -514,7 +554,7 @@
 								<para>za</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.sharenet.co.za" /></para>
+								<para><ulink url="https://www.sharenet.co.za" /></para>
 							</entry>
 						</row>
 						<row>
@@ -525,18 +565,18 @@
 								<para>stockhousecanada_fund</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.stockhouse.ca" /></para>
+								<para><ulink url="https://www.stockhouse.ca" /></para>
 							</entry>
 						</row>
 						<row>
 							<entry>
-								<para>TD Waterhouse Canada, CA</para>
+								<para>TD Waterhouse Funds, CA</para>
 							</entry>
 							<entry>
 								<para>tdwaterhouse</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.tdwaterhouse.ca" /></para>
+								<para><ulink url="https://www.tdassetmanagement.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -547,7 +587,7 @@
 								<para>tdefunds</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.stockhouse.ca" /></para>
+								<para><ulink url="https://www.tdwaterhouse.ca" /></para>
 							</entry>
 						</row>
 						<row>
@@ -558,9 +598,7 @@
 								<para>tiaacref</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.tiaa-cref.org" /></para>
-								<para>Also here were changes, which require at least F::Q 1.18.
-								</para>
+								<para><ulink url="https://www.tiaa-cref.org" /></para>
 							</entry>
 						</row>
 						<row>
@@ -571,7 +609,7 @@
 								<para>tsx</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.TMXmoney.com" /></para>
+								<para><ulink url="https://www.TMXmoney.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -582,18 +620,29 @@
 								<para>troweprice_direct</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.troweprice.com" /></para>
+								<para><ulink url="https://www.troweprice.com" /></para>
 							</entry>
 						</row>
+                        <row>
+                            <entry>
+                                <para>Trustnet via tnetuk.pm, GB</para>
+                            </entry>
+                            <entry>
+                                <para>tnetuk</para>
+                            </entry>
+                            <entry>
+                                <para><ulink url="https://www.trustnet.com" /></para>
+                            </entry>
+                        </row>
 						<row>
 							<entry>
-								<para>Trustnet, GB</para>
+								<para>Trustnet via trustnet.pm, GB</para>
 							</entry>
 							<entry>
 								<para>trustnet</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.trustnet.co.uk" /></para>
+								<para><ulink url="https://www.trustnet.com" /></para>
 							</entry>
 						</row>
 						<row>
@@ -604,7 +653,7 @@
 								<para>unionfunds</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.union-invest.de" /></para>
+								<para><ulink url="https://www.union-invest.de" /></para>
 							</entry>
 						</row>
 						<row>
@@ -615,7 +664,7 @@
 								<para>usfedbonds</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.publicdebt.treas.gov" /></para>
+								<para><ulink url="https://www.publicdebt.treas.gov" /></para>
 							</entry>
 						</row>
 						<row>
@@ -626,7 +675,7 @@
 								<para>tsp</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://www.tsp.gov" /></para>
+								<para><ulink url="https://www.tsp.gov" /></para>
 							</entry>
 						</row>
 						<row>
@@ -637,7 +686,7 @@
 								<para>vanguard</para>
 							</entry>
 							<entry>
-								<para>part of yahoo_us module</para>
+								<para>part of AlphaVantage</para>
 							</entry>
 						</row>
 						<row>
@@ -656,89 +705,55 @@
 						<row>
 							<entry>
 								<para>Yahoo USA</para>
+                                <para>Yahoo Asia</para>
+                                <para>Yahoo Australia</para>
+                                <para>Yahoo Brasil</para>
+                                <para>Yahoo Europe</para>
+                                <para>Yahoo New Zealand</para>
 							</entry>
 							<entry>
 								<para>yahoo</para>
+                                <para>yahoo_asia</para>
+                                <para>yahoo_australia</para>
+                                <para>yahoo_brasil</para>
+                                <para>yahoo_europe</para>
+                                <para>yahoo_nz</para>
 							</entry>
 							<entry>
-								<para><ulink url="http://finance.yahoo.com" /></para>
-							</entry>
-						</row>
-						<row>
-							<entry>
-								<para>Yahoo Asia</para>
-							</entry>
-							<entry>
-								<para>yahoo_asia</para>
-							</entry>
-							<entry>
-								<para><ulink url="http://sg.finance.yahoo.com" /></para>
-							</entry>
-						</row>
-						<row>
-							<entry>
-								<para>Yahoo Australia</para>
-							</entry>
-							<entry>
-								<para>yahoo_australia</para>
-							</entry>
-							<entry>
-								<para><ulink url="http://au.finance.yahoo.com" /></para>
-							</entry>
-						</row>
-						<row>
-							<entry>
-								<para>Yahoo Brasil</para>
-							</entry>
-							<entry>
-								<para>yahoo_brasil</para>
-							</entry>
-							<entry>
-								<para><ulink url="http://br.finance.yahoo.com" /></para>
-							</entry>
-						</row>
-						<row>
-							<entry>
-								<para>Yahoo Europe</para>
-							</entry>
-							<entry>
-								<para>yahoo_europe</para>
-							</entry>
-							<entry>
-								<para><ulink url="http://finance.uk.yahoo.com" /></para>
+								<para>CSV interface discontinued since 2017-11-01</para>
 							</entry>
 						</row>
 						<row>
 							<entry>
-								<para>Yahoo New Zealand</para>
-							</entry>
-							<entry>
-								<para>yahoo_nz</para>
-							</entry>
-							<entry>
-								<para><ulink url="http://nz.finance.yahoo.com" /></para>
-							</entry>
-						</row>
-						<row>
-							<entry>
-								<para>Yahoo Finance through JSON call</para>
+								<para>Yahoo as JSON, US</para>
 							</entry>
 							<entry>
 								<para>yahoo_json</para>
 							</entry>
 							<entry>
-								<para></para>
+								<para><ulink url="https://finance.yahoo.com" /> through "JavaScript Object Notation"</para>
 							</entry>
 						</row>
+                        <row>
+                            <entry>
+                                <para>Yahoo as YQL, US</para>
+                            </entry>
+                            <entry>
+                                <para>yahoo_yql</para>
+                            </entry>
+                            <entry>
+                                <para><ulink url="https://finance.yahoo.com" /> through "Yahoo Query Language"</para>
+                            </entry>
+                        </row>
 						<row>
 							<entry>
-								<para>Zuerich Investments (outdated)</para>
+								<para>Zuerich Investments (removed)</para>
 							</entry>
 							<entry>
 								<para>zifunds</para>
 							</entry>
 							<entry>
-								<para></para>
+								<para>Zürich Invest has been purchased by Deutsche Bank and integrated into DWS.</para>
 							</entry>
 						</row>
 					</tbody>
@@ -764,29 +779,32 @@
 
 					<tbody>
 						<row>
-							<entry>Asia (Yahoo, ...)</entry>
+							<entry>Asia disappeared with Yahoo</entry>
 						</row>
 						<row>
-							<entry>Australia (ASX, Yahoo, ...)</entry>
+							<entry>Australia (ASX, ...)</entry>
 						</row>
 						<row>
-							<entry>Brasil (Yahoo, ...)</entry>
+							<entry>Brasil disappeared with Yahoo</entry>
 						</row>
 						<row>
-							<entry>Canada (Yahoo, ...)</entry>
+							<entry>Canada (Alphavantage, TSX, ...)</entry>
 						</row>
 						<row>
-							<entry>Canada Mutual (Fund Library, ...)</entry>
+							<entry>Canada Mutual (Fund Library, StockHouse, ...)</entry>
 						</row>
 						<row>
 							<entry>Dutch (AEX, ...)</entry>
 						</row>
 						<row>
-							<entry>Europe (Yahoo, ...)</entry>
+							<entry>Europe (asegr,.bsero, hex ...)</entry>
 						</row>
 						<row>
 							<entry>Greece (ASE, ...)</entry>
 						</row>
+                        <row>
+                            <entry>Hungary (Bamosz, BET, ...)</entry>
+                        </row>
 						<row>
 							<entry>India Mutual (AMFI, ...)</entry>
 						</row>
@@ -800,37 +818,42 @@
 							<entry>First Trust (First Trust, ...)</entry>
 						</row>
 						<row>
-							<entry>France (Boursorama, ...)</entry>
+							<entry>France (Boursorama, LeRevenu, ...)</entry>
 						</row>
 						<row>
-							<entry>Nasdaq (Yahoo, ...)</entry>
+							<entry>Nasdaq (Alphavantage, Fool, ...)</entry>
 						</row>
 						<row>
-							<entry>New Zealand (Yahoo, ...)</entry>
+							<entry>New Zealand (NZX, ...)</entry>
 						</row>
 						<row>
-							<entry>NYSE (Yahoo, ...)</entry>
+							<entry>NYSE (Alphavantage, Fool, ...)</entry>
 						</row>
-						<!-- <row><entry>South Africa (Sharenet, ...)</entry></row> -->
+						<row>
+                            <entry>South Africa (Sharenet, ...)</entry>
+                        </row>
 						<row>
 							<entry>Romania (bsero, ...)</entry>
 						</row>
 						<row>
 							<entry>T. Rowe Price</entry>
 						</row>
+                        <row>
+                            <entry>U.K. Funds (citywire, FTfunds, MStar, tnetuk, ...)</entry>
+                        </row>
 						<row>
-							<entry>U.K. Unit Trusts</entry>
+							<entry>U.K. Unit Trusts (trustnet, ...)</entry>
 						</row>
 						<row>
-							<entry>USA (Yahoo, Fool ...)</entry>
+							<entry>USA (Alphavantage, Fool ...)</entry>
 						</row>
 					</tbody>
 				</tgroup>
 			</table>
 
 			<para>Sources:
-				src/engine/gnc-commodity.c:gnc_quote_source (commit 05da881, which was
-				adjusted for Finance::Quote 1.38),
+				src/engine/gnc-commodity.c:gnc_quote_source (commit c0fd3b3, which was
+				adjusted for Finance::Quote 1.47),
       &app;-Wiki,
 				bugzilla, mailing list archive.
 			</para>
@@ -840,9 +863,10 @@
 	<sect1>
 		<title>Yahoo Specifics</title>
 		<abstract>
-			<para>Yahoo offers quotes from many exchanges and markets. If you are
-				not asking for US markets, you have to specify where to look. A
-				typical Yahoo symbol has the form <ISIN><markets suffix>.
+			<para>Yahoo has offered quotes from many exchanges and markets. Alphavatage
+				will behave similar but without delay. If you are not asking for US markets,
+				you have to specify where to look. A typical Yahoo symbol has the form 
+                <ISIN><markets suffix>.
 			</para>
 		</abstract>
 		<table frame="topbot" id="gnc-tbl-fq-yahoo-exchange-codes">
@@ -1737,7 +1761,7 @@
 			</tgroup>
 		</table>
 		<para>Source:
-			http://help.yahoo.com/l/us/yahoo/finance/quotes/fitadelay.html
+			https://help.yahoo.com/l/us/yahoo/finance/quotes/fitadelay.html
 			queried at 2012-09-22.</para>
 	</sect1>
 



Summary of changes:
 help/C/Help_ch_Account-Actions.xml |  36 ++---
 help/C/Help_ch_GettingHelp.xml     |  88 +++++------
 help/C/Help_tips-appendix.xml      | 308 ++++++++++++++++++++-----------------
 3 files changed, 227 insertions(+), 205 deletions(-)



More information about the gnucash-changes mailing list