gnucash-docs maint: Update instructions for updating quote prices by cron - Bug 639776

[Frank H. Ellenberger]

Updated	 via  https://github.com/Gnucash/gnucash-docs/commit/506fc583 (commit)
	from  https://github.com/Gnucash/gnucash-docs/commit/77011fa2 (commit)



commit 506fc583e625e46b57e5bf6e2c598c3aec11cf54
Author: Chris Good <chris.good at ozemail.com.au>
Date:   Tue Jan 26 08:34:51 2016 +0100

    Update instructions for updating quote prices by cron - Bug
     639776

diff --git a/help/C/Help_ch_Account-Actions.xml b/help/C/Help_ch_Account-Actions.xml
index f126ed9..293d460 100644
--- a/help/C/Help_ch_Account-Actions.xml
+++ b/help/C/Help_ch_Account-Actions.xml
@@ -444,7 +444,8 @@
               another. It’s called often something like <quote>perl-Finance-Quote</quote>.</para></listitem>
 
              <listitem><para><guilabel>Windows:</guilabel> <application>Finance::Quote</application> on Windows requires perl
-              to be installed already. If you haven’t done so, you should first install ActivePerl.</para>
+              to be installed already. If you haven’t done so, you should first install ActivePerl, or more recently,
+              Strawberry Perl.</para>
 
               <para>The Windows installer from the <application>&app;</application> home page comes with a small helper program to
               install <application>Finance::Quote</application> for you. You can find it in the Start Menu under the <application>&app;</application>
@@ -480,7 +481,9 @@
              <note>
               <para>If you feel uncomfortable about performing any of these steps, please either email the <application>&app;</application>-user
                mailing list (<email>gnucash-user at gnucash.org</email>) for help or come to the <application>&app;</application> IRC channel on
-               irc.gnome.org. You can also leave out this step and manually update your stock prices.</para>
+               irc.gnome.org. More information is available on the <application>&app;</application> Wiki FAQ for example
+               <ulink url="http://wiki.gnucash.org/wiki/FAQ#Q:_How_do_I_fix_a_.22system_error.22_or_.22unknown_error.22_when_getting_stock_quotes.3F" />
+               You can also leave out this step and manually update your stock prices.</para>
              </note>
             </listitem>
 
@@ -557,7 +560,7 @@
           </itemizedlist>
 
           <para>If you wish to update price quotes from the command line, you can do so by
-           the following command;</para>
+           the following command:</para>
 
           <para><userinput>gnucash --add-price-quotes <gnucash-file-name></userinput>
           </para>
@@ -570,12 +573,18 @@
           in the list of recently opened file; the first item, numbered 1, is the name of the currently
           open file.</para>
 
-          <para>This can be automated by creating a crontab entry. For example, to update your file every Friday
+          <para>This can be automated in Mac OSX by creating a crontab entry. For example, to update your file every Friday
           evening (18:00) after markets close (modify the time accordingly for your time zone), you could add
           the following to your personal crontab:</para>
 
-          <para>0 18 * * 5 gnucash --add-price-quotes $HOME/gnucash-filename > /dev/null 2>&1</para>
-
+          <para><userinput>0 18 * * 5 /path/to/gnucash --add-price-quotes /path/to/gnucash-filename > /dev/null 2>&1'</userinput></para>
+          
+          <para>For Linux, which needs dbus, usually started by the desktop
+            manager, to communicate with dconf or gconf:</para>
+          
+          <para><userinput>0 18 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EXIT; /path/to/gnucash
+            --add-price-quotes /path/to/gnucash-filename > /dev/null 2>&1'</userinput></para>
+          
           <para>Remember that Mutual Fund <quote>prices</quote> are really <quote>Net Asset Value</quote>
           and require several hours after the exchange closes before being available. If NAVs are downloaded before
           the current days NAVs are determined, yesterday’s NAVs are retrieved.</para>



Summary of changes:
 help/C/Help_ch_Account-Actions.xml | 21 +++++++++++++++------
 1 file changed, 15 insertions(+), 6 deletions(-)