gnucash-docs master: Multiple changes pushed
Frank H.Ellenberger
fell at code.gnucash.org
Fri Jun 26 18:59:45 EDT 2020
Updated via https://github.com/Gnucash/gnucash-docs/commit/94296975 (commit)
via https://github.com/Gnucash/gnucash-docs/commit/5fbe2398 (commit)
from https://github.com/Gnucash/gnucash-docs/commit/29715f54 (commit)
commit 94296975dddb9795cd8f1390e0de05c726aec1ce
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Sat Jun 27 00:06:52 2020 +0200
Screenshot: Change a Transaction Association Dialog
diff --git a/help/C/Help_ch_Transactions.xml b/help/C/Help_ch_Transactions.xml
index 587e9b3..50bbf1a 100644
--- a/help/C/Help_ch_Transactions.xml
+++ b/help/C/Help_ch_Transactions.xml
@@ -298,24 +298,67 @@ Author:
<sect1 id="trans-assoc">
<title>Associating an External File with a Transaction.</title>
<para>Some users find it helpful to associate external files or URLs, perhaps images of store reciepts, cancelled checks, or vendor invoices, with their transactions. &app; provides a facility for doing just that.</para>
- <para>Select a transaction in the <guilabel>Register</guilabel> and right-click it to present the <guimenu>Context Menu</guimenu> and select <guimenuitem>Update Association for Transaction</guimenuitem>. You will be presented with the <guilabel>Change a Transaction Association</guilabel> dialog. At the top is a radio button with two choices <guilabel>File Association</guilabel> and <guilabel>Location Association</guilabel>. If there's an item associated then the radio button will have the appropriate selection. At the bottom, 3 buttons: <guilabel>Remove</guilabel>, <guilabel>Cancel</guilabel>, and <guilabel>OK</guilabel>. <guilabel>Remove</guilabel> will remove the current association and close the dialog box; the other two do the usual actions.</para>
+ <para>
+ Select a transaction in the <guilabel>Register</guilabel> and right-click it to present the
+ <guimenu>Context Menu</guimenu> and select
+ <guimenuitem>Update Association for Transaction</guimenuitem>. You will be presented with the
+ <guilabel>Change a Transaction Association</guilabel> dialog.</para>
+ <figure pgwide="1">
+ <title>Change a Transaction Association Dialog</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/Help_Trans_Assoc_Dialog.png" format="PNG"
+ srccredit="Frank H. Ellenberger" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <para>At the top is a radio button with two choices <guilabel>File Association</guilabel> and
+ <guilabel>Location Association</guilabel>. If there's an item associated then the radio button
+ will have the appropriate selection. At the bottom, 3 buttons:
+ <guilabel>Remove</guilabel>,
+ <guilabel>Cancel</guilabel>, and
+ <guilabel>OK</guilabel>.
+ <guilabel>Remove</guilabel> will remove the current association and close the dialog box; the
+ other two do the usual actions.
+ </para>
<para>If the <guilabel>File Association</guilabel> radio button is selected the control beneath it is a file chooser button. It will display the name of the selected file if there is one or <guilabel>None</guilabel> if there isn't. Clicking the button will bring up a file chooser dialog from which one may select the file to associate.</para>
<para>If the <guilabel>Location Association</guilabel> radio button is selected there is a text entry beneath it in which you may type a URL.</para>
<para>When you have finished click the <guilabel>OK</guilabel> button to confirm your choice or the <guilabel>Cancel</guilabel> button to dismiss the dialog without making a change.</para>
<para><guimenuitem>Open Association for Transaction</guimenuitem> is enabled if there is a file or URL associated with the selected transaction. Selecting it will open a file in the operating system's default viewer for the file type and a URL in the default browser</para>
<para><guimenuitem>Remove Association from Transaction</guimenuitem> is enabled if there is a file or URL associated with the selected transaction and does exactly what you'd expect.</para>
- <figure float="1">
- <title>Chain and Paperclip</title>
- <screenshot>
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/Help_Trans_Assoc_Symbols.png" format="PNG"
- srccredit="Frank H. Ellenberger" />
- </imageobject>
- </mediaobject>
- </screenshot>
- </figure>
- <para>When the <guilabel>Register</guilabel> is in <guilabel>Double Line</guilabel> mode the cell underneath the <guilabel>Reconciliation</guilabel> cell is the <guilabel>Association</guilabel> cell and displays a paperclip symbol if there is a file associated with the transaction and a chain-link symbol if there is a URL associated with it as long as those symbols are supported by the current font for the cell. Hovering over the cell will display the file path or URL in a tooltip and clicking in it will open the file or URL as the <guimenuitem>Open Transaction</guimenuitem> context menu item would.</para>
+ <figure float="1">
+ <title>Chain and Paperclip</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/Help_Trans_Assoc_Symbols.png" format="PNG"
+ srccredit="Frank H. Ellenberger" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
+ <para>
+ When the <guilabel>Register</guilabel> is in <guilabel>Double Line</guilabel> mode the cell
+ underneath the <guilabel>Reconciliation</guilabel> cell is the <guilabel>Association</guilabel>
+ cell and displays
+ <itemizedlist>
+ <listitem>
+ <para>a <emphasis>paperclip symbol</emphasis>
+ if there is a file associated with the transaction and
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ a <emphasis>chain-link symbol</emphasis> if there is a URL associated with it
+ </para>
+ </listitem>
+ </itemizedlist>
+ as long as those symbols are supported by the current font for the cell. Hovering over the cell
+ will display the file path or URL in a tooltip and clicking in it will open the file or URL as
+ the <guimenuitem>Open Transaction</guimenuitem> context menu item would.
+ </para>
</sect1>
<sect1 id="trans-multi-enter">
<title>Multiple Split Transactions</title>
diff --git a/help/C/figures/Help_Trans_Assoc_Dialog.png b/help/C/figures/Help_Trans_Assoc_Dialog.png
new file mode 100644
index 0000000..2a2ab0e
Binary files /dev/null and b/help/C/figures/Help_Trans_Assoc_Dialog.png differ
commit 5fbe2398207ca9561e82c2c79a7bb233661be41d
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Fri Jun 26 23:00:21 2020 +0200
Transaction assoc illustration: Symbols
TBD: define a floatstyle in DTD
diff --git a/help/C/Help_ch_Transactions.xml b/help/C/Help_ch_Transactions.xml
index 343dc6c..587e9b3 100644
--- a/help/C/Help_ch_Transactions.xml
+++ b/help/C/Help_ch_Transactions.xml
@@ -304,6 +304,17 @@ Author:
<para>When you have finished click the <guilabel>OK</guilabel> button to confirm your choice or the <guilabel>Cancel</guilabel> button to dismiss the dialog without making a change.</para>
<para><guimenuitem>Open Association for Transaction</guimenuitem> is enabled if there is a file or URL associated with the selected transaction. Selecting it will open a file in the operating system's default viewer for the file type and a URL in the default browser</para>
<para><guimenuitem>Remove Association from Transaction</guimenuitem> is enabled if there is a file or URL associated with the selected transaction and does exactly what you'd expect.</para>
+ <figure float="1">
+ <title>Chain and Paperclip</title>
+ <screenshot>
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/Help_Trans_Assoc_Symbols.png" format="PNG"
+ srccredit="Frank H. Ellenberger" />
+ </imageobject>
+ </mediaobject>
+ </screenshot>
+ </figure>
<para>When the <guilabel>Register</guilabel> is in <guilabel>Double Line</guilabel> mode the cell underneath the <guilabel>Reconciliation</guilabel> cell is the <guilabel>Association</guilabel> cell and displays a paperclip symbol if there is a file associated with the transaction and a chain-link symbol if there is a URL associated with it as long as those symbols are supported by the current font for the cell. Hovering over the cell will display the file path or URL in a tooltip and clicking in it will open the file or URL as the <guimenuitem>Open Transaction</guimenuitem> context menu item would.</para>
</sect1>
<sect1 id="trans-multi-enter">
diff --git a/help/C/figures/Help_Trans_Assoc_Symbols.png b/help/C/figures/Help_Trans_Assoc_Symbols.png
new file mode 100644
index 0000000..5237055
Binary files /dev/null and b/help/C/figures/Help_Trans_Assoc_Symbols.png differ
Summary of changes:
help/C/Help_ch_Transactions.xml | 58 +++++++++++++++++++++++++++-
help/C/figures/Help_Trans_Assoc_Dialog.png | Bin 0 -> 12119 bytes
help/C/figures/Help_Trans_Assoc_Symbols.png | Bin 0 -> 2552 bytes
3 files changed, 56 insertions(+), 2 deletions(-)
create mode 100644 help/C/figures/Help_Trans_Assoc_Dialog.png
create mode 100644 help/C/figures/Help_Trans_Assoc_Symbols.png
More information about the gnucash-changes
mailing list