home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 551.lha / Lister_v1.01 / lister.doc < prev    next >
Text File  |  1991-09-08  |  6KB  |  143 lines
  1.                    Lister v1.01 Copyright 1991 By:
  2.                 Kerry Cianos & Geoffrey Faivre-Malloy
  3.            Amiga Conversion by ^^^^^^^^^^^^^^^^^^^^^^
  4.                 -------------------------------------
  5.  
  6.   It slices, it dices...Ooops - I've seen too many Ginsu commercials! 
  7. That coupled with the fact that it is 2am in the morning leads to
  8. obsfucated code and docs!  If you can make sense of these things, let us
  9. know how you did it ok?  Promise us that you won't read all of the docs!
  10.  
  11.   BAF! Technologies is proud to present Lister, v1.01.  What is Lister?  It
  12. is a program ( C source code ) that when compiled and linked, will allow
  13. you to look into various archive filetypes and see what files are inside the
  14. archive.  Lister will display information on compressed and uncompressed size,
  15. compaction factor, date and time, and filename.  A total summary will be
  16. printed at the end.  Lister currently supports Arc, Cpio, Lharc, Tar, Zip and
  17. Zoo archive formats.  StuffIt support is in development (you can list StuffIt
  18. files now but no date or time information is displayed). (If you have a
  19. archive program that you would like to see supported, let us know!)
  20.  
  21. Setup
  22. -----
  23.  
  24. 1.  This is the Amiga specific version of Lister although you should be
  25. able to recompile with ease.
  26.  
  27. 2.  Ensure that lister is in your path.
  28.  
  29. 3.  That's it.  You are now ready to run Lister.
  30.  
  31. Operation
  32. ---------
  33.  
  34. To use lister all you have to do is type Lister <filename.[ext]>.
  35.  
  36. Your contents of that file will then be listed to the screen or wherever the
  37. standard output is defined to.  For example, let's suppose you wanted to list a
  38. file called test.lzh:
  39.  
  40. Input: Lister test     or   Lister test.lzh
  41.  
  42. Output:
  43. Lharc Archive test.lzh:
  44.  
  45. ---------------------------------------------------------------------------
  46.   Original  Compress  Ratio       Date         Time    Filename
  47. ---------------------------------------------------------------------------
  48.   388       255       65.7 %  Jun  4th 1991  15:44:40  COMPILE.COM
  49.   2999      1241      41.4 %  Jun  4th 1991  15:38:12  MAIN2.C
  50. ---------------------------------------------------------------------------
  51.   3387      1496      44.2 %         2 files processed.
  52.  
  53.  
  54. Features:
  55.  
  56.  o  Header integrity is not checked.  If the file signature is present then 
  57.     Lister assumes that it is an ok file and proceeds to list the contents. 
  58.     This is not really a bug but we thought we'd mention it anyway.
  59.  
  60.  o  The Zoo lister will list ALL files in the archive including Deleted files.
  61.  
  62. Release Notes:
  63.  
  64.  o  Version 0.99 released to the public for scrutiny.  Testing continues into
  65.     the wee hours of the night.
  66.  
  67.  o  Version 0.99a Major bug in the Zoo routine stomped.  Other "Pointer"
  68.     problems obliterated.
  69.  
  70.  o  Version 0.99b Straightened the code out a bit...
  71.  
  72.  o  Version 1.0 released!  Tar and Cpio formats added.  Corrected problem with
  73.     Lharc List.  Multi-File listing added!  Partial StuffIt support added.
  74.  
  75.  o  Version 1.0.1 - Fixed a bug in Zip listing.  Cleaned up the code a
  76.     bit.  Fixed bug in Lharc lister that would cause some pretty system
  77.     crashes :(  Lister can now be made resident.  It is not re-enterable
  78.     (what does that mean anyway? ).
  79.  
  80. Legal Stuff:
  81.  
  82. Lister is FreeWare and as such may be freely distributed for no money other
  83. than those incurred in copying costs.  Hey, if you use it and like it or even
  84. if you don't like it, send us a postcard!  If you are going to distribute it
  85.                       ^^^^^^^^^^^^^^^^^^ - it isn't that hard is it????
  86.  
  87. with a commercial project drop us a line and get written permission before
  88. doing so.
  89.  
  90. Me (Geoffrey Faivre-Malloy) and him (Kerry Cianos) assume no responsibility
  91. if this program happens to destroy your most precious secrets stored in the
  92. depths of your hard drive.  That's why source is included!  Change it and
  93. play with it.  If you add something you think should be added to the official
  94. version, then send it to us and we'll see what we can do.  If you DO modify
  95. the source, then please keep this source to yourself.  All other legalities
  96. apply.
  97.  
  98. Miscellaneous:
  99.  
  100. If you would like to contact us to report bugs (features) or just to say that 
  101. you REALLY LOVE our program, we can be reached at:
  102.  
  103. ktc0440csci @ apsu . bitnet    -=> Kerry Cianos
  104.  
  105. jjm7609csci @ apsu . bitnet    -=> Geoffrey Faivre-Malloy
  106.  
  107. BIX - mduck
  108.  
  109. Or if our accounts are deactivated for some reason (and we like to hack :) ):
  110.  
  111.   Geoffrey Faivre-Malloy           Kerry Cianos
  112.   223 Forbes Av                    645 Bunker Hill Rd                    
  113.   Clarksville TN, 37040            Clarksville TN, 37042
  114.  
  115.  (Please - Don't send any Letter Bombs)
  116.  
  117. Special Thanks to:  James D. Burnell (who found a bug the first time he ran it)
  118.                     Bob Martin - Sent us the XXEncode/Decode Sources
  119.                     Ed Wilts - Found the Lharc bug.  Also gave us tips on how
  120.                       to make the code look better on a VMS system.
  121.  
  122. Planned Additions:
  123.  
  124. o StuffIt Support
  125. o Shar Support
  126. o Shell - is it even possible???
  127. o Compact Pro (maybe)
  128.  
  129. **Note:  You wanna get mentioned in a famous program that thousands of people
  130. will see???  Be the FIRST to send us the source of the following code for us to
  131. peruse and you will get mentioned!  We need source for:
  132.   - Shell Source
  133.  
  134. Other Products by BAF! Technologies:
  135.  
  136.   Lister is a part of a greater program called Extractor, which in addition
  137. to a more powerful lister, will make the use of a mail-based server (written
  138. with BITFTP in mind) much, much easier.  Extractor will combine mail
  139. files, do UUdecoding and XXdecoding, allow for encoding (both UU and XX),
  140. and have many more features.  Expect Extractor later this summer!
  141.  
  142.                         Extractor Coming Summer '91!
  143.