@database WhatIs.Guide
@author "BLOODROCK / SYNDICATE"
@$VER: WhatIs guide 1.03 (2.3.94)
@wordwrap
@node Main "WhatIs: Contents"
@next requirements

WhatIs V 1.03 -short docs
-------------------------

@{" Requirements " link "requirements"}
@{" Usage " link "usage"}
@{" History " link "history"}

@endnode

@node history "WhatIs history"
@next Main
@prev usage

History:

V1.03: You may quote filenames now.
       WhatIs now shows all packed files highlighted instead of only
       highlighting decrunch.library supported file types.
       WB startup code fixed.
       WhatIs stays 512 bytes in size (it gets difficult to keep this.. :^)

V1.02 is 4 bytes smaller now (512 bytes only). This brings you the big
      advantage of having an additional extralarge amount of 512 bytes
      free harddisk space :^)                                ---

V1.01 shows crunched files highlighted.

@endnode
@node usage "Using WhatIs"
@next history
@prev requirements

Sorry for the name, there are several tools already existing with the same
name, but WhatIs just matches best. :^)

WhatIs is a little tool for identifying files using the FileID.library.
For further information please read the library documentations.

Usage:
------

WhatIs is a very small tool, made for CLI usage. It's text outputs are
shrunk to one single line, so you may prefer to assign it to a DirOpus
gadget. Therefor, WhatIs can be made resident for higher script execution
speeds. Just add the following command to your user-startup (if you like!):

Resident WhatIs PURE ADD

Then, yo may call WhatIs like this:

WhatIs <filename>

Example:

WhatIs DH0:Sound/Modules/unknown

If the file is packed, the description string is highlighted.

Please note that checking several files from a CLI script (DirOpus) is not
done very fast, even when FileID.library identifies files extremly quick.
Lots of important system functions slow down the execution of such scripts,
like allocating/freeing several memory locations etc.
@endnode
@node requirements "WhatIs: requirements"
@next usage
@prev Main

WhatIs requires FileID.library stored in the libs: drawer. No further system
requirements, also no further requirements using FileID.library. Both run
on every Amiga. If you want to use the libraries locale function, you just
have to install Workbench 2.1+ and the right FileID locale catalog.

Note: if you discover that WhatIs's PURE bit isn't set (e.g. if you extracted
the archive without using LHA's "-a" option) you may set the PURE bit yourself
without any risks. In CLI, just type:

Protect WhatIs P ADD

or use your favourite DOS manager to do the job.

@endnode
@node dummy
@endnode