**************************************************************************

 - THE LEGENDARY >> SUBSOFTWARE << IN 90 !!!
 ===========================================


                   - CONTACT US
 
                     - BP: 36 -
                   - 1380 REBECK -
                    -  BELGIUM -

              - DON'T SEND ANY DISKS -

**************************************************************************

==============================================================================

        WhatIs This File ?              V1.2
        © J.Tyberghein                  Thu Jan 11 23:13:30 1990

==============================================================================



Preface
-------
  This utility gives you all useful information it can obtain from the file.
  WHATIS recognizes IFF files, object files and executables (hunks),
  Aztec object files, crunched data files (with the PowerPacker), archives
  like ZOO, ARC and ArcFiles (my own archiver), UUEncoded files, .info files,
  Lattice PGTB files and Warp files (disk warper). In addition it will
  print all system information for this file.
  If you specify a device or directory instead of a file, you get more
  system information.
  If WHATIS doesn't recognize your file, it will check if the file could
  be ASCII.

  This program (WHATIS V1.2) is shareware.
  If you like and/or use this utility I would appreciate it very much
  if you'd send me a contribution of $10 US ($15 if you want to get a new
  update (when one is available)).
  Please send money by international money order, EuroCheck (in Belgian
  Francs (BF) !) or cash, because it's very difficult for me to cash in
  other checks.
  If you want an update please state your current version.
  If you want to use this program for commercial purposes please write
  for permission !

  If you have any suggestions or remarks you can write to (Bug reports are
  welcome too)

                            Jorrit  Tyberghein
                             Hepmansbossen 31
                           3990 Meerhout BELGIUM

  New in 1.2:
    Support for ATAK,RLSE,VHDR,SHDR,CAMG,CRNG and FONS chunks (for IFF files)
    ASCII and DIAG options.

  WARNING:
    If you want to use this utility you must have Arp 1.3 or later.
    WHATIS is reexecutable so you can use it with ARes, Resident, ...
    WHATIS is not reentrable, so you will get a warning from ARes or Resident
    if you try to use this program twice at the same time.
    There are still some unsupported hunks in object files. These occure in
    some new Lattice object files. As soon as I have information about these
    new hunks, these shortcomings will be removed.



Syntax
------

  +----------------------------------------------------------------+
  | Commandline template:                                          |
  |   File/a,S=SHORT/s,M=MEDIUM/s,F=FULL/s,D=DIAG/s,A=ASCII/k:     |
  |----------------------------------------------------------------|
  | Usage:                                                         |
  |   WhatIs <File> [SHORT | MEDIUM | FULL | DIAG | ASCII [<len>]] |
  +----------------------------------------------------------------+

    File   : You want info about <File>
    SHORT  : Standard file info
    MEDIUM : SHORT and other info (default)
             The file will be examined.
    FULL   : MEDIUM and diagnostic info
    DIAG   : Only diagnostic info
    ASCII  : Dump ascii in file
    Len    : Minimum linelength for ASCII dump (default 6)


  examples:

    WhatIs KingTut            (KingTut is a graphic image)
      you will get the following output (or something equivalent):

      |  FileInfoBlock:
      |     File         : KingTut
      |     DirEntryType : -3
      |     Protect      : dewr
      |     Size         : 25728       NumBlocks : 51
      |     Last changed : 15-Oct-89 10:54:52 (Sunday)
      |     Comment      :
      |
      |  IFF file
      |    FORM  ILBM   (25720 data bytes)
      |      Interleaved BitMap
      |      BMHD
      |        width   :   320     height  :   200
      |        x       :     0     y       :     0
      |        nPlanes :     5     Masking :     0
      |        xAspect :    10     yAspect :    11
      |        PageWid :   320     PageHei :   200
      |        Compression       : 1
      |        transparent color : 0
      |      CMAP  (96 bytes)
      |      DPPS
      |      CRNG
      |        Rate :     0     Flags : RNG_ACTIVE
      |        Low  :    20     High  :    31
      |      CRNG
      |        Rate :  2730     Flags : RNG_ACTIVE
      |        Low  :     3     High  :     7
      |      CRNG
      |        Rate :  2730     Flags : RNG_ACTIVE
      |        Low  :     0     High  :     0
      |      CRNG
      |        Rate :  2730     Flags : RNG_ACTIVE
      |        Low  :     0     High  :     0
      |      BODY

    WhatIs file.c s
      you get only the basic information

      |  FileInfoBlock:
      |     File         : file.c
      |     DirEntryType : -3
      |     Protect      : dewr
      |     Size         : 146       NumBlocks : 1
      |     Last changed : 17-Dec-89 20:37:04 (Sunday)
      |     Comment      : This is an example file

    WhatIs ram:

      |  FileInfoBlock:
      |     Directory    : RAM DISK
      |     DirEntryType : 2
      |     Protect      : dewr
      |     Size         : 0       NumBlocks : 1
      |     Last changed : 18-Dec-89 17:29:22 (Monday)
      |     Comment      :
      |
      |  InfoData:
      |     UnitNumber    : -1
      |     NumSoftErrors : 0
      |     NumBlocks     : 3       NumBlocksUsed : 3
      |     BytesPerBlock : 488
      |     Disk is validated
      |     Dos disk
      |     Disk in use
      |
      |  DeviceList:
      |     Volume
      |     Creation date : 01-Jan-78 00:00:61 (Sunday)
      |     DiskType      : 444F5300

    WhatIs c:WhatIs f
      Give full information

      |  FileInfoBlock:
      |     File         : WhatIs
      |     DirEntryType : -3
      |     Protect      : dewr
      |     Size         : 14940       NumBlocks : 30
      |     Last changed : 17-Dec-89 17:07:02 (Sunday)
      |     Comment      : © J.Tyberghein
      |
      |  Executable file
      |     Hunk   0 : header
      |                   Resident libraries:
      |                   Table size : 2
      |                   First Hunk : 0
      |                   Last Hunk  : 1
      |                code    (14568 bytes)
      |                reloc32 (1 entries)
      |                end
      |     Hunk   1 : data    (160 bytes)
      |                reloc32 (2 entries)
      |                end
      |
      |  Diagnostic research...
      |     Resource usage:
      |        arp.library
      |        dos.library
      |     Byte count:
      |        8705 normal characters (58 %)
      |        2691 non ascii characters (18 %)
      |        3455 control codes ( <32 ) (23 %)
      |        164 lines

    WhatIs disk.info

      |  FileInfoBlock:
      |     File         : Disk.info
      |     DirEntryType : -3
      |     Protect      : dewr
      |     Size         : 5449       NumBlocks : 11
      |     Last changed : 15-Oct-89 10:21:01 (Sunday)
      |     Comment      :
      |
      |  .info file  version 1
      |     icon gadget:
      |        LeftEdge 406, TopEdge 23
      |        Width 141, Height 74
      |        Flags GADGHIMAGE, Activation RELVERIFY GADGIMMEDIATE
      |        GadgetType BOOLGADGET
      |     DiskObject type WBDISK
      |     Current X 406   Current Y 23

    WhatIs II.smus

      |  FileInfoBlock:
      |     File         : II.smus
      |     DirEntryType : -3
      |     Protect      : dewr
      |     Size         : 1456       NumBlocks : 3
      |     Last changed : 03-Nov-89 15:05:22 (Friday)
      |     Comment      :
      |
      |  IFF file
      |    FORM  SMUS   (1448 data bytes)
      |      Simple Musical Score
      |      SHDR
      |        Tempo  : 16047
      |        Volume :   127     ctTrack :   4
      |      NAME  Sphere
      |      SNX1
      |      INS1  sphere
      |      INS1  human
      |      INS1  SynthiI
      |      INS1  explosion
      |      INS1  no
      |      INS1  EffectII
      |      INS1  synthiII
      |      INS1  BassdrumI
      |      INS1  SphereI
      |      TRAK
      |      TRAK
      |      TRAK
      |      TRAK

    Whatis c:avail a 8
        Show all ascii lines with length greater than 8 and the offsets
        in the file.

      |  Ascii listing:
      |  00000064: PONudos.library
      |  00000074: you need arp.library
      |  000001E6: NuUsage: Avail [CHIP|FAST] [TOTAL] [FLUSH]
      |  00000211: CHIP/s,FAST/s,TOTAL/s,FLUSH/s
      |  0000022F: Avail: %s
      |  0000023A: Type  Available    In-Use   Maximum   Largest
      |  00000268: %s %9ld %9ld %9ld %9ld

==============================================================================

                         End of WHATIS 1.2 document

==============================================================================