WhereIsIt? version 2012
Copyright (c) 1997-2012 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 MP3, AAC and WAV audio files as 
    description, including ID3 tags if present. ID3v1 and ID3v2.2-ID3v2.4
    are supported)
* Windows Media Format Files (imports details from the Windows Media files,
    such as ASF, WMA, WMV,... files)
* HTML files (imports some details from HTML file to be used as description,
    for example HTML document's title and description meta tag)
* Archive descriptions (Imports comments embedded in compressed archive
    files, if they support this feature - Zip, Arj, Rar,...)
* 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,...)   
* Adobe Acrobat Documents (extracts document creation details such as title,
    author, etc. and optionally the bookmark tree (index), if available)
* Ogg Multimedia Files (supports Ogg streams, including Ogg Vorbis audio
    files, description tags, including ID3v1 and ID3v2 and Ogg Vorbis' 
    own tags, as well as Ogg Media (*.OGM) audio/video files, including
    embedded subtitles).
* Adobe Illustrator Files (extracts document summary information such as 
    title, author, creation date, and originating software).
* Autocad DWG File Properties (extracts DWG file properties, if available
    in .DWG file. Note that only files created with AutoCAD 2000 (R15)
    or newer support file properties information).
* MPEG-4 Audio/Video Files (imports technical details about MPEG-4 audio
    and video files, as well as ID3-like embedded information used in 
    audio MP4 files).
* AVI Video Files (extracts technical movie details such as resolution,
    compression/codecs used (a database of 600+ codecs is included), 
    bitrate, quality, playtime etc. It also supports three different 
    types of movie info tags, including basic AVI tags, extended INFO 
    tags (abcAVI Tag Editor), and IDIVX tags).
* Monkey's Audio Files (extracts technical details about *.APE and *.MAC 
    files, and includes support for ID3v1, ID3v2, and APE tags).
* Matroska Media Files (extracts technical details about *.MKV files,
    including tags, subtitles, chapters, and attachments).
* FLAC Audio Files (extracts technical details about *.FLAC files, and 
    includes support for ID3v1, ID3v2, and Vorbis Comment tags).
* WavPack Audio Files (extracts technical details about *.WV and *.WVC 
    files, and includes support for ID3v1, ID3v2, and APE tags).
* NTFS File Summary Information (extracts NTFS file properties as 
    description. Only available on disks formatted with NTFS file system).
* Internet Shortcut Files (*.URL)    
* OpenOffice.org Documents (Extracts document properties such as title, 
    subject, author, keywords, comment, statistics...)
* MS Office OpenXML Documents (extracts document properties such as title, 
    subject, author, keywords, comment, statistics...)
+ XML Paper Specification Documents (Extracts document properties such as 
    title,  subject, author, keywords,... from *.XPS files)
* Gadgets and Widgets (extract file description from several different
  gadgets and widget files, including Vista Sidebar gadgets, Yahoo widgets,
  Adobe AIR widgets,...)
* ISO Image Files (imports volume details and size of several types of ISO 
  images)  
* EPUB E-Book Files (extracts title, author, ISBN, contents index...)  

Also included is a set of formatting plugins. Formatting plugins take the
result of description plugins, description text, and convert or filter
it in some way.

* OEM-to-ANSI charset converter (converts text in OEM (DOS) character set
  to its appropriate ANSI representation. Only used with localized text)
* DOS graphics characters filter (converts DOS graphics characters into
  more readable form under Windows. Should only be used if descriptions
  are in plain ANSI text - turn off with localized descriptions as they
  may use localized characters in place where graphics used to be)
* Limited number of lines in description (limits the number of lines
  in imported text to first "n" lines)
* Text optimizing filter (filters out whitespace characters and empty 
  lines through user-definable options, cutting down the size of text
  and improving readability)
* File name character case formatting (allows changing character case
  for cataloged files and folders, i.e. "FILE.TXT", "File.txt", or
  "file.txt")


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.


---------------------------------------------------------------------------
The DescAPI and DescPlugin.dll module are an integral part of the WhereIsIt 
software package and as such a copyrighted material. Using or distributing 
these librarires for any purpose other than running them as a part of 
WhereIsIt is prohibited and in violation of copyright laws.
---------------------------------------------------------------------------