Git commit fe0a9928b4c8cbeddcca7068e84d2980637b0e3b by Jack Ostroff. Committed on 30/06/2024 at 21:16. Pushed by ostroffjh into branch 'Handbook-5.2'.
update chapter dates M +3 -3 doc/credits.docbook M +1 -1 doc/details-accounts.docbook M +1 -1 doc/details-budgets.docbook M +1 -1 doc/details-categories.docbook M +1 -1 doc/details-currencies.docbook M +1 -1 doc/details-database.docbook M +1 -1 doc/details-forecast.docbook M +1 -1 doc/details-formats.docbook M +1 -1 doc/details-impexp.docbook M +1 -1 doc/details-institutions.docbook M +2 -2 doc/details-investments.docbook M +1 -1 doc/details-ledgers.docbook M +1 -1 doc/details-loans.docbook M +1 -1 doc/details-payees.docbook M +1 -1 doc/details-reconciliation.docbook M +1 -1 doc/details-reports.docbook M +1 -1 doc/details-schedules.docbook M +1 -1 doc/details-search.docbook M +1 -1 doc/details-settings.docbook M +1 -1 doc/details-tags.docbook M +1 -1 doc/faq.docbook M +1 -1 doc/firsttime.docbook M +1 -1 doc/index.docbook M +11 -10 doc/introduction.docbook M +22 -10 doc/makemostof.docbook M +1 -1 doc/reference.docbook M +14 -14 doc/whatsnew.docbook https://invent.kde.org/office/kmymoney/-/commit/fe0a9928b4c8cbeddcca7068e84d2980637b0e3b diff --git a/doc/credits.docbook b/doc/credits.docbook index 1cfe6fb2aa..5f6e40e277 100644 --- a/doc/credits.docbook +++ b/doc/credits.docbook @@ -1,14 +1,14 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="credits"> <chapterinfo> - <date>2023-12-24</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Credits</title> <para> - Program Copyright © 2000-2019 The &kmymoney; Development Team + Program Copyright © 2000-2024 The &kmymoney; Development Team </para> <para> @@ -16,7 +16,7 @@ </para> <para> - Documentation Copyright © 2000-2019 The &kmymoney; Development Team + Documentation Copyright © 2000-2024 The &kmymoney; Development Team </para> <!-- TRANS:CREDIT_FOR_TRANSLATORS --> diff --git a/doc/details-accounts.docbook b/doc/details-accounts.docbook index adc1832a44..7189b9c723 100644 --- a/doc/details-accounts.docbook +++ b/doc/details-accounts.docbook @@ -6,7 +6,7 @@ <author> &Roger.Lum; &Roger.Lum.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2024-01-18</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> diff --git a/doc/details-budgets.docbook b/doc/details-budgets.docbook index a7b7777113..1ed7eabddf 100644 --- a/doc/details-budgets.docbook +++ b/doc/details-budgets.docbook @@ -5,7 +5,7 @@ <author> &Colin.Wright; &Colin.Wright.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-11-20</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> diff --git a/doc/details-categories.docbook b/doc/details-categories.docbook index d8d93df777..96b6994fc3 100644 --- a/doc/details-categories.docbook +++ b/doc/details-categories.docbook @@ -6,7 +6,7 @@ <author>&Michael.Carpino; &Michael.Carpino.mail;</author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-08-30</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> diff --git a/doc/details-currencies.docbook b/doc/details-currencies.docbook index 81bfc905a3..c576060ff1 100644 --- a/doc/details-currencies.docbook +++ b/doc/details-currencies.docbook @@ -6,7 +6,7 @@ <author>&Michael.Carpino; &Michael.Carpino.mail;</author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-09-30</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Currencies</title> diff --git a/doc/details-database.docbook b/doc/details-database.docbook index 29551c868f..c42ae8fb4c 100644 --- a/doc/details-database.docbook +++ b/doc/details-database.docbook @@ -5,7 +5,7 @@ <author>&Tony.Bloomfield; &Tony.Bloomfield.mail;</author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-11-25</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Database</title> diff --git a/doc/details-forecast.docbook b/doc/details-forecast.docbook index 5e330ddbb1..67cce7b2ab 100644 --- a/doc/details-forecast.docbook +++ b/doc/details-forecast.docbook @@ -5,7 +5,7 @@ <author> &Colin.Wright; &Colin.Wright.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-11-20</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Forecast</title> diff --git a/doc/details-formats.docbook b/doc/details-formats.docbook index a67cac1e6a..596623a955 100644 --- a/doc/details-formats.docbook +++ b/doc/details-formats.docbook @@ -5,7 +5,7 @@ <author> &Thomas.Baumgart; &Thomas.Baumgart.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2024-05-10</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>File Formats</title> diff --git a/doc/details-impexp.docbook b/doc/details-impexp.docbook index 4b0bb8e659..757aa10aaf 100644 --- a/doc/details-impexp.docbook +++ b/doc/details-impexp.docbook @@ -5,7 +5,7 @@ <author>&Ace.Jones; &Ace.Jones.mail;</author> <author>&Jack.H.Ostroff; &Jack.H.Ostroff.mail;</author> </authorgroup> - <date>2023-20-25</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Importing and Exporting</title> diff --git a/doc/details-institutions.docbook b/doc/details-institutions.docbook index e3b7911acb..30cf1a58a4 100644 --- a/doc/details-institutions.docbook +++ b/doc/details-institutions.docbook @@ -5,7 +5,7 @@ <author> &Roger.Lum; &Roger.Lum.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2024-01-18</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Institutions</title> diff --git a/doc/details-investments.docbook b/doc/details-investments.docbook index e05a62736e..ce3fd7d745 100644 --- a/doc/details-investments.docbook +++ b/doc/details-investments.docbook @@ -6,7 +6,7 @@ <author>&Michael.Carpino; &Michael.Carpino.mail;</author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-09-05</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Investments</title> @@ -42,7 +42,7 @@ and cash. In &kmymoney;, an Investment account holds <emphasis>only</emphasis> securities. It cannot contain any cash balance. This was a design decision made when Investment accounts were first included in &kmymoney;. It might be changed in - th future, but that is likely to be done as part of a significant revision in all + the future, but that is likely to be done as part of a significant revision in all of &kmymoney;'s handling of investments. For now, any cash needed to purchase a security or gained from a sell or dividend transaction requires the use of a Brokerage Account. diff --git a/doc/details-ledgers.docbook b/doc/details-ledgers.docbook index 82739da9de..fdbb97e709 100644 --- a/doc/details-ledgers.docbook +++ b/doc/details-ledgers.docbook @@ -7,7 +7,7 @@ <author>&Michael.Carpino; &Michael.Carpino.mail;</author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-09-04</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Ledgers</title> diff --git a/doc/details-loans.docbook b/doc/details-loans.docbook index 70bf255949..3fa72ddea0 100644 --- a/doc/details-loans.docbook +++ b/doc/details-loans.docbook @@ -5,7 +5,7 @@ <author> &Darin.Strait; &Darin.Strait.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-11-20</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Loans</title> diff --git a/doc/details-payees.docbook b/doc/details-payees.docbook index c12d150b43..d9facb8a72 100644 --- a/doc/details-payees.docbook +++ b/doc/details-payees.docbook @@ -7,7 +7,7 @@ <author>&Michael.Carpino; &Michael.Carpino.mail;</author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-08-30</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Payees</title> diff --git a/doc/details-reconciliation.docbook b/doc/details-reconciliation.docbook index 8779802b54..27ee627c13 100644 --- a/doc/details-reconciliation.docbook +++ b/doc/details-reconciliation.docbook @@ -5,7 +5,7 @@ <author> &Michael.T.Edwardes; &Michael.T.Edwardes.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-09-30</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Reconciliation</title> diff --git a/doc/details-reports.docbook b/doc/details-reports.docbook index a66f8270a9..f0f3723b72 100644 --- a/doc/details-reports.docbook +++ b/doc/details-reports.docbook @@ -5,7 +5,7 @@ <author> &Ace.Jones; &Ace.Jones.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-10-02</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Reports</title> diff --git a/doc/details-schedules.docbook b/doc/details-schedules.docbook index cbf9a78f2a..2770741db6 100644 --- a/doc/details-schedules.docbook +++ b/doc/details-schedules.docbook @@ -7,7 +7,7 @@ <author>&Michael.Carpino; &Michael.Carpino.mail;</author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-08-30</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Schedules</title> diff --git a/doc/details-search.docbook b/doc/details-search.docbook index b2eefcef12..51bea8e549 100644 --- a/doc/details-search.docbook +++ b/doc/details-search.docbook @@ -5,7 +5,7 @@ <author> &Darin.Strait; &Darin.Strait.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-11-25</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Search Transactions</title> diff --git a/doc/details-settings.docbook b/doc/details-settings.docbook index 7c46d15c8b..a2630d0abc 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-12-30</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>&kmymoney; Settings</title> diff --git a/doc/details-tags.docbook b/doc/details-tags.docbook index 28e60322d7..ee7b15dbf6 100644 --- a/doc/details-tags.docbook +++ b/doc/details-tags.docbook @@ -5,7 +5,7 @@ <author>&Cristian.Onet; &Cristian.Onet.mail;</author> <author>&Michael.Carpino; &Michael.Carpino.mail;</author> </authorgroup> - <date>2024-02-060</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Tags</title> diff --git a/doc/faq.docbook b/doc/faq.docbook index f08433f24b..3182f5eb11 100644 --- a/doc/faq.docbook +++ b/doc/faq.docbook @@ -4,7 +4,7 @@ <authorgroup> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-12-26</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Questions and Answers</title> diff --git a/doc/firsttime.docbook b/doc/firsttime.docbook index faaa9c5b9c..bc5f728dc8 100644 --- a/doc/firsttime.docbook +++ b/doc/firsttime.docbook @@ -5,7 +5,7 @@ <author> &Michael.T.Edwardes; &Michael.T.Edwardes.mail; </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-08-15</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Using &kmymoney; for the first time</title> diff --git a/doc/index.docbook b/doc/index.docbook index 70a46f01c3..52091dce7f 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -152,7 +152,7 @@ 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>2023-12-30</date> +<date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> <!-- Abstract about this handbook --> diff --git a/doc/introduction.docbook b/doc/introduction.docbook index 37d522e0c3..c80a8a42a6 100644 --- a/doc/introduction.docbook +++ b/doc/introduction.docbook @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="introduction"> <chapterinfo> - <date>2023-10-23</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Introduction</title> @@ -41,7 +41,7 @@ <listitem> <formalpara><title>Correctness</title> <para> - Based on tried and tested double entry accounting principles &kmymoney; + Based on tried and tested double entry accounting principles, &kmymoney; ensures that your finances are kept in correct order. </para> </formalpara> @@ -52,14 +52,15 @@ <sect1 id="what-kmymoney-is-not"><title>What &kmymoney; is not</title> <para> - As a personal finance manager, &kmymoney; is not intended to support 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 support the needs of a + business. A small business might find sufficient functionality to use &kmymoney;, + but features such as accounts-receivable and accounts-payable are not directly + supported. The larger the business, the less likely it is to find &kmymoney; will + meet its financial management needs. 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> diff --git a/doc/makemostof.docbook b/doc/makemostof.docbook index 17129772d4..a3dc3bd7e7 100644 --- a/doc/makemostof.docbook +++ b/doc/makemostof.docbook @@ -7,7 +7,7 @@ </author> <author> &Jack.H.Ostroff; &Jack.H.Ostroff.mail; </author> </authorgroup> - <date>2023-10-23</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Making the most of &kmymoney;</title> @@ -20,19 +20,31 @@ </para> <para> - 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 certainly save you time later. + You will get a more efficient and 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 certainly save you time later. </para> +<note> + <para> + This and the following sections have been essentially unchanged since a very + early version of &kmymoney;. While the basics of bookkeeping have not changed + over the years, and there is nothing inaccurate or misleading here, there have + been requests to update this area. If you have any specific suggestions or ideas + for this, the author would like to hear from you, through one of the routes + listed at the <ulink url="https://kmymoney.org/support.html";>Support page</ulink> + at the <ulink url="https://kmymoney.org/";>&kmymoney; web site</ulink> + </para> +</note> + <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 more important, the beans in several - pots. + Imagine your money as balls, or beans, and to stop them rolling around and getting + lost 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> diff --git a/doc/reference.docbook b/doc/reference.docbook index 8959d4dded..e7c680cc00 100644 --- a/doc/reference.docbook +++ b/doc/reference.docbook @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="reference"> <chapterinfo> - <date>2023-12-23</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>Reference</title> diff --git a/doc/whatsnew.docbook b/doc/whatsnew.docbook index fd239cb13c..5a520e9ac2 100644 --- a/doc/whatsnew.docbook +++ b/doc/whatsnew.docbook @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="UTF-8"?> <chapter id="whatsnew"> <chapterinfo> - <date>2023-08-15</date> + <date>2024-07-01</date> <releaseinfo>5.2.0</releaseinfo> </chapterinfo> <title>What's new in this release</title> @@ -10,33 +10,33 @@ <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 + since the previous stable release of 5.1.3; 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 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. + The conversion from using the earlier &KDE; libraries to &kde-frameworks; was + essentially complete in the early 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 + continue to remain stable, although some minor changes may be noticable. In + addition, the team has begun to make changes to support the conversion to using Qt6 + and KDE6 libraries, which have already started to 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> - In past releases, this section of the manual has included a list of many of the - specific bug fixes and functional enhancements. However, rather than - duplicating that information, you can find it directly in the <ulink + In past releases, this section of the manual included a list of many of the + specific bug fixes and functional enhancements. However, rather than duplicating + that information, you can find it directly in the <ulink url="https://kmymoney.org/changelog.html";>Changelog</ulink>. </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 + that most users have converted to 5.1.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
