From a8232abe41cc168fb1596eb16047133fddd7a9ad Mon Sep 17 00:00:00 2001 From: eunhhu Date: Mon, 28 Sep 2026 09:37:36 +0100 Subject: Save a list as its items and a journal of its changes since --- core/module-save.h | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) (limited to 'core/module-save.h') diff --git a/core/module-save.h b/core/module-save.h index bc7adcc..f83e294 100644 --- a/core/module-save.h +++ b/core/module-save.h @@ -4,23 +4,25 @@ /* App states a data host keeps (docs/design/008-module-format.md), internal * to the module executor. Each text state is a stored draft, each list state - * a stored draft its list mirrors, and numbers, cursors and indices are one - * stored value by name. A save publishes what changed, all or nothing. */ + * a stored draft of its items and the records of its changes since, and + * numbers, cursors and indices are one stored value by name. A save + * publishes what changed, all or nothing. */ bool pure_save_enabled(const PureApp *); /* A text state of m: its stored value, or its initial constant when none. */ PureResult pure_save_open_text(PureApp *, const PureModule *m, uint32_t state, PureDraft **out, PureVersion *saved); -/* A list state of m: its stored items, fields moved by name when the stored - * record differs from m's. */ +/* A list state of m: its stored items with its stored changes made again, + * fields moved by name when the stored record differs from m's; journaled is + * the bytes of the records stored after its items. */ PureResult pure_save_open_list(PureApp *, const PureModule *m, uint32_t state, PureList **out, PureDraft **draft, - PureVersion *saved); + PureVersion *saved, size_t *journaled); /* Open the stored numbers, cursors and indices, and put each stored one of the * same name and kind that still fits into values, for the states of m that * kept marks as new (-1); texts and lists are m's. */ PureResult pure_save_open_values(PureApp *, const PureModule *m, double *values, const int *kept, PureDraft *const *texts, PureList *const *lists); -/* Store a list whose record changed in its draft, header and items anew. */ -PureResult pure_save_rewrite_list(const PureModule *m, uint32_t state, PureList *list, PureDraft *draft); +/* Store a list in its draft anew: header and items, no records. */ +PureResult pure_save_rewrite_list(const PureModule *m, uint32_t state, const PureList *list, PureDraft *draft); /* The stored links of a starting app (module.h, PureApp); CONFLICT when an * output with sends left is missing or has other fields. */ PureResult pure_save_open_links(PureApp *, const PureModule *m); -- cgit v1.2.3