save.trim parameter

The save.trim parameter may be used to query or set if 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 will return 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.

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