Difference between revisions of "Appendix"
From TED Notepad
(12 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
− | <noinclude>{{manversion| | + | <noinclude>{{manversion|6.0.2.0}}__NOTOC__</noinclude> |
The meaning of some terms used in this manual is as follows below: | The meaning of some terms used in this manual is as follows below: | ||
− | * A {{definition|white-space}} is a Space or a Tab or another character that can not be ''seen'' but provides ''blank visual separator'' in the document. All other characters which can be ''seen'', are called {{definition|graphs}}. | + | * A {{definition|white-space}} is a Space or a Tab or another character that can not be ''seen'' but provides ''blank visual separator'' in the document. All other characters which can be ''seen'', are called {{definition|graphs}}. A {{definition|blank character}} is also a character that can not be ''seen'' but provides ''blank visual separator'' in the document. All {{definition|white-spaces}} are {{definition|blank characters}}, but some {{defined|control characters}} are {{definition|blank characters}} as well. |
− | * An {{definition|alphanum}} is an alpha-numeric character, i.e. {{string|a}}, {{string|b}}, ..., {{string|z}}; {{string|A}}, {{string|B}}, ..., {{string|Z}}; {{string|0}}, {{string|1}}, ..., {{string|9}}. | + | * An {{definition|alphanum}} is an {{definition|alpha-numeric character}}, i.e. {{string|a}}, {{string|b}}, ..., {{string|z}}; {{string|A}}, {{string|B}}, ..., {{string|Z}}; {{string|0}}, {{string|1}}, ..., {{string|9}}. |
** <small>Special characters like á (a with acute) belong to {{definition|alphanums}} only in certain locale settings. To be able to recognize these characters as {{definition|alphanums}} you need to use CTYPE category of a locale that supports it. TED Notepad always works with the current system locale settings.</small> | ** <small>Special characters like á (a with acute) belong to {{definition|alphanums}} only in certain locale settings. To be able to recognize these characters as {{definition|alphanums}} you need to use CTYPE category of a locale that supports it. TED Notepad always works with the current system locale settings.</small> | ||
+ | |||
+ | * A {{definition|digit}} is any digit recognized by Unicode, i.e. {{string|1}}, ..., {{string|9}}, but also {{string|¹}}, {{string|²}}, {{string|³}}, etc. | ||
* A {{definition|capital}} is any capital letter, i.e. {{string|A}}, {{string|B}}, ..., {{string|Z}}. These are called letters in {{definition|upper letter case}} or simply {{definition|upper case}} letters. Their oposites are called {{definition|lower case}} letters and are in {{definition|lower letter case}} or simply in {{definition|lower case}}. | * A {{definition|capital}} is any capital letter, i.e. {{string|A}}, {{string|B}}, ..., {{string|Z}}. These are called letters in {{definition|upper letter case}} or simply {{definition|upper case}} letters. Their oposites are called {{definition|lower case}} letters and are in {{definition|lower letter case}} or simply in {{definition|lower case}}. | ||
− | ** <small>Special characters like & | + | ** <small>Special characters like Á (A with acute) belong to {{definition|capitals}} only in certain locale settings. To be able to recognize these characters as {{definition|capitals}} you need to use CTYPE category of a locale that supports it. TED Notepad always works with the current system locale settings.</small> |
+ | |||
+ | * Other types of {{definition|character case}} include {{definition|word capitals}}, where each {{defined|word}} begins with a {{defined|capital}} and continues with {{definition|lower case}} letters; {{definition|first capital}}, where the first letter is a {{defined|capital}} and all others are {{definition|lower case}} letters; and {{definition|mixed case}}, where none of the above {{definition|letter cases}} can be determined. | ||
+ | |||
+ | * To {{definition|ignore case}} is to ignore differences between {{definition|letter cases}} like {{definition|capitals}} and {{definition|lower case}} letters. When {{definition|ignoring case}}, letter {{string|a}} is equal to letter {{string|A}}, {{string|b}} equal to {{string|B}}, etc. An antonym of {{definition|ignore case}} is to {{definition|match case}} and an operation, that {{definition|match case|matches case}} is {{definition|case sensitive}}. | ||
+ | |||
+ | * To {{definition|mimic character case}} is to try to alter {{definition|character case}} of some text based on {{definition|character case}} of the original. Currently only ''basic'' types of {{defined|character case}} are recognized: {{defined|lower case}}, {{defined|upper case}}, {{defined|word capitals}}, {{defined|first capital}}. Everyting else is considered {{defined|mixed case}}. | ||
− | * | + | * There are also other types of characters recognized by TED notepad: |
+ | ** A {{definition|punctuation character}} is any character recognized by Unicode as meant for punctuation purposes, e.g. quotation marks. | ||
+ | ** A {{definition|control character}} is a character from the very beginning of the ASCII table. These have special meaning and should be either avoided or treated with care. | ||
Line 18: | Line 28: | ||
− | * A {{definition|word}} is a non-empty sequence of {{definition|alphanums}}. Underscores may optionally be included within words | + | * A {{definition|word}} is a non-empty sequence of {{definition|alphanums}}. Underscores may optionally be included within words, a phrase like {{string|hello_world}} is then also treated as a single {{definition|word}}. All characters a {{definition|word}} can consist of are called {{definition|word letters}} or {{definition|word characters}}. Other characters are called {{definition|word delimiters}} or {{definition|non-word characters}}. See section [[General page]] of the {{dialog|Settings}} dialog for more information about Underscores in words. |
+ | |||
+ | * A {{definition|word boundary}} is a {{defined|word}} beginning or {{defined|word}} end. This is the place where one of the characters around is a {{defined|word character}} and the other is either a {{defined|non-word character}} or there is no character at all. | ||
+ | |||
+ | |||
+ | * A {{definition|line}} is a sequence of characters, where two {{definition|lines}} are divided by one {{definition|newline}}. Note that if {{feature|Word Wrap}} is turned on, a {{definition|line}} may be visually wrapped into several visual lines, but within all tools and most features it will still be treated as a single unbroken {{definition|line}}. Any current visual word-wrapping has seldom impact on how {{definition|lines}} are treated within tools and features . | ||
− | * | + | * An {{definition|empty line}} is a {{definition|line}}, which consists of {{definition|white-spaces}} only. Therefore a {{definition|non-empty line}} is a {{definition|line}}, which contains at least one {{definition|graph}} character. Please note that there might be many {{definition|white-spaces}} and still the {{definition|line}} would be considered {{definition|empty line|empty}}. |
− | |||
* A {{definition|paragraph}} is a sequence of {{definition|non-empty lines}}. Two {{definition|paragraphs}} are divided by a sequence of {{definition|empty lines}}. There is no such thing as empty {{definition|paragraph}}, since sequences of {{definition|empty lines}} are always grouped together when determining {{definition|paragraphs}}. | * A {{definition|paragraph}} is a sequence of {{definition|non-empty lines}}. Two {{definition|paragraphs}} are divided by a sequence of {{definition|empty lines}}. There is no such thing as empty {{definition|paragraph}}, since sequences of {{definition|empty lines}} are always grouped together when determining {{definition|paragraphs}}. | ||
Line 29: | Line 43: | ||
− | *A {{definition|column}} is | + | * A {{definition|line column}} is part of {{defined|line}}, which meets certain {{definition|column criteria}}. As these column criteria are applied to subsequent {{defined|lines}}, they determine a logical {{definition|column}} of text over these lines. The criteria are applied to individual {{defined|lines}} independently, thus possibly determining a column of text, which may be visually hard to identify. Nevertheless, for each individual {{defined|line}}, the column criteria are met. |
− | + | ** Note: A {{definition|line column}} is always one solid line portion, i.e. one line column can never consist of two separate portions of the same line. This is because a {{defined|line column}} is a logical part of {{defined|line}}, it only specifies where it begins and where it ends on each line. | |
− | * | + | ** Applicable column criteria may change from feature to feature and from tool to tool, but they usually include: |
+ | *** Dividing each {{defined|line}} into portions using {{definition|delimiting characters}}, also called {{definition|delimiters}}. These delimiting characters are located within each line and the line is split into portions. A splitting point occurs at any of these characters. These portions are numbered. The criteria then specify, which consequtive portions are to be selected for the line column. Note: Delimiting characters enclosing the selected portions are not included within the line column, but any delimiting characters between the selected portions are naturally included. | ||
+ | *** Dividing each {{defined|line}} into portions using a {{definition|delimiting phrase}}. In contrast to the {{defined|delimiting characters}}, delimiting phrase is always located within each line as a whole sequence of characters, not as a set of individual and interchangeable characters. The line is split into numbered portions wherever this whole delimiting phrase is found. The criteria then specify, which consequtive portions are to be selected for the line column. Note: Delimiting phrases enclosing the selected portions are not included within the line column, but any delimiting phrases between the selected portions are naturally included. | ||
+ | *** Taking only a portion of each {{defined|line}} based on a {{definition|range of characters}}. A range of characters is simply a starting and an ending point within the line. All characters between the starting and ending points are selected for the line column. | ||
+ | *** Certain combinations of the above criteria can be used to further reduce the column. For example, a set of {{defined|delimiting characters}} can be used to split the line and select only the second part, and then a {{defined|range of characters}} can be used to further reduce that part at its beginning and/or at its end. Note that these criteria are applied in sequence and their results compound, i.e. later criteria obey prior criteria and never try to reach outside of boundaries set by preceding criteria. | ||
− | |||
− | * | + | * An {{definition|actual insertion point}} (also called a {{definition|current caret location}}) is a position of the caret in the documnet. It is also the end of the actual selection, if any. Note that the end of the selection is where the user stops selecting the text, therefore if selecting text upwards, the selection end visually preceeds the selection beginning. |
− | + | * To {{definition|unique}} lines is to remove duplicate lines, to unify them. If lines or words have been {{definition|uniqued}}, it means that each line (or word) is unique in the results and that no two lines (or words) are of the same text. |
Latest revision as of 15:34, 12 March 2014
This section is up to date for TED Notepad version 6.3.1.0.
The meaning of some terms used in this manual is as follows below:
- A
white-space
is a Space or a Tab or another character that can not be seen but provides blank visual separator in the document. All other characters which can be seen, are calledgraphs
. Ablank character
is also a character that can not be seen but provides blank visual separator in the document. Allwhite-spaces
areblank characters
, but somecontrol characters
areblank characters
as well.
- An
alphanum
is analpha-numeric character
, i.e. a, b, ..., z; A, B, ..., Z; 0, 1, ..., 9.
- A
digit
is any digit recognized by Unicode, i.e. 1, ..., 9, but also ¹, ², ³, etc.
- A
capital
is any capital letter, i.e. A, B, ..., Z. These are called letters inupper letter case
or simplyupper case
letters. Their oposites are calledlower case
letters and are inlower letter case
or simply inlower case
.
- Other types of
character case
includeword capitals
, where eachword
begins with acapital
and continues withlower case
letters;first capital
, where the first letter is acapital
and all others arelower case
letters; andmixed case
, where none of the aboveletter cases
can be determined.
- To
ignore case
is to ignore differences betweenletter cases
likecapitals
andlower case
letters. Whenignoring case
, letter a is equal to letter A, b equal to B, etc. An antonym ofignore case
is tomatch case
and an operation, thatmatches case
iscase sensitive
.
- To
mimic character case
is to try to altercharacter case
of some text based oncharacter case
of the original. Currently only basic types ofcharacter case
are recognized:lower case
,upper case
,word capitals
,first capital
. Everyting else is consideredmixed case
.
- There are also other types of characters recognized by TED notepad:
- A
punctuation character
is any character recognized by Unicode as meant for punctuation purposes, e.g. quotation marks. - A
control character
is a character from the very beginning of the ASCII table. These have special meaning and should be either avoided or treated with care.
- A
- A
string
is a sequence of characters. Typically, suchstring
is used as a synonym for a phrase that a user have entered in a dialog. E.g. Find and Replacestrings
from Search and Replace dialog are always used in find/replace mechanisms.
- A
word
is a non-empty sequence ofalphanums
. Underscores may optionally be included within words, a phrase like hello_world is then also treated as a singleword
. All characters aword
can consist of are calledword letters
orword characters
. Other characters are calledword delimiters
ornon-word characters
. See section General page of the Settings dialog for more information about Underscores in words.
- A
word boundary
is aword
beginning orword
end. This is the place where one of the characters around is aword character
and the other is either anon-word character
or there is no character at all.
- A
line
is a sequence of characters, where twolines
are divided by onenewline
. Note that if Word Wrap is turned on, aline
may be visually wrapped into several visual lines, but within all tools and most features it will still be treated as a single unbrokenline
. Any current visual word-wrapping has seldom impact on howlines
are treated within tools and features .
- An
empty line
is aline
, which consists ofwhite-spaces
only. Therefore anon-empty line
is aline
, which contains at least onegraph
character. Please note that there might be manywhite-spaces
and still theline
would be consideredempty
.
- A
paragraph
is a sequence ofnon-empty lines
. Twoparagraphs
are divided by a sequence ofempty lines
. There is no such thing as emptyparagraph
, since sequences ofempty lines
are always grouped together when determiningparagraphs
.
- A
sentence
is a sequence of characters that begins with acapital
and ends with a Dot, a Question mark or an Exclamation mark. Example: Alice? Who the f... is Alice? are twosentences
, but Alice? Who the f... Is Alice? are threesentences
. Unfortunatelly, even How are you today, Mr. President? is considered as twosentences
.
- A
line column
is part ofline
, which meets certaincolumn criteria
. As these column criteria are applied to subsequentlines
, they determine a logicalcolumn
of text over these lines. The criteria are applied to individuallines
independently, thus possibly determining a column of text, which may be visually hard to identify. Nevertheless, for each individualline
, the column criteria are met.- Note: A
line column
is always one solid line portion, i.e. one line column can never consist of two separate portions of the same line. This is because aline column
is a logical part ofline
, it only specifies where it begins and where it ends on each line. - Applicable column criteria may change from feature to feature and from tool to tool, but they usually include:
- Dividing each
line
into portions usingdelimiting characters
, also calleddelimiters
. These delimiting characters are located within each line and the line is split into portions. A splitting point occurs at any of these characters. These portions are numbered. The criteria then specify, which consequtive portions are to be selected for the line column. Note: Delimiting characters enclosing the selected portions are not included within the line column, but any delimiting characters between the selected portions are naturally included. - Dividing each
line
into portions using adelimiting phrase
. In contrast to thedelimiting characters
, delimiting phrase is always located within each line as a whole sequence of characters, not as a set of individual and interchangeable characters. The line is split into numbered portions wherever this whole delimiting phrase is found. The criteria then specify, which consequtive portions are to be selected for the line column. Note: Delimiting phrases enclosing the selected portions are not included within the line column, but any delimiting phrases between the selected portions are naturally included. - Taking only a portion of each
line
based on arange of characters
. A range of characters is simply a starting and an ending point within the line. All characters between the starting and ending points are selected for the line column. - Certain combinations of the above criteria can be used to further reduce the column. For example, a set of
delimiting characters
can be used to split the line and select only the second part, and then arange of characters
can be used to further reduce that part at its beginning and/or at its end. Note that these criteria are applied in sequence and their results compound, i.e. later criteria obey prior criteria and never try to reach outside of boundaries set by preceding criteria.
- Dividing each
- Note: A
- An
actual insertion point
(also called acurrent caret location
) is a position of the caret in the documnet. It is also the end of the actual selection, if any. Note that the end of the selection is where the user stops selecting the text, therefore if selecting text upwards, the selection end visually preceeds the selection beginning.