save.trim Parameter

save.trim parameter

Use the save.trim parameter to set or query whether the save command should trim trailing blanks from all of the lines in the document.

Availability

query command
set command
current parameter
default parameter
install parameter

Scope

save.trim is scoped to the current document.
current.save.trim is scoped to the current document.
default.save.trim is globally scoped.
install.save.trim is globally scoped.

Syntax
query save.trim
set save.trim [ default | on | off ]
query current.save.trim
query default.save.trim
set default.save.trim [ install | on | off ]
query install.save.trim 
Parameters

default If you specify the default parameter for the set save.trim command, the current view will use the value of default.save.trim to determine if the save command should trim trailing blanks from all the lines in the document.
on If you specify the on parameter for the set save.trim command, the save command will trim trailing blanks from all the lines in the document. If you specify the on parameter for the set default.save.trim command, the save command will trim trailing blanks from all the lines in the document for all of document views that have save.trim set to default.
off If you specify the off parameter for the set save.trim command, the save command will not trim trailing blanks from all the lines in the document. If you specify the off parameter for the set default.save.trim command, the save command will not trim trailing blanks from all the lines in the document for all of document views that have save.trim set to default.
install If you specify the install parameter for the set default.save.trim command, all of the views that have save.trim set to default will use the value of install.save.trim to determine if the save command trim trailing blanks from all the lines in the document or not.

Description

If you do not specify any of the parameters for the set save.trim command, default is assumed. If you do not specify any of the parameters for the set default.save.trim command, install is assumed.

The query current.save.trim command returns on if, for the current view, the save command will trim trailing blanks and off if, for the current view, the save command will not trim trailing blanks.

The save.trim parameter is also used by the saveToWriter action.

Examples
query save.trim
set save.trim off
query current.save.trim
query default.save.trim
set default.save.trim on
query install.save.trim 
save command
query command
set command
current parameter
default parameter
install parameter
save action
saveToWriter action

default	If you specify the default parameter for the set save.trim command, the current view will use the value of default.save.trim to determine if the save command should trim trailing blanks from all the lines in the document.
on	If you specify the on parameter for the set save.trim command, the save command will trim trailing blanks from all the lines in the document. If you specify the on parameter for the set default.save.trim command, the save command will trim trailing blanks from all the lines in the document for all of document views that have save.trim set to default.
off	If you specify the off parameter for the set save.trim command, the save command will not trim trailing blanks from all the lines in the document. If you specify the off parameter for the set default.save.trim command, the save command will not trim trailing blanks from all the lines in the document for all of document views that have save.trim set to default.
install	If you specify the install parameter for the set default.save.trim command, all of the views that have save.trim set to default will use the value of install.save.trim to determine if the save command trim trailing blanks from all the lines in the document or not.