Git commit 27080b08b0822f7adb69c1742810e33abbcaf54c by Jack Ostroff.
Committed on 14/08/2023 at 23:00.
Pushed by ostroffjh into branch 'Handbook-5.2'.

More initial updates

M  +45   -1    README-CONTRIBUTORS
M  +33   -34   doc/firsttime.docbook
M  +15   -13   doc/index.docbook
M  +14   -13   doc/introduction.docbook
M  +130  -76   doc/makemostof.docbook
M  +20   -14   doc/whatsnew.docbook

https://invent.kde.org/office/kmymoney/-/commit/27080b08b0822f7adb69c1742810e33abbcaf54c

diff --git a/README-CONTRIBUTORS b/README-CONTRIBUTORS
index 8911cd4c8..e3721cdce 100644
--- a/README-CONTRIBUTORS
+++ b/README-CONTRIBUTORS
@@ -16,4 +16,48 @@ placed below the existing or target location.
 
 At some point, I will add to this doc a list of which chapters have and have
 not been edited yet, and not use the list used for the 4 -> 5 changes in the
-What's New section.
\ No newline at end of file
+What's New section.
+
+This is in the order pulled in from index.docbook, with brief note on state of 
update
+
+<!ENTITY introduction SYSTEM "introduction.docbook">
+  prelim update
+  
+<!ENTITY whatsnew SYSTEM "whatsnew.docbook">
+  prelim update
+  
+<!ENTITY makemostof SYSTEM "makemostof.docbook">
+  prelim update
+  
+<!ENTITY firsttime SYSTEM "firsttime.docbook">
+  prelim update
+
+<!ENTITY details-institutions SYSTEM "details-institutions.docbook">
+<!ENTITY details-accounts SYSTEM "details-accounts.docbook">
+<!ENTITY details-categories SYSTEM "details-categories.docbook">
+<!ENTITY details-tags SYSTEM "details-tags.docbook">
+<!ENTITY details-payees SYSTEM "details-payees.docbook">
+<!ENTITY details-schedules SYSTEM "details-schedules.docbook">
+<!ENTITY details-ledgers SYSTEM "details-ledgers.docbook">
+<!ENTITY details-investments SYSTEM "details-investments.docbook">
+<!ENTITY details-currencies SYSTEM "details-currencies.docbook">
+<!ENTITY details-reconciliation SYSTEM "details-reconciliation.docbook">
+<!ENTITY details-reports SYSTEM "details-reports.docbook">
+<!ENTITY details-impexp SYSTEM "details-impexp.docbook">
+<!ENTITY details-impexp-csv SYSTEM "details-impexp-csv.docbook">
+<!ENTITY details-impexp-csvexp SYSTEM "details-impexp-csvexp.docbook">
+<!ENTITY details-impexp-woob SYSTEM "details-impexp-woob.docbook">
+<!ENTITY details-loans SYSTEM "details-loans.docbook">
+<!ENTITY details-budgets SYSTEM "details-budgets.docbook">
+<!ENTITY details-forecast SYSTEM "details-forecast.docbook">
+<!ENTITY details-settings SYSTEM "details-settings.docbook">
+<!ENTITY details-search SYSTEM "details-search.docbook">
+<!ENTITY details-formats SYSTEM "details-formats.docbook">
+<!ENTITY details-database SYSTEM "details-database.docbook">
+<!ENTITY faq SYSTEM "faq.docbook">
+<!ENTITY reference SYSTEM "reference.docbook">
+<!ENTITY details-widgets SYSTEM "details-widgets.docbook">
+<!ENTITY credits SYSTEM "credits.docbook">
+<!-- no longer used? <!ENTITY details-hbciofx SYSTEM 
"details-hbciofx.docbook"> -->
+
+<!-- not directly included in docbook   "man-kmymoney.1.docbook" -->
\ No newline at end of file
diff --git a/doc/firsttime.docbook b/doc/firsttime.docbook
index b7551516b..60704e6a3 100644
--- a/doc/firsttime.docbook
+++ b/doc/firsttime.docbook
@@ -16,10 +16,9 @@
 
 <note>
   <para>
-    When you run &kmymoney;, it might not look exactly like the screenshots in
-    this manual.  Many details, such as fonts, colors, and icons, can be
-    customized, either using the
-    <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
+    When you run &kmymoney;, it might not look exactly like the screenshots in 
this
+    manual.  Many details, such as fonts, colors, and icons, can be 
customized, using
+    the <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
     &kmymoney;...</guimenuitem></menuchoice> menu item or the &kde; 
&systemsettings;
     application, depending on your operating system.
   </para>
@@ -56,18 +55,19 @@
 </itemizedlist>
 
 <para>
-  The menu and toolbars provide access to the features of &kmymoney; and allow
-  you to <link linkend="firsttime.3">Create</link> files or configure how
+  The menu and toolbars provide access to the features of &kmymoney; and allow 
you to
+  <link linkend="firsttime.3">Create a new data file</link> or configure how
   &kmymoney; operates.
 </para>
 
 <para>
-  On the left side of the main window, the view selector consists of at least
-  eleven icons with optional labels, depending upon the software provided by
-  your system.  More icons could be added by various plugins.  By clicking on 
an
-  icon, the view window on the right hand side is loaded with the appropriate
-  view of your financial data.  Each view provides a unique representation of
-  your financial situation and allows you to view or edit the information 
shown.
+  On the left side of the main window, the view selector consists of at least 
eleven
+  icons with optional labels, depending upon the software provided by your 
system, as
+  some features can be included or excluded when the program is compiled.  
More icons
+  could be added by various plugins.  By clicking on an icon, the view window 
on the
+  right hand side is loaded with the appropriate view of your financial data.  
Each
+  view provides a unique representation of your financial situation and allows 
you to
+  view or edit the information shown.
 </para>
 
 <para>
@@ -87,8 +87,8 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Home: A configurable overview of your current financial situation (or an
-      introduction page when no data file is open).
+      Home: a configurable overview of your current financial situation (or an
+      introduction page when no data file is open.)
     </para>
   </listitem>
 
@@ -104,8 +104,7 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Institutions: All of your institutions and accounts displayed in a
-      hierarchy.
+      Institutions: all of your institutions and accounts displayed in a 
hierarchy.
     </para>
   </listitem>
 
@@ -137,7 +136,7 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Scheduled Transactions: Your recurring bills and deposits.
+      Scheduled Transactions: your recurring bills and deposits.
     </para>
   </listitem>
 
@@ -153,8 +152,8 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Categories: Special accounts that provide a means for you to group
-      associated transactions.
+      Categories: special accounts that provide a means for you to group 
associated
+      transactions.
     </para>
   </listitem>
 
@@ -170,8 +169,8 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Tags: Special accounts that provide an additional means to Categories for
-      you to group associated transactions.
+      Tags: special accounts that provide an additional means similar to 
Categories
+      for you to group associated transactions.
     </para>
   </listitem>
 
@@ -187,8 +186,8 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Payees: All Payees used by &kmymoney;.  These are all the people or
-      organizations you pay money to or receive money from.
+      Payees: these are all the people or organizations you pay money to or 
receive
+      money from.
     </para>
   </listitem>
 
@@ -198,13 +197,13 @@
        <inlinemediaobject>
          <imageobject>
            <imagedata fileref="ledgers_view.png" format="PNG"/>
-      </imageobject>
+          </imageobject>
          <textobject>
            <phrase>Ledgers View</phrase>
-      </textobject>
+          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Ledgers: Your account transactions.
+      Ledgers: your account transactions.
     </para>
   </listitem>
 
@@ -220,7 +219,7 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Investments: Your portfolio summary.
+      Investments: your portfolio summary.
     </para>
   </listitem>
 
@@ -236,8 +235,8 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Reports: A collection of useful reports, providing alternate, 
customizable
-      views of your financial data.
+      Reports: a collection of reports, providing alternate, customizable 
views of
+      your financial data.
     </para>
   </listitem>
 
@@ -253,7 +252,7 @@
       </textobject>
        </inlinemediaobject>
       </guiicon>
-      Budgets: Your budgets.
+      Budgets: your budgets.
     </para>
   </listitem>
 
@@ -269,7 +268,7 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Forecast: This view provides a forecast of your accounts and categories.
+      Forecast: forecast of the balances of your accounts and categories.
     </para>
   </listitem>
 
@@ -285,9 +284,9 @@
          </textobject>
        </inlinemediaobject>
       </guiicon>
-      Outbox: Used by the online banking module to provide feedback on running
-      processes.  This view is provided by the KBanking plugin and may not be
-      present on your system.
+      Outbox: used by the online banking module to provide feedback on running
+      processes.  This view is provided by the KBanking plugin and may not be 
present
+      on your system.
     </para>
   </listitem>
 </itemizedlist>
diff --git a/doc/index.docbook b/doc/index.docbook
index 7006546c6..2ad157a15 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -77,16 +77,13 @@
   <!ENTITY configicon "<inlinemediaobject><imageobject><imagedata 
fileref='icon-dialog-configure.png' format='PNG'/>
     </imageobject></inlinemediaobject>">
 
-<!-- the chapters -->
+<!-- the chapters (in order of use in the handbook -->
   <!ENTITY introduction SYSTEM "introduction.docbook">
+  <!ENTITY whatsnew SYSTEM "whatsnew.docbook">
   <!ENTITY makemostof SYSTEM "makemostof.docbook">
   <!ENTITY firsttime SYSTEM "firsttime.docbook">
-  <!ENTITY whatsnew SYSTEM "whatsnew.docbook">
   <!ENTITY details-institutions SYSTEM "details-institutions.docbook">
   <!ENTITY details-accounts SYSTEM "details-accounts.docbook">
-  <!ENTITY details-loans SYSTEM "details-loans.docbook">
-  <!ENTITY details-budgets SYSTEM "details-budgets.docbook">
-  <!ENTITY details-forecast SYSTEM "details-forecast.docbook">
   <!ENTITY details-categories SYSTEM "details-categories.docbook">
   <!ENTITY details-tags SYSTEM "details-tags.docbook">
   <!ENTITY details-payees SYSTEM "details-payees.docbook">
@@ -94,21 +91,24 @@
   <!ENTITY details-ledgers SYSTEM "details-ledgers.docbook">
   <!ENTITY details-investments SYSTEM "details-investments.docbook">
   <!ENTITY details-currencies SYSTEM "details-currencies.docbook">
+  <!ENTITY details-reconciliation SYSTEM "details-reconciliation.docbook">
+  <!ENTITY details-reports SYSTEM "details-reports.docbook">
   <!ENTITY details-impexp SYSTEM "details-impexp.docbook">
   <!ENTITY details-impexp-csv SYSTEM "details-impexp-csv.docbook">
   <!ENTITY details-impexp-csvexp SYSTEM "details-impexp-csvexp.docbook">
   <!ENTITY details-impexp-woob SYSTEM "details-impexp-woob.docbook">
-  <!ENTITY details-reconciliation SYSTEM "details-reconciliation.docbook">
-  <!ENTITY details-search SYSTEM "details-search.docbook">
-  <!ENTITY details-reports SYSTEM "details-reports.docbook">
+  <!ENTITY details-loans SYSTEM "details-loans.docbook">
+  <!ENTITY details-budgets SYSTEM "details-budgets.docbook">
+  <!ENTITY details-forecast SYSTEM "details-forecast.docbook">
   <!ENTITY details-settings SYSTEM "details-settings.docbook">
-  <!ENTITY details-widgets SYSTEM "details-widgets.docbook">
+  <!ENTITY details-search SYSTEM "details-search.docbook">
   <!ENTITY details-formats SYSTEM "details-formats.docbook">
   <!ENTITY details-database SYSTEM "details-database.docbook">
-  <!ENTITY details-hbciofx SYSTEM "details-hbciofx.docbook">
   <!ENTITY faq SYSTEM "faq.docbook">
   <!ENTITY reference SYSTEM "reference.docbook">
+  <!ENTITY details-widgets SYSTEM "details-widgets.docbook">
   <!ENTITY credits SYSTEM "credits.docbook">
+  <!-- no longer used? <!ENTITY details-hbciofx SYSTEM 
"details-hbciofx.docbook"> -->
 ]>
 
 <book id="kmymoney" lang="&language;">
@@ -172,11 +172,13 @@ Please at least include KDE, the KDE package it is in, 
the name
  of your application, and a few relevant keywords. -->
 <keywordset>
 <keyword>KDE</keyword>
-<keyword>office</keyword>
-<keyword>KMyMoney4</keyword>
 <keyword>KMyMoney</keyword>
-<keyword>kmymoney4</keyword>
 <keyword>kmymoney</keyword>
+<keyword>KMyMoney4</keyword>
+<keyword>KMyMoney5</keyword>
+<keyword>kmymoney4</keyword>
+<keyword>kmymoney5</keyword>
+<keyword>office</keyword>
 <keyword>finance</keyword>
 <keyword>accounts</keyword>
 <keyword>accounting</keyword>
diff --git a/doc/introduction.docbook b/doc/introduction.docbook
index f45c8743a..4f54b7a51 100644
--- a/doc/introduction.docbook
+++ b/doc/introduction.docbook
@@ -11,7 +11,8 @@
 <title>What is &kmymoney;?</title>
 
 <para>
-  Put simply, &kmymoney; is a personal finance manager by &kde;.  It enables
+  &kmymoney; is a personal finance manager by &kde;.  Some users prefer 
+  It enables
   users of open source operating systems and applications to keep careful track
   of their personal finances by providing a broad array of financial features
   and tools.
@@ -58,21 +59,21 @@
 <title>What &kmymoney; is not</title>
 
 <para>
-  As a personal finance manager, &kmymoney; is not intended to scale to the
-  needs of an average business.  A small business might find sufficient
-  functionality to use &kmymoney;, but features such as accounts-receivable and
-  accounts-payable are not directly supported.  Most if not all the data needed
-  for a small business, such as for reports for audit and taxation purposes is
-  present, but may need to be extracted using various reports and then 
processed
-  and assembled into the required formats.  In addition, it would be possible 
to
-  create client, supplier, document, or other features through plugins.
+  As a personal finance manager, &kmymoney; is not intended to scalesupport 
the needs
+  of an average business.  A small business might find sufficient 
functionality to
+  use &kmymoney;, but features such as accounts-receivable and 
accounts-payable are
+  not directly supported.  Most if not all the data needed for a small 
business, such
+  as for reports for audit and taxation purposes is present, but may need to be
+  extracted using various reports and then processed and assembled into the 
required
+  formats.  In addition, it would be possible to create client, supplier, 
document,
+  or other features through plugins.
 </para>
 
 <para>
-  &kmymoney; is not simply a clone of the commercially available personal
-  finance programs. Although many of the features present in &kmymoney; can be
-  found in other similar applications, &kmymoney; strives to present an
-  individual and unique view of your finances.
+  &kmymoney; is not simply a clone of any of the commercially available 
personal
+  finance programs.  Although many of the features present in &kmymoney; can 
be found
+  in other similar applications, &kmymoney; strives to present an individual 
and
+  unique view of your finances.
 </para>
 
 </sect1>
diff --git a/doc/makemostof.docbook b/doc/makemostof.docbook
index 0d32ddb94..018633a77 100644
--- a/doc/makemostof.docbook
+++ b/doc/makemostof.docbook
@@ -5,39 +5,45 @@
     
<author><personname><firstname>Joe</firstname><surname>(joe1011010)</surname></personname>
             <email>[email protected]</email>
     </author>
+    <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author>
   </authorgroup>
-  <date>2010-04-05</date>
-  <releaseinfo>5.0.4</releaseinfo>
+  <date>2023-08-15</date>
+  <releaseinfo>5.2.0</releaseinfo>
 </chapterinfo>
 
 <title>Making the most of &kmymoney;</title>
 
 <para>
-  While you could go ahead, clicking some buttons and filling in some data,
-  after a time, you could decide you have done it wrong and start again, even 
if
-  you did read the documentation on each part of &kmymoney;.
+  While much of &kmymoney; might be obvious to a naive user, and you could go 
ahead,
+  clicking some buttons and filling in some data, after a time, you might 
decide you
+  have done it wrong and want to start again, even if you did read the 
documentation
+  on each part of &kmymoney;.
 </para>
 
 <para>
-  You will get a more effective system if you spend a little time planning how
-  you are going to use &kmymoney;, so follow the steps given here.
+  You will get a more effective system and much better use of your time if you 
first
+  spend a little time planning how you are going to use &kmymoney;, so follow 
the
+  steps given here.  This may seem very simple, and indeed, it is simple, but 
taking
+  the time to assure that your understanding of how things work is the same as
+  &kmymoney;'s will almost certianly save you time later.
 </para>
 
 <sect1 id="makingmostof.basicaccounting">
 <title>Basic Accounting</title>
 
 <para>
-  Imagine your money as balls, or beans, and to stop them rolling around you
-  keep them in a box, or pot. Accounting, or Bookkeeping, is the process of
-  counting and keeping track of the beans in the pot, or several pots.
+  Imagine your money as balls, or beans, and to stop them rolling around you 
keep
+  them in a box, or pot.  Accounting, or Bookkeeping, is the process of 
counting and
+  keeping track of the beans in the pot, or more important, the beans in 
several
+  pots.
 </para>
 
 <para>
-  You have some money in the pot marked <quote>Cash</quote>. You buy some 
goods,
-  so you take some beans out of the cash pot and place them into another pot
-  marked <quote>Supplier</quote>. The supplier gives you some goods in exchange
-  for the cash, so you take the beans out of the pot marked
-  <quote>Supplier</quote> and put them in the pot marked <quote>Goods</quote>.
+  You have some money in the pot marked <quote>Cash</quote>. You buy some 
goods, so
+  you take some beans out of the cash pot and place them into another pot 
marked
+  <quote>Supplier</quote>. The supplier gives you some goods in exchange for 
the
+  cash, so you take the beans out of the pot marked <quote>Supplier</quote> 
and put
+  them in the pot marked <quote>Goods</quote>.
 </para>
 
 <para>
@@ -131,23 +137,45 @@
 <title>Mapping your finances to &kmymoney;</title>
 
 <para>
-  So, collect up your papers and see the following sections for each item in
-  &kmymoney;.
+  So, collect your recent financial papers and see the following sections for 
more
+  information on how you can map your own finances to each of the different 
areas of
+  &kmymoney;.  Note that each of these sections below is presented in more 
detail in
+  later chapters of this handbook.
 </para>
 
 <sect2 id="makingmostof.mapping.accounts">
 <title>Accounts</title>
 
 <para>
-  These hold a value. Transactions are created against one or more accounts.
+  An <quote>Account</quote> in &kmymoney; represents one ot the 
<quote>pots</quote>
+  of the previous section: is can be anywhere which holds your money and 
possessions
+  that you wish to monitor.  You generally create an account in &kmymoney; to
+  represent each different account you have in <quote>real life,</quote> 
whether it
+  is with a bank or other financial institution, or a store, or even just the 
cash in
+  your wallet.  There are sevral types of accounts available, to represent the
+  different types of places your money may be.
 </para>
 
+<para>
+  Transactions (to be described in more detail later) are created to indicate 
money
+  moving in or out of one or more accounts.
+</para>
+
+<para>
+  As described below, accounts can either hold money which is actually yours 
(assets)
+  or money which you owe (liabilities.)  Liabilities can be though of as magic 
post,
+  which you can take beans from even if there are not acatually any beans 
there, but
+  which you eventually need to replace.  
+</para>
+
+
 <sect3 id="makingmostof.mapping.accounts.asset">
 <title>Accounts - Asset</title>
 
 <para>
-  These are the accounts which hold your money and possessions that you wish to
-  monitor. The following types are available:
+  There are multiple types of Asset Accounts.  They are all essentially the 
same, in
+  holding your money, but there are some differences in the details of how 
money
+  enters and leaves the different types of accounts.
 </para>
 
 <variablelist>
@@ -173,7 +201,7 @@
     <term>Cash</term>
     <listitem>
       <para>
-        Money in your hand or wallet.
+        Money in your pocket or yoor wallet.
       </para>
     </listitem>
   </varlistentry>
@@ -211,8 +239,7 @@
 <title>Accounts - Liability</title>
 
 <para>
-  These are the accounts which represent your debts and money owed that you 
wish
-  to monitor. The following types are available:
+  These accounts represent your debts and money you owe to others.
 </para>
 
 <variablelist>
@@ -238,7 +265,7 @@
     <term>Liability</term>
     <listitem>
       <para>
-        Anything else you owe that is not a loan.
+        Anything else you owe that does fit the other liability account types.
       </para>
     </listitem>
   </varlistentry>
@@ -250,8 +277,11 @@
 <title>Institutions</title>
 
 <para>
-  These are completely optional and can be used to group accounts, and show a
-  total value for all accounts in each group.
+  These represent financial institutions, such as banks or investment brokers. 
 They
+  can be used to group accounts, and can show the total value of all your 
accounts
+  within that institution.  These do not need to reflect actual organizations, 
but
+  are for your convenience in grouping your accounts, and their use is 
completely
+  optional.
 </para>
 </sect2>
 
@@ -259,29 +289,42 @@
 <title>Categories</title>
 
 <para>
-  These represent non-managed income and expense accounts that do not have a
-  value. The total value of transactions is shown against each category. A
-  category or transfer account is required for each transaction.
+  A Category is a special type of account used internally by &kmymoney; to 
track
+  income and expenses.  These account are non-managed, because as mentioned 
earlier,
+  they do not have real values, and show only what you have gotten from them or
+  contributed to them.  Each category shows the total value of transactions 
which
+  mention it.  The principle of double entry accounting requires that every
+  transaction include a category or transfer account.  This will also be 
explained in
+  more detail later in the handbook.
 </para>
-</sect2>
 
-<sect2 id="makingmostof.mapping.subcategories">
+<para>
+  Income Categories are used as places from which you receive money, and 
Expense
+  Categories represent purposes for which you spend money.  On rare occasion, 
money
+  can flow the "wrong" way, such as getting a refund for an over-payment of a 
utility
+  bill.
+</para>
+
+<sect3 id="makingmostof.mapping.subcategories">
 <title>Sub-Categories</title>
 
 <para>
-  Categories can be split into sub-categories, but this relationship is only 
for
-  display purposes, as the sub-category totals are not included in the higher
-  level category total.
+  Categories can be split into sub-categories, but this relationship is 
primarily for
+  your conveniend, and is used for display purposes.  Most of the time, the
+  sub-category totals are not included in the higher level category total, 
although
+  there are specific reports and displays where this can be done.
 </para>
+</sect3>
+
 </sect2>
 
 <sect2 id="makingmostof.mapping.tags">
 <title>Tags</title>
 
 <para>
-  Tags are very similar to Categories, as they are also non-managed accounts
-  that do not have a value.  However, unlike Categories, the use of Tags is
-  completely optional.
+  Tags are very similar to Categories, as they are also non-managed accounts 
that do
+  not have a value.  However, unlike Categories, the use of Tags is completely
+  optional.  They can be used to group transactions for reporting purpses.
 </para>
 </sect2>
 
@@ -289,9 +332,12 @@
 <title>Payees</title>
 
 <para>
-  These are optional for transactions. They are required for Scheduled
-  transactions. A transaction history, with category, is shown against each
-  payee.
+  A Payee (or Payor) represents someone or some group to which you pay money 
or which
+  pays you money.  As with Tags, they are non-managed, and do not have a 
value.  They
+  are primarily a convenience for being able to report how much money you have 
sent
+  to someone or spent at a particular store.  These are optional for most
+  transactions, but are required for Scheduled transactions, which are describe
+  below.  A transaction history, with category, can be shown for each payee.
 </para>
 </sect2>
 
@@ -299,9 +345,9 @@
 <title>Scheduled transactions</title>
 
 <para>
-  Where transactions occur on a regular basis, these can be set up against a
-  Schedule. Transactions are created from a schedule; any that are overdue can
-  be seen on the home page.
+  Where transactions occur on a regular basis, such as salary or utility 
bills, these
+  can be set up against a Schedule.  Transactions are created from Schedules.
+  Scheduled transaction which are overdue can be shown on the home page.
 </para>
 </sect2>
 </sect1>
@@ -309,74 +355,82 @@
 <sect1 id="makingmostof.usefultips">
 <title>Useful Tips</title>
 
+<para>
+  When you start &kmymoney;, the Home View, or Home Page, shows a high level 
overview
+  of your finances.  It is divided into several sections, and you can 
customize which
+  are displayed.  Along the left, there are icons for each of the major Views. 
 Each one is used
+  by &kmymoney; to present a different type of data for entry or reveiw.
+</para>
+
 <para>
   Unless you keep your money under your mattress or under the floorboards, you
   probably make use of one or more institutions where you have accounts, which
   may be in credit or debit. In order to familiarize yourself with the way
   &kmymoney; works, choose an account you want to track with &kmymoney; and
   select the <menuchoice><guimenu>File</guimenu><guimenuitem>New</guimenuitem>
-  </menuchoice> menu item in order to set up an account file.
+  </menuchoice> menu item in order to set up a data file.
 </para>
 
 <para>
-  If you have used another personal finance manager, you may be able to import
-  the data from it into &kmymoney;.
+  If you have used another personal finance manager, you may be able to import 
the
+  data from it into &kmymoney;.
 </para>
 
 <para>
-  If you have some regular receipts into or outgoings from this account, go to
-  Payee and enter the names of both the payers and the payees involved; then go
-  to Schedule and fill in a New Schedule for each recurring transaction. If you
-  haven't entered the payee or payer, &kmymoney; will offer you the opportunity
-  to do this in the middle of entering the schedule.
+  If you have some regular receipts into or outgoings from this account, you 
can go
+  to the Payees View and enter the names of both the payers and the payees 
involved;
+  then go to Scheduled Transactions View and fill in a New Schedule for each
+  recurring transaction. If you haven't entered the payee or payer, &kmymoney; 
will
+  offer you the opportunity to do this in the middle of entering the Schedule.
 </para>
 
 <para>
-  To add other new transactions go to Ledgers; you can add new payees and
-  categories in the middle of a transaction or by going to Payees or Categories
-  before entering the transaction.
+  To add other new transactions go to th Ledger view; you can add new payees 
and
+  categories while entering a transaction or by going to the Payees or 
Categories
+  View before entering the transaction.
 </para>
 
-<para>
-  You will probably find that the default Categories do not exactly match your
-  needs; you can easily delete ones you know you are never going to need and 
add
-  others that you need. But when you are entering a transaction, you only have
-  to type a few letters of a category and &kmymoney; will offer you a drop down
-  list of the matching categories from which to choose.
+<para> 
+  Depending on which option you chose when setting up the data file, you will
+  probably find that the default Categories do not exactly match your needs; 
you can
+  easily delete ones you know you are never going to need and add others that 
you
+  need. But when you are entering a transaction, you only have to type a few 
letters
+  of a category and &kmymoney; will offer you a drop down list of the matching
+  categories from which to choose.
 </para>
 
 <para>
   You can add different accounts managed by different institutions; the
-  preferred one will show when you open &kmymoney; but you can quickly switch 
to
+  preferred ones will show when you open &kmymoney; but you can quickly switch 
to
   any of the others.
 </para>
 
 <para>
-  When you make a payment, &kmymoney; will work out what the next check number
-  should be; delete this if you are not making a check payment or edit it if
-  the first check you enter is not check number 1. Alternatively, it is
-  possible to switch off auto-increment of check numbers.
+  When you make a payment, &kmymoney; will work out what the next check number 
should
+  be; delete this if you are not making a check payment or edit it if the 
first check
+  you enter is not check number 1. Alternatively, it is possible to switch off
+  auto-increment of check numbers.
 </para>
 
 <para>
-  Every so often you may get statements of your account from the institutions
-  you use; you can reconcile your &kmymoney; accounts against these statements
-  so that you have an accurate statement of the current state of your finances.
+  Every so often you may get statements of your account from the institutions 
you
+  use.  You can reconcile your &kmymoney; accounts against these statements so 
that
+  you know you have an accurate representation of the current state of your 
finances.
 </para>
 
 <para>
-  If you go to Reports, you will find several default reports; to customize
-  these, open one similar to the sort you prefer and then select 'New' (not
-  'Copy'); you can then customize this to your needs and mark it as a preferred
+  If you go to the Reports View, you will find several default reports.  To 
customize
+  these, open the one most similar to the sort you prefer and then select 
'New' (not
+  'Copy'.)  You can then customize this to your needs and mark it as a 
preferred
   report if you wish.
 </para>
 
 <para>
-  Though &kmymoney; is not intended for use in a business context, if you are
-  running a business on your own and so do not need payroll functions, you will
-  probably find that &kmymoney; is sufficiently customizable to meet your needs
-  particularly as it comes with budgeting and forecasting features and you can
-  export your customized reports via CSV into other applications.
+  Though &kmymoney; is not intended for use in a business context, if you are 
running
+  a business on your own and so do not need payroll functions, you may find 
that
+  &kmymoney; is sufficiently customizable to meet your needs, particularly as 
it
+  comes with budgeting and forecasting features, and you can export your 
customized
+  reports via CSV into other applications.
 </para>
 </sect1>
 </chapter>
diff --git a/doc/whatsnew.docbook b/doc/whatsnew.docbook
index 7a8f5b99d..a948b1778 100644
--- a/doc/whatsnew.docbook
+++ b/doc/whatsnew.docbook
@@ -10,19 +10,22 @@
 <title>Bug fixes and enhancements to functionality</title>
 
 <para>
-  As with every release, the &kmymoney; development team continues to work hard
-  to make each version better and easier to use in every way.  Many bugs have
-  been fixed since the previous stable release of 5.1.4; several areas of the
-  program have seen functional enhancements; but the major noticeable change 
from
-  the 5.1 series of releases is in the ledger - more details below.
+  As with every release, the &kmymoney; development team continues to work 
hard to
+  make each version better and easier to use in every way.  Many bugs have 
been fixed
+  since the previous stable release of 5.1.4; several areas of the program 
have seen
+  functional enhancements; but the major noticeable changes from the 5.1 
series of
+  releases are in the ledger - more details below.
 </para>
 
 <para>
   The conversion to using &kde-frameworks; was essentially complete in the 
5.1.x
   releases, with much of that work behind the scenes and not directly visible 
to the
   end user.  The general look and feel should remain stable, although some 
minor
-  changes still occur.  The basic functionality of the program also remains 
the same,
-  aside from intentional improvements and additions.
+  changes may be noticable.  In addition, the team has begun to make changes to
+  support the eventual conversion to using Qt6 and KDE6 libraries, which will
+  eventually replace Qt5 and KDE5. With all these changes, the basic 
functionality of
+  the program remains the same, aside from intentional bug fixes, 
improvements, and
+  additions.
 </para>
 
 <para>
@@ -33,10 +36,13 @@
 </para>
 
 <para>
-  The 5.0.x and 5.1.x series included some changes needing adjustments on the
-  user's side, if they were upgrading from 4.8.x or an older version.  However,
-  we expect that most users have converted to 5.x by now.  Specifically, there
-  should be no adjustments needed by users converting from 5.1.x to 5.2.
+  The 5.0.x and 5.1.x series included some changes needing adjustments on the 
user's
+  side, if they were upgrading from 4.8.x or an older version.  However, we 
expect
+  that most users have converted to 5.x by now.  Specifically, there should be 
no
+  adjustments needed by users converting from 5.1.x to 5.2.  If for some 
reason, you
+  are still using &kmymoney; version 4, you are very strongly encouraged to 
upgrade,
+  as it is getting increasingly difficult for the team to provide any 
assistance for
+  very old version.
 </para>
 
 </sect1>
@@ -44,9 +50,9 @@
 <sect1>
 <title>Updates to this Handbook</title>
 <para>
-  This section used to talk about the lack of complete handbook update from 4.x
-  to 5.x.  The intent is that the handbook be fully updated for 5.2, so this
-  section should hopefully be able to be removed before release.
+  This section used to present some details related to the lack of a complete
+  handbook update from 4.x to 5.x.  The intent is that the handbook be fully 
updated
+  for 5.2, so this section should hopefully be able to be removed before 
release.
 </para>
 
 </sect1>

Reply via email to