home *** CD-ROM | disk | FTP | other *** search
/ Merciful 3 / Merciful_Release_3.bin / software / d / decompressordtypev39.0.lha / DecompressorDT / AutoDocs / decompressor_dtc.doc
Text File  |  1996-09-24  |  3KB  |  69 lines
  1. TABLE OF CONTENTS
  2.  
  3. decompressor/decompressor.datatype
  4. decompressor/decompressor.datatype         decompressor/decompressor.datatype
  5.  
  6.     NAME
  7.     decompressor.datatype -- Special root data type for compressed files.
  8.  
  9.     FUNCTION
  10.     The decompressor.datatype is special DataTypes class for multiformat
  11.     compressed files.
  12.  
  13.     METHODS
  14.     OM_NEW -- Decompress source file, place it in temporary directory and
  15.         call OM_NEW method on that file.
  16.  
  17.     NOTES
  18.     *VERY IMPORTANT NOTE*
  19.     However this is a programmer document, the decompressor.datatype should
  20.     not be used by programmers in general and this information is enclosed
  21.     here just for completness and to satisfy the standards. This datatype
  22.     is considered as a temporary solution and is very likely to become
  23.     obsolete in next revisions of DatyTypes system.
  24.  
  25.     Decompressor.datatype has been written to be as transparent to DataTypes
  26.     system as possible. However, accomplishing this task needed some not so
  27.     system-friendly programming on my part - I was forced to do a patch of
  28.     DisposeDTObject() function of datatypes.library (that is why OM_DISPOSE
  29.     method is not provided). While this is still legal, such a practice is
  30.     generally not recommended. Maybe I will try to remedy the situation by
  31.     possible use of model class in the future.
  32.  
  33.     Actual decompression is performed with help of temporary files, which
  34.     are placed in unique directories on T: logical device and then fed to
  35.     NewDTObject() function.
  36.  
  37.     Due to strange programming of amigaguide.datatype this is not possible
  38.     to properly load and display packed amigaguide databases from within an
  39.     amigaguide database. At this time I can see no workaround for this.
  40.  
  41.     Because filetype recognition is performed via use of xfdmaster.library
  42.     (© Georg Hörmann), number of supported compression formats is not
  43.     predefined - and will automatically enlarge when new, future versions of
  44.     this library are installed to the system.
  45.  
  46.     BUGS
  47.     16 (XFDPF_KEY16) and 32 (XFDPF_KEY32) bit keys as password inputs are
  48.     not supported.
  49.  
  50.     Maximal length of password is 65534, without terminating zero. Unlimited
  51.     length passwords of xfdmaster.library are not supported and will be
  52.     treated as 65535 bytes long (unsigned word) passwords - thus they most
  53.     propably won't work. ;-)
  54.  
  55.     Unfortunately, at a time, decompressor.datatype completely lacks support
  56.     for descriptive error messages. Hopefully I will fix it in final release.
  57.  
  58.     Not my bugs:
  59.     - unable to load packed amigaguide databases from within an amigaguide
  60.       document (this is due to weird programming of amigaguide.datatype)
  61.     - amigaguide path environment variable is not handled properly when
  62.       version 0.7 of HappyENV-Handler (© Martin Gierich) is installed (this
  63.       is due to the fact, that curently this handler lacks support for some
  64.       important dos functions like Seek(), OpenFromLock(), etc.)
  65.  
  66.     SEE ALSO
  67.     xpk.datatype, xfdmaster.library, dos.library
  68.  
  69.