Difference between revisions of "Edit page"

From TED Notepad
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
<noinclude>{{manversion|6.0.0.17|dialog|Settings:Edit}}__NOTOC__</noinclude>
+
<noinclude>{{manversion|6.2.1.0|dialog|Settings:Edit}}__NOTOC__</noinclude>
  
 
===={{field|Settings:Edit|Basics}}====
 
===={{field|Settings:Edit|Basics}}====
  
The {{field|Settings:Edit|Tab Size}} specifies the size of each ''tab stop''. These tab stops determine, how much a Tab character shifts following text. Note: Tab characters unlike spaces are variable-length characters. They use pre-calculated tab stops to determine length of each Tab instance.
+
The '''{{field|Settings:Edit|Tab Size}}''' setting specifies the size of each ''tab stop''. These tab stops determine, how much a Tab character shifts following text. Note: Tab characters unlike spaces are variable-length characters. They use pre-calculated tab stops to determine length of each Tab instance.
  
The {{field|Settings:Edit|Left Margin}} specifies the size of the ''left selection margin''. The selection margin is a space between the text of the document and left border of the main window. Here users can drag mouse cursor to select entire lines quickly. Set {{field|Settings:Edit|Left Margin}} to zero to hide the selection margin completely.
+
The '''{{field|Settings:Edit|Left Margin}}''' setting specifies the size of the ''left selection margin''. The selection margin is a space between the text of the document and left border of the main window. Here users can drag mouse cursor to select entire lines quickly. Set {{field|Settings:Edit|Left Margin}} to zero to hide the selection margin completely.
 +
 
 +
The '''{{field|Settings:Edit|Highlight current line}}''' setting visually backlights currently selected line(s). Upon no selection, the current line is backlit. Upon a multiline selection, all lines containing such selection are backlit. See also {{field|Settings:Appearance|Colors: Current line: Back}} in the [[Appearance page]] of the {{dialog|Settings}} dialog.
  
 
===={{field|Settings:Edit|Options}}====
 
===={{field|Settings:Edit|Options}}====
  
The {{field|Settings:Edit|Disable smart Home key}} disables smart behavior of the {{hotkey|Home}} key. Smart behavior includes jumping between line's indentation and its beginning, or wrapped line beginning and unwrapped line beginning. See chapter [[Hotkeys]] for more details.
+
The '''{{field|Settings:Edit|Disable smart Home key}}''' setting disables smart behavior of the {{hotkey|Home}} key. Smart behavior includes jumping between line's indentation and its beginning, or wrapped line beginning and unwrapped line beginning. See chapter [[Hotkeys]] for more details.
  
The {{field|Settings:Edit|Disable Overwrite mode}} disables the
+
The '''{{field|Settings:Edit|Disable Overwrite mode}}''' setting disables the
{{feature|Overwrite mode}} altogether and prevents invoking it accidentaly.
+
{{feature|Overwrite Mode}} altogether and prevents invoking it accidentaly.
  
The {{field|Settings:Edit|Bold Caret in Overwrite mode}} visualy enlarges the caret while in {{feature|Overwrite mode}}. If disabled, {{feature|Overwrite mode}} can be still be determined from indicator in the {{feature|Status Bar}}.
+
The '''{{field|Settings:Edit|Bold Caret in Overwrite mode}}''' setting visualy enlarges the caret while in {{feature|Overwrite Mode}}. If disabled, {{feature|Overwrite Mode}} can be still be determined from indicator in the {{feature|Status Bar}}.
  
The {{field|Settings:Edit|Suppress multi-level Undo/Redo}} disables multi-level {{feature|Undo}}/{{feature|Redo}} altogether and imitates the old Windows Notepad's Undo command. Note: Windows Notepad's single-level Undo is always available thru {{feature|Simple Undo}} hotkey {{hotkey|Alt+BkSpace}}, even if multi-level {{feature|Undo}}/{{feature|Redo}} is enabled. Therefore, it may be more convenient to keep the multi-level
+
The '''{{field|Settings:Edit|Suppress multi-level Undo/Redo}}''' setting disables multi-level {{feature|Undo}}/{{feature|Redo}} altogether and imitates the old Windows Notepad's Undo command. Note: Windows Notepad's single-level Undo is always available thru {{feature|Simple Undo}} hotkey {{hotkey|Alt+BkSpace}}, even if multi-level {{feature|Undo}}/{{feature|Redo}} is enabled. Therefore, it may be more convenient to keep the multi-level
 
{{feature|Undo}}/{{feature|Redo}} enabled and use {{feature|Simple Undo}} hotkey {{hotkey|Alt+BkSpace}} to get the old Windows Notepad's behaviour.
 
{{feature|Undo}}/{{feature|Redo}} enabled and use {{feature|Simple Undo}} hotkey {{hotkey|Alt+BkSpace}} to get the old Windows Notepad's behaviour.
  
The {{field|Settings:Edit|Reduce Undo/Redo upon Save}} tells to reduce the multi-level {{feature|Undo}}/{{feature|Redo}} queues to a single
+
The '''{{field|Settings:Edit|Reduce Undo/Redo upon Save}}''' setting tells to reduce the multi-level {{feature|Undo}}/{{feature|Redo}} queues to a single
 
{{feature|Undo}} step. The {{feature|Redo}} queue is emptied completely, the {{feature|Undo}} queue is allowed to retain one step (the last one).
 
{{feature|Undo}} step. The {{feature|Redo}} queue is emptied completely, the {{feature|Undo}} queue is allowed to retain one step (the last one).
  
 
Note: By default, all {{feature|Undo}} steps are kept for the duration of a document, i.e. until another document is loaded or the current document is at least re-loaded. This might have severe influence on available memory after too many modifications to the document (e.g. if one keeps some document opened for days and makes lots of modifications daily, the {{feature|Undo}} queue can become quite big and superfluous, assuming no-one wants to {{feature|Undo}} entire days of work anyway).
 
Note: By default, all {{feature|Undo}} steps are kept for the duration of a document, i.e. until another document is loaded or the current document is at least re-loaded. This might have severe influence on available memory after too many modifications to the document (e.g. if one keeps some document opened for days and makes lots of modifications daily, the {{feature|Undo}} queue can become quite big and superfluous, assuming no-one wants to {{feature|Undo}} entire days of work anyway).
  
Note: {{feature|Revert}} is a handy command to get rid of {{feature|Undo}} queue besides {{field|Settings:Edit|Reduce Undo/Redo upon Save}} setting.
+
Note: {{feature|Revert}} is a handy command to get rid of the {{feature|Undo}} queue besides the {{field|Settings:Edit|Reduce Undo/Redo upon Save}} setting.
  
The {{field|Settings:Edit|Allow inserting control characters}} allows users to insert special control characters (several ASCII characters below 32) into the document. Inserting these characters is by default forbidden in order to prevent inexperienced users to add these characters thru unassigned hotkeys.
+
The '''{{field|Settings:Edit|Allow inserting control characters}}''' setting allows users to insert special control characters (several ASCII characters below 32) into the document. Inserting these characters is by default forbidden in order to prevent inexperienced users to add these characters thru unassigned hotkeys.
  
 
===={{field|Settings:Edit|Mouse multi-clicks gradually select}}:====
 
===={{field|Settings:Edit|Mouse multi-clicks gradually select}}:====
  
The {{field|Settings:Edit|Mouse multi-clicks gradually select}} set of options allow to specify, which text entities are to be selectable as whole pieces by mouse multi-clicks. Note: A multi-click is a double-click, triple-click or quadruple-click.
+
The '''{{field|Settings:Edit|Mouse multi-clicks gradually select}}''' setting set of options allow to specify, which text entities are to be selectable as whole pieces by mouse multi-clicks. Note: A multi-click is a double-click, triple-click, quadruple-click, etc.
  
Each further click advances to the next type of text entity (naturally, only those checked in this list count) in the following list. After multi-clicking, hold down the mouse button and drag thru text to select it by whole text pieces according to currently chosen text entity.
+
Each further click advances to the next type of text entity in the following list (naturally, only those actually checked in this list count). After multi-clicking, hold down the mouse button and drag thru text to select by whole text pieces according to currently chosen text entity. See chapter [[Using mouse]] for further details about how mouse can be used within TED Notepad.
  
* The {{field|Settings:Edit|Mouse multi-clicks gradually select: Word}} enables multi-click selecting by entire {{defined|words}}.
+
* The '''{{field|Settings:Edit|Mouse multi-clicks gradually select: Word}}''' setting enables multi-click selecting by entire {{defined|words}}.
  
* The {{field|Settings:Edit|Mouse multi-clicks gradually select: Wrapped line part}} enables multi-click selecting by visual lines. Unlike entire unwrapped {{defined|lines}}, visual lines are what the user can visually determine as lines of text after applying {{feature|word wrapping}}.
+
* The '''{{field|Settings:Edit|Mouse multi-clicks gradually select: Wrapped line part}}''' setting enables multi-click selecting by visual lines. Unlike whole unwrapped {{defined|lines}}, visual lines are what the user can visually determine as lines of text at given time while {{feature|word wrapping}} is turned on.
  
* The {{field|Settings:Edit|Mouse multi-clicks gradually select: Whole line}} enables multi-click selecting by entire unwrapped {{defined|lines}}.
+
* The '''{{field|Settings:Edit|Mouse multi-clicks gradually select: Whole line}}''' setting enables multi-click selecting by entire unwrapped {{defined|lines}}.
  
* The {{field|Settings:Edit|Mouse multi-clicks gradually select: Paragraph}} enables multi-click selecting by entire {{defined|paragraphs}}.
+
* The '''{{field|Settings:Edit|Mouse multi-clicks gradually select: Paragraph}}''' setting enables multi-click selecting by entire {{defined|paragraphs}}.
  
* The {{field|Settings:Edit|Mouse multi-clicks gradually select: Entire document}} enables multi-click selecting the entire document.
+
* The '''{{field|Settings:Edit|Mouse multi-clicks gradually select: Entire document}}''' setting enables multi-click selecting the entire document.
  
Example: Selecting thru double-click selects by entire words, if
+
Example: Selecting thru double-click selects by entire words, if {{field|Settings:Edit|Mouse multi-clicks gradually select: Word}} is checked; triple-click selects by entire lines if {{field|Settings:Edit|Mouse multi-clicks gradually select: Wrapped line part}} is not checked and {{field|Settings:Edit|Mouse multi-clicks gradually select: Whole line}} is checked; and quadruple-click selects entire paragraphs if {{field|Settings:Edit|Mouse multi-clicks gradually select: Paragraph}} is checked. If {{field|Settings:Edit|Mouse multi-clicks gradually select: Wrapped line part}} is enabled triple-click selects wrapped line parts and entire lines can be selected by quadruple-click.
{{field|Settings:Edit|Mouse multi-clicks gradually select: Word}} is checked; triple-click selects by entire lines if {{field|Settings:Edit|Mouse multi-clicks gradually select: Wrapped line part}} is not checked and {{field|Settings:Edit|Mouse multi-clicks gradually select: Whole line}} is checked; and quadruple-click selects entire paragraphs if
 
{{field|Settings:Edit|Mouse multi-clicks gradually select: Paragraph}} is checked. If {{field|Settings:Edit|Mouse multi-clicks gradually select: Wrapped line part}} is enabled triple-click selects wrapped line parts and entire lines can be selected by quadruple-click; etc.
 
  
 
===={{field|Settings:Edit|Complete Word}}====
 
===={{field|Settings:Edit|Complete Word}}====
  
The {{field|Settings:Edit|Complete Word: Ignore case}} tells to
+
The '''{{field|Settings:Edit|Complete Word: Ignore case}}''' setting tells to {{defined|ignore case}} upon populating the {{dialog|Complete Word}} dialog in {{feature|Complete Word}}. See {{feature|Complete Word}} for further details.
{{defined|ignore case}} upon populating the {{dialog|Complete Word}} dialog in {{feature|Complete Word}}. See {{feature|Complete Word}} for further details.
 
  
The {{field|Settings:Edit|Complete Word: Longest auto-completion}} enables the longest auto-completion in {{feature|Complete Word}}. See {{feature|Complete Word}} for further details.
+
The '''{{field|Settings:Edit|Complete Word: Longest auto-completion}}''' setting enables the longest auto-completion in {{feature|Complete Word}}. See {{feature|Complete Word}} for further details.
  
The {{field|Settings:Edit|Complete Word: Sort suggestions}} sorts suggestions in the {{dialog|Complete Word}} dialog in {{feature|Complete Word}}. See {{feature|Complete Word}} for further details.
+
The '''{{field|Settings:Edit|Complete Word: Sort suggestions}}''' setting sorts suggestions in the {{dialog|Complete Word}} dialog in {{feature|Complete Word}}. See {{feature|Complete Word}} for further details.
  
 
===={{field|Settings:Edit|Indentation}}====
 
===={{field|Settings:Edit|Indentation}}====
  
The {{field|Settings:Edit|Auto-indent text}} specifies, whether auto-indent mode is to be used. If turned on, each time a new line is started (using {{hotkey|Enter}} key), {{feature|Smart Return}} (hotkey {{hotkey|Ctrl+Enter}}) is used instead. Note: {{feature|Smart Return}} starts a new line as usual, but also copies indentation from the previous line to the new line. See {{feature|Smart Return}} for further details.
+
The '''{{field|Settings:Edit|Auto-indent text}}''' setting specifies, whether auto-indent mode is to be used. If turned on, each time a new line is started (using {{hotkey|Enter}} key), {{feature|Smart Return}} (hotkey {{hotkey|Ctrl+Enter}}) is used instead. Note: {{feature|Smart Return}} starts a new line as usual, but also copies indentation from the previous line to the new line. See {{feature|Smart Return}} for further details.
  
The {{field|Settings:Edit|Tab key indents multiple lines}} allows the user to use {{hotkey|Tab}} key to {{feature|Indent}} multiple lines instead of replacing them by a Tab character. If turned off, {{hotkey|Tab}} key simply inserts one Tab character (or Spaces, if {{field|Settings:Edit|Insert Spaces instead of Tab}} is turned on), replacing anything selected. This is the same as if any other character was inserted, e.g. a letter. On the other hand, if turned on, instead of replacing, {{feature|Indent}} is invoked if multiple lines are selected and {{hotkey|Tab}} key is hit. Note: If single line or line part is selected (i.e. the selection does not contain any
+
The '''{{field|Settings:Edit|Tab key indents multiple lines}}''' setting allows the user to use {{hotkey|Tab}} key to {{feature|Indent}} multiple lines instead of replacing them by a Tab character. If turned off, {{hotkey|Tab}} key simply inserts one Tab character (or Spaces, if {{field|Settings:Edit|Insert Spaces instead of Tab}} is turned on), replacing anything selected. This is the same as if any other character was inserted, e.g. a letter. On the other hand, if turned on, instead of replacing, {{feature|Indent}} is invoked if multiple lines are selected and {{hotkey|Tab}} key is hit. Note: If single line or line part is selected (i.e. the selection does not contain any
 
{{defined|newline}}), it gets replaced even if {{field|Settings:Edit|Tab key indents multiple lines}} is turned on.
 
{{defined|newline}}), it gets replaced even if {{field|Settings:Edit|Tab key indents multiple lines}} is turned on.
  
The {{field|Settings:Edit|Insert Spaces instead of Tab}} specifies whether to use Tab character when {{hotkey|Tab}} key is pressed, or rather to use Spaces instead. Note: The number of Spaces inserted depends on the position on line and on the {{field|Settings:Edit|Tab Size}} setting.
+
The '''{{field|Settings:Edit|Insert Spaces instead of Tab}}''' setting specifies whether to use Tab character when {{hotkey|Tab}} key is pressed, or rather to use Spaces instead. Note: The number of Spaces inserted depends on the position on line and on the {{field|Settings:Edit|Tab Size}} setting.
  
 
Note: While using fixed-width font, the resulting visual blank space of inserted Spaces should be the same, as if a Tab character was inserted. This, however, does not always work with proportional fonts. In proportional fonts, size of a Space character often differ from font's base character width, from which tab stops are calculated. Therefore, there might be difference between real Tab size and accumulated size of Spaces inserted instead of a Tab. This option is however primarily meant for fixed-width fonts, and thus any potential difference while using proportional font is not considered wrong.
 
Note: While using fixed-width font, the resulting visual blank space of inserted Spaces should be the same, as if a Tab character was inserted. This, however, does not always work with proportional fonts. In proportional fonts, size of a Space character often differ from font's base character width, from which tab stops are calculated. Therefore, there might be difference between real Tab size and accumulated size of Spaces inserted instead of a Tab. This option is however primarily meant for fixed-width fonts, and thus any potential difference while using proportional font is not considered wrong.
Line 70: Line 69:
 
===={{field|Settings:Edit|Keep caret from borders}}====
 
===={{field|Settings:Edit|Keep caret from borders}}====
  
The {{field|Settings:Edit|Keep caret from borders: Top/bottom}} ensures there is always some space between the caret and window borders. Scrolling is used early to keep this visual space, allowing the user to always see what is below or above the caret.
+
The '''{{field|Settings:Edit|Keep caret from borders: Top/bottom}}''' setting ensures there is always some space between the caret and window borders. Scrolling is used early to keep this visual space, allowing the user to always see what is below or above the caret.
  
The {{field|Settings:Edit|Keep caret from borders: Left/right}} ensures there is always some space between the caret and window borders. Scrolling is used early to keep this visual space, allowing the user to always see what is before or after the caret.
+
The '''{{field|Settings:Edit|Keep caret from borders: Left/right}}''' setting ensures there is always some space between the caret and window borders. Scrolling is used early to keep this visual space, allowing the user to always see what is before or after the caret.

Latest revision as of 23:53, 4 October 2021

This section is up to date for TED Notepad version 6.3.1.0.
Control page Control:dialog:Settings:Edit

Basics

The Tab Size setting specifies the size of each tab stop. These tab stops determine, how much a Tab character shifts following text. Note: Tab characters unlike spaces are variable-length characters. They use pre-calculated tab stops to determine length of each Tab instance.

The Left Margin setting specifies the size of the left selection margin. The selection margin is a space between the text of the document and left border of the main window. Here users can drag mouse cursor to select entire lines quickly. Set Left Margin to zero to hide the selection margin completely.

The Highlight current line setting visually backlights currently selected line(s). Upon no selection, the current line is backlit. Upon a multiline selection, all lines containing such selection are backlit. See also Colors: Current line: Back in the Appearance page of the Settings dialog.

Options

The Disable smart Home key setting disables smart behavior of the Home key. Smart behavior includes jumping between line's indentation and its beginning, or wrapped line beginning and unwrapped line beginning. See chapter Hotkeys for more details.

The Disable Overwrite mode setting disables the Overwrite Mode altogether and prevents invoking it accidentaly.

The Bold Caret in Overwrite mode setting visualy enlarges the caret while in Overwrite Mode. If disabled, Overwrite Mode can be still be determined from indicator in the Status Bar.

The Suppress multi-level Undo/Redo setting disables multi-level Undo/Redo altogether and imitates the old Windows Notepad's Undo command. Note: Windows Notepad's single-level Undo is always available thru Simple Undo hotkey Alt+BkSpace, even if multi-level Undo/Redo is enabled. Therefore, it may be more convenient to keep the multi-level Undo/Redo enabled and use Simple Undo hotkey Alt+BkSpace to get the old Windows Notepad's behaviour.

The Reduce Undo/Redo upon Save setting tells to reduce the multi-level Undo/Redo queues to a single Undo step. The Redo queue is emptied completely, the Undo queue is allowed to retain one step (the last one).

Note: By default, all Undo steps are kept for the duration of a document, i.e. until another document is loaded or the current document is at least re-loaded. This might have severe influence on available memory after too many modifications to the document (e.g. if one keeps some document opened for days and makes lots of modifications daily, the Undo queue can become quite big and superfluous, assuming no-one wants to Undo entire days of work anyway).

Note: Revert is a handy command to get rid of the Undo queue besides the Reduce Undo/Redo upon Save setting.

The Allow inserting control characters setting allows users to insert special control characters (several ASCII characters below 32) into the document. Inserting these characters is by default forbidden in order to prevent inexperienced users to add these characters thru unassigned hotkeys.

Mouse multi-clicks gradually select:

The Mouse multi-clicks gradually select setting set of options allow to specify, which text entities are to be selectable as whole pieces by mouse multi-clicks. Note: A multi-click is a double-click, triple-click, quadruple-click, etc.

Each further click advances to the next type of text entity in the following list (naturally, only those actually checked in this list count). After multi-clicking, hold down the mouse button and drag thru text to select by whole text pieces according to currently chosen text entity. See chapter Using mouse for further details about how mouse can be used within TED Notepad.

Example: Selecting thru double-click selects by entire words, if Mouse multi-clicks gradually select: Word is checked; triple-click selects by entire lines if Mouse multi-clicks gradually select: Wrapped line part is not checked and Mouse multi-clicks gradually select: Whole line is checked; and quadruple-click selects entire paragraphs if Mouse multi-clicks gradually select: Paragraph is checked. If Mouse multi-clicks gradually select: Wrapped line part is enabled triple-click selects wrapped line parts and entire lines can be selected by quadruple-click.

Complete Word

The Complete Word: Ignore case setting tells to ignore case upon populating the Complete Word dialog in Complete Word. See Complete Word for further details.

The Complete Word: Longest auto-completion setting enables the longest auto-completion in Complete Word. See Complete Word for further details.

The Complete Word: Sort suggestions setting sorts suggestions in the Complete Word dialog in Complete Word. See Complete Word for further details.

Indentation

The Auto-indent text setting specifies, whether auto-indent mode is to be used. If turned on, each time a new line is started (using Enter key), Smart Return (hotkey Ctrl+Enter) is used instead. Note: Smart Return starts a new line as usual, but also copies indentation from the previous line to the new line. See Smart Return for further details.

The Tab key indents multiple lines setting allows the user to use Tab key to Indent multiple lines instead of replacing them by a Tab character. If turned off, Tab key simply inserts one Tab character (or Spaces, if Insert Spaces instead of Tab is turned on), replacing anything selected. This is the same as if any other character was inserted, e.g. a letter. On the other hand, if turned on, instead of replacing, Indent is invoked if multiple lines are selected and Tab key is hit. Note: If single line or line part is selected (i.e. the selection does not contain any newline), it gets replaced even if Tab key indents multiple lines is turned on.

The Insert Spaces instead of Tab setting specifies whether to use Tab character when Tab key is pressed, or rather to use Spaces instead. Note: The number of Spaces inserted depends on the position on line and on the Tab Size setting.

Note: While using fixed-width font, the resulting visual blank space of inserted Spaces should be the same, as if a Tab character was inserted. This, however, does not always work with proportional fonts. In proportional fonts, size of a Space character often differ from font's base character width, from which tab stops are calculated. Therefore, there might be difference between real Tab size and accumulated size of Spaces inserted instead of a Tab. This option is however primarily meant for fixed-width fonts, and thus any potential difference while using proportional font is not considered wrong.

Keep caret from borders

The Keep caret from borders: Top/bottom setting ensures there is always some space between the caret and window borders. Scrolling is used early to keep this visual space, allowing the user to always see what is below or above the caret.

The Keep caret from borders: Left/right setting ensures there is always some space between the caret and window borders. Scrolling is used early to keep this visual space, allowing the user to always see what is before or after the caret.