#

## flush

Forget changes to the edit cell (or to the indicated cell) since the last saved version.

### Usage:

> flush [cellname] [-noprompt] [-dereference]

> > where cellname is the name of a cell definition to be flushed.

### Summary:

> The flush command reverts a cell definition to the last version saved to disk, forgetting all changes made in the interim. Without arguments, the current edit cell is flushed. Otherwise, the named cell is flushed.

> The effects of the flush command are irrevocable; the command cannot be undone with an undo command.

> With the -noprompt option, no interactive confirmation is presented if there are unsaved changes. Those changes will be flushed. With the -dereference option, any file path that has been associated with the cell is discarded, and the cell is reloaded from the first location found in the search path. With search path manipulations, this can be used, for example, to switch between abstract and full views of a cell.

### Implementation Notes:

> flush is implemented as a built-in command in magic. However, it conflicts with the Tcl flush command that flushes an output pipe. Special processing determines which use is intended.

### See Also:

> path

Return to command index

Last updated: December 10, 2020 at 1:15pm