TED Notepad - User contributions [en]

Options menu

2011-06-30T14:32:35Z

Kew:

<noinclude>{{manversion|6.0.0.17|menu}}__NOTOC__</noinclude>

{{:Status Bar}}

{{:Line Numbers}}
{{:Visible Newlines}}
{{:Line Lengths}}

{{:Zoom In}}
{{:Zoom Reset}}
{{:Zoom Out}}

{{:Word Wrap}}
{{:Wrap Margin}}

{{:Fullscreen}}
{{:Stay on Top}}

{{:Second Font}}

{{:Settings}}

Zoom Reset

2011-06-30T14:26:28Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Options menu|Zoom Reset (Alt+Num0)}}

Resets the size of font to size set in the {{feature|Settings}} dialog. See chapter [[Appearance page]] of the {{dialog|Settings}} dialog.

See also {{feature|Zoom In}} and {{feature|Zoom Out}}.

Zoom In

2011-06-30T14:26:26Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Options menu|Zoom In (Alt+Num+)}}

Increases the size of font.

See also {{feature|Zoom Out}} and {{feature|Zoom Reset}}.

Zoom Out

2011-06-30T14:26:26Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Options menu|Zoom Out (Alt+Num-)}}

Decreases the size of font.

See also {{feature|Zoom In}} and {{feature|Zoom Reset}}.

Wrap Margin

2011-06-30T14:26:24Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Options menu|Wrap Margin}}

Shows or hides the {{feature|Wrap Margin}}, which is a thin vertical line, indicating soft {{feature|word wrapping}} width. If both {{feature|Word Wrap}} and {{feature|Wrap Margin}} are turned on, all lines in the document are wrapped to fit within this margin. If {{feature|Wrap Margin}} is turned off while {{feature|Word Wrap}} is turned on, lines in the document are wrapped to fit within window width.

Note: {{feature|Wrap Margin}} can stay turned on even while {{feature|Word Wrap}} is turned off. In such case, the {{feature|Wrap Margin}} does not wrap lines on its own, but rather gives a visual guideline for line lengths and manual line wrapping.

Position of the {{feature|Wrap Margin}} can be easily adjusted by clicking on the margin line and dragging it.

Note: The visual position of the {{feature|Wrap Margin}} changes (along with text of the document) upon horizontal scrolling, therefore, it always denotes the same absolute horizontal position within the text.

See also {{feature|Word Wrap}}.

Word Wrap

2011-06-30T14:26:23Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude><noinclude>{{manversion|6.0.0.16|feature|word wrapping}}__NOTOC__</noinclude>
{{#headline:Options menu|Word Wrap (Ctrl+W)}}

If turned on, every line of the document is wrapped to fit either the visual width of the editor window, or the {{feature|Wrap Margin}}, if {{feature|Wrap Margin}} is enabled as well. Wrapping lines of text enables user to see all text on any line, but it does not affect the way such text appears when it is printed or saved to a file.

Note: If a single word is too long to fit within {{feature|Wrap Margin}}, it is not broken just yet, but is allowed to continue even beyond the {{feature|Wrap Margin}}. However, if the word is also too long to fit within the width of the editor window, then it is broken into several lines as necessary. In other words, {{feature|Wrap Margin}} is a somewhat soft wrapping guide, whereas editor window width is a hard wrapping point.

Note: Numbers in the {{feature|Line Numbers}} gutter and within the {{feature|Status Bar}} are always irrespective of actual {{feature|word wrapping}}.

Note: If window width or {{feature|Wrap Margin}} changes, actual {{feature|word wrapping}} adjusts itself automatically.

{{mycomment|No ale to dnes asi uz nikoho neprekvapi, ze ano... :) Teraz ma napada, mozno by prekvapilo, keby to tak nefungovalo. Clovek by musel mackat nejaky cudlik, aby sa mu opravilo aktualne zalomenie.. :D}}

See also {{feature|Wrap Margin}}.

Visible Newlines

2011-06-30T14:26:22Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Options menu|Visible Newlines}}

If checked, each line in the document window, which is terminated by an actual {{defined|newline}}, is visually capped with a special newline symbol.

Note: The text of the document is not modified by this feature in any way.

See also {{feature|Line Lengths}}.

Status Bar

2011-06-30T14:26:21Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude><noinclude>{{manversion|6.0.0.16|feature|unsaved modifications}}__NOTOC__</noinclude>
{{#headline:Options menu|Status Bar}}

Shows or hides the {{feature|Status Bar}}, which resides at the bottom of the main window.

The {{feature|Status Bar}} indicates:
# Current {{defined|line}} number with the caret, and total lines count (see also {{feature|Line Numbers}});
# caret position on the current {{defined|line}}, and the current {{defined|line}} length (see also {{feature|Line Lengths}});
# and offset of the caret within the entire document, and total document length.
# Decimal and hexadecimal code of character at caret position — directly after the caret. {{todo|what does it mean?}}
# Type of {{feature|Encoding}}, which the document is to be saved in (e.g. {{system|ANSI}}, {{system|UTF-8}} or {{system|Unicode}});
# and whether {{feature|BOM}} (i.e. Byte-Order-Mark) shall be used (only in encodings, which allow BOM, e.g. {{system|UTF-8}} or {{system|Unicode}}).
# Type of {{feature|Newlines}} to be used upon saving (i.e. {{system|Win}}, {{system|Unix}}, {{system|Mac}} or {{system|Mixed}}).
# Whether any {{feature|unsaved modifications}} to the document have been made since the last {{feature|Save}} operation.
# Current state of typing mode, i.e. {{feature|Insert mode}} or {{feature|Overwrite mode}};
# and current state of the {{feature|Word Wrap}} option.

The {{feature|Status Bar}} responds to mouse clicks:
* invoking {{feature|Go to}} dialog on panels with actual position info;
* toggling {{feature|Encoding}} and {{feature|Newlines}} on panels with file info;
* saving the document on panel with {{feature|unsaved modifications}} indicator;
* toggling {{feature|Insert mode}} and {{feature|Overwrite mode}};
* or toggling {{feature|Word Wrap}} option on and off.

Note: The last {{feature|Status Bar}} panel might contain active operation progress information and other such notifications from time to time.

Note: Displayed {{feature|Line Numbers}} are irrespective of actual {{feature|word wrapping}}, therefore, the same line number may span across more than one visual line, as long as such line is only temporarily wrapped by the {{feature|Word Wrap}} option.

Stay on Top

2011-06-30T14:26:19Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Options menu|Stay on Top (Alt+O+T)}}

If checked, TED Notepad stays in front of other common applications even if not active.

Note: If more than one application is in a ''stay-on-top'' mode, their order on the screen depends on the System. There is no way to ensure, that any particular one will be the topmost one of them.

Note: The reason the hotkey is a combination of menu mnemonics, instead of using a more usual hotkey combination, is to avoid accidental unwanted activation of ''stay-on-top'' mode by new less experienced users.

See also {{feature|Fullscreen}}.

Settings

2011-06-30T14:26:13Z

Kew:

<noinclude>{{manversion|6.0.0.17|dialog}}__NOTOC__</noinclude>
{{#headline:Options menu|Settings.. (Alt+Enter)}}

Shows the {{dialog|Settings}} dialog which is described in chapter [[Settings dialog]].

Second Font

2011-06-30T14:26:12Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude><noinclude>{{manversion|6.0.0.16|feature|Primary Font}}__NOTOC__</noinclude>
{{#headline:Options menu|Second Font (F8)}}

If checked, {{feature|Second Font}} is used to display edited text. Otherwise, {{feature|Primary Font}} is used.

Both these fonts, including their color, can be changed in the {{feature|Settings}} dialog. See chapter [[Appearance page]] of the {{dialog|Settings}} dialog.

Note: By default, {{feature|Primary Font}} is preset to a {{system|fixed-width}} font, also caled {{system|monospace}} font, while {{feature|Second Font}} is preset to a {{system|proportional}} font. This convention, however, is not exacted. The user is free to setup any pair of fonts.

Line Numbers

2011-06-30T14:26:08Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Options menu|Line Numbers}}

If checked, gutter with line numbers is displayed next to the lines.

Note: Each line is numbered regardless of current {{feature|word wrapping}}. If a line is wrapped, it keeps the original line number nonetheless. Therefore some visual lines may lack numbers in the gutter, which is an indicator of that line being a continuation of the previous visual line.

Note: The same line numbers are displayed in the {{feature|Status Bar}}.

Note: Color of the gutter and numbers can be customized in the {{feature|Settings}} dialog. See chapter [[Appearance page]] of the {{dialog|Settings}} dialog.

See also {{feature|Status Bar}}.

Line Lengths

2011-06-30T14:26:06Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Options menu|Line Lengths}}

If checked, each visible line in the document window, is capped with a length of that line. The lengths are represented in characters, and depend on current {{feature|word wrapping}}. This is different from what {{feature|Status Bar}} displays as line length, since {{feature|Status Bar}} calculates line lengths regardless of current {{feature|word wrapping}}. The foundation of {{feature|Line Lengths}} is to provide an immediate visual clue of length for any given visual line as currently displayed, while {{feature|Status Bar}} is to provide information about the document itself, ignoring any temporary wrapping.

Note: The text of the document is not modified by this feature in any way.

See also {{feature|Visible Newlines}}.

Fullscreen

2011-06-30T14:26:05Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Options menu|Fullscreen (F11)}}

If checked, TED Notepad enters the {{feature|Fullscreen}} mode. In this mode, the application window is expanded to entire user screen.

Note: This mode is somewhat ''stay-on-top'' as well, as long as the application window is active. This is a desired system default behaviour.

See also {{feature|Stay on Top}}.

Favourites

2011-06-30T13:26:40Z

Kew:

<noinclude>{{manversion|6.0.0.17|menu}}__NOTOC__</noinclude><noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>

This menu is designed to remember chosen documents, so they could be easily accessed at any time.

To open a favourited file, click on its file name in this menu. TED Notepad may ask, whether to save any current document before opening a new one.

{{todo|relative paths in the favourites..}}

Note: If this feature is never used, it does not cost any extra resources.

{{mycomment|Fakt... ziadne alokacie, ziadna extra pamat... :))}}

{{:Add Favourite File}}
{{:Manage Favourites List}}

Manage Favourites List

2011-06-30T13:26:34Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Favourites|Manage List..}}

Opens the {{feature|Settings}} dialog, where {{feature|Favourites}} can be added, modified, deleted and re-ordered. See chapters [[Favourites page]] of the {{dialog|Settings}} dialog.

See also {{feature|Add Favourite File}}.

Add Favourite File

2011-06-30T13:26:33Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Favourites|Add this File}}

Adds currently opened file name and its path to the {{menu|Favourites}} menu.

See also {{feature|Manage Favourites List}}.

Copy to Clip

2011-06-30T13:12:44Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Clips menu|Copy to [1..9] (Alt+[1..9])}}

Copies the selection into the chosen extra clipboard.

See also {{feature|Paste from Clip}} and {{feature|View All Clips}}.

Paste from Clip

2011-06-30T13:12:40Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Clips menu|Paste from [1..9] (Ctrl+[1..9])}}

Pastes content of the chosen extra clipboard to the actual {{defined|insertion point}} or replaces the selection, if any.

See also {{feature|Copy to Clip}} and {{feature|View All Clips}}.

Clips menu

2011-06-30T12:19:00Z

Kew:

<noinclude>{{manversion|6.0.0.17|menu}}__NOTOC__</noinclude>

This menu gives access to 9 permanent extra {{feature|Clips}} for extended clipboarding and copy/pasting.

{{:Clips}}

{{:View All Clips}}
{{:Clear All Clips}}

{{:Copy to Clip}}
{{:Paste from Clip}}

View All Clips

2011-06-30T12:16:07Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Clips menu|View All.. (Ctrl+0)}}

Shows the {{dialog|Clipboards}} dialog, where content of {{feature|Clips}} is displayed. Use {{button|Clipboards|Paste from}} buttons in this dialog to paste content of any chosen extra clipboard into the document.

See also {{feature|Copy to Clip}} and {{feature|Paste from Clip}}.

See also {{feature|Clear All Clips}}.

Paste from Clip

2011-06-30T12:16:06Z

Kew:

Copy to Clip

2011-06-30T12:16:05Z

Kew:

Clear All Clips

2011-06-30T12:16:03Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Clips menu|Clear All}}

Erases content of all {{feature|Clips}}.

See also {{feature|View All Clips}}.

Clips

2011-06-30T12:14:19Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
The 9 extra {{feature|Clips}} can be used only within TED Notepad, but they work quite the same way as Windows clipboard does. However, content of {{feature|Clips}} is being saved between sessions, therefore it persists computer restarts.

Press {{hotkey|Alt}} key with a digit {{hotkey|1}}..{{hotkey|9}} to copy the selection into one of the {{feature|Clips}}.

Press {{hotkey|Ctrl}} key with the same digit to paste the content from the {{feature|Clips}} to the document.

{{tip}} {{feature|Clips}} can be easily pre-configured to frequent phrases and then used later to quikly paste rife snippets.

Note: Content of {{feature|Clips}} is loaded when TED Notepad starts, and is saved along with other settings when TED Notepad quits. Therefore, {{feature|Clips}} are not shared between different running instances of TED Notepad. With two or more instances running concurrently, each opperate on a different set of {{feature|Clips}}. After all instances have closed, contents of {{feature|Clips}} from all instances are merged together (resolving any merging collisions in the same order in which instances have closed).

Note: If saving of {{feature|Clips}} is turned off in {{feature|Settings}} dialog; or the {{feature|/ns}} command line parameter is used; or the {{feature|Exit without saving!}} is used; {{feature|Clips}} are not saved, and will not persist the session. See chapter [[Settings page]] of the {{dialog|Settings}} dialog, chapter [[Command line parameters]] and chapter [[File menu]] for details on how to prevent various settings from being saved.

Tools reference

2011-06-29T09:20:21Z

Kew:

<noinclude>{{manversion|6.0.0.17|menu|Tools}}__NOTOC__</noinclude>

This chapter describes all tools within the {{menu|Tools}} menu.

=====Table of Contents:=====

*[[Case tools]]
*[[Lines tools]]
*[[Text tools]]
*[[Reverse tools]]
*[[Sort tools]]
*[[Wrap tools]]
*[[Text Filters]]

Text Filters

2011-06-29T09:19:45Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>

<q>How about a plugin architecture? Something simple - just a list of menu names and programs to run and maybe an indication of whether it should prompt for additional parameters. TED will run the program with those parameters and with current selection and then accept the output back into the TED workspace.</q>         (--- anonymous user ---)

====Managing filters====

Filters can be added thru the {{dialog|Settings}} dialog. See chapter [[Filters page]] of the {{dialog|Settings}} dialog for details on adding, modifying and managing filters.

====Filter commands====

Each {{feature|Text Filters|filter}} must be defined as a runnable command, consisting of an application file to execute and its parameters. System commands can be executed as well, but only through a {{system|command interpreter}}, i.e. {{system|cmd.exe}}, {{system|command.com}} or {{system|launch.exe}}, as described below.

Each {{feature|Text Filters|filter}} can be supplemented with upto 9 user ''variables'' within its command, using batch variable syntax, i.e. {{syntax|Text Filters|%1}}, {{syntax|Text Filters|%2}}, ..., {{syntax|Text Filters|%9}}. Upon invoking such {{feature|Text Filters|filter}}, {{dialog|Filter}} dialog appears, asking for values for required variables.

Besides user variables, internal variables are available:
* {{syntax|Text Filters|%F}} variable can be used to insert path and file name of the current document.
* {{syntax|Text Filters|%S}} variable can be used to insert current selection into the command.
* {{todo|more internal variables?}}

All command variables can be auto-enclosed with "double-quotes" by adding an ''escaping flag'' to them. Escaping flag is one of following:
* Tilde (~) — Encloses the variable with double-quotes, and doubles all double-quotes in the variable. This is more common for native Windows commandline applications. E.g. Variable {{string|%~1}} expands to {{string|"Use ""double-quotes"" in parameters"}}, if {{syntax|Text Filters|%1}} contains phrase {{string|Use "double-quotes" in parameters}}.
* Back-slash (\) — Encloses the variable with double-quotes, and escapes all double-quotes in the variable with back-slashes. This is more common for unix and linux commandline applications. E.g. Variable {{string|%~1}} expands to {{string|"Use \"double-quotes\" in parameters"}}, if {{syntax|Text Filters|%1}} contains phrase {{string|Use "double-quotes" in parameters}}.

Note: Unescaped variable, e.g. {{syntax|Text Filters|%S}}, does not add any extra characters to the command. This can be useful and sometimes even necessary, but it can also become unreliable, if spaces and other special characters are expected in such variable. Consider escaping variables, if spaces are expected to be given upon using a filter.

{{example start}}Example:
{{example body}}<nowiki>myapp.exe %1

myapp.exe /a %1 /b /c %2

myviewer.exe %~F

grep.exe -e %\S</nowiki>
{{example end}}

====Filter options====

{{todo|Options}}

Nothing is written into the {{feature|Text Filters|filter}}'s {{system|stdin}}.

No output is gathered from {{feature|Text Filters|filter}}'s {{system|stdout}}.

{{tip}} Variable {{string|%F}}, along with {{field|Text Filters|Push input}} and {{field|Text Filters|Capture output}} options turned off, can be useful to define an external viewer which does not read the {{system|stdin}} at all, but requires a file name to start on.

====Technical details====

Upon {{feature|Text Filters|filter}} being executed, a new process is started using the {{feature|Text Filters|filter}}'s command, after replacing all variables with given user values from the {{dialog|Filter}} dialog. Current selection is written into the {{system|stdin}}1 of the started process, and its {{system|stdout}}2 and {{system|stderr}}3 are read. Depending on what value the process returns, current selection is replaced with the output of the process, or an error message is displayed, containing returned error code and contents of the {{system|stderr}}3.

If the {{syntax|Text Filters|%F}} variable is used, the document is saved automatically before the execution of the filter and the {{syntax|Text Filters|%F}} is then replaced by the actual path and file name of the current document.

: 1 {{system|standard console input}}
: 2 {{system|standard console output}}
: 3 {{system|standard console error output}}

=====Filter requirements=====

An application defined in {{feature|filter}}'s command should read the {{system|stdin}} for input text and should output any results to the {{system|stdout}}. If the operation is successful, the application should return zero. Otherwise it should return non-zero value and optionally describe the error to the {{system|stderr}}.

Note: Some languages (like Pascal) does not support {{system|stderr}} at all. Therefore, if a non-zero return code is received and {{system|stderr}} is empty, {{system|stdout}} is expected to contain the error description.

If an application file name ends with an {{string|.exe}} extension, it is not necessary to use it in the command, but it may be necessary otherwise. The command can specify the full path and file name of the application to execute as well as only the file name. In the case of a missing path, system uses the current working directory and system directories upon searching for the application.

System commands need to be executed through a {{system|command interpreter}}, as they do not have any file names to be executed. Use standard {{system|command interpreters}} (i.e. {{system|cmd.exe}} on Win NT/2000/XP, {{system|command.com}} on Win 9x/ME) or the {{system|launch.exe}} interpreter, which is included in the installation package and installed with TED Notepad.

{{example start}}Examples:
{{example body}}<nowiki>cmd.exe /c command [parameters]
cmd /c dir /b %1

command.com /c command [parameters]
command.com /c dir /b %1

launch.exe command [parameters]
launch dir /b %1</nowiki>
{{example end}}

=====How to create a filter's application?=====

Very easy! Any programming language that can be compiled to a console application (i.e. PE files with an .exe extension) may be used, e.g. C/C++, Pascal, Visual Basic, etc. Even scripting languages are supported by using their associated interpreter for execution, e.g. PHP, Python, Perl, etc.

Such application should use its {{system|stdin}} for input, its {{system|stdout}} for output and its {{system|stderr}} in the case of failure/error. It should return zero upon success and non-zero value upon failure. No other requirements/restrictions are necessary. Applications can execute their own sub-processes, and even show user dialogs if necessary.

Note: Some languages do not define {{system|stderr}}. Therefore, all error messages can also be written to {{system|stdout}}. If a non-zero error code is returned and no {{system|stderr}} is started, {{system|stdout}} is read instead of {{system|stderr}} for any error messages to be displayed to the user.

Note: Actually, both {{system|stdout}} and {{system|stderr}} are displayed to the user upon a non-zero error code. This behaviour may change in the future, according to the suggestions of the end users. The {{system|stderr}} is and will be preffered. {{todo|really?}}

{{example start}}Example:
{{example body}}<nowiki>
#include <stdio.h>
#include <stdlib.h>

int main (int argc, char* argv[])
{
int lines;
char buff[1024];

if (argc < 2) {
fprintf (stderr, "Enter the number!"); // outputs to stderr
return 1; // ...failure!
}

lines = atoi (argv[1]); // gets 1st parameter and
// converts it to integer
if (lines < 1) {
fprintf (stderr, "Wrong number!"); // outputs to stderr
return 2; // ...failure!
}

while (lines != 0) {
if (EOF == scanf ("%s", buff)) // reads from stdin
break; // or breaks on end-of-input
printf ("%s\n", buff); // writes to stdout
lines = lines - 1;
}

return 0; // ...success
}
</nowiki>
{{example end}}

{{example start}}Example: There is no {{system|stderr}} in Pascal, therefore writting errors to {{system|stdout}}...
{{example body}}<nowiki>
var lines, code: integer;
buff: string;
begin
if ParamCount < 1 then begin
writeln ('Enter the number!'); { outputs }
halt (1); { ...failure! }
end;

Val(ParamStr(1), lines, code); { gets 1st param and }
{ converts it to integer }
if lines < 1 then begin
writeln ('Wrong number!'); { outputs }
halt (2); { ...failure! }
end;

while lines <> 0 do begin
readln (buff); { reads a line from stdin }
if eof then break;
writeln (buff); { writes to stdout }
lines:= lines - 1;
end;
end. { ...autosuccess }
</nowiki>
{{example end}}

Wrap tools

2011-06-29T09:18:36Z

Kew:

<noinclude>{{manversion|6.0.0.17|menu}}__NOTOC__</noinclude>
{{:Commit Wrapping}}

{{:Unwrap Paragraphs}}
{{:Unwrap Lines}}

Unwrap Paragraphs

2011-06-29T09:18:16Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Wrap tools|Unwrap Paragraphs (Ctrl+Shift+W)}}

Unwraps {{defined|lines}} of each {{defined|paragraph}} in the selection by concatenating them into a single line. One Space character is placed between every two concatenated lines, if there is no {{defined|white-space}} already present at the point of connexion.

Note that if lines were formerly wrapped/committed by {{feature|Commit Wrapping}} tool, this tool will not ''undo'' that exactly as expected. This is because this tool needs lines to be divided into {{defined|paragraphs}} to let them separated; as opposed to the fact that a sequence of several lines form only one {{defined|paragraph}} and is committed by {{feature|Commit Wrapping}} tool again into only one {{defined|paragraph}}.

See also {{feature|Unwrap Lines}} and {{feature|Commit Wrapping}} tools.

Unwrap Lines

2011-06-29T09:18:14Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Wrap tools|Unwrap Lines (Alt+Ctrl+Shift+W)}}

Unwraps {{defined|lines}} in the selection by concatenating them into a single line. One Space character is placed between every two concatenated lines, if there is no {{defined|white-space}} already present at the point of connexion.

Note: This tool always transforms the selection into only one single line.

See also {{feature|Unwrap Paragraphs}} and {{feature|Commit Wrapping}} tools.

Commit Wrapping

2011-06-29T09:18:12Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Wrap tools|Commit Wrapping (Alt+Ctrl+W)}}

Commits actual word-wrapping of the lines in the selection. This tool is enabled only if {{feature|Word Wrap}} is enabled.

Note: The word-wrapping is commited as actually visualy rendered. Commited word-wrapping is permanent and affects how the document is saved, printed and further displayed.

See also {{feature|Unwrap Paragraphs}} and {{feature|Unwrap Lines}} tools.

Sort tools

2011-06-29T08:32:53Z

Kew:

<noinclude>{{manversion|6.0.0.17|menu}}__NOTOC__</noinclude>
{{:Sort Lines Ascending}}
{{:Sort Lines Descending}}
{{:Sort Lines}}

{{:Shuffle Lines}}

Sort Lines Descending

2011-06-29T08:32:40Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Sort tools|Descending (Alt+Ctrl+Z)}}

Sorts {{defined|lines}} of the selecion in descending order, comparing the entire lines as simple text.
Does not {{defined|ignore case}} or any characters upon comparison.

See also {{feature|Sort Lines Ascending}} and {{feature|Sort Lines}} tools.

See also {{feature|Shuffle Lines}} tool.

Sort Lines Ascending

2011-06-29T08:32:37Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Sort tools|Ascending (Alt+Ctrl+A)}}

Sorts {{defined|lines}} of the selecion in ascending order, comparing the entire lines as simple text.
Does not {{defined|ignore case}} or any characters upon comparison.

See also {{feature|Sort Lines Descending}} and {{feature|Sort Lines}} tools.

See also {{feature|Shuffle Lines}} tool.

Sort Lines

2011-06-29T08:32:35Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Sort tools|Sort.. (Alt+Ctrl+S)}}

Sorts {{defined|lines}} of the selection according to the given sorting keys.

Upto five sorting keys can be used, each sorting key represented by its own tab in the {{dialog|Sort Lines}} dialog: {{field|Sort Lines|First}}, {{field|Sort Lines|Second}}, {{field|Sort Lines|Third}}, {{field|Sort Lines|Then}}, and {{field|Sort Lines|Finally}}. Sorting keys are used subsequently ony by one, i.e. if two lines are considered equal acording to the {{field|Sort Lines|First}} key, then the {{field|Sort Lines|Second}} key is used, etc. In other words, to have the {{field|Sort Lines|Finally}} key harnessed/employed, all four preceeding sorting keys must yield indecisive comparison.

Note: Each sorting key offer a special {{field|Cutting line portion|Nothing}} option, which turns off the entire key. Such key is not used for comparing lines upon sorting, but it does not prevent later sorting keys from being queried. Using {{field|Cutting line portion|Nothing}} option has the same effect as setting up a sorting key, which would always yield indecisive comparison.

Note: Sorting keys are used only to compare and sort the lines, e.g. to decide, which one goes first and which one will be the second one. The lines themselves are not being modified, only their order.

=====Cutting line portion=====

Each sorting key may cut a portion of a line, which is used for comparison upon sorting. {{:Cutting line portion}}

=====Direction and format=====

The meaning of each sorting key is specified by {{field|Sort Lines|Sort as}} options.
* {{field|Sort Lines|Text}} option tells that each portion of line previously cut is to be treated as a simple string of characters upon comparison — comparison of two strings of characters is done {{defined|lexicographically}}, i.e. by subsequently comparing each pair of corresponding characters from both strings (the first pair of different characters is the one that decides which string is greater).
** Note: {{defined|Character case}} can be ignored upon {{defined|lexicographical}} comparison, as well as entire characters and character types. See below.
* {{field|Sort Lines|Numbers}} option tells that each portion of line previously cut is to be treated as a {{defined|number}} upon comparison — comparison of two numbers is done by their natural order.
** A {{defined|number}} may, in general, consist of a sign, numerals, decimal point and more numerals. Any of those may be omitted, e.g. {{string|3.14}}, {{string|+2.0}}, {{string|2.}}, {{string|-7}}, {{string|.3}} are all valid numbers. Total count of digits in a {{defined|number}} is not limited. Note that individual separate decimal point or positive/negative sign character with no numerals, as well as ''empty'' number, are all treated as 0.
** Note: System locale settings (Regional settings) are used while comparing numbers. This includes decimal point, positive and negative signs, thousands separator, etc.
** Note: All alpha-numeric characters are considered valid numerals, thus hexadecimal numbers (or any other system with radix upto 36) are supported. All numbers must share the same radix, however.
** Note: All {{defined|white-spaces}} are automatically ignored upon comparing {{defined|numbers}}. {{defined|Character case}} is ignored as well.
** Note: The first unrecognized and non-ignored character after a recognizable {{defined|number}} terminates that {{defined|number}}. Any following text is ignored. Note, however, that all alpha-numeric characters are considered valid numerals and {{defined|white-spaces}} are ignored, thus mystifying {{string|3 pigs}} is a valid number, which is bigger than {{string|3 cows}}, but is far far less than {{string|1 elephant}}. This is because both {{string|3pigs}} and {{string|3cows}} have only 5 digits while {{string|1elephant}} has 9 digits. It is the same as if comparing numbers {{string|37198}}, {{string|32048}} and {{string|131375429}}.
** See chapter [[Appendix]] for further details and examples of recognized {{defined|number formats}}.

Each sorting key can specify the resulting order of sorted lines using the {{field|Sort Lines|Direction}} with two intuitive options: {{field|Sort Lines|Ascending}} or {{field|Sort Lines|Descending}}.

===== options=====

Additional options are available to further modify, which characters are compared and which are ignored upon comparison.
* {{field|Sort Lines|Ignore case}} option can be used to compare lines in {{defined|case insensitive}} manner. This option is implicit upon {{field|Sort Lines|Sort as}} {{field|Sort Lines|Numbers}}.
* {{field|Sort Lines|Ignore white-spaces}} option can be used to ignore all {{defined|white-spaces}} upon comparison. This option is implicit upon {{field|Sort Lines|Sort as}} {{field|Sort Lines|Numbers}}.
* {{field|Sort Lines|Ignore punctuation}} option can be used to ignore all {{defined|punctuation characters}} upon comparison. System locale settings and system unicode tables are used to identify {{defined|punctuation characters}}.
* {{field|Sort Lines|Ignore blank characters}} option can be used to ignore all {{defined|blank characters}} upon comparison. System unicode tables are used to identify {{defined|blank characters}} — invisible spacing characters.
* {{field|Sort Lines|Ignore control characters}} option can be used to ignore all {{defined|control characters}} upon comparison. System unicode tables are used to identify {{defined|control characters}} — non-printable characters with special meaning.
* {{field|Sort Lines|Ignore all but alpha-numeric characters}} option can be used to ignore all but {{defined|alpha-numeric characters}} upon comparison. System unicode tables are used to identify {{defined|alpha-numeric characters}}, which include letters and symbols from many different languages.
* {{field|Sort Lines|Ignore characters}} option can be used to manually specify individual characters to be ignored upon comparison. Note that characters from this option are always {{defined|case sensitive}}.
* {{field|Sort Lines|Ignore all but}} option can be used to manually specify individual characters to be accepted upon comparison, while ignoring any other characters. Note that characters from this option are always {{defined|case sensitive}}.

If a character is to be ignored upon comparison, it is as if all occurrences of such character were deleted before the comparison. Note, however, that the characters are never physically removed from the lines — the resulting lines are not modified by this tool.

Note: Set of characters to be actually ignored upon comparison is a union of all ignored characters as specified by the options above. Note that even if {{field|Sort Lines|Ignore all but}} option specifies some character, {{field|Sort Lines|Ignore characters}} option can take it off the table.

See also {{feature|Sort Lines Ascending}}, {{feature|Sort Lines Descending}} and {{feature|Sort Lines}} tools.

See also {{feature|Shuffle Lines}} tool.

Shuffle Lines

2011-06-29T08:32:33Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Sort tools|Shuffle (Ctrl+Shift+K)}}

Reorders {{defined|lines}} of the selecion randomly.

{{:Random generator warning}}

See also {{feature|Sort Lines Ascending}}, {{feature|Sort Lines Descending}} and {{feature|Sort Lines}} tools.

Reverse tools

2011-06-29T08:27:32Z

Kew:

<noinclude>{{manversion|6.0.0.17|menu}}__NOTOC__</noinclude>
{{:Reverse Text}}
{{:Reverse Order of Lines}}
{{:Reverse Order of Words}}

{{:Reverse Each Word}}
{{:Reverse Each Line}}

{{:Reverse Order of Words on Each Line}}

Reverse Order of Words

2011-06-29T08:27:06Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Reverse tools|Order of Words (Ctrl+Shift+Y)}}

Reverses order of entire {{defined|words}} of the selection. The {{defined|words}} themselves remain unreversed, only their order is changed.

Note: {{defined|Non-word}} characters are treated as single words.

{{example_start}}Example:
{{example_body}}{{example_select|<nowiki>There is no place like 127.0.0.1!</nowiki>}}
{{example_end}}

{{example_start}}Result:
{{example_body}}<nowiki>!1.0.0.127 like place no is There</nowiki>
{{example_end}}

Reverse Text

2011-06-29T08:27:05Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Reverse tools|Text (Ctrl+Shift+J)}}

Reverses the selection by exchanging its first character with its last character, the second with the penultimate, etc.

Note: Multi-character newlines are always reversed as single characters.

{{mycomment|Niekedy mam pocit, ze to vysvetlujem jak pre debilov...}}

{{example_start}}Example:
{{example_body}}{{example_select|Dog lived on, devil god.}}
{{example_end}}

{{example_start}}Result:
{{example_body}}.dog lived ,no devil goD
{{example_end}}

Reverse Order of Words on Each Line

2011-06-29T08:27:04Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Reverse tools|Order of Words on Each Line (Ctrl+Shift+F)}}

Reverses order of entire {{defined|words}} on each {{defined|line}} separately.

Note: The order of {{defined|lines}} is not changed, and {{defined|words}} themselves remain unreversed on their original {{defined|lines}}. Only the order of words on any given line is changed.

{{example_start}}Example:
{{example_body}}{{example_select|<nowiki>There is no place
like 127.0.0.1!</nowiki>}}
{{example_end}}

{{example_start}}Result:
{{example_body}}<nowiki>place no is There
!1.0.0.127 like</nowiki>
{{example_end}}

Reverse Order of Lines

2011-06-29T08:27:01Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Reverse tools|Order of Lines (Ctrl+Shift+R)}}

Reverses {{defined|line}} order within the selection by exchanging the first {{defined|line}} with the last {{defined|line}}, the second with the penultimate, etc.

{{example_start}}Example: {{mycomment|(Stupidnejsi priklad som uz asik najst nemohol, co? :-)}}
{{example_body}}{{example_select|<nowiki>For the 1st time, I nearly came to the door, but chickened out immediately.
The 2nd time was better, I rang the doorbell and only then I chickened out.
Unfortunately, by the 3rd time, I was caught. Now... ...now I am married.</nowiki>}}
{{example_end}}

{{example_start}}Result:
{{example_body}}<nowiki>Unfortunately, by the 3rd time, I was caught. Now... ...now I am married.
The 2nd time was better, I rang the doorbell and only then I chickened out.
For the 1st time, I nearly came to the door, but chickened out immediately,</nowiki>
{{example_end}}

Reverse Each Word

2011-06-29T08:26:59Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Reverse tools|Each Word (Ctrl+Shift+B)}}

Searches the selection for {{defined|words}} and reverses each {{defined|word}} separately in its original position.

Note: The order of {{defined|words}} is not changed. All {{defined|word delimiters}} are left untouched.

{{example_start}}Example:
{{example_body}}{{example_select|Dog lived on, devil god..}}
{{example_end}}

{{example_start}}Result:
{{example_body}}goD devil no, lived dog..
{{example_end}}

Reverse Each Line

2011-06-29T08:26:58Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Reverse tools|Each Line (Ctrl+Shift+G)}}

Reverses each {{defined|line}} of the selection separately in its original position.

Note: The order of {{defined|lines}} is not changed.

{{example_start}}Example: {{mycomment|(Stupidny priklad zo vcera pokracuje...)}}
{{example_body}}{{example_select|<nowiki>For the 1st time, I nearly came to the door, but chickened out immediately.
The 2nd time was better, I rang the doorbell and only then I chickened out.
Unfortunately, by the 3rd time, I was caught. Now... ...now I am married.</nowiki>}}
{{example_end}}

{{example_start}}Result:
{{example_body}}<nowiki>.yletaidemmi tuo denekcihc tub ,rood eht ot emac ylraen I ,emit ts1 eht roF
.tuo denekcihc I neht ylno dna llebrood eht gnar I ,retteb saw emit dn2 ehT
.deirram ma I won... ...woN .thguac saw I ,emit dr3 eht yb ,yletanutrofnU</nowiki>
{{example_end}}

Text tools

2011-06-29T07:50:40Z

Kew:

<noinclude>{{manversion|6.0.0.17|menu}}__NOTOC__</noinclude>
{{:Enclose Selection}}
{{:XML/HTML Tag}}

{{:Extract Words}}

{{:Extended Replace}}
{{:Translate Characters}}

{{:Compare Strings}}

{{:Statistics}}

XML/HTML Tag

2011-06-29T07:50:35Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Text tools|XML/HTML Tag.. (Ctrl+Shift+H)}}

Asks for a tag {{field|XML/HTML Tag|Name}} and for its {{field|XML/HTML Tag|Attributes}}. Then encloses the selection with a specified XML/HTML tag (including the attributes if given). The tag may be {{field|XML/HTML Tag|Empty}} which means that only the starting tag is generated with a slash at its end according to XML specification (e.g. <nowiki> </nowiki>). In this case, if a selection is found, the tag is placed at the end of such selection.

If the selection does not contain newline, it is enclosed tightly. However, if the selection does contain newlines, it is enclosed with additional newlines after the starting and before the closing tag.

The selection always persists the operation, but it excludes the generated starting and closing tags, thus selecting the same text as before.

Note: The {{field|Settings:Tools|Persistent selection}} setting does not apply to this tool (as described in chapter [[Tools page]] of the {{dialog|Settings}} dialog).

{{example_start}}Example:
{{example_body}}There is no place like {{example_select|127.0.0.1}}!
{{example_end}}

{{example_start}}Result, using {{field|XML/HTML Tag|Name}}: {{string|a}} and {{field|XML/HTML Tag|Attributes}}: {{string|1=<nowiki>href="http://127.0.0.1/"</nowiki>}}:
{{example_body}}There is no place like <a href="<nowiki>http://127.0.0.1/</nowiki>">{{example_select|127.0.0.1}}</a>!
{{example_end}}

{{example_start}}Example:
{{example_body}}{{example_select|There is no place like 127.0.0.1!}}
{{example_end}}

{{example_start}}Result:
{{example_body}}<a href="<nowiki>http://127.0.0.1/</nowiki>"> {{example_select|There is no place like 127.0.0.1!}} </a>
{{example_end}}

{{tip}} If you need to enclose selection with more general phrases, use the {{feature|Enclose Selection}} tool instead.

{{tip}} In {{dialog|Settings}} dialog, on the [[Tools page]], there are options to keep or reset the {{field|XML/HTML Tag|Attributes}} and {{field|XML/HTML Tag|Empty}} fields every time the tool dialog is invoked. You can use them to support your habits or ease routines of your current tasks.

See also {{feature|Enclose Selection}} tool.

Translate Characters

2011-06-29T07:50:34Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Text tools|Translate Characters.. (Alt+Ctrl+T)}}

Asks for {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}} character maps. Then translates the characters in the selection by replacing all occurrences of each character from {{field|Translate Characters|Find}} with corresponding character from {{field|Translate Characters|Translate to}}.

Note that {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}} represent ''lists'' of characters rather than entire phrases. By assigning the first character from {{field|Translate Characters|Find}} to the first character from {{field|Translate Characters|Translate to}}, the second character from {{field|Translate Characters|Find}} to the second character from {{field|Translate Characters|Translate to}}, etc., the tool creates a so called ''character translation map'' (similar to one used by Boy Scouts for substitution cipher encryption). With this ''translation map'', individual characters of the selection are then substituted for other characters (as Boy Scouts are encrypting a secret message).

If {{field|Translate Characters|Translate to}} is shorter than {{field|Translate Characters|Find}}, extra characters from {{field|Translate Characters|Find}} are translated to ''nothing'', effectively deleting them from the results.

If {{field|Translate Characters|Translate to}} is longer than {{field|Translate Characters|Find}}, extra characters from {{field|Translate Characters|Translate to}} are simply ignored.

Optionally, {{field|Translate Characters|Delete all other characters}} option can be used to delete all characters, which are not specified in the {{field|Translate Characters|Find}}. Note: Even if {{field|Translate Characters|Delete all other characters}} is turned on, the translation of characters still requires that every character from {{field|Translate Characters|Find}} has a corresponding character in {{field|Translate Characters|Translate to}}. If {{field|Translate Characters|Translate to}} is shorter than {{field|Translate Characters|Find}}, extra characters from {{field|Translate Characters|Find}} are again translated to ''nothing'', deleting them from the results as well.

Optionally, {{field|Translate Characters|Escapes & ranges}} option can be used to turn on recognition of character ranges within {{field|Translate Characters|Find}} and {{field|Translate Characters|Translate to}}. Character ranges allow to easily specify entire sets of characters, e.g. {{string|a-z}} or {{string|0-9}}. Note however, that using ranges has a few limitations/caveats. {{todo|Escapes & ranges specifics}}

Note: Characters not specified in {{field|Translate Characters|Find}} are not modified, unless {{field|Translate Characters|Delete all other characters}} option is turned on.

Note: This tool is always {{defined|case sensitive}}. You need to specify translation for both {{defined|lower case}} and {{defined|upper case}} characters, if {{defined|case insensitiveness}} is expected.

{{example_start}}Example:
{{example_body}}{{example_select|TED Notepad for Windows}}
{{example_end}}

{{example_start}}Result: (using {{field|Translate Characters|Find}}: {{string|EDNopadfWinws}} and {{field|Translate Characters|Translate to}}: {{string|enmeorspparc.}})
{{example_body}}Ten meteors per parsec.
{{example_end}}

{{feature|Translate Characters}} tool can have similar effect as, for example, {{feature|All Upper Case}} tool:

{{example_start}}Result: (using {{field|Translate Characters|Find}}: {{string|a-z}} and {{field|Translate Characters|Translate to}}: {{string|A-Z}})
{{example_body}}TED NOTEPAD FOR WINDOWS
{{example_end}}

Statistics

2011-06-29T07:50:32Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Text tools|Statistics.. (F9)}}

Shows the {{dialog|Statistics}} dialog with computed statistics about the document and the selection. Statistics include several types of counts of characters, words, lines, sentences and paragraphs; minimum, maximum and average line lengths; etc.

Note: Statistics are computed separately for the document and for the selection.

Note: Description of terminology used in the {{dialog|Statistics}} dialog can be found in the section [[Appendix]], including exact definitions.

Extract Words

2011-06-29T07:50:30Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Text tools|Extract Words (Ctrl+Shift+E)}}

Searches the selection for {{defined|words}} and then transforms the selection into a complete list of all words, placing one word per line. The order of words is not changed during the transformation.

Note: All {{defined|non-word}} characters are removed by this tool. The original selection is replaced by the newly created list. Be careful not to accidentally destroy your document while extracting word-lists out of it.

Note: Duplicate words are not removed. Use {{feature|Unique Lines}} tool to remove them.

{{example_start}}Example:
{{example_body}}{{example_select|There is no place like 127.0.0.1!}}
{{example_end}}

{{example_start}}Result:
{{example_body}}<nowiki>There
is
no
place
like
127
0
0
1</nowiki>
{{example_end}}

See also {{feature|Unique Lines}} tool.

Extended Replace

2011-06-29T07:50:27Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Text tools|Extended Replace.. (Alt+Ctrl+R)}}

Searches for all occurrences of a specified {{field|Extended Replace|Find what}} phrase within the selection and replaces them with {{field|Extended Replace|Replace with}} phrase.

By default, the search is {{defined|case insensitive}}. {{field|Extended Replace|Match case}} option can be used to make the search {{defined|case sensitive}}.

{{field|Extended Replace|Whole words}} option can be used to restrict the search to only those matches, which start and end at word boundaries. Note that a match itself might contain {{defined|non-word characters}}, since only the boundaries of the match are probed. Therefore, the last character before the match and the first character after the match may not be {{defined|word characters}}; while the first character and the last character of the match must be {{defined|word characters}}.

{{field|Extended Replace|RegExps}} option can be used to turn the {{feature|Regular expressions}} engine on. When {{feature|Regular expressions}} are enabled, {{field|Extended Replace|Find what}} is parsed as a ''regular expression pattern''. See chapter [[Regular expressions]] for more details on supported regular expressions syntax.

Note: Invalid or faulty patterns result in tool refusing to work until the pattern is corrected.

{{field|Extended Replace|Mimic case}} option can be used to {{defined|mimic character case}} of matches upon replacing. This option individually converts {{defined|character case}} of the replacement string upon each match. The conversion is done upon actual replacing (i.e. after the replacement string is prepared for the match) and the conversion takes only {{defined|character case}} of the match into account. Therefore, the {{defined|mimic case}} may result in different {{defined|character case}} for each match. If the tool cannot decide how to {{defined|mimic case}} of a match, it leaves the replacement intact, giving the user a chance to specify one special {{defined|mixed case}} replacement.

{{tip}} The {{defined|mimic case}} option recognizes only ''basic'' types of {{defined|character case}}, i.e. {{defined|lower case}}, {{defined|upper case}}, {{defined|word capitals}}, {{defined|first capitals}}. Everyting else is considered {{defined|mixed case}} and the tool does not try to convert case of the replacement. This can be utilized to specify ''one'' {{defined|mixed case}} version of the replacement. Consider you need to replace {{string|OneHalf}} with {{string|SlovakBomber}}, but want to use the {{defined|mimic case}} to automatically replace {{string|onehalf}} with {{string|slovakbomber}} and {{string|ONEHALF}} with {{string|SLOVAKBOMBER}}. Using {{defined|mixed case}} {{string|SlovakBomber}} as a replacement will do the trick.

{{button|Extended Replace|Escape \}} button can be used to automatically escape all back-slashes in both {{field|Extended Replace|Find what}} and {{field|Extended Replace|Replace with}} edit fields.

{{button|Extended Replace|UnEscape \}} button can be used to remove all escapes from both {{field|Extended Replace|Find what}} and {{field|Extended Replace|Replace with}} edit fields.

Note: Newlines and Tab characters can be used in {{field|Extended Replace|Find what}} and {{field|Extended Replace|Replace with}} fields freely. Moreover, each newline from the {{field|Extended Replace|Find what}} field matches any kind of newline in the document (Win/Unix/Mac). Each newline from the {{field|Extended Replace|Replace with}} field is converted to the current newline type (as shown in the {{feature|Status Bar}} for example) upon replacing.

Note: This tool is prefered to the standard {{button|Find Bar|Replace All}} mechanism from the {{feature|Find Bar}} in many cases. Its search is done in more feasible way and the replacing routine works much faster and uses less resources. Furthermore, the selection ensures, that the replacing is done only in the desired part of the text. And finally, one {{feature|Undo}} step covers all replacements together, instead of grouping many small separate replacements. Although this may not be directly apparent, it is incomparably better to have one big {{feature|Undo}} step instead of too many small {{feature|Undo}} steps. On the other hand, if you expect only a handful of matches and replacements in a big big document, the old good looping {{button|Find Bar|Replace All}} routine might come more handy.

Enclose Selection

2011-06-29T07:50:26Z

Kew:

<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
{{#headline:Text tools|Enclose Selection.. (Alt+Ctrl+E)}}

Asks for two phrases and then encloses the selection with them. The first one ({{field|Enclose Selection|Before}}) is placed before the selection, the second one ({{field|Enclose Selection|After}}) is placed after the selection.

If there is nothing selected while using this tool, then the caret is placed between the two inserted strings.

{{example_start}}Example:
{{example_body}}TED Notepad for Windows is a {{example_select|freeware}} text editor, ...
{{example_end}}

{{example_start}}Result, using {{field|Enclose Selection|Before}}: {{string|<nowiki></nowiki>}} and {{field|Enclose Selection|After}}: {{string|<nowiki></nowiki>}}:
{{example_body}}TED Notepad for Windows is a freeware text editor, ...
{{example_end}}

{{tip}} This tool is most suitable for repeating phrases where only some part of those phrases varies and this variance occurs somewhere in the middle of them. Every time you need to use such phrase, either invoke this tool on empty selection and then type the varying part right in, or type the varying part first and then select it and enclose it. Remember: If there is nothing selected while using this tool, then the caret is placed between the two inserted strings.

{{tip}} If you need to enclose with XML or HTML tags, use the {{feature|XML/HTML Tag}} tool instead.

{{tip}} If you need to enclose entire subsequent lines, it is better to select all of them at once and use {{feature|Quote Lines}} tool (hotkey {{hotkey|Alt+Ctrl+Q}}) and then {{feature|Close Lines}} tool (hotkey {{hotkey|Alt+Ctrl+C}}) instead of selecting each one of them separately and performing the {{feature|Enclose Selection}} again and again.

See also {{feature|XML/HTML Tag}} tool.