home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / wb-enhancement / ccb / dldiz / dldiz.doc < prev    next >
Encoding:
Text File  |  1996-02-26  |  7.9 KB  |  233 lines
  1.  
  2. Welcome to DLDiz v1.7 ©Copyright 1995 by Rasmus K. Ursem, Dreamline Designs.
  3.                        Release Date: 08-Apr-95
  4.  
  5. Introduction:
  6.  DLDiz is a small utility to extract and show "file_id.diz" from Textfiles, 
  7. LHA and DMS-archives. It can also create filelists from the file_id.diz, this
  8. version can supports 2 BBS types (Daydream and AmiExpress). Using this option
  9. you have the fastest local upload tool. More about this later.
  10. DLDiz now supports LZX.
  11.  
  12. This is BUNGYJUMPWARE. If you like it you should go bungyjumping.
  13.  
  14. Disclaimer:
  15. I take no responsibility for any lack of data or currupted archives. 
  16. (or any bungycrashes...) DLDiz is checked in everyday use and has shown no
  17. errors.
  18.  
  19. Needed programs:
  20. LHA placed in the path.
  21. LZX placed in the path.
  22.  
  23. Reason to code: I used Whadiz 1.2 from nocTurne deSign/RefLeX, but this 
  24. utility has a major bug. It dosn't unlock files when there isn't any 
  25. "file_Id.diz" file in the archive. On top of that it dosn't unlock dirs.
  26. Very annoying because you cannot delete these files and dirs.
  27. Sometimes a list of the file_id.diz's is also very useful, so DLDiz can
  28. now create such a list.
  29.  
  30. Usage:
  31. DLDiz NAME/K/M,F=FILELIST/S,Q=QUIET/S,NH=NOHEADER/S,LT=LISTTYPE/K,LN=LISTNAME/K,
  32. ED=EDITOR/K
  33.  
  34. NAME      is the name of the archive.
  35. FILELIST  is used to enable the create filelist. A file called 
  36.           "Filelist_created_by_DLDiz" is placed in ram: 
  37. QUIET     will disable all output but errormessages from DLDiz.
  38. NOHEADER  will disable the header output. Only the File_ID.Diz will be 
  39.           displayed.
  40. LISTTYPE  is the type of the list you want to generate.
  41.           Currently supported listtypes is:
  42.           N     This result in a standard list with no sizes, dates ect.
  43.           A     Generates a list for AmiExpress BBS.
  44.           D     Generates a list for Daydream BBS.
  45.           If this is not found in the commandline, DLDiz will generate a 
  46.           standard filelist like version 1.5 Did.
  47. LISTNAME  An optional listname. The File_ID.DIZ from the file, will be added
  48.           to this list specified here. 
  49.           If this is not found in the commandline, DLDiz will add to the
  50.           standard filelist in ram:
  51. EDITOR    Editor to use if no File_ID.Diz is found. For the moment this dosn't
  52.           work in DMS-Archives because DMS can't add a File_ID.Diz without
  53.           repacking the whole file. :(
  54.  
  55. History
  56. V1.0    -First working version.
  57.  
  58. V1.1    -Improved: DMS extraction replaced with own search routines.
  59.     -Added: Search in textfiles. (Or any other file where the
  60.      file_id.diz is between a begin and end file_id.diz line.
  61.     -Added: Buffermode so you can get the file_id.diz even if you
  62.      havn't enough memory free to load the whole file.
  63.  
  64. V1.2    -Bugfix: V1.1 had a minor bug. (Colorflash when no file_id.diz was
  65.      found.) A friend of mine uploaded v1.1 without asking me. :-(
  66.  
  67. V1.3    -Bugfix: Major fuckup in the DMS-searching.
  68.  
  69. V1.4    -Added: Option to create filelist.
  70.         -Added: Quietmode.
  71.  
  72. V1.5    -Bugfix: DLDiz didn't delete the t:File_ID.Diz when a corrupted
  73.          archive was processed.
  74.         -Added: If a lha fails (corrupted data) DLDiz print a message on
  75.          the screen or in the filelist.
  76.  
  77. V1.6    -Added: LZX support.
  78.         -Added: Special list generating for AmiExpress and Daydream BBS.
  79.         -Improved: DLDiz can add to a userselected list instead of
  80.          ram:Filelist_created_by_DLDiz.
  81.  
  82. V1.7    -Bugfix: V1.6 would crash on textfiles greater than 65535 bytes.(Ups!)
  83.         -Bugfix: DMS search-routine couldn't find the Diz if it was placed
  84.          as the last "hunk".
  85.         -Bugfix: The listgenerator for Daydream and AmiExpress would create
  86.          "funny" lists if the Diz wasn't ending on a CR. ($0a)
  87.         -Added: If no file_ID.Diz is found DLDiz can open a userselected 
  88.          editor and add the File_ID.Diz to the archive. NOTE: This dosn't
  89.          work on DMS-archives because DMS cannot just add File_ID.Diz-info.
  90.          You have to unpack the file and repack it with the Diztext option.
  91.          (Crap?)
  92.         -Added: NoHeader option, this will prevent the usual header text from
  93.          being displayed. Now you can use DLDiz in connection with upload on 
  94.          Diz-supporting BBS-systems.
  95.         -Added: Rexxscript for use with DOpus. Thanks goes to Morten K. 
  96.          Andersen for being our Arexx-wizard.
  97.         -Changed: In the privious versions you had to type DLDiz Name <File>
  98.          Now added a /M so you just have to type DLDiz <file>.
  99.         -Improved: The listgenerating-routine now adjust the width of the 
  100.          file_id.diz.          
  101.  
  102. Using the editor option.
  103.  
  104. Example:
  105. DLDiz test.lha f ed="ced -keepio"
  106.  
  107. This will call DLDiz, and if test.lha dosn't have any File_ID.Diz the editor
  108. specicified in Ed= will be executed. In the above example, DLDiz will execute 
  109. the following command.
  110.  
  111. ced -keepio t:File_ID.Diz
  112.  
  113. If you use some wierd editor that must have the filename as the first argument 
  114. you can freely create a script to execute your editor, just remember to set the
  115. S (Script) bit, and keep in mind that DLDiz tries to load the File_ID.Diz from
  116. T:File_ID.Diz.
  117.  
  118. example of script for use with CygnusEd
  119.  
  120. -------------- Cut ---------------
  121.  
  122. stack  8000
  123. Ced t:File_ID.Diz -keepio
  124.  
  125. -------------- Cut ---------------
  126.  
  127.  
  128.  
  129. Using with DOpus.
  130.  
  131. *** Normal showing ***
  132.  
  133. AmigaDOS    c:DLDiz NAME {f}
  134.  
  135. Stack:          4000
  136. Priority:       0
  137. Close Delay:    -1
  138.  
  139. Flags:
  140. Directory Opus to front
  141. Do all files
  142. Output window
  143.  
  144.  
  145. *** Generating a list in ram: ***
  146.  
  147. AmigaDOS    c:DLDiz NAME {f} F Q
  148.  
  149. Stack:          4000
  150. Priority:       0
  151. Close Delay:    -1
  152.  
  153. Flags:
  154. Directory Opus to front
  155. Do all files
  156. Output window
  157.  
  158. *** Local uploading on Daydream/AmiExpress ***
  159.  
  160. AmigaDOS    c:DLDiz NAME {f} F Q LN {Rf} LT D
  161.                                      \/     \__Specifies Listtype. 
  162.                                       \        Here Daydream. Use A for AmiX
  163.                                        \
  164.                                         \______Tells Dopus to pop a filereq.
  165.                                                Here ou select the list you
  166.                                                want to add to.
  167. Stack:          4000
  168. Priority:       0
  169. Close Delay:    -1
  170.  
  171. Flags:
  172. Directory Opus to front
  173. Do all files
  174. Output window
  175.  
  176. Local upload on Daydream and AmiExpress.
  177. If you have Dopus do as described just above, else do this:
  178.  
  179. c:DLDiz NAME <filename> F Q LN <Listname> LT <Listtype: D = Daydream, A = AmiExpress>
  180.  
  181. 1STNOTE: The archive/file MUST have a FILE_ID.Diz, else the Discription will be
  182.          "File_ID.Diz NOT found!"
  183. 2NDNOTE: You must copy the files to the path according to the selected list.
  184. 3RDNOTE: Remember these BBS-programs MUST have the names in uppercase and 
  185.          the filename MUST support the 8.3 (PeeCee) standard.
  186.  
  187. *** Using the arrex script with DOpus ***
  188.  
  189. This script is used for local uploading/creation of filelists. Use these 
  190. settings:
  191.  
  192. ARexx       rexx:dopus/DLDListgenerator.dopus
  193.  
  194. Stack:          9000
  195. Priority:       0
  196. Close Delay:    0
  197.  
  198. Flags:
  199. Run asynchronously
  200.  
  201.  
  202. How to contact the author.
  203. Snail mail (@, -mail)
  204.  
  205.  Rasmus K. Ursem
  206.  Vittenvej 26
  207.  8382 Hinnerup
  208.  Denmark
  209.  Phone +45 86910058
  210.  
  211.  FidoNet:    2:238/28.10
  212.  AmigaNet:    39:140/109.10
  213.  HOANet:    10:2/9.10
  214.  
  215. Or Call this board:
  216.  
  217. Stargate, Dreamline Designs BBS Phone: +4586910058 Hours: 21:00-09:00
  218. Sysop: Rasmus K. Ursem, Dreamline Designs.
  219.  
  220. Some Notes about this BBS:
  221. All releases from Dreamline Designs is online, even the winner-demo from 
  222. the dealer-demo-competition at TP3 (22MB). Furthermore I am trying to build a
  223. collection of coding utilities and public sources such as chunkytoplanar-
  224. routines and other demo-routines/utilities-sources.
  225.  
  226. Other Utils coded by me:
  227. DLDCheck:    The *ultimate* stripper, with intelligent killmode to strip
  228.         randomgenerated adds, CRC-Checking(=ANY banner can be deleted).
  229.                 latest release is V4.1.
  230. DLDBoot:    HD-Bootprogram to wait for old slow hds.
  231. DLDInfo:    Improvement to CBMs info.
  232. DLDModRe:    Rename (unpacked) Protracker modules to the original name.
  233.