home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / DIZDIR15.ZIP / DIZDIR.DOC next >
Text File  |  1994-03-12  |  7KB  |  166 lines
  1. DIZDIR Version 1.5
  2. Copyright (c) 1994 GDSOFT
  3.  
  4. March 12, 1994
  5.  
  6.  
  7. WHAT IS IT :
  8. ------------
  9.  
  10. DIZDIR is a  simple utility that creates an ASCII  file listing of all ZIP,
  11. ARJ, LZH, ARC, and SFX files in a directory on you system, and will use the
  12. FILE_ID.DIZ  or  FILE.DES  or  FILE.DES   included  in  the  archive  as  a
  13. description for the file. Additionally, files can be listed the DO NOT have
  14. a FILE_ID.DIZ  or, ONLY  listed if  they do.  As and  added option, you can
  15. create file lists  containing the filename, size, date  and what I'll refer
  16. to as a ONE-LINER which is the FIRST xxx characters of the FILE_ID.DIZ, all
  17. on one  line. Listings can  be placed  in  ANY ASCII file  anywhere on your
  18. disk.
  19.  
  20. Commonly, on most BBS systems, the file contained in an archive to describe
  21. the  file is  named FILE_ID.DIZ,  however other  variations are FILE.DES or
  22. FILE.SDI.  In this  document, I'll  refer to  this file  regardless of  the
  23. flavor as  the FILE_ID. DIZDIR  will look for  FILE_ID.DIZ first, then  SDI
  24. then DES.
  25.  
  26. The format of the output file that DIZDIR creates is as follows.
  27.  
  28. --------------------------------  RULER -----------------------------------
  29. 0        2         2         3         4         5         6         7
  30. 123456789012345678901234567890123456789012345678901234567890123456789012345
  31.  
  32. FILENAME.EXT 1234567 03-12-94  The file description starts here  and can go
  33.                                on through the next as many lines as may  be
  34.                                in the FILE_ID.DIZ.
  35.  
  36.  
  37. BASIC STARTUP :
  38. ---------------
  39.  
  40. Unpack the  distribution archive to some  directory on your disk,  and type
  41. the command  : DIZDIR <ENTER>.  You'll see the following HELP screen :
  42.  
  43. DIZDIR 1.5a (c) 1993,1994 GDSOFT
  44. Purpose : Create files listing from FILE_ID.DIZ,SDI or DES in archives
  45. Usage   : DIZDIR [/f:outputfile] [/p:filepath] [/d:default.diz] [switches ..]
  46.  
  47. Switches :
  48.        /f:c:\outputfile  (default = FILES.BBS)
  49.        /p:c:\filepath (default=Current Directory)
  50.        /d:c:\default.diz (use this if NO DIZ in files and NOT /x switch)
  51.        /o = OVERWRITE output file (default=APPEND)
  52.        /x = DO NOT include files WITHOUT FILE_ID.DIZ (Default=include them)
  53.        /e = ONLY include files WITHOUT FILE_ID.DIZ (overrides /x switch)
  54.        /1:### = Write FIRST xxx chars of FILE_ID.DIZ ( create one-liner )
  55.        /? = Show this help screen
  56.  
  57. AH... NOW FOR THE GOOD PART
  58. ---------------------------
  59.  
  60. DIZDIR is really  easy to use. It DOES  NOT matter in what order  you enter
  61. the commandline parameters.
  62.  
  63. First off, you'll  need to tell the program  what the name and path  of the
  64. OUTPUT file will be. If you omit  this, DIZDIR will write the output to the
  65. CURRENT directory in  the file named FILES.BBS. To  specify the output file
  66. enter /f:c:\outputfile as part of the commandline.
  67.  
  68. Next, we  have to tell DIZDIR  what directory to look  in for the archives.
  69. ALL ZIP, LZH, ARJ, and ARC files  and their SFX counterparts will be listed
  70. for that directory.  Enter /p:c:\somepath as part of  the commandline. This
  71. is the ONLY parameter that DIZDIR  actually MUST have. Therefore, you could
  72. just enter on the command line  : DIZDIR \somepath, and DIZDIR would create
  73. a list of that directory.
  74.  
  75. Some of  the files in  the directory chosen  may NOT contain  a FILE_ID. In
  76. this case,  you can use the  /d:c:\default.diz to force these  files to ALL
  77. have a default description. This file can  be anywhere on you disk, but you
  78. MUST include the path if not in the current directory.
  79.  
  80. Finally, we have the option switches  which are completely OPTIONAL. The /o
  81. switch permits  OVERWRITING of the  output file if  it already exists.  The
  82. default is to APPEND to the end of this file. The /x and /e switches permit
  83. you to INCLUDE  or EXCLUDE files that DO NOT  have FILE_ID's. The /x switch
  84. EXCLUDE these files from the listing, and the /e switch ONLY includes these
  85. files. Also, the /e switch is EXCLUSIVE and will override the /x switch.
  86.  
  87. Another USEFUL feature of DIZDIR is  the /1:### switch, where the pounds(#)
  88. are  replaced with  numbers from  20-240. What  DIZDIR will  do here  is to
  89. create a ONE-LINER listing containing the  filename, size, date and the xxx
  90. characters from  the FILE_ID. This switch  may be used in  conjunction with
  91. the other switches (/e,/x,/o).
  92.  
  93.  
  94.         EXAMPLES
  95.         --------
  96.  
  97.         DIZDIR  \zip  /o  -  list  all  archives  in  the ZIP directory and
  98.         overwrite FILES.BBS which will be placed in the current directory.
  99.  
  100.         DIZDIR \zip /f:\bbs\Files.bbs /o /x - list ONLY archives in the ZIP
  101.         directory that have a FILE_ID and overwrite \BBS\FILES.BBS.
  102.  
  103.         DIZDIR \zip /f:listfile.txt /d:c:\util\junk.diz - list all archives
  104.         in  the ZIP  directory and   write to  LISTFILE.TXT in  the current
  105.         directory. For files that have no FILE_ID, use "c:\util\junk.txt"
  106.  
  107.         DIZDIR \p:\zip /f:a:\files.txt /1:70 - list all archives in the ZIP
  108.         directory and write to FILES.TXT the  'A' drive. Make the listing a
  109.         ONE-LINER using 70 chars from the FILE_ID.
  110.  
  111.  
  112. I think that you have the idea !!
  113.  
  114.  
  115.  
  116. ARCHIVE PROGRAMS NEEDED AND LOCATIONS
  117. -------------------------------------
  118.  
  119. DIZDIR recognizes the  extensions ZIP,ARJ,LZH and ARC. In  order for DIZDIR
  120. to work for each  of these respective archives, you MUST have  a copy of at
  121. LEAST ONE of  the following files FOR EACH FORMAT,  SOMEWHERE on your path.
  122. DIZDIR will search  for them, and if NOT found,  will NOT create list items
  123. for these formats. You must then make sure that these files are in the same
  124. directory as DIZDIR.EXE or in a directory listed in your PATH statement.
  125.  
  126. Where I list  more than one program here, DIZDIR  will search for the First
  127. one, then the second  and so on until it finds at  least one of them. Since
  128. ALL DIZDIR  needs to do  is to  unpack  any FILE_ID.DIZ that  exists in the
  129. archive, it really does NOT matter which of these programs that it uses.
  130.  
  131.                 ZIP - PKUNZIP.EXE
  132.                 ARJ - ARJ.EXE
  133.                 ARC - ARC.EXE, ARCE.EXE, ARC.COM, PKXARC.COM or PAK.EXE
  134.                 LZH - LHA.EXE or LHARC.EXE
  135.  
  136. Well, that's pretty much it. I think that you will find DIZDIR easy to use,
  137. FAST, and once you get used to using it, indispensable !! Especially if you
  138. maintain a BBS.
  139.  
  140. If you like DIZDIR, then please register  it. For those who do, I will send
  141. my super dooper BONUS archive as well. Believe me there are many goodies on
  142. this  BONUS  disk.  including  ARCTOOL,  ARCPLUS  and  FILEMANAGER PLUS, an
  143. exciting NEW program which does ALL that you could EVER want a file manager
  144. program to do and MUCH MORE !!!
  145.  
  146. To register, send a FORMATTED, BLANK diskette to
  147.  
  148.         GDSOFT
  149.         G.D. DAVIS
  150.         57280 Osage Drive
  151.         Goshen, Indiana 46526
  152.  
  153.         Please Include a $15.00 registration fee.
  154.  
  155.         Make sure that you include your return address.
  156.  
  157.  
  158. If you have any comments or questions,  I would REALLY love to receive your
  159. comments  or  suggestions.  I  can  be  reached  by  leaving  mail on GENIE
  160. (G.D.DAVIS) or CompuServe (72067,2726), or write to me at the above address
  161. or better yet,  call GDSOFT BBS (219) 875-8133,  HST 14400,8,N,1 v.32/v.42.
  162. This is a FREE BBS, and you'll  find MANY GDSOFT programs and files as well
  163. as lots of other goodies.
  164.  
  165. Thank you for using DIZDIR.
  166.