history:ensure-empty-root-state
List of: Scheme Extensions
Subjects: History and Roll
Contents: Kernel

Action: Adds empty delta state to the beginning of the history stream so that users can roll to a state with no entities.

Filename: kern/kern_scm/hist_scm.cxx

APIs: api_ensure_empty_root_state, api_get_state_id

Syntax: (history:ensure-empty-root-state [history])

Arg Types: history history

Returns: integer

Description: This routine examines the root delta state of the specified history stream. If the root state is empty (no bulletin boards), then it does nothing. If the root state is not empty, then it adds a new, empty, root state immediately before the original root state. In either case, it returns the ID number of the (empty) root state.


history specifies a history stream.

Example: ; history:ensure-empty-root-state

; No example available at this time
PDF/KERN/13SCF.PDF
HTM/DATA/KERN/KERN/13SCF/0094.HTM