                    The plugin "Named Folders"
                    ~~~~~~~~~~~~~~~~~~~~~~~~~~
                    

[!] Important
[+] New
[-] Fixed error
[*] Changes


----------------------------------------------------------------------------
Version 2.5 release [9.01.2006]
----------------------------------------------------------------------------
[+] Add filter to all menus of variants. If you type "abc cde" in the
menu, then menu will show only variants that contain "abc" AND "cde" in the
path or name of alias. For typing local characters (i.e. russian) press SHIFT.
[+] New configuration parameter "Use single menu mode". 
It specify the behavior of the "cd:a\b" commands. If this flag is set off, 
the plugin shows two menus: first for aliases "a*' and second for paths, 
available for the alias, selected by the user in the first menu. 
If this flag is set on, the plugin shows single menu with all paths 
available for all aliases.
[-] Fixed bug with opening paths which contain russian letters.
[-] Fixed bug in the command "cd: :soft" - russian letters in
the path were stored in the clipboard in the wrong encoding.
[-] It was not possible to set plugin's hotkey for the disk menu.
[-] Buttons Ok and Cancel didn't work in the dialogs in new FAR (alpha 6).
[-] Fixed bug with opening local paths that contain metacharacters
[-] Fixed bug with appearing of double-slashes near the disk letter 
after coping directory to the plugins panel.
[-] The plugin hangs on opening "net:\\abc" from the plugins panel
in the new versions of FAR (alpha 6, build 2060).
[+] New configuration parameter "Aliases mask expand mode". 
You can specify how to expand masks in the local paths. There are three possible
variants: 0: a -> *a*. 1: a -> a*; 2: a -> a.  For example, for "cd:x\a\*b\c": 
0 - *a*\b*\*c*,  1 - a*\b*\c*,  2 - a\b*\c. Names a, b, c, which contain metacharacters,
are not transformed.
[+] There are two modes of the view in the variants menu of "cd: soft" now: 
with and without group name.
[*] New macros "FastPrefix.reg" replaced "FastPanel.reg". 
New macros assign ":" as a hotkey to call the plugin's panel. It automatically 
switches current keyboard layout to the english one (FAR 1.7 alpha 6 is required)
[*] Tree-like mode of catalog's showing was removed.
[*] A state of named folders is checked in the Ctrl+8 panel mode only. 
So all other modes (i.e Ctrl+6) work faster now.
[+] New configuration parameter "Subdirectories as aliases". 
When this mode is switched on, the command "cd:a" will search "a" in the list of aliases 
and in the list of subdirectories of the current directory. All subdirectories are
displayed in the list of aliases as ".\abc".
[*] Search files command (cf) was improved - the cursor of the FAR
panel is set on the selected file now.

----------------------------------------------------------------------------
Version 2.4 beta [22.06.2005]
----------------------------------------------------------------------------
[+] Patterns for commands - general mechanism 
to create short notations for frequently used commands of the plugin.
See help for details.

[-] Several bugs in the command cd:% were fixed
[-] Command "cd: soft param" didn't work correctly, if
the "param" was absolute path to the file.
[+] Now you can stop search of the local paths by 
pressing Esc.
[+] Now you can use two directions of the search in the
mask of local directory. "\" is used to search in subdirectories,
"." is used to search in parent directories. So you can use
such masks as "cd:a\\path", "cd:a..path", "cd:a.*\path", etc.
Note: "." is special symbol now, you should not use it in the names
of shortcuts.

[+] Now it's possible to make global search of local path
(i.e. search without any restrictions of the nesting level).
"cd:sh\*\ab" - search "down"
"cd:sh.*.ab" - search "up"
[*] Hotkeys were added to the settings dialog.
[-] Fixed bugs with "Delete all" and "Skip".
[*] The confirmation of deletion is common for 
deletion of the shortcuts and empty catalogs. There is individual
confirmation for deletion of non-empty catalogs.
[*] The dialog of execution now is not closed
after unsuccessful execution of the command.
[-] Implicit commands were not work correctly
when the name of the catalog was specified (f.e, "cD::cat/")
[+] New form of the command "cd:path" - "cd:.relativepath" (with point) - 
search "relativepath" relatively current directory.
[+] New command "cd:--f sh\path" search files matched to "path"
in the named directory "sh".
[+] New command "cd:--df sh\path" search files and subdirectories
matched to "path" in the named directory "sh"
[+] New reg-files "cs.reg", "cf.reg", "cdf.reg","cc.reg" 
(see subdirectory Patterns) - patterns for commands 
"cd: :soft", "cd:--f ", "cd:--df ", "cd:.\"

----------------------------------------------------------------------------
Version 2.3.3 postrelease [4.04.2005]
----------------------------------------------------------------------------
[-]  Fixed bug in "cd:sh\\\path" - path was searched only on the last 
level, not on all three required levels (the bug was appeared in the case of 
the path without metacharacters).
[+] New possibility to open shortcuts for network directories
through Network plugin. It's useful in the case of network paths protected 
by the password. This feature is switched off by default.
[*] Now the plugin "press" Ctrl+Y before open shortcut 
for virtual directory (to clear current command line content before
sending there keys sequence).
[+'] New feature for command "cd: soft". If you place colon
before soft "cd: :soft" then the plugin store path to current directory 
to the clipboard. It's useful, if you want to open an application and 
save then new file to directory, currently opened in the FAR. 
I.e. "cd: :word".
[+'] Now you can specify disk menu hotkey for Named Folders.
[+'] It's possible now to change the plugin's virtual panel 
view mode settings (only for default mode "Files owners", Ctrl+8). 
In the plugin's configuration set value for "panel mode" like this:
"N,Z,C0;10,0,5" (columns through commas, semicolon, widths for columns).

----------------------------------------------------------------------------
Version 2.3.2 postrelease [21.03.2005]
----------------------------------------------------------------------------
Functionality
~~~~~~~~~~~~~
[+] Now it's possible to execute "cd: soft" with parameters.
Selected application will be executed with these parameters.
Example: "cd: word abc.txt" (to open file "abc.txt" in MsWord)"
[!] Now minimum system requirements for Named Folders are
Win9X/WinNT + IE4.0. The plugin was tested under Win98SE.
[+] New command "cd:path". "Path" must be absolute
local path. So, you can use local drive's letters as shortcuts.
Example: "cd:z:\\a*" 
[+] New TODO page on the Names Folders's site: 
http://www.rammus.ru/?tag=nf_todo
[+] Now it's possible to delete all selected shortcuts
without unnecessary confirmations (DeleteAll button was added). 
[*] Now "cd:abc:sh" with two or more letters in abc is equivalent to "cd:sh".

Fixed bugs
~~~~~~~~~~
[-] Error with creation of the folders with russian names
was fixed.
[-] Names of folders with ampersands in the names
were not correctly displayed in the selection menu. Fixed.
[-] Masks with "[]" didn't work when they contain no more
metachars and "[]" contains two or more characters. Fixed.
Example: :\Tasks\[TD]o[dn][oe]. 
[-] Now "cd:path" is executed as "cd:*path*" if there are no metacharacters
in the path and as "cd:path*" otherwise. I.e. you can search now paths
by first letters in their names.
[-] Fixed several bugs with positioning cursor after
creation folders and refreshing.


----------------------------------------------------------------------------
Version 2.3.1 postrelease [16.08.2004]
----------------------------------------------------------------------------
Functionality
~~~~~~~~~~~~~
[+] Now you can set named folders path in the form
"%environment variable%\related path". E.g. "%windir%\system32".
[*] Now you can omit asterix after last slash in the
local path. I.e. "cd:pf\" is equal "cd:pf"

Fast launching problems
~~~~~~~~~~~~~~~~~~~~~~~
[+] In the command "cd: soft" you can set now "soft" in the
form "group mask\shortcuts mask". E.g. "cd: adobe\*" will find
all shortcuts in all groups which names is matched to "*adobe*" 
[-] Bug with ANSI/OEM characters in the list of 
ignored masks for "cd: soft" was fixed
[-] Switching between ignore-on/off modes in the variants menu 
leaded to closing of menu

Virtual panel
~~~~~~~~~~~~~
[-] It wasn't possible to type R in the command line with 
opened plugins panel.
[-] Fixed several bugs with positioning cursor after
creation (Shift+F4) and copying/moving (F5/F6) of shortcuts.


----------------------------------------------------------------------------
Version 2.3 release [1.08.2004]
----------------------------------------------------------------------------
Fast launching programms
~~~~~~~~~~~~~~~~~~~~~~~~
[+] New possibility to set in the configurations 
list of mask of shortcuts which should be ignored. 
[+] New reg-file "SoftIgnoreMasks.reg" with 
several common masks which should be ignored (*Uninstall*, 
*readme* and *read me*)
[+] Two modes of variants menu: with hidden ignored 
shortcuts and with not hidden. In the last mode there is an 
asterix in the title of menu.
[-] Didn't work fast launching of Excel and Word
[+] Now function of fast launching should work under
all versions of Windows.  
[+] Now it's possible to open directory for selected
shortcut from variants menu. Use  Shift+Enter to open directory 
in Far and  Ctrl+Enter to open it in Explorer
[+] The paths of shortcuts now is displayed as short
as possible (equal path for all variants are not displayed)

Misc
~~~~
[-] Fixed bug with creation of catalogs.
[-] Fixed several bugs with converting between
OEM and ANSI.
[-] Fixed bug with copying directory to plugins panel
(the plugin losts slash between directory name and its path)
[+] Now an asterix in the title of variants
menu is displayed in tree-like mode.
[-] List of appropriated paths in variants menu now
is sorted
[-] Fixed an error with pressing of BACKSPACE on the virtual
panel

Sources
~~~~~~~
[*] From this versions source codes of Named Folders will not
be included in distributive on PlugRing. You can get them if you want on the site 
of the plugin: http://www.rammus.ru
[+] Several XSLT and XML files for autogeneration
of help and readme files were included in source codes.


----------------------------------------------------------------------------
Version 2.3 beta 1 [10.05.2004]
----------------------------------------------------------------------------
Fast launching programs
~~~~~~~~~~~~~~~~~~~~~~~
[+]  New command "cd: soft" (prefix, space, pattern) 
for launching programs from Start menu.
The plugin search all programs shortcuts with names matched to "*soft*"
(or to "soft" if "soft" is already mask), suggest a list of all matched
shortcuts to user and launch selected shortcut.
[!]  New command is experimental. Please send your comments and suggestions.

Support of OEM and ANSI
~~~~~~~~~~~~~~~~~~~~~~~
[-]  Didn't work shortcuts with local chars in the names.
[-]  Shortcuts to the registry key didn't allow to jump to the folders
with local chars in the path.

Misc
~~~~
[-]  Didn't work jumping to the nearest directory.
[-]  Shortcuts for paths like "c:\", "d:\", etc didn't work.
[-]  The states of shortcuts with metacharacters in their paths were
incorrectly displayed as "Not found".
[-]  Now it's possible to freely use "/" instead of "\" in the paths of 
local named folders.


----------------------------------------------------------------------------
Version 2.2.1 postrelease [20.04.2004]
----------------------------------------------------------------------------
[-]  Shortcuts to folders with symbols [] in the paths didn't work. 
[-]  In the Far 1.7 alpha 6 if you opened not exist shortcut and specify 
any local path, the plugin show list of subfolders of the current folder.
[+]  Now, you can directly specify the name of required registry value 
for shortcut to registry key. I.e. You can use "cd:stdu\co" to jump 
to "cookies".

----------------------------------------------------------------------------
Version 2.2 release [15.04.2004]
----------------------------------------------------------------------------
Support of metacharacters in paths
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[+]  Now it's possible to set the depth of the searching in the paths of
local named folders and in the related paths. The depth of the searching
are regulated by the number of slashes. N slashes mean: "search folder 
among all folders with nesting level less or equal N. I.e.:
	"b\a"  - search "a" among subfolders of "b"
	"b\\a" - search "a" among subfolders of "b" and their subfolders.    
	etc.
[+]  Now it's possible to use FAR's metacharacters (?, * and [a-b, z]) in the 
named folders paths. Scope of "*" is NOT spreaded to the subfolders.
You should explicitly specify the depth of the searching by the number of 
slashes.
[!]  Useful examples:
   - Now you can specify single shortcut for all "Program Files" folders
     "pf" = "?:\Program Files" or "[c-d, f]:\Program Files".
   - There is new fast method to jump to the folder, located somewhere in
     the named folder:
     "cd:pf\office", "cd:pf\\vc", "cd:pf\\delphi", "cd:pf\\\atl" etc.

Support of the system directories
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
[+]  Now you can specify the registry key as a path of named folder:
"$HKEY_LOCAL_MACHINE\\Software..." (first character must be "$").
For such named folder the plugin will look through the values of this key,
find all values, which contains paths to exists folders and 
will allow to user select one of these folders.
[!]  Such feature allows us to get access to all system folders
(like "My documents", "History", "Favorites" etc) through the single
shortcut.
[+]  New file  "StdPaths.reg" was added to Named Folders distributive.
This file create shortcuts "stda" and "stdu" for system folders
(for all users and current user correspondingly).

Variants menu
~~~~~~~~~~~~~
[*]  Variants menu was improved. Now you can view catalogs
in two modes: standard and pseudo-treelike :). 
Switch them by F11.

Misc
~~~~
[*]  Method of opening shortcuts for two directories was improved.
Now the plugin always open first directory on the left panel, 
and the second one on the right panel. It doesn't matter which 
panel is currently active. If you open shortcut with pressed Ctrl, 
first directory will be opened on the right panel and so on.
[*]  Shift+Del delete catalogs and shortcuts. 


----------------------------------------------------------------------------
Version 2.1.2 postrelease [4.04.2004]
----------------------------------------------------------------------------
[-]  Now it's possible to use ":" as the prefix of the plugin.
[+]  Now you can save current view mode of the plugin's panel as default one 
by Shift+F9.
[*]  The command "cd:%var" was changed. Now, "var" will be located
not only in the names of environment variables, but also in their paths.
So, the command "cd:%32", for example, will show "c:\windows\system32" 
(from "path"). 

----------------------------------------------------------------------------
Version 2.1.1 release [14.03.2004]
----------------------------------------------------------------------------
[-]  The bug with "&" now is removed completely. 

----------------------------------------------------------------------------
Version 2.1 release [8.03.2004]
----------------------------------------------------------------------------
General
~~~~~~~
[+]  Now you can view state of local directories (exists, partly exists or
    not found) in the "File owners" (Ctrl+8) view mode. 
[-]  The plugin didn't work correctly if the named folders with the "&" in 
    the path was selected.  

Variants menu
~~~~~~~~~~~~~
[+]  Menu was divided on the collumns.
[+]  In the menu with environment variables it's possible now to view 
    variables names. 


----------------------------------------------------------------------------
Version 2.0 release [24.02.2004]
----------------------------------------------------------------------------
Command line
~~~~~~~~~~~~
[*]  Now display mode in the shortcuts menu is stored always. 
[-]  The command "cd::+shortcut" worked incorrectly. 
[-]  The command "cd::catalog/shortcut" didn't work. 

Configuration dialog
~~~~~~~~~~~~~~~~~~~~
[-]  Tab order was corrected. 
[-]  The option "hide temporary shortcuts" was returned. 
[-]  Plugin's prefix wasn't saved. 
[+]  New command: "cd:%var%" to open directory specified in the 
    environment variable "var"; if this variable contains 
    several paths (separated by ";"), the plugin allows to 
    select required path from the list. Incomplete syntax
    of command is supported: for example, you can  
    use "cd:%p" instead of "cd:%path%". 

Virtual panel
~~~~~~~~~~~~~
[-]  Several errors with incorrect positioning of the cursor on the
    FAR panel after operations of renaming and deleting were
    corrected. 
[-]  In the Far alpha 6 it wasn't possible to go to the parent catalog
    through ".." 
[+]  New type of named folder: now you can specify environment
    variable as path to the named folder in the form of "%var%". 
[*]  Character-separator between paths for active and inactive panels 
    in the path of named folders was changed from "\n" to "|".

Misc
~~~~
[-]  The plugin was failed after cancellation of the submenu in the 
    plugins menu. 
[-]  Help and lang files were corrected. 


----------------------------------------------------------------------------
Version 2.0 beta 1 [26.01.2004]
----------------------------------------------------------------------------
General
~~~~~~~
[+]  Catalogs are supported now. 
[*]  Filters were removed.  
[*]  If a shortcut to a non-existing folder is selected, the plugin will suggest
    to go to the nearest existing folder in the shortcut path. 
[!]  Now the site of this plugin are http://www.rammus.ru  

Virtual panel
~~~~~~~~~~~~~
[*]  F7 is opened the dialog for creation catalog. 
[+]  The copping any directory to the virtual panel of the plugin
    will lead to the implicit creation of the shortcut. 
[+]  It's possible to copy and remove catalogs and shortcuts through F5 and F6.
[-]  Now previous view mode of the virtual panel is restored automatically. 

Command line
~~~~~~~~~~~~
[+]  Now it's possible to use metasymbols * and ? in the names of shortcuts,
	catalogs and paths.
[!]  Now in the commands of opening and deleting the names of shortcut 
	in the general case writing as [catalog/][shortcut][\path related named folder].
[+]  New commands to create shortcut for two folders.
    Commands "cd:::shortcut" and "cd::+shortcut" will create, accordingly,
	constant and temporary shortcut for two folders, opened on 
	active and inactive panels.
[+]  New commands for implicit creation of shortcuts: "cd::", "cd:+",
    "cd:::", "cd::+". As the name of shortcut the name of the opened
	directory will be used. 
[-]  New command for implicit deletion of the shortcut: "cd:-".
	This command display menu with the list of shortcuts for 
	currently opened and directory and its subdirectories.
	Selected shortcut will be deleted.
[+]  New command for finding shortcut by the text included in the 
	path of named folder: "cd:~mask". 
[+]  Now it's possible to execute any command through
	"Command execution dialog" (F11 -> Named Folders 2.0 -> Execute command). 
	In contrast to command line, it's possible to skip plugins prefix "cd:"
	in this case. File "ApplyCommand.reg" is allowed to set hot key "Ctrl+D"
	for this dialog. 
[*]  Now it's possible to search shortcuts by Alt+F7. 

Settings
~~~~~~~~
[+]  New confirmations for overriding existing shortcut, deleting catalogs 
	and shortcuts, going to the nearest folder, creating and deleting 
	shortcut implicitly.
[+]  New flag "always show all variants" which define the behavior of the
	plugin in the case, when several shortcuts satisfied to specified
	mask but only one of them satisfied exactly. I.e. user 
	type shortcut name "a" and plugin find shortcuts "a" and "ab". 
	If this flag is ON plugin will display menu with both variants,
	otherwise plugin will open shortcut "a". 

Misc
~~~~
[-]  Now the registry key for saving shortcuts are dependent from the user of FAR.
	(Previously the plugin save all data to 
	HKEY_CURRENT_USER\Software\Far\Plugins\NamedFolders)
[*]  Now the plugin has two default prefixes: "cd" and "cc"


