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-li...@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>
