Git commit 6c8932acd263b40228248e79de2c5bd08d6e6ec4 by Jack Ostroff. Committed on 14/05/2024 at 20:56. Pushed by ostroffjh into branch 'Handbook-5.2'.
more doc cleanup M +29 -99 README-CONTRIBUTORS M +2 -1 doc/details-categories.docbook M +18 -3 doc/details-formats.docbook M +9 -0 doc/reference.docbook https://invent.kde.org/office/kmymoney/-/commit/6c8932acd263b40228248e79de2c5bd08d6e6ec4 diff --git a/README-CONTRIBUTORS b/README-CONTRIBUTORS index 65b4b59947..08097dd496 100644 --- a/README-CONTRIBUTORS +++ b/README-CONTRIBUTORS @@ -22,98 +22,25 @@ updated for the 4 -> 5 changes in the What's New section. It is no longer usefu needed as this version will be released with the release of 5.2, ane really should be complete by then. -This is in the order pulled in from index.docbook, with brief note on state of update +All chapters have had at least one pass, with the following exceptions: -<!ENTITY introduction SYSTEM "introduction.docbook"> - prelim update complete - -<!ENTITY whatsnew SYSTEM "whatsnew.docbook"> - prelim update complete - <!ENTITY makemostof SYSTEM "makemostof.docbook"> - prelim update - probably need a complete replacement of this - -<!ENTITY firsttime SYSTEM "firsttime.docbook"> - prelim update complete - -<!ENTITY details-institutions SYSTEM "details-institutions.docbook"> - prelim update complete - -<!ENTITY details-accounts SYSTEM "details-accounts.docbook"> - prelim update complete - -<!ENTITY details-categories SYSTEM "details-categories.docbook"> - prelim update complete - -<!ENTITY details-tags SYSTEM "details-tags.docbook"> - prelim update complete - -<!ENTITY details-payees SYSTEM "details-payees.docbook"> - prelim update complete - -<!ENTITY details-schedules SYSTEM "details-schedules.docbook"> - prelim update complete - -<!ENTITY details-ledgers SYSTEM "details-ledgers.docbook"> - prelim update complete - -<!ENTITY details-investments SYSTEM "details-investments.docbook"> - prelim update complete - -<!ENTITY details-currencies SYSTEM "details-currencies.docbook"> - prelim update complete + I think we need a complete replacement of this chapter. -<!ENTITY details-reconciliation SYSTEM "details-reconciliation.docbook"> - prelim update complete - -<!ENTITY details-reports SYSTEM "details-reports.docbook"> - prelim update complete - -<!ENTITY details-impexp SYSTEM "details-impexp.docbook"> - prelim update complete - <!ENTITY details-impexp-csv SYSTEM "details-impexp-csv.docbook"> - prelim update one pass. needs lots more work - -<!ENTITY details-impexp-csvexp SYSTEM "details-impexp-csvexp.docbook"> - prelim update complete + Really needs lots more work. I'd love to add a discussion of what parts of import + are file type specific, and what things are done after an import is processed into + a common format for final processing. <!ENTITY details-impexp-woob SYSTEM "details-impexp-woob.docbook"> - prelim update complete - needs reveiw by Woob user. - -<!ENTITY details-loans SYSTEM "details-loans.docbook"> - prelim update complete + Needs reveiw by Woob user. <!ENTITY details-budgets SYSTEM "details-budgets.docbook"> - prelim update complete, need to add screenshots - -<!ENTITY details-forecast SYSTEM "details-forecast.docbook"> - prelim update complete - -<!ENTITY details-search SYSTEM "details-search.docbook"> - prelim update complete - -<!ENTITY details-formats SYSTEM "details-formats.docbook"> - prelim update complete + Need to add screenshots -<!ENTITY details-database SYSTEM "details-database.docbook"> - prelim update complete - -<!ENTITY details-settings SYSTEM "details-settings.docbook"> - 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 + Needs to be reviewed by Thomas -<!ENTITY credits SYSTEM "credits.docbook"> - prelim update complete - <!-- not directly included in docbook "man-kmymoney.1.docbook" but should still be reviewed for accuracy --> @@ -306,9 +233,6 @@ elsewhere. - Cant search results be sorted any more? (Could they ever?) -- Need to mention in file formats chapter that all data files can be stored locally - or on a network share. Also mention mounting the share is often an issue on Windows. - - what does File/Backup do if SQL is the current file type? - on the config dialog, home section, should the top area be put in a box as are the @@ -326,10 +250,11 @@ elsewhere. example, Ledger configuration, Data Entry tab: Default reconciliation state is dropdown with three choices, but Autofill has three radio-button choices. -XXX - In Edit Account, bottom of General tab, Budget Options allows account to be - included in budgets as Income or Expense. Does this essentially allow to include - transfers to/from this account in budgets? + included in budgets as Income or Expense. This actually adds the account as Asset + or Liability, not Income or Expense. However, I still see no evicence of any such + account in any budget report. Perhaps this should just be left as is, and raised + as an issue after 5.2? ------------------------ resolved issues moved to below. should probably just delete @@ -352,6 +277,7 @@ XXX - Is CC (cost center) used for anything? Does it occur anywhere except Categories (which is only that cc is required) -- not used, and now possibly hidden by config time option. + -- now noted. - do we need a Tags main menu item? -- don't have one for tags or payees. OK @@ -409,6 +335,10 @@ XXX security. Should it also show the symbol? (The manual used to say it did.) -- Added. Not explicitly mentioned in handbook. +- Need to mention in file formats chapter that all data files can be stored locally + or on a network share. Also mention mounting the share is often an issue on Windows. + -- done. + ------------------------ resolved issues for now, but still need future discussion - do we want to talk about stock as an account type? - will defer, including possible @@ -420,9 +350,8 @@ XXX -- actually fixed a while ago. However when you click on new parent and then OK, instead of just updating the hierarchy, the whole dialog is closed. Is this OK? -- In New Category dialog, Price entry dropdown is disabled. Is there any condition - under which it is enabled? If so, need to add to handbook. - -- CC and price entry dropped. Should we also drop Last Check number? +- In New Category dialog, Price entry has been dropped (also CC) + -- Should we also drop Last Check number? - On schecule frequency, should we comment on possibly odd combinations of frequency and the interval? What happens if you say 2 Once? Is 2 Month the same as 1 Every @@ -435,9 +364,9 @@ XXX actually fetching prices (stocks or currency.) Should we just drop the field, or at least note it is ignored? IS there any way to retreive historic prices? - > > T This has recently changed. If the price source has a #x in its regex for - price or date then it expects the data to be in CSV format. In such a case, - the date fields are enabled but only used for that price source. + >> T This has recently changed. If the price source has a #x in its regex for + price or date then it expects the data to be in CSV format. In such a case, + the date fields are enabled but only used for that price source. > J2 I'll need to try it, if I can find any source with historic dates. Otherwise, I suppose I can just save any changes about this for later. T2 I attach a screenshot of my settings for this. And here are those settings @@ -477,7 +406,7 @@ XXX ignored. How do we want to deal with this? -- (This is really part of the previous issue.) -- Can the transaction form show up other than at the bottom of the transaction list? +- The transaction form shows up always at the bottom of the transaction list. With or without the form enabled, editing a transaction shows the form at the location of the transaction in the ledger. Shouldn't editing take place in the form at the bottom? @@ -494,8 +423,8 @@ XXX enter/edit transactions. - The handbook uses "Schedules" as the formal name, but the View Selector says - "Scheduled transactions" We should be consistent. - -- I found the source - do we want to shorten it? + "Scheduled transactions" We should be consistent. and shorten it? (hard to find in + code, since it includes \n. - In Gnucash import, matching of account types, some map to things that are only applicable to security subaccounts of investmant accounts. Should these be shown @@ -526,7 +455,8 @@ XXX -- Still would like a note on the relation between Aqbanking and KBanking. (external libraries/routines and the KMM framework for calling them?) -- Budget View has buttons labelled Upd and Res. Should these be expanded to Update and Reset? - -- TB said he would remove, but I now see full text Update and Remove. Tooltips are present and - for those two, there is a (not useful?) "hit Shift for more". +- Budget View has buttons labelled Upd and Res. Should these be expanded to Update +and Reset? -- TB said he would remove, but I now see full text Update and Remove. +Tooltips are present and for those two, there is a (not useful?) "hit Shift for +more". The "more" is not very useful - should it just be dropped? diff --git a/doc/details-categories.docbook b/doc/details-categories.docbook index 58dd565736..d8d93df777 100644 --- a/doc/details-categories.docbook +++ b/doc/details-categories.docbook @@ -61,7 +61,8 @@ An indication that a cost center assignment is necessary under certain conditions when entering a transaction for this category. This is a recently added feature, which is not yet implemented, so this column is not currently - used. + used. In addition, it may not show up at all, depending on the value of a + build time configuration setting. </para> </listitem> </varlistentry> diff --git a/doc/details-formats.docbook b/doc/details-formats.docbook index 4deb85bf57..a67cac1e6a 100644 --- a/doc/details-formats.docbook +++ b/doc/details-formats.docbook @@ -57,15 +57,14 @@ a filename in <filename class="extension">.xml</filename>, the file will be stored in this format. -<!-- FIXME: should this caution really be within the above <para>? --> -<caution> +<note> <para> Manual modification of the file is not recommended to the normal user, and should only be performed if the internal working of &kmymoney; is fully understood or if instructions from the developers tell you what to do. Don't blame the &kmymoney; developers if you damage or destroy your data: You have been warned! </para> -</caution> +</note> </para> </sect2> @@ -205,6 +204,22 @@ developer mailing list at &devlist; for further investigation. If the problem does not show ... well, I don't want to think about this scenario right now. </para> +</sect2> + +<sect2><title>Data file locations</title> +<para> + All of the above file types can be stored on a local hard drive, a removeable + devicee such as a usb thumb drive, or a network location. Depending on your + Operating System, a remote location may need to be mapped or mounted prior to use. +</para> + +<note><title>Limitation on Windows</title> + <para> + On &Windows;, in order to use a netork or remote file location, that mapped + location must be mapped to a drive letter. + </para> +</note> + </sect2> </sect1> diff --git a/doc/reference.docbook b/doc/reference.docbook index 4988ce9c00..9dc890e651 100644 --- a/doc/reference.docbook +++ b/doc/reference.docbook @@ -428,6 +428,15 @@ </listitem> </varlistentry> + <varlistentry> + <term><menuchoice> + <guimenu>Account</guimenu><guimenuitem>Show balance chart...</guimenuitem> + </menuchoice></term> + <listitem> + <para>Opens a YTD (Year to date) chart of the balance of the selected account.</para> + </listitem> + </varlistentry> + <varlistentry> <term><menuchoice> <guimenu>Account</guimenu><guimenuitem>Close account</guimenuitem>