File page - Revision history

Jsimlo at 00:02, 5 October 2021

2021-10-05T00:02:16Z

Jsimlo: /* {{field|Settings:File|Dialogs}} */

2014-02-24T15:22:00Z

Jsimlo: /* {{field|Settings:File|Default newlines}} */

2013-11-19T11:50:09Z

Jsimlo: /* {{field|Settings:File|Default encoding}} */

2013-11-19T11:49:57Z

Jsimlo at 17:58, 1 October 2013

2013-10-01T17:58:32Z

Jsimlo: /* {{field|Settings:File|Dialogs}} */

2013-10-01T17:25:07Z

Jsimlo: /* {{field|Settings:File|Dialogs}} */

2013-10-01T17:19:35Z

Jsimlo: /* {{field|Settings:File|Default encoding}} */

2013-10-01T17:12:45Z

Jsimlo: /* {{field|Settings:File|Dialogs}} */

2013-10-01T13:31:35Z

Jsimlo at 11:33, 4 July 2012

2012-07-04T11:33:47Z

Show changes

@@ Line 3: / Line 3: @@
 ===={{field|Settings:File|Default encoding}}====
-The {{field|Settings:File|Default encoding}} specifies default
+The '''{{field|Settings:File|Default encoding}}''' setting specifies default
 {{feature|Encoding}} to be used for new documents, or in cases where detection of encoding of a file being loaded is indecisive (e.g. if loading pure ASCII file, encoding can be both ANSI and UTF-8).
@@ Line 12: / Line 12: @@
 * '''{{field|Settings:File|Default encoding: Big Endian}}''', which should always include {{defined|BOM}}.
-The '''{{field|Settings:File|Default encoding: Add BOM (UTF-8 / Unicode)}}''' extends some encodings with {{defined|BOM}} and non-{{defined|BOM}} variants. Note: While some encodings do not allow {{defined|BOM}} at all (e.g. ANSI), other encodings recommend using {{defined|BOM}} (e.g. both Unicodes), and some encodings make {{defined|BOM}} optional (e.g. UTF-8).
+The '''{{field|Settings:File|Default encoding: Add BOM (UTF-8 / Unicode)}}''' setting extends some encodings with {{defined|BOM}} and non-{{defined|BOM}} variants. Note: While some encodings do not allow {{defined|BOM}} at all (e.g. ANSI), other encodings recommend using {{defined|BOM}} (e.g. both Unicodes), and some encodings make {{defined|BOM}} optional (e.g. UTF-8).
 '''Important note:''' If {{defined|BOM}} is recommended for some encoding, omitting it is allowed, but might result in inability to auto-detect correct file encoding upon future file loading. This is especially true with Unicode files. See {{feature|Open File}} for further details about encoding auto-detection and available workarounds.
@@ Line 18: / Line 18: @@
 ===={{field|Settings:File|Default newlines}}====
-The {{field|Settings:File|Default newlines}} specifies default type of {{feature|Newlines}} to be used for new documents, or in cases where detection of newlines of a file being loaded is indecisive (e.g. if loading file with no newlines).
+The '''{{field|Settings:File|Default newlines}}''' setting specifies default type of {{feature|Newlines}} to be used for new documents, or in cases where detection of newlines of a file being loaded is indecisive (e.g. if loading file with no newlines).
 Supported types of default newlines are:
-* The '''{{field|Settings:File|Default newlines: Windows}}'''
+* '''{{field|Settings:File|Default newlines: Windows}}''', i.e. {{string|CR/NL}}, i.e. {{string|13 10}} in ASCII, i.e. {{string|0D 0A}} in hex.
-* The '''{{field|Settings:File|Default newlines: Unix}}'''
+* '''{{field|Settings:File|Default newlines: Unix}}''', i.e. {{string|NL}} only, i.e. {{string|10}} in ASCII, i.e. {{string|0A}} in hex.
-* The '''{{field|Settings:File|Default newlines: Mac}}'''
+* '''{{field|Settings:File|Default newlines: Mac}}''', i.e. {{string|CR}} only, i.e. {{string|13}} in ASCII, i.e. {{string|0D}} in hex.
 See {{feature|Newlines}} for further details on when and how
@@ Line 30: / Line 30: @@
 ===={{field|Settings:File|Dialogs}}====
-The '''{{field|Settings:File|Default file type}}''' specifies, what file extension is to be used by default in the {{feature|Save As}} dialog, if no file extension is specified explicitly. This default file extension may not exceed 4 characters.
+The '''{{field|Settings:File|Default file type}}''' setting specifies, what file extension is to be used by default in the {{feature|Save As}} dialog, if no file extension is specified explicitly. This default file extension may not exceed 4 characters.
 {{tip}} The default file extension for plain-text documents is {{string|txt}}, but users may choose to override this with another value. For example, use {{string|html}}, if creating HTML documents more often than plain-text files.
-The '''{{field|Settings:File|Default path}}''' defines relative or absolute path, which is to be used as a starting point in the {{dialog|Open}} and {{dialog|Save As}} dialogs.
+The '''{{field|Settings:File|Default path}}''' setting defines relative or absolute path, which is to be used as a starting point in the {{dialog|Open}} and {{dialog|Save As}} dialogs.
-* If no path is specified as {{field|Settings:File|Default path}}, the current working directory is used if it contains files which satisfy {{field|Settings:File|Filter strings}} patterns described below. Otherwise, personal files directory of the current user is used as starting point.
+* If no path is specified as {{field|Settings:File|Default path}}, the current working directory is used if it contains files which satisfy the {{field|Settings:File|Filter strings}} patterns described below. Otherwise, personal files directory of the current user is used as starting point.
 * If absolute path is specified, it is used unmodified in all cases.
 * If relative path is specified (e.g. {{string|.}} or {{string|\docs}}), it refers to current working directory. Note: The current working directory is usually the directory which TED Notepad was started from; although shortcuts allow to specify another starting directory for example. Also note that the current working directory no longer changes with every {{dialog|Open}} and {{dialog|Save As}} dialog operations as it did in previous versions of TED Notepad. The current working directory stays the same throughout the entire instance session.
@@ Line 43: / Line 43: @@
 Note: One of the requirements for this to work, is to use correct working directory upon launching TED Notepad from the USB drive. In most typical cases, the system uses the USB drive as the working directory (as expected). However, some file managers and portable launchers may need to be told what working directory to use explicitly. Set them to use the USB drive.
-The '''{{field|Settings:File|Filter strings}}''' define filters, which are to be used in the {{dialog|Open}} and {{dialog|Save As}} dialogs as file filters. These filters appear in a combo-box, usually bellow the file name box. A filter consists of two {{defined|strings}} separated by Pipe character ({{string|<nowiki>|</nowiki>}}).
+The '''{{field|Settings:File|Filter strings}}''' setting define filters, which are to be used in the {{dialog|Open}} and {{dialog|Save As}} dialogs as file filters. These filters appear in a combo-box, usually bellow the file name box. A filter consists of two {{defined|strings}} separated by Pipe character ({{string|<nowiki>|</nowiki>}}).
 The first {{defined|string}} in a filter is a name to be displayed, which describes the filter (e.g. {{string|Text Files}}). The second one specifies a filtering pattern (e.g. {{string|*.txt}}). A filter for text files could look like {{string|Text Files<nowiki>|</nowiki>*.txt}} or {{string|Text Files (*.txt)<nowiki>|</nowiki>*.txt}}.
@@ Line 53: / Line 53: @@
 Example: Default filters are {{string|<nowiki>Text Files (*.txt)|*.txt|All Files|*.*</nowiki>}}
-The '''{{field|Settings:File|Suggest first line as new file name}}''' specifies, whether text from the first non-empty line of the document is to be suggested in the {{dialog|Save As}} dialog as a new file name instead of the default {{string|Untitled}}.
+The '''{{field|Settings:File|Suggest first line as new file name}}''' setting specifies, whether text from the first non-empty line of the document is to be suggested in the {{dialog|Save As}} dialog as a new file name instead of the default {{string|Untitled}}.
 Note: Characters unallowed in file names are automatically converted into dashes.

@@ Line 34: / Line 34: @@
 {{tip}} The default file extension for plain-text documents is {{string|txt}}, but users may choose to override this with another value. For example, use {{string|html}}, if creating HTML documents more often than plain-text files.
-The '''{{field|Settings:File|Default path}}''' defines relative or absolute path, which is to be used as a starting point in the {{dialog|Open}} and {{dialog|Save As}} dialogs. If absolute path is specified, it is used unmodified in all cases.
+The '''{{field|Settings:File|Default path}}''' defines relative or absolute path, which is to be used as a starting point in the {{dialog|Open}} and {{dialog|Save As}} dialogs.
-If relative path is specified (e.g. {{string|.}} or {{string|\docs}}), it refers to current working directory. Note: The current working directory is usually the directory which TED Notepad was started from; although shortcuts allow to specify another starting directory for example. Also note that the current working directory no longer changes with every {{dialog|Open}} and {{dialog|Save As}} dialog operations as it did in previous versions of TED Notepad. The current working directory stays the same throughout the entire instance session.
+{{tip}} A useful example for portable usage is simple back-slash ({{string|\}}) as {{field|Settings:File|Default path}}, which makes the {{dialog|Open}} and {{dialog|Save As}} dialogs start in the root directory of the drive, from which you originally launched the application. This can be used to twist the USB drive around, while moving TED Notepad on the USB drive from one computer to another.
-If no path is specified as {{field|Settings:File|Default path}}, the current working directory is used if it contains files which satisfy {{field|Settings:File|Filter strings}} patterns described below. Otherwise, personal files directory of the current user is used as starting point.
+Note: One of the requirements for this to work, is to use correct working directory upon launching TED Notepad from the USB drive. In most typical cases, the system uses the USB drive as the working directory (as expected). However, some file managers and portable launchers may need to be told what working directory to use explicitly. Set them to use the USB drive.
 The '''{{field|Settings:File|Filter strings}}''' define filters, which are to be used in the {{dialog|Open}} and {{dialog|Save As}} dialogs as file filters. These filters appear in a combo-box, usually bellow the file name box. A filter consists of two {{defined|strings}} separated by Pipe character ({{string|<nowiki>|</nowiki>}}).

@@ Line 20: / Line 20: @@
 The {{field|Settings:File|Default newlines}} specifies default type of {{feature|Newlines}} to be used for new documents, or in cases where detection of newlines of a file being loaded is indecisive (e.g. if loading file with no newlines).
-Supported types of newlines are:
+Supported types of default newlines are:
 * The '''{{field|Settings:File|Default newlines: Windows}}'''
 * The '''{{field|Settings:File|Default newlines: Unix}}'''

@@ Line 4: / Line 4: @@
 The {{field|Settings:File|Default encoding}} specifies default
-{{feature|Encoding}} to be used for new documents, or in cases where detection of encoding of a file being loaded is indecisive (e.g. if loading pure ASCII file, encoding can be both {{field|Settings:File|Default encoding: ANSI}} and {{field|Settings:File|Default encoding: UTF-8}}).
+{{feature|Encoding}} to be used for new documents, or in cases where detection of encoding of a file being loaded is indecisive (e.g. if loading pure ASCII file, encoding can be both ANSI and UTF-8).
-Supported encodings are:
+Supported default encodings are:
 * '''{{field|Settings:File|Default encoding: ANSI}}''', which depends on the System default code page.
 * '''{{field|Settings:File|Default encoding: UTF-8}}''', which can include or exclude {{defined|BOM}}.

@@ Line 7: / Line 7: @@
 Supported encodings are:
-* {{field|Settings:File|Default encoding: ANSI}}, which depends on the System default code page.
+* '''{{field|Settings:File|Default encoding: ANSI}}''', which depends on the System default code page.
-* {{field|Settings:File|Default encoding: UTF-8}}, which can include or exclude {{defined|BOM}}.
+* '''{{field|Settings:File|Default encoding: UTF-8}}''', which can include or exclude {{defined|BOM}}.
-* {{field|Settings:File|Default encoding: Unicode}}, which should always include {{defined|BOM}}.
+* '''{{field|Settings:File|Default encoding: Unicode}}''', which should always include {{defined|BOM}}.
-* {{field|Settings:File|Default encoding: Big Endian}}, which should always include {{defined|BOM}}.
+* '''{{field|Settings:File|Default encoding: Big Endian}}''', which should always include {{defined|BOM}}.
-The {{field|Settings:File|Default encoding: Add BOM (UTF-8 / Unicode)}} extends some encodings with {{defined|BOM}} and non-{{defined|BOM}} variants. Note: While some encodings do not allow {{defined|BOM}} at all (e.g. ANSI), other encodings recommend using {{defined|BOM}} (e.g. both Unicodes), and some encodings make {{defined|BOM}} optional (e.g. UTF-8).
+The '''{{field|Settings:File|Default encoding: Add BOM (UTF-8 / Unicode)}}''' extends some encodings with {{defined|BOM}} and non-{{defined|BOM}} variants. Note: While some encodings do not allow {{defined|BOM}} at all (e.g. ANSI), other encodings recommend using {{defined|BOM}} (e.g. both Unicodes), and some encodings make {{defined|BOM}} optional (e.g. UTF-8).
 '''Important note:''' If {{defined|BOM}} is recommended for some encoding, omitting it is allowed, but might result in inability to auto-detect correct file encoding upon future file loading. This is especially true with Unicode files. See {{feature|Open File}} for further details about encoding auto-detection and available workarounds.
@@ Line 21: / Line 21: @@
 Supported types of newlines are:
-* The {{field|Settings:File|Default newlines: Windows}}
+* The '''{{field|Settings:File|Default newlines: Windows}}'''
-* The {{field|Settings:File|Default newlines: Unix}}
+* The '''{{field|Settings:File|Default newlines: Unix}}'''
-* The {{field|Settings:File|Default newlines: Mac}}
+* The '''{{field|Settings:File|Default newlines: Mac}}'''
 See {{feature|Newlines}} for further details on when and how
@@ Line 30: / Line 30: @@
 ===={{field|Settings:File|Dialogs}}====
-The {{field|Settings:File|Default file type}} specifies, what file extension is to be used by default in the {{feature|Save As}} dialog, if no file extension is specified explicitly. This default file extension may not exceed 4 characters.
+The '''{{field|Settings:File|Default file type}}''' specifies, what file extension is to be used by default in the {{feature|Save As}} dialog, if no file extension is specified explicitly. This default file extension may not exceed 4 characters.
 {{tip}} The default file extension for plain-text documents is {{string|txt}}, but users may choose to override this with another value. For example, use {{string|html}}, if creating HTML documents more often than plain-text files.
-The {{field|Settings:File|Default path}} defines relative or absolute path, which is to be used as a starting point in the {{dialog|Open}} and {{dialog|Save As}} dialogs. If absolute path is specified, it is used unmodified in all cases.
+The '''{{field|Settings:File|Default path}}''' defines relative or absolute path, which is to be used as a starting point in the {{dialog|Open}} and {{dialog|Save As}} dialogs. If absolute path is specified, it is used unmodified in all cases.
 If relative path is specified (e.g. {{string|.}} or {{string|\docs}}), it refers to current working directory. Note: The current working directory is usually the directory which TED Notepad was started from; although shortcuts allow to specify another starting directory for example. Also note that the current working directory no longer changes with every {{dialog|Open}} and {{dialog|Save As}} dialog operations as it did in previous versions of TED Notepad. The current working directory stays the same throughout the entire instance session.
@@ Line 42: / Line 42: @@
 {{tip}} A useful example for portable usage is simple back-slash ({{string|\}}) as {{field|Settings:File|Default path}}, which makes the {{dialog|Open}} and {{dialog|Save As}} dialogs start in the root directory of the drive, from which you originally launched the application. This can be used to twist the USB drive around, while moving TED Notepad on the USB drive from one computer to another. Note: One of the requirements for this to work, is to use correct working directory upon launching TED Notepad from the USB drive. In most typical cases, the system uses the USB drive as the working directory (as expected). However, some file managers and portable launchers may need to be told what working directory to use explicitly. Set them to use the USB drive.
-The {{field|Settings:File|Filter strings}} define filters, which are to be used in the {{dialog|Open}} and {{dialog|Save As}} dialogs as file filters. These filters appear in a combo-box, usually bellow the file name box. A filter consists of two {{defined|strings}} separated by Pipe character ({{string|<nowiki>|</nowiki>}}).
+The '''{{field|Settings:File|Filter strings}}''' define filters, which are to be used in the {{dialog|Open}} and {{dialog|Save As}} dialogs as file filters. These filters appear in a combo-box, usually bellow the file name box. A filter consists of two {{defined|strings}} separated by Pipe character ({{string|<nowiki>|</nowiki>}}).
 The first {{defined|string}} in a filter is a name to be displayed, which describes the filter (e.g. {{string|Text Files}}). The second one specifies a filtering pattern (e.g. {{string|*.txt}}). A filter for text files could look like {{string|Text Files<nowiki>|</nowiki>*.txt}} or {{string|Text Files (*.txt)<nowiki>|</nowiki>*.txt}}.
@@ Line 52: / Line 52: @@
 Example: Default filters are {{string|<nowiki>Text Files (*.txt)|*.txt|All Files|*.*</nowiki>}}
-The {{field|Settings:File|Suggest first line as new file name}} specifies, whether text from the first non-empty line of the document is to be suggested in the {{dialog|Save As}} dialog as a new file name instead of the default {{string|Untitled}}.
+The '''{{field|Settings:File|Suggest first line as new file name}}''' specifies, whether text from the first non-empty line of the document is to be suggested in the {{dialog|Save As}} dialog as a new file name instead of the default {{string|Untitled}}.
 Note: Characters unallowed in file names are automatically converted into dashes.

@@ Line 38: / Line 38: @@
 If relative path is specified (e.g. {{string|.}} or {{string|\docs}}), it refers to current working directory. Note: The current working directory is usually the directory which TED Notepad was started from; although shortcuts allow to specify another starting directory for example. Also note that the current working directory no longer changes with every {{dialog|Open}} and {{dialog|Save As}} dialog operations as it did in previous versions of TED Notepad. The current working directory stays the same throughout the entire instance session.
-If no path is specified as {{field|Settings:File|Default path}}, the current working directory is used if it contains files which satisfy {{field|Filter strings}} patterns described below. Otherwise, personal files directory of the current user is used as starting point.
+If no path is specified as {{field|Settings:File|Default path}}, the current working directory is used if it contains files which satisfy {{field|Settings:File|Filter strings}} patterns described below. Otherwise, personal files directory of the current user is used as starting point.
 {{tip}} A useful example for portable usage is simple back-slash ({{string|\}}) as {{field|Settings:File|Default path}}, which makes the {{dialog|Open}} and {{dialog|Save As}} dialogs start in the root directory of the drive, from which you originally launched the application. This can be used to twist the USB drive around, while moving TED Notepad on the USB drive from one computer to another. Note: One of the requirements for this to work, is to use correct working directory upon launching TED Notepad from the USB drive. In most typical cases, the system uses the USB drive as the working directory (as expected). However, some file managers and portable launchers may need to be told what working directory to use explicitly. Set them to use the USB drive.
@@ Line 48: / Line 48: @@
 To specify multiple filtering patterns for single filter, use semicolon to separate the patterns (e.g. {{string|*.txt;*.doc;*.bak}}). Filtering pattern can be a combination of valid filename characters and an asterisk wildcard character. Do not include spaces in the pattern {{defined|string}}.
-Several filters are to be delimited by a Pipe character
+Several filters are to be delimited by a Pipe character ({{string|<nowiki>|</nowiki>}}). Therefore {{field|Settings:File|Filter strings}} value should eventually consist of pairs of {{defined|strings}} delimited by Pipe characters. Each pair defines one filter: a name and its filtering pattern.
-The {{field|Settings:File|Suggest first line as new file name}} specifies, whether text from the first non-empty line of the document is to be suggested in the {{dialog|Save As}} dialog as a new file name instead of the default {{string|Untitled}}. Note: Characters unallowed in file names are
+Example: Default filters are {{string|<nowiki>Text Files (*.txt)|*.txt|All Files|*.*</nowiki>}}
 automatically converted into dashes.