[office/kmymoney/Handbook-5.2] /: complete preliminary pass on all handbook chapters
Jack Ostroff
null at kde.org
Mon Jan 1 00:41:44 GMT 2024
Git commit 09cf5cd9ec505872c4894fcd8465d3bb3ca9af2f by Jack Ostroff.
Committed on 01/01/2024 at 01:41.
Pushed by ostroffjh into branch 'Handbook-5.2'.
complete preliminary pass on all handbook chapters
M +5 -5 README-CONTRIBUTORS
M +1 -1 doc/credits.docbook
M +29 -5 doc/details-settings.docbook
M +5 -5 doc/index.docbook
M +263 -163 doc/reference.docbook
https://invent.kde.org/office/kmymoney/-/commit/09cf5cd9ec505872c4894fcd8465d3bb3ca9af2f
diff --git a/README-CONTRIBUTORS b/README-CONTRIBUTORS
index 978905f0e9..1481ee4831 100644
--- a/README-CONTRIBUTORS
+++ b/README-CONTRIBUTORS
@@ -97,22 +97,22 @@ This is in the order pulled in from index.docbook, with brief note on state of u
prelim update complete
<!ENTITY details-settings SYSTEM "details-settings.docbook">
- prelim update begun
+ prelim update complete
<!ENTITY faq SYSTEM "faq.docbook">
prelim update complete
<!ENTITY reference SYSTEM "reference.docbook">
-
+ prelim update complete
+
<!ENTITY details-widgets SYSTEM "details-widgets.docbook">
to be reviewed by Thomas
<!ENTITY credits SYSTEM "credits.docbook">
prelim update complete
-<!-- no longer used? <!ENTITY details-hbciofx SYSTEM "details-hbciofx.docbook"> -->
-
-<!-- not directly included in docbook "man-kmymoney.1.docbook" -->
+<!-- not directly included in docbook "man-kmymoney.1.docbook" but should
+ still be reviewed for accuracy -->
----------------
diff --git a/doc/credits.docbook b/doc/credits.docbook
index 285d3077d9..ec286e7480 100644
--- a/doc/credits.docbook
+++ b/doc/credits.docbook
@@ -55,7 +55,7 @@
<listitem>
<para>
<emphasis role="bold">Marko Käning <email>mk-lists at email.de</email></emphasis>:
- Patches, packaging and KF5-CI for OS-X.
+ Patches, packaging, and KF5-CI for OS-X.
</para>
</listitem>
diff --git a/doc/details-settings.docbook b/doc/details-settings.docbook
index 1962edff84..9c750d0a68 100644
--- a/doc/details-settings.docbook
+++ b/doc/details-settings.docbook
@@ -6,7 +6,7 @@
<author>&Michael.Carpino; &Michael.Carpino.mail;</author>
<author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author>
</authorgroup>
- <date>2023-11-30</date>
+ <date>2023-12-30</date>
<releaseinfo>5.2.0</releaseinfo>
</chapterinfo>
@@ -1289,22 +1289,46 @@
</para>
</sect2>
-<sect2><title>QIF Exporter</title>
+<sect2><title>QIF Exporter, QIF Importer</title>
<para>
+ These are described in the section on <link
+ linkend="details.impexp.qif.profile">QIF Profiles</link>. As pointed out in that
+ section, QIF Import and QIF Export are implemented as separate plugins, they both
+ utilize the same set of profiles.
</para>
</sect2>
-<sect2><title>QIF Importer</title>
+<sect2><title>Reports view</title>
+<!-- FIXME: this needs better incorporation into the Reports Chapter. It is currently
+ not mentioned there at all. -->
<para>
+ This provides a dialog where you can configure some default values to be used when displaying
+ <link linkend="details.reports">Reports</link>.
</para>
-</sect2>
-<sect2><title>Reports view</title>
+<para>
+ <guilabel>Maximum number of legend items to display</guilabel> limits the number of
+ items to list in the legend of the graph of chart display of a report.
+</para>
+
+<para>
+ <guilabel>Charts line width</guilabel> is the default width in pixels of any lines
+ in the chart display of a report.
+</para>
+
+<para>
+ <guilabel>Charts palette</guilabel> gives some choice in the array of colors used
+ in graphs and chart displays of a report.
+</para>
<para>
+ Since the graph and chart form of reports are shown using HTML, the
+ <guilabel>Default CSS file</guilabel> lets you provide a css file to customize
+ these displays.
</para>
+
</sect2>
<sect2><title>XML Storage</title>
diff --git a/doc/index.docbook b/doc/index.docbook
index f3abee804f..70a46f01c3 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -116,7 +116,7 @@
<bookinfo>
<title>The &kmymoney; Handbook</title>
-<subtitle>for &kmymoney; version 5.0</subtitle>
+<subtitle>for &kmymoney; version 5.2</subtitle>
<authorgroup>
<!-- This is just put in as an example. For real documentation, please
@@ -137,7 +137,7 @@ and use `&George.N.Ugnacious; &George.N.Ugnacious.mail;' in the author element.
</authorgroup>
<copyright>
-<year>2000-2018</year>
+<year>2000-2024</year>
<holder>The &kmymoney; Development Team</holder>
</copyright>
<!-- Translators: put here the copyright notice of the translation -->
@@ -152,8 +152,8 @@ Please respect the format of the date (YYYY-MM-DD) and of the version
(V.MM.LL), it could be used by automation scripts.
Do NOT change these in the translation. -->
-<date>2018-01-13</date>
-<releaseinfo>5.0.0</releaseinfo>
+<date>2023-12-30</date>
+<releaseinfo>5.2.0</releaseinfo>
<!-- Abstract about this handbook -->
@@ -163,7 +163,7 @@ Do NOT change these in the translation. -->
</para>
<para>
- This handbook describes &kmymoney; version 5.0.
+ This handbook describes &kmymoney; version 5.2.
</para>
</abstract>
diff --git a/doc/reference.docbook b/doc/reference.docbook
index c0e16ceccc..b3a65d3ac6 100644
--- a/doc/reference.docbook
+++ b/doc/reference.docbook
@@ -10,15 +10,17 @@
<sect1 id="reference.menus">
<sect1info>
<author> &Roger.Lum; &Roger.Lum.mail; </author>
+ <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author>
</sect1info>
<title>Menus</title>
<para>
- Below is a complete list of the menu selections in &kmymoney;, with a very
- brief description of what each one does. Note that many of these menu choices
- will be unavailable, or grayed out, depending on the current display or state
- of the application. For example, you are not able to edit an account unless
- you have an account selected or displayed in the current view.
+ Below is a complete list of the menu selections in &kmymoney;, with a very brief
+ description of what each one does. Note that many of these menu choices will be
+ unavailable, or grayed out, depending on the current display or state of the
+ application. In addition, some may not be present if it relates to a feature not
+ included in your particular version. For example, you are not able to edit an
+ account unless you have an account selected or displayed in the current view.
</para>
<sect2 id="reference.menus.file"><title>File Menu</title>
@@ -29,12 +31,13 @@
<shortcut>
<keycombo>&Ctrl;<keycap>N</keycap></keycombo>
</shortcut>
- <guimenu>File</guimenu><guimenuitem>New</guimenuitem>
+ <guimenu>File</guimenu><guimenuitem>New book</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action> Creates a new empty &kmymoney; data file. Only one
- &kmymoney; file can be open at once, so this will close your current file
- first, if one is open. </action></para>
+ <para>
+ Creates a new, empty &kmymoney; data file. Only one &kmymoney; file can be
+ open at once, so this will close your current file first, if one is open.
+ </para>
</listitem>
</varlistentry>
@@ -46,19 +49,17 @@
<guimenu>File</guimenu><guimenuitem>Open</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Opens an existing &kmymoney; data file.</action></para>
+ <para>Opens an existing &kmymoney; data file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu>
- <guimenuitem>Open Recent</guimenuitem>
- <guimenuitem>...</guimenuitem>
+ <guimenuitem>Open Recent</guimenuitem><guimenuitem>...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Allows quick access to recently opened
- files.</action></para>
+ <para>Provides quick access to recently opened files.</para>
</listitem>
</varlistentry>
@@ -67,7 +68,7 @@
<guimenu>File</guimenu><guimenuitem>Open Database...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Opens an existing database.</action></para>
+ <para>Opens an existing database.</para>
</listitem>
</varlistentry>
@@ -79,10 +80,14 @@
<guimenu>File</guimenu><guimenuitem>Save</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Saves the currently open file.</action></para>
+ <para>
+ Saves the currently open file. Only enabled if there are any changes to
+ save.
+ </para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><menuchoice>
<shortcut>
@@ -91,18 +96,7 @@
<guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Saves the currently open file with a different
- filename.</action></para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term><menuchoice>
- <guimenu>File</guimenu><guimenuitem>Save As Database...</guimenuitem>
- </menuchoice></term>
- <listitem>
- <para><action>Saves the currently open file in a <link
- linkend="details.database">Database</link>.</action></para>
+ <para>Saves the currently open file with a different filename.</para>
</listitem>
</varlistentry>
@@ -113,9 +107,11 @@
<guimenuitem>...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Imports financial data from other file types, such as QIF
- and &gnucash;, or a template file of accounts and categories that can be
- used in setting up new accounts.</action></para>
+ <para>
+ Imports financial data from other file types, such as QIF and &gnucash;, or a
+ template file of accounts and categories that can be used in setting up new
+ accounts.
+ </para>
</listitem>
</varlistentry>
@@ -126,9 +122,10 @@
<guimenuitem>...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Exports the current file as a different file type, such as
- QIF, or exports a list of your accounts and categories as an template.
- </action></para>
+ <para>
+ Exports the current file as a different file type, such as QIF, or exports a
+ list of your accounts and categories as a template.
+ </para>
</listitem>
</varlistentry>
@@ -137,41 +134,40 @@
<shortcut>
<keycombo>&Ctrl;<keycap>P</keycap></keycombo>
</shortcut>
- <guimenu>File</guimenu><guimenuitem>Print</guimenuitem>
+ <guimenu>File</guimenu><guimenuitem>Print...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Prints the current file.</action></para>
+ <para>Prints the current file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
- <guimenu>File</guimenu><guimenuitem>Backup</guimenuitem>
+ <guimenu>File</guimenu><guimenuitem>Backup...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Saves a backup the current file.</action></para>
+ <para>Saves a backup the current file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
- <guimenu>File</guimenu><guimenuitem>Personal Data</guimenuitem>
+ <guimenu>File</guimenu><guimenuitem>Personal Data...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Allows to edit personal data.</action></para>
+ <para>Allows to edit personal data.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
- <guimenu>File</guimenu><guimenuitem>File information</guimenuitem>
+ <guimenu>File</guimenu><guimenuitem>File information...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Displays information about the currently open &kmymoney;
- file.</action></para>
+ <para>Displays information about the currently open &kmymoney; file.</para>
</listitem>
</varlistentry>
- <!--Dump Memory what i sthis?-->
+
<varlistentry>
<term><menuchoice>
<shortcut>
@@ -180,7 +176,7 @@
<guimenu>File</guimenu><guimenuitem>Close</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Closes the current file.</action></para>
+ <para>Closes the currently open data file.</para>
</listitem>
</varlistentry>
@@ -192,7 +188,10 @@
<guimenu>File</guimenu><guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Quit &kmymoney;.</action></para>
+ <para>
+ Quits &kmymoney;. Offers to save the currenly open data file, if there are
+ any changes.
+ </para>
</listitem>
</varlistentry>
</variablelist>
@@ -204,12 +203,40 @@
<varlistentry>
<term><menuchoice>
<shortcut>
- <keycombo>&Ctrl;<keycap>F</keycap></keycombo>
+ <keycombo>&Ctrl;<keycap>Z</keycap></keycombo>
+ </shortcut>
+ <guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para>Reverses the most recent action.</para>
+ </listitem>
+ </varlistentry>
+</variablelist>
+
+<variablelist>
+ <varlistentry>
+ <term><menuchoice>
+ <shortcut>
+ <keycombo>&Ctrl;&Shift;<keycap>Z</keycap></keycombo>
+ </shortcut>
+ <guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para>Re-applies the most recently undone action.</para>
+ </listitem>
+ </varlistentry>
+</variablelist>
+
+<variablelist>
+ <varlistentry>
+ <term><menuchoice>
+ <shortcut>
+ <keycombo>&Ctrl;&Shift;<keycap>F</keycap></keycombo>
</shortcut>
<guimenu>Edit</guimenu><guimenuitem>Find transaction...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Search transactions.</action></para>
+ <para>Searches transactions.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -227,15 +254,15 @@
<guimenuitem>Show Transaction Detail</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>
+ <para>
Shows transaction details in the <link
- linkend="details.ledgers">Ledger</link> view. With this option turned
- on, all lines of the transaction will be shown in the ledger. When it
- is turned off, only one line will be shown.
- </action></para>
+ linkend="details.ledgers">Ledgers</link> view. With this option turned on,
+ all lines of the transaction will be shown. When it is turned off, only one
+ line will be shown.
+ </para>
<para>
- If you only want to see details for the currently selected transaction,
- but only one line for the others, you can turn on the <link
+ If you only want to see details for the currently selected transaction, but
+ only one line for the others, you can turn on the <link
linkend="details.settings.register.lens">Ledger Lens</link>.
</para>
</listitem>
@@ -250,8 +277,7 @@
<guimenuitem>Hide reconciled transactions</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Hides reconciled transactions on the
- register.</action></para>
+ <para>Hides reconciled transactions in the register.</para>
</listitem>
</varlistentry>
@@ -264,21 +290,22 @@
<guimenuitem>Hide unused categories</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Hides unused categories in the views.</action></para>
+ <para>Hides unused categories in the views.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
- <keycombo>
- &Ctrl;&Shift;<keycap>A</keycap>
- </keycombo>
+ <keycombo>&Ctrl;&Shift;<keycap>A</keycap></keycombo>
</shortcut>
<guimenu>View</guimenu><guimenuitem>Show all accounts</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Shows all accounts in the views.</action></para>
+ <para>
+ Shows all accounts in the views, including closed accounts and accountw with
+ zero balance.
+ </para>
</listitem>
</varlistentry>
</variablelist>
@@ -293,7 +320,7 @@
<guimenuitem>New institution...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Add a new institution.</action></para>
+ <para>Add a new institution.</para>
</listitem>
</varlistentry>
@@ -303,7 +330,7 @@
<guimenuitem>Edit institution...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Edit an institution.</action></para>
+ <para>Edit an institution.</para>
</listitem>
</varlistentry>
@@ -313,7 +340,7 @@
<guimenuitem>Delete institution...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Delete an institution.</action></para>
+ <para>Delete an institution.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -328,7 +355,7 @@
<guimenuitem>New account...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Adds a new account.</action></para>
+ <para>Adds a new account.</para>
</listitem>
</varlistentry>
@@ -337,7 +364,7 @@
<guimenu>Account</guimenu><guimenuitem>Edit account...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Edits an account.</action></para>
+ <para>Edits an account.</para>
</listitem>
</varlistentry>
@@ -346,7 +373,7 @@
<guimenu>Account</guimenu><guimenuitem>Delete account...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Deletes an account.</action></para>
+ <para>Deletes an account.</para>
</listitem>
</varlistentry>
@@ -355,31 +382,28 @@
<guimenu>Account</guimenu><guimenuitem>Open ledger</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Displays the ledger view of an account.</action></para>
+ <para>Displays the ledger view of the selected account.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
- <keycombo>
- &Ctrl;&Shift;<keycap>R</keycap>
- </keycombo>
+ <keycombo>&Ctrl;&Shift;<keycap>R</keycap></keycombo>
</shortcut>
<guimenu>Account</guimenu><guimenuitem>Reconcile...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Reconciles an account through the reconciliation
- wizard.</action></para>
+ <para>Reconciles an account through the reconciliation wizard.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
- <guimenu>Account</guimenu><guimenuitem>Postpone reconciliation</guimenuitem>
+ <guimenu>Account</guimenu><guimenuitem>Postpone</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Postpones reconciliation of an account.</action></para>
+ <para>Postpones reconciliation of an account.</para>
</listitem>
</varlistentry>
@@ -388,7 +412,16 @@
<guimenu>Account</guimenu><guimenuitem>Finish</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Finishes reconciliation of an account.</action></para>
+ <para>Finishes reconciliation of an account.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Account</guimenu><guimenuitem>Cancel</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para>Cancels reconciliation of an account.</para>
</listitem>
</varlistentry>
@@ -397,7 +430,7 @@
<guimenu>Account</guimenu><guimenuitem>Transaction report</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Opens a transaction report of an account.</action></para>
+ <para>Opens a transaction report of the selected account.</para>
</listitem>
</varlistentry>
@@ -406,7 +439,7 @@
<guimenu>Account</guimenu><guimenuitem>Close account</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Closes an account.</action></para>
+ <para>Closes an account.</para>
</listitem>
</varlistentry>
@@ -415,25 +448,25 @@
<guimenu>Account</guimenu><guimenuitem>Reopen account</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Reopens an account, if closed.</action></para>
+ <para>Reopens an account, if closed.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
- <guimenu>Account</guimenu><guimenuitem>Unmap account</guimenuitem>
+ <guimenu>Account</guimenu><guimenuitem>Unmap account...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Unmaps an online account.</action></para>
+ <para>Unmaps an online account.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
- <guimenu>Account</guimenu><guimenuitem>Map to online account</guimenuitem>
+ <guimenu>Account</guimenu><guimenuitem>Map account...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Maps an account to an online account.</action></para>
+ <para>Maps an account to an online account.</para>
</listitem>
</varlistentry>
@@ -442,8 +475,7 @@
<guimenu>Account</guimenu><guimenuitem>Update account...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Imports transactions from online banking for an
- account.</action></para>
+ <para>Imports transactions from online banking for the selected account.</para>
</listitem>
</varlistentry>
@@ -453,11 +485,9 @@
<guimenuitem>Update all accounts...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Import transactions from online banking for all
- accounts.</action></para>
+ <para>Import transactions from online banking for all mapped accounts.</para>
</listitem>
</varlistentry>
- <!--New credit transfer-->
</variablelist>
</sect2>
@@ -469,7 +499,7 @@
<guimenu>Category</guimenu><guimenuitem>New category...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Adds a new category.</action></para>
+ <para>Adds a new category.</para>
</listitem>
</varlistentry>
@@ -478,7 +508,7 @@
<guimenu>Category</guimenu><guimenuitem>Edit category...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Edits a category.</action></para>
+ <para>Edits a category.</para>
</listitem>
</varlistentry>
@@ -487,7 +517,7 @@
<guimenu>Category</guimenu><guimenuitem>Delete category...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Deletes a category.</action></para>
+ <para>Deletes a category.</para>
</listitem>
</varlistentry>
@@ -496,7 +526,7 @@
<guimenu>Category</guimenu><guimenuitem>Open ledger</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Displays the ledger view of a category.</action></para>
+ <para>Displays the ledger view of a category.</para>
</listitem>
</varlistentry>
</variablelist>
@@ -510,109 +540,125 @@
<shortcut>
<keycombo>&Ctrl;&Ins;</keycombo>
</shortcut>
- <guimenu>Transaction</guimenu><guimenuitem>New</guimenuitem>
+ <guimenu>Transaction</guimenu><guimenuitem>New transaction</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Adds a new transaction.</action></para>
+ <para>Adds a new transaction.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
+ <shortcut>
+ <keycombo>&Ctrl;<keycap>E</keycap></keycombo>
+ </shortcut>
<guimenu>Transaction</guimenu><guimenuitem>Edit</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Edits a transaction.</action></para>
+ <para>Edits a transaction.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
+ <shortcut>
+ <keycombo>&Ctrl;&Shift;<keycap>E</keycap></keycombo>
+ </shortcut>
<guimenu>Transaction</guimenu><guimenuitem>Edit splits</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Edits the splits of a transaction.</action></para>
+ <para>Edits the splits of a transaction.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
+ <shortcut>
+ <keycombo>&Ctrl;∇</keycombo>
+ </shortcut>
<guimenu>Transaction</guimenu><guimenuitem>Delete</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Deletes a transaction.</action></para>
+ <para>Deletes a transaction.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
+ <shortcut>
+ <keycombo>&Ctrl;<keycap>D</keycap></keycombo>
+ </shortcut>
<guimenu>Transaction</guimenu><guimenuitem>Duplicate</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Duplicates a transaction.</action></para>
+ <para>Duplicates a transaction.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
+ <shortcut>
+ <keycombo>&Ctrl;&Alt;&Shift;&Space;</keycombo>
+ </shortcut>
<guimenu>Transaction</guimenu>
<guimenuitem>Mark transaction as ...</guimenuitem>
<guimenuitem>Not Reconciled</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Changes a transaction to Not Reconciled
- status.</action></para>
+ <para>
+ Changes the status of the selected transaction(s) to Not Reconciled status.
+ </para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
- <keycombo>
- &Ctrl;&Alt;&Space;
- </keycombo>
+ <keycombo>&Ctrl;&Alt;&Space;</keycombo>
</shortcut>
<guimenu>Transaction</guimenu>
<guimenuitem>Mark transaction as ...</guimenuitem>
<guimenuitem>Cleared</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Changes a transaction to Cleared status.</action></para>
+ <para> Changes the status of the selected transaction(s) to Cleared.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
<shortcut>
- <keycombo>
- &Ctrl;&Shift;&Space;
- </keycombo>
+ <keycombo>&Ctrl;&Shift;&Space;</keycombo>
</shortcut>
<guimenu>Transaction</guimenu>
<guimenuitem>Mark transaction as ...</guimenuitem>
<guimenuitem>Reconciled</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Changes a transaction to Reconciled status.</action></para>
+ <para>Changes the status of the selected transaction(s) to Reconciled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
- <guimenu>Transaction</guimenu><guimenuitem>Go to account</guimenuitem>
+ <guimenu>Transaction</guimenu><guimenuitem>Go to "account"</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Displays the other account of a transaction.</action></para>
+ <para>Displays the other account of a transaction in the Ledger.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><menuchoice>
+ <shortcut>
+ <keycombo>&Ctrl;&Shift;<keycap>P</keycap></keycombo>
+ </shortcut>
<guimenu>Transaction</guimenu><guimenuitem>Go to payee</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Displays the Payee view and focuses on the payee of the
- selected transaction.</action></para>
+ <para>
+ Displays the Payee view and focuses on the payee of the selected transaction.
+ </para>
</listitem>
</varlistentry>
@@ -622,7 +668,10 @@
<guimenuitem>Create scheduled transaction...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Creates a new scheduled transaction.</action></para>
+ <para>
+ Creates a new scheduled transaction using the details of the selected
+ transaction.
+ </para>
</listitem>
</varlistentry>
@@ -631,7 +680,10 @@
<guimenu>Transaction</guimenu><guimenuitem>Match</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Matches imported transactions.</action></para>
+ <para>
+ Matches two transactions. This is most commonly used to match an imported
+ and a manually entered transaction, but other combinations also work.
+ </para>
</listitem>
</varlistentry>
@@ -641,9 +693,9 @@
</menuchoice></term>
<listitem>
<para>
- <action>Unmatches a transactions that &kmymoney; has proposed
- as a match of imported transactions.</action> Note that this
- menu choice is only present if a matched transaction exists.
+ Unmatches a transaction that &kmymoney; has proposed as a match of imported
+ transactions. Note that this menu choice is only present if a matched
+ transaction exists and is selected.
</para>
</listitem>
</varlistentry>
@@ -653,8 +705,7 @@
<guimenu>Transaction</guimenu><guimenuitem>Accept</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Accepts a proposed merge of imported
- transactions.</action></para>
+ <para>Accepts a proposed merge of two transactions.</para>
</listitem>
</varlistentry>
@@ -666,7 +717,7 @@
<guimenu>Transaction</guimenu><guimenuitem>Select all</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Selects all transactions on the register.</action></para>
+ <para>Selects all transactions in the register.</para>
</listitem>
</varlistentry>
@@ -676,12 +727,10 @@
</menuchoice></term>
<listitem>
<para>
- <action>Prints the contents of the selected transaction in the displayed
- register, formatted according to the selected template.</action> Note
- that this menu choice is only present if a transaction is selected in
- the register. See the section on configuring the <link
- linkend="details.settings.plugins">Print check</link> plugin for more
- information.
+ Prints the contents of the selected transaction in the displayed ledger,
+ formatted according to the selected template. See the section on configuring
+ the <link linkend="details.settings.plugins">Print check</link> plugin for
+ more information.
</para>
</listitem>
</varlistentry>
@@ -691,22 +740,12 @@
<sect2 id="reference.menus.tools"><title>Tools Menu</title>
<variablelist>
- <varlistentry>
- <term><menuchoice>
- <guimenu>Tools</guimenu><guimenuitem>QIF Profile Editor...</guimenuitem>
- </menuchoice></term>
- <listitem>
- <para><action>Modifies the QIF profile used to import or export QIF
- files.</action></para>
- </listitem>
- </varlistentry>
-
<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Currencies...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Lists the currencies known to &kmymoney;.</action></para>
+ <para>Lists the currencies known to &kmymoney;.</para>
</listitem>
</varlistentry>
@@ -715,7 +754,7 @@
<guimenu>Tools</guimenu><guimenuitem>Prices...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Lists stock and currency prices.</action></para>
+ <para>Lists stock and currency prices.</para>
</listitem>
</varlistentry>
@@ -725,9 +764,11 @@
<guimenuitem>Update Stock and Currency Prices...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Updates stock and currency prices from online sources using
- the <link linkend="details.investments.onlinequotes">Online Price
- Quotes</link> feature.</action></para>
+ <para>
+ Updates stock and currency prices from online sources using the <link
+ linkend="details.investments.onlinequotes">Online Price Quotes</link>
+ feature.
+ </para>
</listitem>
</varlistentry>
@@ -736,8 +777,10 @@
<guimenu>Tools</guimenu><guimenuitem>Consistency Check</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Runs a check on your file and tries to fix any problem it
- finds, if possible.</action></para>
+ <para>
+ Runs a check on your file, fixes any problems it can, and displayes a report
+ of the results.
+ </para>
<para>Make a backup of your file before running this option.</para>
</listitem>
</varlistentry>
@@ -747,22 +790,36 @@
<guimenu>Tools</guimenu><guimenuitem>Performance-Test</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Runs a performance test on your file and displays the
- results.</action></para>
+ <para>Runs a performance test on your file and displays the results.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Tools</guimenu><guimenuitem>Generate Database SQL</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para>Generates the SQL necessary to create a database.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Tools</guimenu><guimenuitem>Debug timers</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para>This is a tool for developers.</para>
</listitem>
</varlistentry>
- <!--Generate Database SQL
- Debug Traces
- Debug Timers-->
</variablelist>
</sect2>
-<sect2 id="reference.menus.settings.help"><title>Settings and Help Menu</title>
+<sect2 id="reference.menus.settings.help"><title>Settings and Help Menus</title>
<para>
- &kmymoney; has the default &kde; Settings and Help menus as described
- in the <ulink url="help:/fundamentals/menus.html">&kde;
- Fundamentals</ulink> with one additional entry:
+ The Settings and Help menus of &kmymoney; are based on those described in <ulink
+ url="help:/fundamentals/menus.html">&kde; Fundamentals</ulink> with some additional
+ items.
</para>
<variablelist>
@@ -771,28 +828,71 @@
<guimenu>Settings</guimenu><guimenuitem>Enable all messages</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Re-enables any messages you may have turned off by checking
+ <para>Re-enables any messages you may have turned off by checking
<guimenuitem>Don't tell me about this again</guimenuitem> in a dialog
- box.</action></para>
+ box.</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Settings</guimenu><guimenuitem>Configure Language...</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para>
+ By default, the language used by &kmymoney; depends on the system wide
+ seettings for location or locale. This allows you to change that language,
+ and to set a fallback language, which is used for text whic has not been
+ translated into the primary language.
+ </para>
</listitem>
</varlistentry>
+
<varlistentry>
<term><menuchoice>
- <guimenu>Settings</guimenu><guimenuitem>Configure Aqbanking</guimenuitem>
+ <shortcut>
+ <keycombo>&Ctrl;&Alt;<keycap>,</keycap></keycombo>
+ </shortcut>
+ <guimenu>Settings</guimenu><guimenuitem>Configure Keyboard Shortcuts...</guimenuitem>
</menuchoice></term>
<listitem>
- <para><action>Configure online banking settings</action>, see
- <ulink url="https://userbase.kde.org/KMyMoney/FAQ#How_do_I_configure_online_banking_.3F">How do I configure online banking</ulink>
- for further details.
+ <para>
+ Allows you to add or modify keyboard shortcuts for various actions.
</para>
- <para>Note that this menu selection is only available if the KBanking
- module is enabled. See the section on configuring the
- <link linkend="details.settings.plugins.kbanking">KBanking plugin</link>
- for more information.
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><menuchoice>
+ <guimenu>Settings</guimenu><guimenuitem>Configure Aqbanking</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para>
+ Configure online banking setting. See <ulink
+ url="https://userbase.kde.org/KMyMoney/FAQ#How_do_I_configure_online_banking_.3F">How
+ do I configure online banking</ulink> for further details. This menu
+ selection is only available if the KBanking module is enabled. See the
+ section on configuring the <link
+ linkend="details.settings.plugins.kbanking">KBanking plugin</link> for more
+ information.
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><menuchoice>
+ <shortcut>
+ <keycombo>&Ctrl;&Alt;<keycap>I</keycap></keycombo>
+ </shortcut>
+ <guimenu>Help</guimenu><guimenuitem>Find Action...</guimenuitem>
+ </menuchoice></term>
+ <listitem>
+ <para>
+ Displays the names and shortcuts of all actions in &kmymoney;. Clicking on
+ one will invoke that action, if it is currently enabled.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
</sect2>
</sect1>
More information about the kde-doc-english
mailing list