WhereIsIt? version 3.

93 Copyright (c) 1997-2008 Robert Galle All Rights Reserved GENERIC TEXT FILE DESCRIPTION PLUGIN ==================================== This module includes two description plugins, capable of capable of automatically importing user-defined text files as descriptions for either parent items (folders) or files themselves during media scan. This feature was in high demand among WhereIsIt users, however it is likely to produce much longer catalog files with importing more or less irrelevant text. Because of that, this plugin is not officially a part of WhereIsIt and is not supported in any way. Use on your own responsibility! INSTALLING THE PLUGIN ===================== Copy the "GenTextPlugin.dll" file in subfolder "Plugins" in WhereIsIt's main folder, for example, "C:\Program Files\WhereIsIt\Plugins". When WhereIsIt is run the next time, it will recognize and include the new plugin module. HOW TO USE IT ============= In order to setup either of the two plugins included in this module, select "Description Settings" option in program's "Settings" menu, select to view available plugins, highlight the "Generic Text File Descriptions" or "Text File Importer" plugin on the list, and click the "Configure" button. This will bring up plugin's own setup dialog. You can define a list of files or file masks to look for when scanning the media, and import them as description for either their parent item (disk, if file is located in root folder, otherwise parent folder), or for the file itself. Files listed are expeted to be text files. Files or file masks listed first have higher priority - for example, if you have listed "*.txt" and "read.me" files to be imported as description, plugins will first look for any .txt file. When using file masks like "*.txt", program will import first found file that matches the mask. For example, to ensure that "Readme.txt" file is always used where more .txt files are available, use priority to specify "Readme.txt" first, and "*.txt" second. LIMITATIONS =========== WhereIsIt descriptions are limited to user defined settings between 4 KB and 32 KB of text - if imported text file is longer, only the first part of file up to the limited site will be used for description. Note that abusing this plugin can make catalog files a lot larger. Even 4 KB of text is a lot, proper and meaningful description should not be longer than a few lines in order not to waste precious catalog file space and burden the program with lots of mostly useless text. For your reference, one single imported description with 32 KB of text takes in catalog as much as about 2000 cataloged files or folders! It is strongly recommended that imported descriptions are edited in order to keep only relevant data for an useable description. HISTORY ======= 2.02 (13. June 2008)

----------------------* Added support for storing settings to configuration files. 2.01 (28. January 2008) ----------------------* Changed to leave empty lines in imported descriptions. Text Optimizer formatting plugin can be used to remove empty lines if so desired. 2.00 (21. October 2007) ----------------------* Support Unicode file names. * Imports Unicode text files in different encodings as Unicode descriptions. 1.10 (6. January 2005) ---------------------* Added support for importing Unicode encoded text files. 1.00 (23. January 2001) ----------------------* Reimplemented the plugin to use DescAPI 2.0 support in WhereIsIt 3.xx and combined two previously used plugins in the same module, one importing text files as descriptions for their parent items, and the other for files themselves. 0.91 (2. April 1999) -------------------* fixed registry path where plugin stores its settings, the previous version has used inapropriate registry key by mistake. 0.90 (14. March 1999) --------------------+ initial release