ch_Finance-Quote.xml (gnucash-docs-4.12) | : | ch_Finance-Quote.xml (gnucash-docs-4.13) | ||
---|---|---|---|---|
skipping to change at line 99 | skipping to change at line 99 | |||
<step> | <step> | |||
<para>&app-perl; is normally already set up under &mac;. | <para>&app-perl; is normally already set up under &mac;. | |||
</para> | </para> | |||
</step> | </step> | |||
</procedure> | </procedure> | |||
<procedure> | <procedure> | |||
<title>On &win;</title> | <title>On &win;</title> | |||
<step> | <step> | |||
<para>Under &win; run the program &mc.start.win-install-fq; to run. This will | <para>Under &win; run the program &mc.winOS.inst-fq; to run. This will | |||
install <ulink url="&url-wp-en;Strawberry_Perl">Strawberry Perl</ulink >. | install <ulink url="&url-wp-en;Strawberry_Perl">Strawberry Perl</ulink >. | |||
<footnote> | <footnote> | |||
<para>&app; Version 2.2.6 and before require <ulink url="&url-wp-en; ActivePerl">ActivePerl</ulink>. in | <para>&app; Version 2.2.6 and before require <ulink url="&url-wp-en; ActivePerl">ActivePerl</ulink>. in | |||
version 5.8. | version 5.8. | |||
</para> | </para> | |||
</footnote> | </footnote> | |||
<footnote> | <footnote> | |||
<para>&app; Version 2.4 and before require <ulink url="&url-wp-en;Ac tivePerl">ActivePerl</ulink> Version | <para>&app; Version 2.4 and before require <ulink url="&url-wp-en;Ac tivePerl">ActivePerl</ulink> Version | |||
5.16.3 and later. | 5.16.3 and later. | |||
skipping to change at line 245 | skipping to change at line 245 | |||
<procedure> | <procedure> | |||
<title>On &win;</title> | <title>On &win;</title> | |||
<step> | <step> | |||
<simpara>Close &app;. | <simpara>Close &app;. | |||
</simpara> | </simpara> | |||
</step> | </step> | |||
<step> | <step> | |||
<simpara>Run &mc.start.win-install-fq;. This is a small utility that ins talls &app-fq; for you. | <simpara>Run &mc.winOS.inst-fq;. This is a small utility that installs & app-fq; for you. | |||
</simpara> | </simpara> | |||
</step> | </step> | |||
</procedure> | </procedure> | |||
</sect1> | </sect1> | |||
<sect1 id="finance-quote-helper"> | <sect1 id="finance-quote-helper"> | |||
<title>Helper Scripts for Update and Diagnostics</title> | <title>Helper Scripts for Update and Diagnostics</title> | |||
<abstract> | <abstract> | |||
<para>&app; provides several utilities that will help you select the | <para>&app; provides several utilities that will help you select the | |||
skipping to change at line 275 | skipping to change at line 275 | |||
<step> | <step> | |||
<simpara>Open a <application>CMD</application> or <application>Powershel l</application> | <simpara>Open a <application>CMD</application> or <application>Powershel l</application> | |||
window: Click <guimenu>Start</guimenu> and type either | window: Click <guimenu>Start</guimenu> and type either | |||
<userinput>cmd</userinput> or <userinput>powershell</userinput> | <userinput>cmd</userinput> or <userinput>powershell</userinput> | |||
then select the resulting menu item. You don't need to run as administ rator. | then select the resulting menu item. You don't need to run as administ rator. | |||
</simpara> | </simpara> | |||
</step> | </step> | |||
<step> | <step> | |||
<simpara>Since, as previously recommended, the GnuCash directory was ent ered in the <envar>PATH</envar> | <simpara>Since, as previously recommended, the &app; directory was enter ed in the <envar>PATH</envar> | |||
envinronment variable, prefix any gnc-fq-xxx &app-perl; script command with | 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</us erinput>. | <quote>Perl</quote> and a space, e.g. <userinput>perl gnc-fq-check</us erinput>. | |||
Otherwise you have to execute the command e.g. <userinput><replaceable > | 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\ | C:\strawberry-perl\bin\</replaceable>perl.exe <replaceable>C:\Program Files (x86)\gnucash\bin\ | |||
</replaceable>gnc-fq-check</userinput>. | </replaceable>gnc-fq-check</userinput>. | |||
</simpara> | </simpara> | |||
</step> | </step> | |||
</procedure> | </procedure> | |||
<sect2 id="gnc-fq-check"> | <sect2 id="gnc-fq-check"> | |||
skipping to change at line 343 | skipping to change at line 343 | |||
</para> | </para> | |||
</tip> | </tip> | |||
</sect2> | </sect2> | |||
<sect2 id="gnc-fq-update"> | <sect2 id="gnc-fq-update"> | |||
<title>gnc-fq-update</title> | <title>gnc-fq-update</title> | |||
<abstract> | <abstract> | |||
<para>This program installs or updates the &app-fq; software module alon g with its dependencies. | <para>This program installs or updates the &app-fq; software module alon g with its dependencies. | |||
<note> | <note> | |||
<para>Windows users are generally better off using the update-tool & mc.start.win-install-fq;. | <para>Windows users are generally better off using the update-tool & mc.winOS.inst-fq;. | |||
</para> | </para> | |||
</note> | </note> | |||
</para> | </para> | |||
</abstract> | </abstract> | |||
<note> | <note> | |||
<para>This program needs superuser or administrative privileges to succe ed in &lin; or &mac; but not in &win;. | <para>This program needs superuser or administrative privileges to succe ed in &lin; or &mac; but not in &win;. | |||
</para> | </para> | |||
</note> | </note> | |||
skipping to change at line 466 | skipping to change at line 466 | |||
<simpara>The Online Quotes Retrieval command has been changed from &app; 4.0. The old command | <simpara>The Online Quotes Retrieval command has been changed from &app; 4.0. The old command | |||
<command>gnucash --add-price-quotes &user-datafile;</command> is still available, but it | <command>gnucash --add-price-quotes &user-datafile;</command> is still available, but it | |||
is deprecated and will be removed in the future release. If you've upg raded from &app; | is deprecated and will be removed in the future release. If you've upg raded from &app; | |||
3.11 or previous version, it is recommended to use the new command | 3.11 or previous version, it is recommended to use the new command | |||
<command>gnucash-cli</command>. | <command>gnucash-cli</command>. | |||
</simpara> | </simpara> | |||
</footnote> | </footnote> | |||
can be used to fetch the current quotes of your stocks and write them dire ctly into your | can be used to fetch the current quotes of your stocks and write them dire ctly into your | |||
&app;-data file without starting the GUI. Thus an automatic, regular updat ing of the price | &app;-data file without starting the GUI. Thus an automatic, regular updat ing of the price | |||
database is possible. | database is possible. | |||
<warning> | <note> | |||
<para>Please note that the data file should not be open in another insta | <para>The command will fail if it cannot get a lock on the data file, fo | |||
nce of &app; at the same time! | r example if the | |||
data file is open in another &app; instance or if the last session for | ||||
the file crashed. | ||||
</para> | </para> | |||
</warning> | </note> | |||
</para> | </para> | |||
<para>The file specified &user-datafile; will depend on the name and locatio n of your data file. This can | <para>The file specified &user-datafile; will depend on the name and locatio n of your data file. This can | |||
be determined by the name displayed in the top frame of the &app; window, before the | be determined by the name displayed in the top frame of the &app; window, before the | |||
<quote>-</quote>. | <quote>-</quote>. | |||
<tip> | <tip> | |||
<para>The file name can also be found under <guimenu>File</guimenu> in t he recently opened file list. If | <para>The file name can also be found under <guimenu>File</guimenu> in t he recently opened file list. If | |||
you place the mouse over the menu item with the number 1 in the list o f recently opened | you place the mouse over the menu item with the number 1 in the list o f recently opened | |||
files, the complete file name is displayed in the <guilabel>status bar </guilabel>. | files, the complete file name is displayed in the <guilabel>status bar </guilabel>. | |||
</para> | </para> | |||
skipping to change at line 507 | skipping to change at line 508 | |||
<simpara>Run <command>crontab -e</command>. | <simpara>Run <command>crontab -e</command>. | |||
</simpara> | </simpara> | |||
</step> | </step> | |||
<step> | <step> | |||
<para>Add the following line to your crontab: | <para>Add the following line to your crontab: | |||
<informalexample> | <informalexample> | |||
<screen>0 16 * * 5 gnucash-cli --quotes get &user-datafile; > /dev/null 2> &1</screen> | <screen>0 16 * * 5 gnucash-cli --quotes get &user-datafile; > /dev/null 2> &1</screen> | |||
</informalexample> | </informalexample> | |||
<warning> | <important> | |||
<para>If there is no graphic session that has already started the dbus, running on your computer at the | <para>If there is no graphic session that has already started the dbus, running on your computer at the | |||
time of the quote request, you must do the entry as follows inst ead: | time of the quote request, you must do the entry as follows inst ead: | |||
<informalexample> | <informalexample> | |||
<screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EX IT; | <screen>0 16 * * 5 env `dbus-launch` sh -c 'trap "kill $DBUS_SESSION_BUS_PID" EX IT; | |||
gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1</screen> | gnucash-cli --quotes get &user-datafile; > /dev/null 2>&1</screen> | |||
</informalexample> | </informalexample> | |||
(Do not copy the line breaks into the crontab, they were inserte d here only for the | (Do not copy the line breaks into the crontab, they were inserte d here only for the | |||
purpose of readability). | purpose of readability). | |||
</para> | </para> | |||
</warning> | </important> | |||
</para> | </para> | |||
</step> | </step> | |||
</procedure> | </procedure> | |||
<procedure> | <procedure> | |||
<title>On &win;</title> | <title>On &win;</title> | |||
<para>Register <command>gnucash-cli</command> with Task Scheduler. | <para>Register <command>gnucash-cli</command> with Task Scheduler. | |||
</para> | </para> | |||
End of changes. 8 change blocks. | ||||
10 lines changed or deleted | 12 lines changed or added |