gnucash-docs maint: Replace most occurences of <emphasis> in help:transactions
Frank H.Ellenberger
fell at code.gnucash.org
Sun Mar 31 12:45:56 EDT 2019
Updated via https://github.com/Gnucash/gnucash-docs/commit/f92b8168 (commit)
from https://github.com/Gnucash/gnucash-docs/commit/4bfce900 (commit)
commit f92b8168d10d8ceba386e284dc380f4ce0fc8b88
Author: Frank H. Ellenberger <frank.h.ellenberger at gmail.com>
Date: Sat Mar 30 23:02:28 2019 +0100
Replace most occurences of <emphasis> in help:transactions
Usually there are more specific tags available
diff --git a/help/C/Help_ch_Transactions.xml b/help/C/Help_ch_Transactions.xml
index cda53e3..6d09c8c 100644
--- a/help/C/Help_ch_Transactions.xml
+++ b/help/C/Help_ch_Transactions.xml
@@ -3,18 +3,20 @@
<!--
(Do not remove this comment block.)
- Version: 2.0.x
- Last modified: April 15th 2007
+ Version: 3.5
+ Last modified: March 30th 2019
+ modified: April 15th 2007
modified: August 12th 2006
modified: February 28th 2005
Maintainers:
-Chris Lyttle <chris at wilddev.net>
-Neil Williams <linux at codehelp.co.uk>
+ Frank H. Ellenberger
+ Chris Lyttle <chris at wilddev.net>
+ Neil Williams <linux at codehelp.co.uk>
Author:
-Chris Lyttle <chris at wilddev.net>
-Translators:
+ Chris Lyttle <chris at wilddev.net>
+ Translators:
(translators put your name and email here)
-->
@@ -90,7 +92,7 @@ Translators:
<listitem><para><guilabel>Memo:</guilabel> Additional information you
might want to note about the transaction. Anything entered here
will be added to the <guilabel>Memo</guilabel> fields of
- <emphasis role="italic">both</emphasis> splits.</para></listitem>
+ <emphasis>both</emphasis> splits.</para></listitem>
</itemizedlist>
</sect2>
<sect2><title>Transfer Accounts</title>
@@ -138,7 +140,7 @@ Translators:
Rate</guilabel> button.</para></listitem>
<listitem><para>Select the
<guilabel>To Amount</guilabel> radio button if you want to enter
- the amount of the <emphasis role="italic">To Account</emphasis>
+ the amount of the <emphasis>To Account</emphasis>
split.</para></listitem>
<listitem><para>Enter the price/exchange rate or the amount in the
numeric entry corresponding to radio button you
@@ -256,7 +258,7 @@ Translators:
</listitem>
<listitem>
- <para>The next field (R) is used for reconciliation. This is described in the <guimenu>Reconcile an
+ <para>The next field <guilabel>R</guilabel> is used for reconciliation. This is described in the <guimenu>Reconcile an
Account to a Statement</guimenu> section. <xref linkend="acct-reconcile"></xref></para>
</listitem>
@@ -336,7 +338,7 @@ Translators:
<listitem>
<para>When typing in the <guilabel>Transfer</guilabel> field <application>&app;</application> will also attempt to automatically match the account.
- It does this alphabetically, so typing <emphasis>Ex</emphasis> will match the <emphasis>Expenses</emphasis> section of the account list.
+ It does this alphabetically, so typing <userinput>Ex</userinput> will match the <computeroutput>Expenses</computeroutput> section of the account list.
When the section is matched, it is possible to move to a child account by pressing <keycap>:</keycap> (colon).
If after typing <emphasis>Ex</emphasis> you press <keycap>:</keycap> then the cursor will move to the first child account in the
list. Typing combinations of letters and <keycap>:</keycap> will allow movement down the tree of accounts
@@ -638,8 +640,7 @@ Translators:
<title>Scheduling Transactions</title>
<para>Scheduled Transactions provide the ability to have reminders scheduled or transactions scheduled to be
- entered at a specified date. This is combined with the <emphasis role="bold">Since Last Run
- </emphasis> assistant (<xref linkend="trans-sched-slr"></xref>) to review and enter the transactions. The
+ entered at a specified date. This is combined with the <guilabel>Since Last Run</guilabel> assistant (<xref linkend="trans-sched-slr"></xref>) to review and enter the transactions. The
<guilabel>Mortgage & Loan Repayment</guilabel> assistant (<xref linkend="trans-sched-loans"></xref>) is used
to setup a scheduled transaction to repay a compounding interest loan. The Scheduled Transaction Editor
(<xref linkend="sched-editor"></xref>) is used to create and edit transactions that are to be added to the
@@ -722,26 +723,26 @@ Translators:
</sect1>
<sect1 id="sched-editor">
<title>Edit Scheduled Transaction Window</title>
-
+<!-- Todo: has been redesigned -->
<para>The Edit Scheduled Transaction Window is divided into a Name area, Options area, Occurrences area,
Recurrence Frequency area, mini calendar and Template Transaction pane.</para>
- <para>The <emphasis role="bold">Name</emphasis> field is used to enter the name for the scheduled transaction. This will be
+ <para>The <guilabel>Name</guilabel> field is used to enter the name for the scheduled transaction. This will be
used in the <guilabel>Description</guilabel> of the transaction.</para>
- <para>The <emphasis role="bold">Options</emphasis> area contains check-boxes to set if the transaction is
+ <para>The <guilabel>Options</guilabel> area contains check-boxes to set if the transaction is
automatically created and how many days in advance the transaction is created and/or a reminder posted.
</para>
- <para>The <emphasis role="bold">Occurrences</emphasis> area contains selections to set for dates limits on
+ <para>The <guilabel>Occurrences</guilabel> area contains selections to set for dates limits on
transactions to be entered or the number of transactions to be entered.</para>
- <para>The <emphasis role="bold">Recurrence Frequency</emphasis> area contains selections to set how
+ <para>The <guilabel>Recurrence Frequency</guilabel> area contains selections to set how
often the transaction is scheduled to be added and on what dates this occurs.</para>
<para>The mini calendar provides a visual indication of what transactions are already scheduled.</para>
- <para>The <emphasis role="bold">Template Transaction</emphasis> pane allows you to setup the transaction
+ <para>The <guilabel>Template Transaction</guilabel> pane allows you to setup the transaction
as you would like it to be entered into the register.</para>
<para>These options are described in more detail in <xref linkend="trans-sched"></xref></para>
@@ -892,9 +893,9 @@ Translators:
(.csv) Comma Separated Values;</para></listitem>
</itemizedlist>
- <para>These import methods can be accessed from the <emphasis role="bold">Import</emphasis> submenu
- of the main menu <emphasis role="bold">File</emphasis> entry, along with methods for importing
- other types of data. Select the appropriate entry in the <emphasis role="bold">Import</emphasis>
+ <para>These import methods can be accessed from the <guisubmenu>Import</guisubmenu> submenu
+ of the main menu <guimenu>File</guimenu> entry, along with methods for importing
+ other types of data. Select the appropriate entry in the <guisubmenu>Import</guisubmenu>
sub menu to initiate importing transactions.
</para>
</sect2>
@@ -908,9 +909,16 @@ Translators:
<sect3><title>To import QIF files:</title><para> </para></sect3>
<sect3>
<title>Load all of the QIF files containing data you wish to import</title>
- <para>To do this, select <emphasis role="bold">File -> Import -> Import QIF...</emphasis> from the menu. When the QIF Import dialog
- box appears, click <emphasis role="bold">Next</emphasis> and follow the instructions to guide you through the process of loading
- your files.
+ <para>To do this, select
+ <menuchoice>
+ <guimenu>File</guimenu>
+ <guisubmenu>Import</guisubmenu>
+ <guimenuitem>Import QIF...</guimenuitem>
+ </menuchoice>
+ from the menu. When the QIF Import dialog box appears, click
+ <guibutton>Next</guibutton>
+ button and follow the instructions to guide you through the process
+ of loading your files.
</para>
<para>This image shows the start of the QIF Import Druid.<!--FIXME put an image of the import druid in --> </para>
<para>You will be prompted for a filename to load. Use the Select button to select your QIF file and
@@ -928,21 +936,21 @@ Translators:
income and expense categories import as GnuCash income and expense accounts <!--(see section 3.1 FIXME for
more on this).--> Make changes to these account names if necessary, and click Next to continue.
</para>
- <para><emphasis role="bold">Note:</emphasis> If you are not sure what changes are needed, it is safe to
+ <note><para>If you are not sure what changes are needed, it is safe to
accept the GnuCash account names. It is easy to edit the accounts later if you find you need to make
a change.
- </para>
- <para>From the drop-down list, select a standard currency to be used for the imported accounts and click <emphasis role="bold">Next</emphasis>
+ </para></note>
+ <para>From the drop-down list, select a standard currency to be used for the imported accounts and click <guibutton>Next</guibutton>
to continue. If you have stocks, mutual funds, or other securities, you will be prompted for additional
information. The importer dialog will ask for the exchange or listing (i.e. Nasdaq), the security's
full name, and the ticker symbol. If you do not have this information handy, you can edit the account
- information later, once the import is complete. Click <emphasis role="bold">Next</emphasis> to continue.
+ information later, once the import is complete. Click <guibutton>Next</guibutton> button to continue.
</para>
</sect3>
<sect3>
<title>Tell GnuCash to import the data.</title>
<para>The last step is the import. Once you have verified your account names and investment information,
- click <emphasis role="bold">Finish</emphasis> in the Update your GnuCash accounts page to complete the import process. Depending
+ click <guibutton>Finish</guibutton> button in the Update your GnuCash accounts page to complete the import process. Depending
upon the size of your file, the import might take a few minutes to complete, so a progress bar
displays the percentage finished. When the import process is complete, GnuCash will return you
to the main window, which should now display the names of the accounts you imported.
@@ -952,9 +960,9 @@ Translators:
<sect2 id="trans-import-ofx">
<title>Import OFX/QFX</title>
<para>This opens a file selection dialog. Navigate to the file you wish to import, select a file with
- the appropriate extension (.ofx or .qfx), then press the <emphasis role="bold">Import</emphasis> button.</para>
+ the appropriate extension (.ofx or .qfx), then press the <guibutton>Import</guibutton> button button.</para>
<para>Gnucash opens an Account Selection dialog to select an account in your CoA corresponding to data source. Select
- the appropriate account from the account tree and press the <emphasis role="bold">OK</emphasis> button. On subsequent import of files from the
+ the appropriate account from the account tree and press the <guibutton>OK</guibutton> button. On subsequent import of files from the
same source (identified by tags in the file), the source is remembered and the account selection dialog is not
displayed.</para>
<para>The generic import transaction matcher dialog is opened next. See the <link linkend="trans-import-matcher">
@@ -964,9 +972,9 @@ Translators:
</sect2>
<sect2 id="trans-import-csv">
<title>Import CSV</title>
- <para>Clicking on <emphasis role="bold">Import CSV</emphasis> in the Import menu will bring up the Import Assistant dialog. The first step brings up a file selection
+ <para>Clicking on <guimenuitem>Import CSV...</guimenuitem> in the Import menu will bring up the Import Assistant dialog. The first step brings up a file selection
dialog. Navigate to the location where the file you wish to import is located and select the file to import then click the
- <emphasis role="bold">OK</emphasis> button.
+ <guibutton>OK</guibutton> button.
</para>
<para>The next window will allow you to set parameters for the importing of the file. All widgets have tooltips which explain what
the setting affects and the options for the setting.
@@ -974,10 +982,10 @@ Translators:
<sect3 id="trans-import-csv-save">
<title>Load and Save Settings</title>
<para>If this import is a regular occurrence, once you have set the other import paramters, you can save these settings by typing
- in a setting name in the <emphasis role="bold">Load and Save Settings Entry</emphasis> combo box and pressing the <emphasis role="bold">Save</emphasis> button just to the right of the box.
+ in a setting name in the <guilabel>Load and Save Settings Entry</guilabel> combo box and pressing the <guibutton>Save</guibutton> button just to the right of the box.
Previously defined settings can be retrieved by selecting the appropriate setting name from the dropdown list activated by
the down arrow at the right end of the text box. The trash can button to the right of the Save button can be used to remove
- the settings selected from the drop down list for the box. The settings group <emphasis role="bold">"GnuCash Export Settings"</emphasis> define a setting
+ the settings selected from the drop down list for the box. The settings group <computeroutput>"GnuCash Export Settings"</computeroutput> define a setting
group for the export and reimport of GnuCash transaction data - use this if importing data previously exported from GnuCash.
</para>
</sect3>
@@ -993,22 +1001,22 @@ Translators:
</para>
<itemizedlist>
<listitem>
- <para><emphasis role="bold">Fixed width columns</emphasis> Selecting this radio button will allow you to define
+ <para><guilabel>Fixed width columns</guilabel>: Selecting this radio button will allow you to define
column boundaries by double clicking at the appropriate positions in the sample records displayed in the
panel below. Single clicking in a column will narrow, widen or merge the column.
</para>
</listitem>
<listitem>
- <para><emphasis role="bold">Separators</emphasis> Selecting this radio button will allow you to define characters
+ <para><guilabel>Separators</guilabel>: Selecting this radio button will allow you to define characters
which will be used to distinguish columns in the input file. The default is comma separated however spaces,
tabs,colons or semicolons or any combination of them may be used to separate columns in the input file by
selecting the appropriate check boxes. You may also define custom separators by typing the required characters
- into the text box and selecting the <emphasis role="bold">Custom</emphasis> checkbox. This may be used in combination with any of the
+ into the text box and selecting the <guilabel>Custom</guilabel> checkbox. This may be used in combination with any of the
predefined separators.
</para>
</listitem>
<listitem>
- <para><emphasis role="bold">Multi-split</emphasis> Selecting this check box allows the splits for a single transaction
+ <para><guilabel>Multi-split</guilabel>: Selecting this check box allows the splits for a single transaction
to be defined on consecutive lines within the file with each line defining a single split. If not selected each
line is assumed to contain the information for a single transaction including one or two splits.
</para>
@@ -1020,12 +1028,12 @@ Translators:
<para>The miscellaneous settings allow you to set:
</para>
<itemizedlist>
- <listitem><para><emphasis role="bold">Encoding</emphasis>This is usually the UTF-8 variant for your locale;</para></listitem>
- <listitem><para><emphasis role="bold">Date Format</emphasis> This does not default to the Locale setting so check it matches the data you are importing;</para></listitem>
- <listitem><para><emphasis role="bold">Currency Format</emphasis>;</para></listitem>
- <listitem><para><emphasis role="bold">Leading Lines to Skip</emphasis>;</para></listitem>
- <listitem><para><emphasis role="bold">Trailing Lines to Skip</emphasis>;</para></listitem>
- <listitem><para><emphasis role="bold">Skip alternate lines</emphasis>;</para></listitem>
+ <listitem><para><guilabel>Encoding</guilabel>: This is usually the UTF-8 variant for your locale;</para></listitem>
+ <listitem><para><guilabel>Date Format</guilabel>: This does not default to the Locale setting so check it matches the data you are importing;</para></listitem>
+ <listitem><para><guilabel>Currency Format</guilabel>: </para></listitem>
+ <listitem><para><guilabel>Leading Lines to Skip</guilabel>: </para></listitem>
+ <listitem><para><guilabel>Trailing Lines to Skip</guilabel>: </para></listitem>
+ <listitem><para><guilabel>Skip alternate lines</guilabel>: </para></listitem>
</itemizedlist>
<para>to match the settings for the file you are importing. Tooltips may also contain information on the setting and options.</para>
</sect3>
@@ -1034,21 +1042,21 @@ Translators:
<para>The import panel shows the data being imported as it is interpreted using the settings chosen to define columns and formats.
The dropdown lists in the headers for each column of the import allow you to associate a specific column in the imported data
with a specific field in the display of a transaction in an account register. At a minimum to import data, columns in the
- imported data containing the following information <emphasis role="bold">must</emphasis> be specified:
+ imported data containing the following information <emphasis>must</emphasis> be specified:
</para>
<itemizedlist>
- <listitem><para><emphasis role="bold">Date </emphasis>of transaction;</para></listitem>
- <listitem><para><emphasis role="bold">Account</emphasis> into which transaction is to be imported (or alternatively set the base account as above);</para></listitem>
- <listitem><para><emphasis role="bold">Description</emphasis> of the transaction;</para></listitem>
- <listitem><para><emphasis role="bold">Deposit or Withdrawal</emphasis> column.</para></listitem>
+ <listitem><para><guilabel>Date</guilabel>: of transaction;</para></listitem>
+ <listitem><para><guilabel>Account</guilabel>: into which transaction is to be imported (or alternatively set the base account as above);</para></listitem>
+ <listitem><para><guilabel>Description</guilabel>: of the transaction;</para></listitem>
+ <listitem><para><guilabel>Deposit or Withdrawal</guilabel>: column.</para></listitem>
</itemizedlist>
- <para>The <emphasis role="bold">Skip Errors</emphasis> check box will skip trying to import any rows with errors in matching the columns.
+ <para>The <guilabel>Skip Errors</guilabel> check box will skip trying to import any rows with errors in matching the columns.
</para>
<para>When you are happy with all the import settings, <link linkend="trans-import-csv-save">save</link> them
- if you will use the same settings again, then press the <emphasis role="bold">Next</emphasis> button.
+ if you will use the same settings again, then press the <guibutton>Next</guibutton> button.
This will bring up a window which allows you to map the accounts identified in the account column (Account Id) with accounts
in the GnuCash account tree (Account name). Double click on a row to bring up a dialog to select the matching GnuCash account.
- When you have selected a match for all accounts, click on the <emphasis role="bold">Next</emphasis> button.
+ When you have selected a match for all accounts, click on the <guibutton>Next</guibutton> button.
</para>
<para>The Transaction Information panel allows review of data entry settings so far.
</para>
@@ -1076,16 +1084,16 @@ Translators:
account must be specified for these transactions.
</para>
<sect3><title>Assign a Destination Account to a Single Transaction</title>
- <para>The currently selected row is selected by Left-clicking it. It is displayed with a mid dark green background.</para>
- <para><emphasis role="bold">Double click</emphasis> on a row. This will select it and open an Account Selection
- dialog. Select the desired destination account in the dialog and click <emphasis role="bold">OK</emphasis>. The row
+ <para>The currently selected row is selected by <mousebutton>left</mousebutton> clicking it. It is displayed with a mid dark green background.</para>
+ <para>Double <mousebutton>left</mousebutton> click on a row. This will select it and open an Account Selection
+ dialog. Select the desired destination account in the dialog and click <guibutton>OK</guibutton>. The row
background will change to a light green and the assigned destination account will be displayed
in the Info column.
</para>
- <para>or alternatively, <emphasis role="bold">Left-click</emphasis> on a row to select it followed by a
- <emphasis role="bold">Right-click </emphasis>to bring up a popup menu then select
- "Assign a transfer account" to display the Account Selection dialog, select the destination account and
- click the <emphasis role="bold">OK</emphasis> button.
+ <para>or alternatively, <mousebutton>left</mousebutton> click on a row to select it followed by a
+ <mousebutton>right</mousebutton> click to bring up a popup menu then select
+ <guimenuitem>Assign a transfer account</guimenuitem> to display the <guilabel>Account Selection</guilabel> dialog, select the destination account and
+ click the <guibutton>OK</guibutton> button.
</para>
</sect3>
<sect3>
@@ -1098,21 +1106,33 @@ Translators:
<para>Multiple rows may be selected to have the same destination account assigned to them.</para>
<para>To select rows either:</para>
<itemizedlist>
- <listitem><para><emphasis role="bold">Left click</emphasis> on first row and then
- <emphasis role="bold">Ctrl-Left click</emphasis> on other rows to add to the selection or</para></listitem>
- <listitem><para><emphasis role="bold">Left-click</emphasis> on a first row and then
- <emphasis role="bold">Shift-Left-click</emphasis> on another row to select all rows between them.</para></listitem>
- </itemizedlist>
- <para>then <emphasis role="bold">Right-click</emphasis> to display a popup menu and then select
- <emphasis role="bold">"Assign a transfer account"</emphasis> to open the Account
- Selection dialog. Select the desired destination account and click the <emphasis role="bold">OK</emphasis>
+ <listitem><para>
+ <mousebutton>Left</mousebutton>
+ click on first row and then
+ <keycombo action='simul'>
+ <keycap>Ctrl</keycap>
+ <mousebutton>Left</mousebutton>
+ </keycombo>
+ click on other rows to add to the selection or
+ </para></listitem>
+ <listitem><para>
+ <mousebutton>left</mousebutton> click on first row and then
+ <keycombo action='simul'>
+ <keycap>Shift</keycap>
+ <mousebutton>Left</mousebutton>
+ </keycombo> click on another row to select all rows between them.
+ </para></listitem>
+ </itemizedlist>
+ <para>then <mousebutton>right</mousebutton> click to display a popup menu and then select
+ <guimenuitem>"Assign a transfer account"</guimenuitem> to open the Account
+ Selection dialog. Select the desired destination account and click the <guibutton>OK</guibutton>
button in the Account Selection dialog.</para>
</sect3>
<sect3>
<title>Completing the Import</title>
<para>Once you have assigned destination accounts for all the imported transactions using the above methods
(all row backgrounds will be a light green colour), check that the assigned destination acounts are correct
- and then press the <emphasis role="bold">OK</emphasis> button at the bottom of the Generic Import Matcher
+ and then press the <guibutton>OK</guibutton> button at the bottom of the Generic Import Matcher
window. The transactions selected for import will have their splits added to the selected source
and destination accounts.
</para>
Summary of changes:
help/C/Help_ch_Transactions.xml | 158 ++++++++++++++++++++++------------------
1 file changed, 89 insertions(+), 69 deletions(-)
More information about the gnucash-changes
mailing list