gnucash maint: Multiple changes pushed

[John Ralls]

Updated	 via  https://github.com/Gnucash/gnucash/commit/b1b36874 (commit)
	 via  https://github.com/Gnucash/gnucash/commit/0fd0aca5 (commit)
	from  https://github.com/Gnucash/gnucash/commit/6384985f (commit)



commit b1b368746f1a9bd9209e948fde4ac0d72d2fe30c
Merge: 6384985f9 0fd0aca53
Author: John Ralls <jralls at ceridwen.us>
Date:   Sat Jun 19 13:19:31 2021 -0700

    Merge Hong Xu's 'explain-as-of-date' into maint.


commit 0fd0aca531aed6876a588fc466c0f3e5c95e5c8e
Author: Hong Xu <hong at topbug.net>
Date:   Wed Jun 16 12:07:23 2021 -0700

    Explain out what AsOfDate means in the doc
    
    As discussed at
    https://lists.gnucash.org/pipermail/gnucash-user/2021-June/096893.html

diff --git a/libgnucash/engine/Account.h b/libgnucash/engine/Account.h
index 04b6e6e07..910d96fdf 100644
--- a/libgnucash/engine/Account.h
+++ b/libgnucash/engine/Account.h
@@ -561,11 +561,11 @@ gnc_numeric xaccAccountGetClearedBalance (const Account *account);
 gnc_numeric xaccAccountGetReconciledBalance (const Account *account);
 gnc_numeric xaccAccountGetPresentBalance (const Account *account);
 gnc_numeric xaccAccountGetProjectedMinimumBalance (const Account *account);
-/** Get the balance of the account as of the date specified */
+/** Get the balance of the account at the end of the day before the date specified. */
 gnc_numeric xaccAccountGetBalanceAsOfDate (Account *account,
         time64 date);
 
-/** Get the reconciled balance of the account as of the date specified */
+/** Get the reconciled balance of the account at the end of the day of the date specified. */
 gnc_numeric xaccAccountGetReconciledBalanceAsOfDate (Account *account, time64 date);
 
 /* These two functions convert a given balance from one commodity to
@@ -605,13 +605,13 @@ gnc_numeric xaccAccountGetProjectedMinimumBalanceInCurrency (
     const Account *account, const gnc_commodity *report_commodity,
     gboolean include_children);
 
-/* This function gets the balance as of the given date, ignoring
-   closing entries, in the desired commodity. */
+/** This function gets the balance at the end of the given date, ignoring
+    closing entries, in the desired commodity. */
 gnc_numeric xaccAccountGetNoclosingBalanceAsOfDateInCurrency(
     Account *acc, time64 date, gnc_commodity *report_commodity,
     gboolean include_children);
-/* This function gets the balance as of the given date in the desired
-   commodity. */
+/** This function gets the balance at the end of the given date in the desired
+    commodity. */
 gnc_numeric xaccAccountGetBalanceAsOfDateInCurrency(
     Account *account, time64 date, gnc_commodity *report_commodity,
     gboolean include_children);



Summary of changes:
 libgnucash/engine/Account.h | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)