r18099 - gnucash/trunk/src/register/ledger-core - Register: Add some header comments for a confusing function.

Charles Day cedayiv at code.gnucash.org
Mon Jun 1 20:50:54 EDT 2009

Author: cedayiv
Date: 2009-06-01 20:50:54 -0400 (Mon, 01 Jun 2009)
New Revision: 18099
Trac: http://svn.gnucash.org/trac/changeset/18099

Register: Add some header comments for a confusing function.

Modified: gnucash/trunk/src/register/ledger-core/split-register-p.h
--- gnucash/trunk/src/register/ledger-core/split-register-p.h	2009-06-01 04:29:30 UTC (rev 18098)
+++ gnucash/trunk/src/register/ledger-core/split-register-p.h	2009-06-02 00:50:54 UTC (rev 18099)
@@ -142,6 +142,15 @@
 void gnc_split_register_show_trans (SplitRegister *reg,
                                     VirtualCellLocation start_loc);
+// Set the visibility of the split rows belonging to a transaction located at
+// vcell_loc.
+// If only_blank_split is TRUE, only the row used for entering an
+// additional split is affected. Despite the name, this should not be confused
+// with the "blank split" row used for entering the first split of a brand-new
+// transaction. Instead, here it only refers to rows not tied to any split at
+// all, such as those created for entering new splits on old transactions or
+// the 2nd through nth split on brand-new transactions.
 void gnc_split_register_set_trans_visible (SplitRegister *reg,
                                            VirtualCellLocation vcell_loc,
                                            gboolean visible,

More information about the gnucash-changes mailing list