WhereIsIt? version 2.15
Copyright (c) 1997-2000 Robert Galle
All Rights Reserved


MAIN DESCRIPTION MODULE
=======================
The main description module (DescPlugin.dll) is the heart of WhereIsIt's
description importing capabilities. It includes a number of description
plugins, including the following ones:

* File_id.diz descriptions (imports File_id.diz files as descriptions for 
    parent folders or archive files)
* Files.bbs description files (imports the contents of Files.bbs files as
    descriptions for files and folders located in the same folder, or in
    other folders if full path to item is provided)
* Index.txt description files (imports the contents of Index.txt, 
    00index.txt,Catalog.txt,DirInfo,... and similar files as descriptions 
    for files and folders located in the same folder, or in other folders 
    if full path to item is provided. List of file names checked is user-
    configurable)
* Descript.ion descriptions (imports the 4DOS/NDOS description file for
    files and folders located in the same folder)
* 32-bit executable files (imports appended version information as 
    description for 32-bit executable files, such as .exe, .dll, .vxd...
* Audio files (imports details about WAV or MP3 audio files as description,
    including ID3 tags if present)
* HTML files (imports some details from HTML file to be used as description,
    for example HTML document's title)
* Archive descriptions (Imports comments embedded in compressed archive
    files, if they support this feature - Zip, Arj, Rar,...)
* Audio CD tracks (imports information about Audio CD track as description,
    such as track's play time. Also checks the CD Player's database if more
    details are available, such as track title, or CD disk details)
* CDDB Audio CD Information via Internet (retrieves details about current
    Audio CD from CDDB server on the Internet)
* TTF fonts (extracts font name, style, and copyright notes from true type 
    font files)    
* MS Office documents (Word, Excel, PowerPoint - extracts document summary
    information such as title, subject, author, keywords, comment,...)
* Visio documents (extracts document summary information such as title, 
    subject, author, keywords, comment,...)
* Word Perfect documents, version 7.0 or never (extracts document summary
    information such as title, subject, author, keywords, comment,...)
* Quattro Pro documents, version 6.0 or never (extracts document summary
    information such as title, subject, author, keywords, comment,...)   


INSTALLING THE PLUGINS
======================
Since the DescPlugin.dll module is a part of WhereIsIt program it is 
installed together with the application itself. Just as any other 
plugin it is expected be located in subfolder "Plugins" in WhereIsIt's 
main folder; for example, "C:\Program Files\WhereIsIt\Plugins". No
other installation is necessary, except maybe personalizing some settings
for individual plugins that offer configurable parameters.


USAGE NOTES
===========

CDDB Audio CD plugin
--------------------
In order to use this plugin you must have active Internet connection at
the time your Audio CD is added or updated in the catalog, and the
Wininet.dll library available on your system. The latter shouldn't be
a problem unless you are using one of the earliest version of Windows
95 (pre-OSR2). Please note that if your Audio CD is being used by some
other application at the time WhereIsIt tries to import CDDB details
(for example being played by CD Player), chances are that WhereIsIt will 
not be able to access CD and retrieving description will not be successful.

There are two plugins available for Audio CD disks, besides CDDB plugin
there is also the generic Audio CD plugin. If you want to import CDDB
data, make sure the CDDB plugin has higher priority than Audio CD plugin,
otherwise generic audio track data will be imported by Audio CD plugin
instead.

CDDB server address to be used is configurable and can be set in plugin's
config dialog (you can retrieve the list of all available CDDB servers on
this address: http://www.cddb.com).

In some cases CDDB server can return inexact hits, or multiple hits. This
plugin will by default ignore them both and rather leave the description 
empty than taking chances to import details for the wrong CD. Alternatively,
you can also setup the CDDB plugin in its config dialog to stop in such 
cases and present to user a dialog where he can select appropriate entry 
out of possible ones as presented by CDDB server. Please note that enabling
such options may interfere with scanning the media, and may cause problems
if program is expected to work on its own, for example with scheduled auto-
matic updates.
Cases of multiple hits are fairly rare to encounter though, large majority 
of entries in CDDB database are unique.