changes Parameter

Sets the number of changes made to the file.

Scope: File

Syntax

query changes 
set changes [Number] 

Option

Number 
The new count of changes made to the file until the next save. The default is zero.

Description

The changes parameter counts the number of changes made to the file until it is saved.

The changes count is increased by one every time a command that changes the file is issued or a line or part line is altered by overtyping. A macro that makes many alterations counts as just one change.

The changes count is also affected by the undo command. Each set of changes undone by an undo operation decrements the count by one, and each set of changes redone by a redo operations increases the count by one. If you perform undo operations to a document past a file save point, the changes count decrements until it reaches zero, after which it starts incrementing. The opposite occurs if you are redoing changes to a document.

When the file is saved, Number is set to zero.

Setting the changes parameter explicitly also adds Number to the value of the autochanges parameter. This means that the changes can be used to force an autosave operation. Changing the autochanges parameter does not change the changes parameter.

Examples

  1. To display the number of changes made, type:
    query changes 
  2. To force an autosave if autocount is 15 and autochanges is zero, type:
    set changes 15 

API Return Codes

-2 
The number specified was either outside the valid range or not a whole number. Issue the command again using a valid number.

autochanges Parameter
autocount Parameter
undo Command