Difference between revisions of "Settings:Editor:Word wrap / tab settings"

Revision as of 21:55, 11 January 2018

The Editor » Word wrap / tab settings branch of Settings has the following options.

Select extension for settings or default

The editor allows the tab and word wrap settings to be based on file extension. Initially the defaults will be used. To add an extension type click on Change list and a dialog will be displayed allowing you to add or edit up to 10 extension types. You can select or add a file extension(s) (or "Default") to which all settings specified on this page will be applied. As you select file extension(s) from the top dropdown, the tab and word wrap settings will change to reflect the extension(s) selected.

The "Default" settings are used for any files that do not match any user defined extensions. Periods should not be included when specifying extensions for word wrap settings. For example, "c cpp h" is correct, but ".c .cpp .h" is not.

Auto-complete file

If desired, you can set here the path to an auto-complete file specific to the selected file extension(s). You can enter the path directly or browse to the desired file. The auto-complete file should be in plain-text format with a single word on each line, sorted alphabetically.

Use spaces in place of tabs

If this item is selected the editor will insert spaces instead of a tab stop when you press the Tab key.

Tab stop value

This value specifies the (visual) width of a tabstop. For example, if you set this to 4, then when you press Tab in a file, the editor will insert a tabstop that visually occupies 4 columns (even though only a single tabstop was entered).

You can define multiple tabstop values (up to 12) in comma-delimited format, i.e. "4,4,8". The last value defined will be used for subsequent tabs. In the example above, the first two tabs would be equal to four spaces and all subsequent tabs would be equivalent to 8 spaces.

Indent spaces

If use spaces in place of tabs is set, this value determines the number of spaces to use when the Tab key is pressed. This setting is independent of the tab stop value. If you have use spaces in place of tabs set, but open a file containing tabs, the tabs are not converted to spaces and are displayed with the tab stop value.

Default word wrap on for each file

If this is selected, then word wrap will be enabled each time a file with a matching extension is opened. Please note that if additional file extensions are defined for other settings (aside from "Default") this option would have to be selected separately for each group to which it should apply.

Font

You can use this button to set a font for the currently selected extension(s).

Wrap method

Word wrap automatically wraps words to the next line at the vertical edge of the active window or at a specified column. Please note that changing these settings does not actually toggle word wrap; it simply modifies the behavior of word wrap when it is toggled. To turn on word wrap, press Ctrl + W in the edit window, or click the Word wrap button in the Edit tab.

There are four selectable modes of operation for word wrap:

Wrap at window boundary, without inserting a hard return
Wrap at a specified column number without inserting a hard return
Wrap at a specified column number and insert a hard return
With this option, the Automatically insert CR/LF when file is opened option can also be set. This controls whether the file should be automatically wrapped on input. If selected, the file is wrapped on open, otherwise text is only wrapped as it is entered and modified.
Absolute wrap after specified column
This will wrap exactly at the specified column, even breaking apart words if necessary to force the wrap at the specified column number.

The wrap column # value controls the column number for the wrap settings above.

Additionally, the Reformat paragraph feature may be used to wrap a paragraph to the specified column number.

If the active file is in hex mode, word wrap is not available.

Categories

Popular topics