home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / tempest.lha / msgfle26.lha / README.FILEARC < prev    next >
Text File  |  1993-05-19  |  13KB  |  271 lines
  1.                       The Technician presents :
  2.  
  3.  
  4.                   The FileListing Archiving Module!
  5.  
  6.                                  V2.5
  7.  
  8.   ******   New Version Notes Towards the bottom of this README file
  9.  
  10.  
  11. IMPORTANT NOTE:
  12.    Do  NOT  assign  the  FILEARC:   or MSGARC:  to VDK:, or any device
  13. mounted  as  a device using the VDK-Handler !!!!  It has been found to
  14. totally  crash  LHA  &  ZIP  on  a regular basis !!!  Use RAM:  or the
  15. actual Hard Drive !
  16.  
  17.                                 NOTES:
  18.  
  19.    This  module  works  very  similar to the Message Archiving Module,
  20. except that (obviously) it works with the file listings instead of the
  21. messages.   Much to everyone's disappointment i'm sure, I was NOT able
  22. to  use  the  view mode 5 method of listing files.  It just plain took
  23. way  to  long, since I have to do alot of checks & string manipulation
  24. to  get it to work right.  Instead, I chose the simple (Read FAST) way
  25. to  do  it.   Simply insert the first 40 or so characters of the desc.
  26. That way it's all on one line, and makes a very clean looking listing.
  27.  
  28.    REGISTRATION:
  29.  
  30.    Nothing  like an old subject, but I would appreciate a registration
  31. for  this.  UNLIKE other utils I've written, this one is optional, and
  32. for  ONE reason.  I cannot honestly say this is a program that I wrote
  33. 100%  by  myself.   I  basically  used  Tim's  Message Archiver code &
  34. Converted  it  to run with files instead of messages.  Not easy, but I
  35. did  manage  to  do  it.  For that reason, this IS and CAN BE a public
  36. release.   This  may  be posted on ANY BBS system, as long as there is
  37. not  a  charge  for  it.  An exception to this would be if 100% of the
  38. charge  for it is sent to me for registration.  I don't do many public
  39. releases, largely because of the time I spend programming.
  40.  
  41.       To register for this program, simply send $5.00 (Or whatever you
  42. feel it's worth) US MONEY to :
  43.  
  44.                        NiteFall BBS/Rick Rumer
  45.                        3319 Hickman Road
  46.                        Des Moines, IA, USA
  47.                        50310
  48.  
  49.                        ATTN: Util Registration!
  50.  
  51.    SETUP:
  52.  
  53.    All you have to do to activate this is assign FILEARC:  to the SAME
  54. area  you  have  MSGARC:  assigned.  (I use RAM:, but I have 9 Megs of
  55. memory.   Keep in mind you MUST have room for the file, as well as the
  56. archive if the user requests it!)
  57.    You  must  then  copy  the  FileArc.MOD  file  to  your BBS:Modules
  58. directory.   To  call  it from the file menu with the command FILEARC,
  59. you would put this in your FileMENU.OPT file:
  60.  
  61. [*,*,*,*,*]    = FILEARC      |MODULE          |FileArc.MOD
  62.  
  63.    Of course, you can ALSO call it as a DOOR program, in which in some
  64. text file, you would do this:
  65.  
  66. ~TD(BBS:MODULES/FILEARC.MOD)
  67.  
  68.    Adjust  your  paths according to whatever your setup requires.  The
  69. MOD  will read the path to your catalogs correctly no matter what path
  70. you use, as I check for that in the code.
  71.  
  72.    BUGS:
  73.  
  74.    As  far as I know, all security checks are still valid, and no bugs
  75. exist.   If  you  should find one, please let me know ASAP on NiteFall
  76. BBS  (515)  277-1320.  File Area 0 checks re-vamped by Tim Hatzenbeler
  77. December 1991.
  78.  
  79. The Technician    5-7-93
  80.  
  81. ************************************************************************
  82. CHANGES:
  83.  
  84. 1)  Instead  of  asking for compression method in advance, it now asks
  85. you  AFTER you have seen the file size....  Just made more sense!  I'd
  86. either  have  people downloading a 300K file with no compression, or a
  87. 1k  file  with  the  longest  compression...   Now  users  can  make a
  88. decision, instead of guessing...
  89.  
  90. 2) Since InsertAd (Originally by me, massive updates by Professor) has
  91. become  so  popular,  I  had  to  make some adjustments to the FileArc
  92. module  as  well  as the MessageArc Module...  The only way to disable
  93. the  ZIP  adding  in  InsertAd is to delete the command C:ZIP ...  But
  94. suppose  you want ZIP active for the file archiver/message archivers ?
  95. I found a solution.  Simply rename your C:ZIP file to C:ZZIP .  I have
  96. BOTH  the  message  & file archivers check for that before saying they
  97. can't choose that option.  If it can't find either name, then ZIP will
  98. not  be  used.  If you don't use insertad, then you can have either or
  99. both  names  present.   C:ZIP  is  checked first, so achieves slightly
  100. better  speed  in  finding  the command...
  101. (Maybe a difference of .1 sec)
  102.  
  103. 3)  BIG  CHANGE...  LHA & ZIP are the ONLY supported archiving methods
  104. now...   The  others  began  to  get flakey, and were obsolete anyway.
  105. This  dramatically speeds up the whole process, as less things have to
  106. be  checked  for,  as  well as the actual archiving time now is almost
  107. irrelevant,  since both are quite quick...  Although LHA blows ZIP out
  108. of the water!  ;-)
  109.  
  110. 4)  The  Default options have been deleted now, since many people were
  111. annoyed  with  having  to  backspace each time...  It took me a couple
  112. minutes  to  get  used to it, but I like it better now....  (Being the
  113. programmer, the defaults were MY prefered settings...He he he)
  114.  
  115. 5)  In  previous versions of the archive utilities, if for some reason
  116. the  transfer  failed,  the  archives  would be left in the directory.
  117. This  has  been  corrected.   Even if the entire process is aborted, a
  118. cleanup call is made to ensure no leftovers will be present, consuming
  119. space...
  120.  
  121. 6)  IBM  style  graphics  have  been  included,  to  give  it  a  more
  122. professional  look.   If  you have not done so already, you'll need to
  123. install  an  IBM  font  in the SetupBBS...  I'll include one with this
  124. archive for those who don't happen to have one....  :-)
  125.  
  126. ************************************************************************
  127. CHANGES (to 2.0)  :
  128.  
  129. 1)  OK,  everyone  stay  seated.....  Tim convinced me to add the view
  130. modes...   Currently  supported ae ALL the View modes except View mode
  131. 3,  which  was the 4 across style....  That just plain was too hard to
  132. write,  as  well  as taking forever to do...  (Who in their right mind
  133. uses  it  anyway???) Everyone should thank Tim for sending me the code
  134. to  use  to  get  it  going...  Without it, it wouldn't have even been
  135. attempted...
  136.  
  137. 2)  Fixed  a bug Tim found when View Mode 3 was selected...  Was doing
  138. view  mode  1  anyway, even though they selected the non-existant view
  139. mode  3....   Now it just plainly says (Say in a President Bush voice)
  140. "nope, Ya aren't gonna do it, wouldn't be prudent at this juncture..".
  141.  
  142. 3)  Ya  know,  the neat thing about read.me files, is that I could say
  143. anything  in  here,  since  noone bothers to read them anyway!  If you
  144. actually  read  this,  impress me by leaving me a message on NiteFall!
  145. Tell  me  you  read  this!  I want to see how many people are actually
  146. making all this typing worth the effort!  If noone replies, obviously,
  147. I won't waste time typing them up...  (I know this doesn't count as an
  148. addition,  or  even  a  slight  modification,  but I feel it's just as
  149. neccessary...)
  150.  
  151. 4)  Sorta  added FIFO:  output...  As of this writing, I have sent the
  152. code  to  Tim...  I can get it to print out the archive info, but ONLY
  153. AFTER  it's  done...   Can't  seem  to  get  it  to  do  it DURING the
  154. archiving....   (Kinda pointless to report it after, but so far that's
  155. all  it does...) This MIGHT be fixed in the release version...  (Which
  156. will probably have the same name...)
  157.  
  158. 5)  I  guess  I  forgot  to mention the Help screen....  Since not all
  159. users  call  only Tempest BBS's (Delete'em for it!  He he he) they may
  160. not  be familiar with all the view modes avaliable, so I've included a
  161. HELP screen that shows all the ones it's capable of.
  162.  
  163. 6)  This  really  isn't  an  addition,  and  actually  qualifies  as a
  164. subtraction, but I removed my original option of displaying the files.
  165. I  was asked repeatedly what the difference between mine and View Mode
  166. 1...   I  couldn't come up with anything except that "Mine was worse."
  167. so I killed mine....;-)
  168.  
  169. ************************************************************************
  170. CHANGES (to 2.4)  :
  171.  
  172. 1)  Added  what  I call "Auto Jump & Adjust" which automatically takes
  173. you to an entered number (0-39), refreshes the screen, then allows you
  174. to  edit that number.  If you enter an area that doesn't exist, ie not
  175. turned  on  by  the SYSOP, OR if they don't have access, it will still
  176. take  them  to  that  page,  but they can't edit a yes/no question....
  177. (Since they don't have access, why let them?!)
  178.  
  179. 2)  FIXED  a bug in the CloseStuff() routine that wouldn't let it exit
  180. the  door  properly.   Some  SYSOPS were having a crash every time the
  181. utility  was  exited...   This  was a silly error on my part, but it's
  182. fixed now.  (Too silly to even mention what I did!)
  183.  
  184. 3)  Added  the  FIFO output routines, which enables the viewing of the
  185. archiving  WHILE  it's being done!  Note that to run this version, you
  186. MUST    have    installed    the    FIFO   handlers   and   libraries!
  187. ************************************************************************
  188. CHANGES (to 2.5)  :
  189.  
  190. 1)  Optimized  for speed and size by The Skeleton.  I must say, he did
  191. an  EXCELLENT  job  of  cutting  the  size  down, and at the same time
  192. increasing the speed of the util!!!
  193.  
  194. ************************************************************************
  195. CHANGES (to 2.6)  :
  196.  
  197. 1)  Checked  to see if the USER had toggled areas off!  Previously, if
  198. the  sysop  had given the user access, the archiver would do it.  NOW,
  199. it  checks  for  both,  so that when d/l msgs/files, you don't get the
  200. areas you don't wish to see!!!
  201.  
  202. ***********************************************************************
  203. CHANGES (to xx.xx)  :
  204.  
  205.    YOUR ideas are welcomed here!  Got an idea you want added?  Send it
  206. to  me  in  a text file, or leave me a message on NiteFall, and let me
  207. know!  I'll do the best I can to get it in...
  208.  
  209. ************************************************************************
  210.  
  211.    No bugs have been found in these versions, but should you encounter
  212. one, please call me on NiteFall (Number etc, above) and let me know...
  213. Please tell me what your configuration is (Hardware, and which version
  214. of  Tempest),  as well as where you have FILEARC:  & MSGARC:  assigned
  215. to...  (I use RAM:, which is NOT the same as VDK: or VD0: !)
  216.  
  217.    Example Configuration report:
  218.  
  219.    My  configuration:   Workbench  2.0 (From software, not ROM), Supra
  220. RAM card expanded to 8 megs, 600M CDC Hard Drive, Xetec HD controller,
  221. 150M  (TEAC) tape backup system, A2000 CPU running at 14 Mhz with Math
  222. Co-Processor  (CMI),  Fatter Agnus (8372), Normal Denise, and 2 floppy
  223. drives...  This is Networked using PARNET with an A1000 which has only
  224. an  expansion of memory, totalling 1.5M of RAM.  I use Mach III in the
  225. background,  as  well  as AssignX, MenuMaster, and WShell.  When I run
  226. Tempest I leave the shell I ran it from open, in case any output comes
  227. thru it...  (Prevents guru's) ....
  228.  
  229.    My BUG I found was this: (Or I want it to do that...etc..)
  230.  
  231. My handle on your BBS is xxxxxxxxxxx, my BBS name is xxxxxx at
  232. (555) 555-5555.
  233.  
  234.    Hope this helps!   The Technician
  235.                       4-18-93
  236.  
  237.  
  238. ************************************************************************
  239.                             ADVERTISEMENT
  240. ************************************************************************
  241.  
  242.                                           __
  243.                         __   _           /  \       _   _
  244.                        /_/__/ )_      __/ /\/      / ) / )
  245.                ____   _  /_  _ /____ /_  _/____   / / / /
  246.               / _  ) / )  / /  / _  ) / / / _  ) / / / /
  247.              / // /_/ /_ / /__/ (__/_/ /_/ // /_/ /_/ /_
  248.             /_//___/___//____/______/___/___\__/___/___/
  249.                               __     __
  250.                              / /    / /
  251.                             / /_   / /_    ______
  252.                            / _  ) / _  )  / ____/
  253.                           / // /_/ // /___\ \
  254.                          /______/___________/   -sk-
  255.  
  256.                Featuring the BEST of the Public Domain!
  257.  
  258.    This  file  happily  presented  to you from those of us on NiteFall
  259. BBS!   (515)  277-1320  (Des Moines, IA) 602 Megs!  2400 - 19.200 Baud
  260. USR  HST  DUAL STANDARD MODEM (300-1200 Message access only) 24 hrs, 7
  261. days a week Tempest BBS software AND a Tempest support site!
  262.  
  263.                    SUPPORTING THE NEW MNP-5 MODEMS!
  264.  
  265.                    CALL NOW!!!!  Access first call!
  266.                             The Technician
  267.  
  268.    If  you  got  a  busy  signal  before, try again NOW!  NiteFall has
  269. undergone  many changes to allow more users on !  Soon to be expanding
  270. to MULTI-NODE !!!!  Keeping up with the times....
  271.