[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