home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / CYC-DZ11.ZIP / DIZZLY.DOX < prev    next >
Text File  |  1995-12-01  |  9KB  |  213 lines
  1. dox&askeebynixxon
  2.  
  3.  
  4.  
  5.                 $$S$$$s. .sS$ .sS$$$s. .sS$$$s. .sS$ .s$ $$$s
  6.                 $$$$^$$$ $$$$ ²$$$ $$$ ²$$$ $$$ $$$$ $$$ $$$$
  7.                 $$$$ $$$ `^²²      $$$      $$$ $$$$ $$$ $$$$
  8.                 $$$$ $$$ $Ss. $$$$.$$$ $$$$.$$$ $$$$ $$$ $$$$
  9.                 $$$$ $$$ $$$$ $$$$     $$$$     $$$$ ²$$.$$$$
  10.                 $$$$ $$$ $$$$ $$$$ $s. $$$$ $s. $$$$     $$$$
  11.                 $$$$ $$$ $$$$ $$$$ $$$ $$$$ $$$ $$$$     $$$$
  12.                 $$$$s$$$ $$$$ $$$$ $$$ $$$$ $$$ $$$$     $$$$
  13.                 `$$$$$²^ `^²$ `^²$$$²^ `^²$$$²^ `^²$     $²^`
  14.                   D   ·   I   ·   Z   ·   Z   ·   L   ·   Y
  15.  
  16.                      - The Final FILE_ID.DIZ Processor -
  17.  
  18.                                     v1.1O
  19.  
  20.                                <Final Version>
  21.  
  22.  
  23.  
  24.  
  25.            Welcome to The New Age Of FILE_ID.DIZ-Processing!
  26.  
  27.  
  28.                           Table of contents:
  29.  
  30.                              Introduction
  31.                               Advantages
  32.                             Configuration!
  33.                              Installation
  34.                                  ├ In Remote Access
  35.                                  ├ With SkullCheck
  36.                                  └ Making a batchfile
  37.                  ───════ Contacting the author ════───
  38.                                Greetings
  39.  
  40. ┌────────────────────────────────────────────────────────────────────────────┐
  41. │                           ** IMPORTANT NOTE! **                            │
  42. │                                                                            │
  43. │ Throughout this documenation, SKULLCHECK is used as an example. If you are │
  44. │ using another uploadprocessor, just change all the SKULLCHECK commandlines │
  45. │ to those  of you own scanner's. DiZZLY  works just as fine  with all other │
  46. │ upload processors on the market.                                           │
  47. └────────────────────────────────────────────────────────────────────────────┘
  48.  
  49. ---- [·INTRODUCTION·] --------------------------------------------------------
  50.  
  51.  This program has been designed to work with the three most common types
  52. of archives; ZIP, ARJ, RAR and LHA (LZH). It's very easy to use, in fact
  53. it's quite self-explanatory, just execute DIZZLY.EXE and you'll get all
  54. the help you need.
  55.  
  56.  I know that some upload-processors (SkullCheck for instance) has their own
  57. ability to add taglines into FILE_ID.DIZ. This function is although often
  58. limited, like in SkullCheck (again for instance) you can not use ANSI colour
  59. codes in your tagline. So, why not use a program that is specifically designed
  60. to add/remove lines to/from FILE_ID.DIZ's?
  61.  
  62.  And that, folks, is what my program is all about. Try it - you'll like it!
  63.  
  64.  If you do find any bugs (surprised if you didn't), feel free to contact me.
  65. The different addresses I can be reached at are presented at the end of this
  66. documentation.
  67.  
  68. ---- [·ADVANTAGES·] ----------------------------------------------------------
  69.  
  70.  I now what you are thinking - there are hundreds of FILE_ID.DIZ processors
  71. around (well - a few anyway), so why use this? I will, most briefly, explain
  72. the advantages of using this program:
  73.  
  74.   [·O1] Automatic archiver recognition
  75.               - Yup, that's right. No matter what the extension might be,
  76.                 the program will still use the correct packer/unpacker.
  77.                 (This function is limitied to ZIP, ARJ, RAR and LHA/LZH)
  78.  
  79.   [·O2] Keeps the date intact
  80.               - When processing ZIP or RAR files, DiZZLY will not change the
  81.                 archive's date nor its time.
  82.  
  83.   [·O3] User friendly!
  84.               - Configure the program with DIZZLY.EXE /C - could it be easier?
  85.                 Perhaps, but it's still neat. And once you have configured it,
  86.                 you will not have to think about any command-line parameters.
  87.  
  88.   [·O4] Logs all actions
  89.               - You may, if you want to, define a logfile. DiZZLY will then
  90.                 write all actions it takes into that file. The styling is
  91.                 the same as in SKULLCHECK, but you can of course use it with
  92.                 any UploadChecker that uses a logfile (you can, of course,
  93.                 use a separate DiZZLY logfile)
  94.  
  95.   [·O5] Find out...
  96.                - Thought it would be nice with five advantages, so the fifth
  97.                  one will be for you to find out just what this nifty little
  98.                  program can do for you!
  99.  
  100. ---- [·CONFIGURATION·] -------------------------------------------------------
  101.  
  102.  First you should edit the files REMOVE.DIZ and ADD.DIZ. DiZZLY will search
  103. the FILE_ID.DIZ for lines mathing any of those in REMOVE.DIZ. If a matching
  104. line is found, DiZZLY simply removes it. In ADD.DIZ you specify the line to
  105. be added into every FILE_ID.DIZ (only the first line is read).
  106.  
  107.  Second, you should type DIZZLY.EXE /C and the configuration program will
  108. start. You will get all the information you need once you're there.
  109.  
  110.  You should always keep the configuration file (DIZZLY.CFG) in the same
  111. directory as DIZZLY.EXE, otherwise the program won't find it.
  112.  
  113.  One more thing - you must have the archivers in your path. Of course, if
  114. you never use ARJ-files, it does not matter where ARJ.EXE resides. The
  115. program will tell you if it can't find the archiver it needs (if logging is
  116. enabled, it will be written in that file as well).
  117.  
  118.  
  119. ---- [·INSTALLATION·] --------------------------------------------------------
  120.  
  121.  Installation, installation... I don't know about other BBS systems, but
  122. this is what a typical Remote Access configuration would look like:
  123.  
  124. (in RA Config -> Options -> Files -> Upload scan)
  125. ╒══════════════════════════════════════════════════════════ Upload scanning ╕
  126. │                                                                           │
  127. │ Scan online  Ask                                                          │
  128. │ Failed scan  Unlisted                                                     │
  129. │ Scan utility C:\RA\SKULLCHK\SKULLCHK.EXE @ /N:*N /P:*P *M                 │
  130. │                                                                           │
  131. ╘═══════════════════════════════════════════════════════════════════════════╛
  132.  
  133.   @ passes the filename
  134.  *N    - " -   nodenumber
  135.  *P    - " -   COM-port
  136.  *M swaps out of memory
  137.  
  138.  Not much room for an extra FILE_ID.DIZ processor there, huh? So, how about
  139. making a batchfile to start the upload processor? It would look something
  140. like this:
  141.  
  142. ╒══════════════════════════════════════════════════════════ Upload scanning ╕
  143. │                                                                           │
  144. │ Scan online  Ask                                                          │
  145. │ Failed scan  Unlisted                                                     │
  146. │ Scan utility *C /C C:\RA\UL_SCAN.BAT @ *N *P *M                           │
  147. │                                                                           │
  148. ╘═══════════════════════════════════════════════════════════════════════════╛
  149. (don't forget *C /C when using batchfiles!)
  150.  
  151.  And the BAT-file could look like this:
  152.  
  153. @ECHO OFF
  154. C:\RA\SKULLCHK\SKULLCHK.EXE %1 /N:%2 /P:%3
  155. C:\DIZZLY\DIZZLY.EXE %1
  156.  
  157.  If you are using another upload scanner, you would of course write the
  158. command line of that program instead of SkullCheck's.
  159.  
  160.  SkullCheck users should disable the tagline feature in SKCCFG, otherwise
  161. you'll end up with two ad's.
  162.  
  163. ---- [·CONTACTING THE AUTHOR·] -----------------------------------------------
  164.  
  165.  I, Niklas Malmgren (aka Nixxon) can be reached at the following addresses:
  166.  
  167.  BBS:        Name   : Replica
  168.              Number : +46-49O-35123 (in Sweden)
  169.              Sysop  : Niklas Malmgren (that's me)
  170.  
  171.         ****  No ratios for foreign callers! ****
  172.  
  173.  FidoNet:    2:204/711
  174.  PascalNet:  115:4640/200
  175.  WasteNet:   55:300/200
  176.  
  177.  InterNet:   sysop@f711.n204.z2.fidonet.org
  178.  
  179.  Snailmail:  Niklas Malmgren
  180.              Alviksgatan 13
  181.              S-593 37 Vastervik
  182.              Sweden
  183.  
  184.  
  185.  DiZZLY was compiled using Borland Turbo Pascal 7.0. Using PKLITE I compressed
  186. the executable.
  187.  
  188.  If you find any bugs (or have suggestions), I would appreciate if you'd
  189. contact me on any of the above addresses.
  190.  
  191. ---- [·GREETINGS·] -----------------------------------------------------------
  192.  
  193.  ß-testers: fREEJACK, HOoDOo, CiRCUiT - THANK YOU!
  194.  
  195.  Other greets: HooDoo   - for beeing my cosys, friend and all...
  196.                fREEJACK - for teaching me Pascal
  197.                Snooper  - for helping me out with Pascal
  198.                Krille   - for ... erhm.. being my friend
  199.                Malin    - I still love you!
  200.                   ..and of course to Bruce Springsteen for his music!
  201.  
  202.  Look out for my other programs - NixxNews
  203.                                 - UploadSearcher (still ß-testing)
  204.  
  205.  And remember - the important thing is not what you do, as long as you do
  206.  it well!
  207.  
  208.  In Swedish:
  209.    Det viktiga är inte vad man gör utan att man gör det med stil
  210.                    - Lars Demian
  211.  
  212.  
  213.