mirror of
https://github.com/Gnucash/gnucash.git
synced 2025-02-25 18:55:30 -06:00
add documentation, add safety check
git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash/trunk@9592 57a11ea4-9604-0410-9ed3-97b8803252fd
This commit is contained in:
parent
e23307d377
commit
5bae2ba525
@ -123,6 +123,10 @@ void
|
||||
qof_instance_gemini (QofInstance *to, QofInstance *from)
|
||||
{
|
||||
time_t now;
|
||||
|
||||
/* Books must differ for a gemini to be meaningful */
|
||||
if (!from || !to || (from->book == to->book)) return;
|
||||
|
||||
now = time(0);
|
||||
|
||||
/* Make a note of where the copy came from */
|
||||
|
@ -60,9 +60,14 @@ KvpFrame* qof_instance_get_slots (QofInstance *);
|
||||
/** return value of is_dirty flag */
|
||||
gboolean qof_instance_is_dirty (QofInstance *);
|
||||
|
||||
/** pair things up. Currently, this routine only inserts a
|
||||
* pair of guid-pointers pointing to each other. it
|
||||
* doesn't copy any data.
|
||||
/** Pair things up. This routine inserts a kvp value into each instance
|
||||
* containing the guid of the other. In this way, if one has one of the
|
||||
* pair, one can always find the other by looking up it's guid. Typically,
|
||||
* you will want to use qof_instance_lookup_twin() to find the twin.
|
||||
* (The current implementation assumes the two instances belong to different
|
||||
* books, and will not add gemini kvp's unless the books differ. Note that
|
||||
* the gemini kvp includes the book guid as well, so that the right book can
|
||||
* be found.
|
||||
*/
|
||||
void qof_instance_gemini (QofInstance *to, QofInstance *from);
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user