Difference between revisions of "Appendix"

From TED Notepad
Line 13: Line 13:
 
*A {{definition|string}} is a sequence of characters. Typically, such {{definition|string}} is used as a synonym for a phrase, that a user have written in a dialog. (E.g. {{field|Find what}} and {{field|Replace with}} {{definition|strings}} from {{feature|Find/Replace}} dialogs are always used in find/replace mechanisms.)
 
*A {{definition|string}} is a sequence of characters. Typically, such {{definition|string}} is used as a synonym for a phrase, that a user have written in a dialog. (E.g. {{field|Find what}} and {{field|Replace with}} {{definition|strings}} from {{feature|Find/Replace}} dialogs are always used in find/replace mechanisms.)
  
<p>A <b>word</b> is a non-empty sequence of <q>alphanums</q>. Underscores may be optionally included<sup>**</sup> and phrase "<code>hello_world</code>" is then treated as a single <q>word</q>. All characters that a <q>word</q> can consist of are called <b>word letters</b>.</p>
+
*A {{definition|word}} is a non-empty sequence of {{definition|alphanums}}. Underscores may be optionally included<sup>**</sup> and phrase {{string|hello_world}} is then treated as a single {{definition|word}} within all Tools and Functions. All characters that such a {{definition|word}} can consist of are called {{definition|word letters}} or also {{definition|word characters}}.
  
<p>A <b>line</b> is a sequence of characters, where two <q>lines</q> are divided by a "<code>CR/NL</code>" characters sequence. Note, that if <cite>Word Wrap</cite> is turned on, a <q>line</q> may be wrapped, but within tools it will be treated only as a single <q>line</q>. Also note, that a single "<code>NL</code>" or "<code>CR</code>" character do not divide two <q>lines</q>.</p>
+
*A {{definition|line}} is a sequence of characters, where two {{definition|lines}} are divided by a {{string|CR/NL}} sequence of characters. Note, that if {{feature|Word Wrap}} is turned on, a {{definition|line}} may be wrapped, but within all tools it will be still treated as a single {{definition|line}}. Also note, that a single {{string|NL}} or {{string|CR}} character does not divide two {{definition|lines}}.
  
<p>An <b>empty line</b> is a <q>line</q>, that consists only of <q>white-spaces</q>. Therefore a <b>non-empty line</b> is a <q>line</q>, that contains at least one <q>graph</q> character.</p>
+
*An {{definition|empty line}} is a {{definition|line}}, that consists only of {{definition|white-spaces}}. Therefore a {{definition|non-empty line}} is a {{definition|line}}, that contains at least one {{definition|graph}} character.
  
<p>A <b>paragraph</b> is a sequence of <q>non-empty lines</q>. Two <q>paragraphs</q> are then divided by a non-empty sequence of <q>empty lines</q>.</p>
+
*A {{definition|paragraph}} is a sequence of {{definition|non-empty lines}}. Two {{definition|paragraphs}} are then divided by a non-empty sequence of {{definition|empty lines}}.
  
<p>A <b>sentence</b> is a sequence of characters that begins with a <q>capital</q> and ends with a Dot, a Question mark or an Exclamation mark. Example: "<code>Alice? Who the f... is Alice?</code>" are two <q>sentences</q>, but "<code>Alice? Who the f... Is Alice?</code>" are three <q>sentences</q>.</p>
+
*A {{definition|sentence}} is a sequence of characters that begins with a {{definition|capital}} and ends with a Dot, a Question mark or an Exclamation mark. Example: "<code>Alice? Who the f... is Alice?</code>" are two {{definition|sentences}}, but {{string|Alice? Who the f... Is Alice?}} are three {{definition|sentences}}.
  
<p>A <b>column</b> is a sequence of characters on a <q>line</q>. Two <q>columns</q> are divided by any of the <b>column delimiters</b>. A <q>column</q> can not exceed a <q>line</q>. Typically, when a <q>line</q> is divided into logical parts by a special <q>delimiter</q> character (e.g. a Tab character), those parts are called <q>columns</q>. <q>Columns</q> are used to cut out a sub-<q>string</q> from a <q>line</q>.</p>
+
*A {{definition|column}} is a sequence of characters on a {{definition|line}}. Two {{definition|columns}} are divided by any of the {{definition|column delimiters}}. A {{definition|column}} can not exceed a {{definition|line}}. Typically, when a {{definition|line}} is divided into logical parts by a special {{definition|delimiter}} character (e.g. a Tab character), those parts are called {{definition|columns}}. {{definition|Columns}} are used to cut out a sub-{{definition|string}} from a {{definition|line}}.
  
<p>A <b>char range</b> is a sub-sequence of characters that begins and ends at the specified positions. Char range is used to cut out a sub-<q>string</q> from a longer <q>column</q>.</p>
+
*A {{definition|char range}} is a sub-sequence of characters that begins and ends at the specified positions. Char range is used to cut out a sub-{{definition|string}} from a longer {{definition|column}}.
  
<p>An <b>actual insertion point</b> (also called a <b>cursor position</b>) is a position of the caret in the documnet or the end of the actual selection, if any. Note, that in special cases, it is the beginning of the selection, if any. These special cases are tools/features that work backward. (e.g. <cite>Find Previous</cite> or <cite>BkSpace Word</cite>.)</p>
+
*An {{definition|actual insertion point}} (also called a {{definition|cursor position}}) is a position of the caret in the documnet or the end of the actual selection, if any. Note, that in special cases, it is the beginning of the selection, if any. These special cases are tools/features that work backward. (e.g. {{feature|Find Previous}} or {{feature|BkSpace Word}}.)
  
<strong>unique</strong>
+
{{todo|Describe verb to unique.}}
  
 +
<small>*: Special characters like &aacute; (a with acute) do not belong to {{definition|alphanums}}, nor {{definition|capitals}} in English locale settings. To be able to recognize those characters as {{definition|alphanums}} and {{definition|capitals}} you have to use CTYPE category of the locale that supports it. TED Notepad always works with the system locale settings.</small>
  
<small>*: Special characters like á (a with acute) do not belong to <q>alphanums</q>, nor <q>capitals</q>, in English locale settings. To be able to recognize those characters as <q>alphanums</q> and <q>capitals</q>, you have to use CTYPE category of the locale that supports it. TED Notepad always works with the system locale settings.</small><br><br>
+
<small>**: See section [[Settings dialog]].</small>
 
 
<small>**: See section <a href="#basic_sett">.. </a>.</small>
 

Revision as of 20:08, 23 February 2006

The meaning of some terms used in this manual is as follows below. Many of them are intuitive; some of them may not be well-known; and some of them are used here, only to describe exact actions of some tools within TED Notepad.

  • A white-space is a Space, a Tab or another character that can not be seen but takes place in the document. All other characters, which can be seen, are called graphs.
  • An alphanum* is an alpha-numeric character (ie. a, b, ..., z, A, B, ..., Z, 0, 1, ..., 9).
  • A capital* is any capital letter (ie. A, B, ..., Z).
  • A word is a non-empty sequence of alphanums. Underscores may be optionally included** and phrase hello_world is then treated as a single word within all Tools and Functions. All characters that such a word can consist of are called word letters or also word characters.
  • A line is a sequence of characters, where two lines are divided by a CR/NL sequence of characters. Note, that if Word Wrap is turned on, a line may be wrapped, but within all tools it will be still treated as a single line. Also note, that a single NL or CR character does not divide two lines.
  • A sentence is a sequence of characters that begins with a capital and ends with a Dot, a Question mark or an Exclamation mark. Example: "Alice? Who the f... is Alice?" are two sentences, but Alice? Who the f... Is Alice? are three sentences.
  • A char range is a sub-sequence of characters that begins and ends at the specified positions. Char range is used to cut out a sub-string from a longer column.
  • An actual insertion point (also called a cursor position) is a position of the caret in the documnet or the end of the actual selection, if any. Note, that in special cases, it is the beginning of the selection, if any. These special cases are tools/features that work backward. (e.g. Find Previous or BkSpace Word.)
This section is incomplete and wants to be finished later.
TODO: Describe verb to unique.

*: Special characters like á (a with acute) do not belong to alphanums, nor capitals in English locale settings. To be able to recognize those characters as alphanums and capitals you have to use CTYPE category of the locale that supports it. TED Notepad always works with the system locale settings.

**: See section Settings dialog.