save.lineSeparator Parameter

save.lineSeparator parameter

Use the save.lineSeparator parameter to set or query the line delimiter characters that should be used for save operations, overriding the default line separator for the platform.

Availability

query command
set command
current parameter
default parameter
install parameter

Scope

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

Syntax
query save.lineSeparator
set save.lineSeparator [ default | CRLF | LF | CR ]
query current.save.lineSeparator
query default.save.lineSeparator
set default.save.lineSeparator [ install | CRLF | LF | CR ]
query install.save.lineSeparator 
Parameters

default If you specify the default parameter for the set save.lineSeparator command, the current document will use the value of default.save.lineSeparator for the save operations.
CRLF If you specify the CRLF parameter for the set save.lineSeparator command, the save operations will use "\r\n" (0x0D, 0x0A) as the line delimiter characters within the current document. If you specify the CRLF parameter for the set default.save.lineSeparator command, the save operations will use "\r\n" as the line delimiter characters within all the documents that have the save.lineSeparator parameter set to default.
LF If you specify the LF parameter for the set save.lineSeparator command, the save operations will use "\n" (0x0A) as the line delimiter character within the current document. If you specify the LF parameter for the set default.save.lineSeparator command, the save operations will use "\n" as the line delimiter character within all the documents that have the save.lineSeparator parameter set to default.
CR If you specify the CR parameter for the set save.lineSeparator command, the save operations will use "\r" (0x0D) as the line delimiter character within the current document. If you specify the CR parameter for the set default.save.lineSeparator command, the save operations will use "\r" as the line delimiter character within all the documents that have the save.lineSeparator parameter set to default.
install If you specify the install parameter for the set default.save.lineSeparator command, all documents with save.lineSeparator set to default will use the value of install.save.lineSeparator to determine the line separator that should be used by the save operations.

Description

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

The query current.save.lineSeparator command returns the line separator that will be used, within the current document, by the save operations. A null value indicates that the default line separator for the platform will be used.

The save.lineSeparator parameter facilitates the saving of a file in a certain line-separator standard different from the platform's default line separator. This allows, for example, the editing of UNIX files on Windows. If not given, the default line separator for the platform is used. The base editor does not record the original line separators when a file is loaded.

The save.lineSeparator setting is used by the base editor's save command (unless the lineSeparator command parameter is used), by the saveAsHtml command, and by the save, saveAs, and saveToWriter actions.

Note: The implementation of the save operations in an editor application may differ from the behavior of the base editor as described in here.

Examples
query save.lineSeparator
set save.lineSeparator CR
query current.save.lineSeparator
query default.save.lineSeparator
set default.save.lineSeparator CRLF
query install.save.lineSeparator 
query command
save command
saveAsHtml command
set command
current parameter
default parameter
install parameter
length parameter
useSourceColumns parameter
save action
saveAs action
saveToWriter action

default	If you specify the default parameter for the set save.lineSeparator command, the current document will use the value of default.save.lineSeparator for the save operations.
CRLF	If you specify the CRLF parameter for the set save.lineSeparator command, the save operations will use "\r\n" (0x0D, 0x0A) as the line delimiter characters within the current document. If you specify the CRLF parameter for the set default.save.lineSeparator command, the save operations will use "\r\n" as the line delimiter characters within all the documents that have the save.lineSeparator parameter set to default.
LF	If you specify the LF parameter for the set save.lineSeparator command, the save operations will use "\n" (0x0A) as the line delimiter character within the current document. If you specify the LF parameter for the set default.save.lineSeparator command, the save operations will use "\n" as the line delimiter character within all the documents that have the save.lineSeparator parameter set to default.
CR	If you specify the CR parameter for the set save.lineSeparator command, the save operations will use "\r" (0x0D) as the line delimiter character within the current document. If you specify the CR parameter for the set default.save.lineSeparator command, the save operations will use "\r" as the line delimiter character within all the documents that have the save.lineSeparator parameter set to default.
install	If you specify the install parameter for the set default.save.lineSeparator command, all documents with save.lineSeparator set to default will use the value of install.save.lineSeparator to determine the line separator that should be used by the save operations.