DVT PSS IDE User Guide
Rev. 24.1.9, 26 April 2024

13.8 Preferences Keys

Formatting preferences are serialized as key-value pairs, by default under $DVT_USER_SETTINGS/preferences.ini.

The Settings Management mechanism allows you to reuse such preferences across your group, team, company.

Preference Name Details Preference Key Default Value
Whitespace    
Compact whitespace groupsWhen enabled, consecutive whitespace characters are trimmed to a single space character.ro.amiq.pss/format.whitespace.compactfalse
Compact consecutive empty linesControls whether to compact consecutive empty lines.ro.amiq.pssdt/format.whitespace.compact_consecutive_empty_linesfalse
Maximum number of consecutive empty linesMaximum number of consecutive empty lines that can appear in a file.ro.amiq.pssdt/format.whitespace.maximum_nof_consecutive_empty_lines1
Insert spaces for tabsWhen enabled, indentation will use space characters, otherwise tabs will be used.org.eclipse.ui.editors/spacesForTabsfalse
Tab widthControls the size of a tab in spaces.org.eclipse.ui.editors/tabWidth4
Trim end of line whitespaceWhen enabled, end of line whitespace is deleted.ro.amiq.pss/format.whitespace.trim_end_of_linetrue
Trim whitespace linesWhen enabled, whitespace line are deleted.ro.amiq.pss/format.whitespace.trim_whitespace_linetrue
Indentation    
{Affects the "{" placement: Leave as is (1), On a new line (2), On the same line (3). ro.amiq.pss/format.indent.begin1 ("Leave as is")
Don't indent single line comments at first columnWhen enabled, single line comments that start at column zero are not indented.ro.amiq.pss/format.indent.preserve_sl_comment_column_zerotrue
Ignore lines starting withSpace separated list of line prefixes. A line starting with one of the prefixes is completely ignored, that is it is not indented, nor it contributes to indentation.ro.amiq.pss/format.indent.ignore_lines-
Vertical Alignment    
Enable vertical alignWhen enabled, this option performs vertical alignment.ro.amiq.pss/format.vertical_alignfalse
Only consecutive linesWhen enabled, only consecutive lines (lines that follow each other or are separated by comment lines) are vertically aligned.ro.amiq.pss/format.vertical_align.consecutive_linesfalse
Vertical align single line commentsWhen enabled, single line comments are aligned.ro.amiq.pss/format.vertical_align.sl_commentsfalse
Vertical Alignment TokensThe lines of code inside the same scope are aligned by the specified comma separated list of vertical alignment tokens.ro.amiq.pss/format.vertical_align.tokens=\=,\=\=
Line Wrapping    
Enable line wrappingWhen enabled, this option splits the lines of code that exceed the specified number of characters.ro.amiq.pss/format.line_wrapfalse
Line widthNumber of characters on a line after wrapping the line.ro.amiq.pss/format.line_wrap.threshold80
Wrap multi line commentsControls whether multi-line comments are wrapped.ro.amiq.pss/format.line_wrap.ml_commentsfalse
Wrap single line comments and move above when neededControls whether single line comments are wrapped and moved above the code.ro.amiq.pss/format.line_wrap.sl_commentsfalse
External    
Format code using external programWhen enabled, all other code formatting options are disabled and code formatting is performed using the given command.ro.amiq.pss/format.externalfalse
Format commandThe command used to perform code formatting when `Format code using external program` is enabled.ro.amiq.pss/format.external.commandformat_code %f
Post-format code using external programWhen enabled, the code is post-formatted using the given command.ro.amiq.pss/format.post_externalfalse
Post-format commandThe command used to perform code post-formatting when `Post-format code using external program` is enabled.ro.amiq.pss/format.post_external.commandpost_format_code %f
Pre-format code using external programWhen enabled, the code is pre-formatted using the given command.ro.amiq.pss/format.pre_externalfalse
Pre-format commandThe command used to perform code pre-formatting when `Pre-format code using external program` is enabled.ro.amiq.pss/format.pre_external.commandpre_format_code %f