Cascading Portable INI files - Revision history

Jsimlo at 22:30, 4 October 2021

2021-10-04T22:30:47Z

Jsimlo at 11:14, 22 September 2019

2019-09-22T11:14:50Z

Jsimlo: moved Portable INI file to Cascading Portable INI files over redirect

2019-09-22T11:14:00Z

moved Portable INI file to Cascading Portable INI files over redirect

Jsimlo at 11:01, 22 September 2019

2019-09-22T11:01:27Z

Jsimlo at 10:59, 22 September 2019

2019-09-22T10:59:39Z

Jsimlo at 22:12, 1 October 2013

2013-10-01T22:12:00Z

Jsimlo at 22:16, 7 May 2012

2012-05-07T22:16:49Z

Jsimlo at 22:15, 7 May 2012

2012-05-07T22:15:50Z

Jsimlo at 22:14, 7 May 2012

2012-05-07T22:14:52Z

Jsimlo at 22:14, 7 May 2012

2012-05-07T22:14:12Z

@@ Line 1: / Line 1: @@
-<noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
+<noinclude>{{manversion|6.3.0.8|feature}}__NOTOC__</noinclude>
 {{#headline:Saving Config|Cascading Portable INI files}}
-Besides system Registry, TED Notepad offers to save its {{feature|Config}} into a hierarchy of portable INI files instead. These INI files are quite easily manageable, editable and moveable from one computer to another. They can be stored on USB flash disks, and most importantly, they offer possibility to setup different {{feature|Config}} for each different working directory.
+Besides System Registry, TED Notepad offers to save its {{feature|Config}} into a hierarchy of portable INI files instead. These INI files are quite easily manageable, editable and moveable from one computer to another. They can be stored on USB flash disks, and most importantly, they offer possibility to setup different {{feature|Config}} for each different working directory.
-Note: Using INI files prevents using system Registry altogether. One can either use Registry for storing {{feature|Config}}, or benefit from INI files. Also note that unlike INI files, Registry cannot offer per-working-directory {{feature|Config}} storing.
+Note: Using INI files prevents using System Registry altogether. One can either use System Registry for storing {{feature|Config}}, or benefit from INI files. Also note that unlike INI files, System Registry cannot offer per-working-directory {{feature|Config}} storing.
 The INI file must always be named '''{{system|TedNPad.ini}}''' in order to be recognized by TED Notepad. The name is usually {{defined|case insensitive}}, but if using Wine under Linux (or other such emulators), make sure the name is {{defined|case sensitive}}. Common mistake is to name the INI file according to the application exe file. This is wrong, an INI file must always be named {{system|TedNPad.ini}}.
@@ Line 17: / Line 17: @@
 # ''(If not explicitly fobidden)'' Current working directory is searched, i.e. the directory from which the application was launched. If launching the application thru Shortcut on Desktop, it is the ''starting directory'' from the Shortcut's properties dialog. This is the ''tertiary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and loaded values override any previously loaded values (e.g. from the primary and/or secondary INI file locations) wherever they conflict. This is known as {{feature|Cascading Portable INI files}}.
 #* Note: Current working directory is searched by default. This location can however be explicitly fobidden. To deny reading INI file from current working directory, create an INI file in the primary or secondary INI file location, and in section {{string|[Save]}} add line {{string|<nowiki>IniCWD=0</nowiki>}}. This disables the current working directory INI file location.
-# If (and only if) no INI file is found in any searched location, TED Notepad loads {{feature|Config}} from system Registry, particularly user's hive, also known as {{system|HKEY_CURRENT_USER}}. Note: There is no hierarchical loading from system Registry.
+# If (and only if) no INI file is found in any searched location, TED Notepad loads {{feature|Config}} from System Registry, particularly user's hive, also known as {{system|HKEY_CURRENT_USER}}. Note: There is no hierarchical loading from System Registry.
-Upon {{feature|Config}} saving, all modified options and settings are always written to the last location, where an INI file was found upon {{feature|Config}} loading. Even if such INI file was deleted in the meantime. Note: This ''last known'' location is also indicated on the [[Settings page]] of the {{dialog|Settings}} dialog. If no INI file was found in any searched location, {{feature|Config}} is saved back to system Registry.
+Upon {{feature|Config}} saving, all modified options and settings are always written to the last of the cascading locations, where an INI file was found upon {{feature|Config}} loading. Even if such INI file was deleted in the meantime.
 {{tip}} Since each {{feature|Config}} only carries modified options and settings, this hierarchy of primary, secondary and tertiary INI file locations can be used to create hierarchy of global and local {{feature|Config}} sets. While the primary location affects the entire system, the secondary location affects each user separately, and the tertiary location can be effectively used to share project-specific settings and options.

@@ Line 1: / Line 1: @@
 <noinclude>{{manversion|6.0.0.17|feature}}__NOTOC__</noinclude>
-{{#headline:Saving Config|Portable INI file}}
+{{#headline:Saving Config|Cascading Portable INI files}}
 Besides system Registry, TED Notepad offers to save its {{feature|Config}} into a hierarchy of portable INI files instead. These INI files are quite easily manageable, editable and moveable from one computer to another. They can be stored on USB flash disks, and most importantly, they offer possibility to setup different {{feature|Config}} for each different working directory.

@@ Line 13: / Line 13: @@
 # Directory, where the application executable file is stored, is searched. This is the ''primary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and any loaded values override application default values.
-# ''(Only if explicitly requested)'' User profile folder is searched, i.e. the {{system|%UserProfile%}} directory. This is the ''secondary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and loaded values override any previously loaded values (e.g. from the primary INI file location) wherever they conflict. This is known as {{feature|Cascading INI files}}.
+# ''(Only if explicitly requested)'' User profile folder is searched, i.e. the {{system|%UserProfile%}} directory. This is the ''secondary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and loaded values override any previously loaded values (e.g. from the primary INI file location) wherever they conflict. This is known as {{feature|Cascading Portable INI files}}.
 #* Note: User profile folder is not searched by default. This location must be explicitly requested. To request reading INI file from user profile folder, create an INI file in the primary INI file location, and in section {{string|[Save]}} add line {{string|<nowiki>IniUPF=1</nowiki>}}. This enables the user profile folder INI file location.
-# ''(If not explicitly fobidden)'' Current working directory is searched, i.e. the directory from which the application was launched. If launching the application thru Shortcut on Desktop, it is the ''starting directory'' from the Shortcut's properties dialog. This is the ''tertiary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and loaded values override any previously loaded values (e.g. from the primary and/or secondary INI file locations) wherever they conflict. This is known as {{feature|Cascading INI files}}.
+# ''(If not explicitly fobidden)'' Current working directory is searched, i.e. the directory from which the application was launched. If launching the application thru Shortcut on Desktop, it is the ''starting directory'' from the Shortcut's properties dialog. This is the ''tertiary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and loaded values override any previously loaded values (e.g. from the primary and/or secondary INI file locations) wherever they conflict. This is known as {{feature|Cascading Portable INI files}}.
 #* Note: Current working directory is searched by default. This location can however be explicitly fobidden. To deny reading INI file from current working directory, create an INI file in the primary or secondary INI file location, and in section {{string|[Save]}} add line {{string|<nowiki>IniCWD=0</nowiki>}}. This disables the current working directory INI file location.
 # If (and only if) no INI file is found in any searched location, TED Notepad loads {{feature|Config}} from system Registry, particularly user's hive, also known as {{system|HKEY_CURRENT_USER}}. Note: There is no hierarchical loading from system Registry.

@@ Line 13: / Line 13: @@
 # Directory, where the application executable file is stored, is searched. This is the ''primary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and any loaded values override application default values.
-# ''(Only if explicitly requested)'' User profile folder is searched, i.e. the {{system|%UserProfile%}} directory. This is the ''secondary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and loaded values override any previously loaded values (e.g. from the primary INI file location) wherever they conflict.
+# ''(Only if explicitly requested)'' User profile folder is searched, i.e. the {{system|%UserProfile%}} directory. This is the ''secondary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and loaded values override any previously loaded values (e.g. from the primary INI file location) wherever they conflict. This is known as {{feature|Cascading INI files}}.
 #* Note: User profile folder is not searched by default. This location must be explicitly requested. To request reading INI file from user profile folder, create an INI file in the primary INI file location, and in section {{string|[Save]}} add line {{string|<nowiki>IniUPF=1</nowiki>}}. This enables the user profile folder INI file location.
-# ''(If not explicitly fobidden)'' Current working directory is searched, i.e. the directory from which the application was launched. If launching the application thru Shortcut on Desktop, it is the ''starting directory'' from the Shortcut's properties dialog. This is the ''tertiary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and loaded values override any previously loaded values (e.g. from the primary and/or secondary INI file locations) wherever they conflict.
+# ''(If not explicitly fobidden)'' Current working directory is searched, i.e. the directory from which the application was launched. If launching the application thru Shortcut on Desktop, it is the ''starting directory'' from the Shortcut's properties dialog. This is the ''tertiary INI file location''. If an INI file is found here, {{feature|Config}} is read from it, and loaded values override any previously loaded values (e.g. from the primary and/or secondary INI file locations) wherever they conflict. This is known as {{feature|Cascading INI files}}.
 #* Note: Current working directory is searched by default. This location can however be explicitly fobidden. To deny reading INI file from current working directory, create an INI file in the primary or secondary INI file location, and in section {{string|[Save]}} add line {{string|<nowiki>IniCWD=0</nowiki>}}. This disables the current working directory INI file location.
 # If (and only if) no INI file is found in any searched location, TED Notepad loads {{feature|Config}} from system Registry, particularly user's hive, also known as {{system|HKEY_CURRENT_USER}}. Note: There is no hierarchical loading from system Registry.

← Older revision		Revision as of 22:12, 1 October 2013
Line 1:		Line 1:
−	<noinclude>{{manversion\|6.0.0.17}}__NOTOC__</noinclude>	+	<noinclude>{{manversion\|6.0.0.17\|feature}}__NOTOC__</noinclude>
		+	{{#headline:Saving Config\|Portable INI file}}

	Besides system Registry, TED Notepad offers to save its {{feature\|Config}} into a hierarchy of portable INI files instead. These INI files are quite easily manageable, editable and moveable from one computer to another. They can be stored on USB flash disks, and most importantly, they offer possibility to setup different {{feature\|Config}} for each different working directory.		Besides system Registry, TED Notepad offers to save its {{feature\|Config}} into a hierarchy of portable INI files instead. These INI files are quite easily manageable, editable and moveable from one computer to another. They can be stored on USB flash disks, and most importantly, they offer possibility to setup different {{feature\|Config}} for each different working directory.

← Older revision	Revision as of 11:14, 22 September 2019
(No difference)

@@ Line 26: / Line 26: @@
 {{tip}} Setting hidden attribute to the {{system|TedNPad.ini}} file does not affect {{feature|Config}} loading/saving, but effectively hides the excess file from folders.
-'''Administration note''': Consider allowing user profile folder INI file location, if installing TED Notepad to {{system|Program Files}} or {{system|SysDir}} folders and creating an INI file there. Also instruct users to create their own INI files in their user profile folders or create them for them. Users might miss privileges to modify system locations, and may thus end up restricted from saving their settings. Although current working directory location may be sufficient in some cases, it can be very frustrating for most users.
+'''Administration note:''' Consider allowing user profile folder INI file location, if installing TED Notepad to {{system|Program Files}} or {{system|SysDir}} folders and creating an INI file there. Also instruct users to create their own INI files in their user profile folders or create them for them. Users might miss privileges to modify system locations, and may thus end up restricted from saving their settings. Although current working directory location may be sufficient in some cases, it can be very frustrating for most users.
-{{example_start}}{{tip}} Example of INI file enabling secondary and tertiary INI file locations:
+{{example_start}}'''Example:''' INI file enabling secondary and tertiary INI file locations:
 {{example_body}}<nowiki>[Save]
 IniUPF=1    ; User profile folder        ; 1=read ; 0=skip
 IniCWD=1    ; Current working directory  ; 1=read ; 0=skip</nowiki>
 {{example_end}}