home *** CD-ROM | disk | FTP | other *** search
/ The Best of Mecomp Multimedia 1 / Mecomp-CD.iso / amiga / tools / wb / pda / pda.doc < prev    next >
Text File  |  1997-08-10  |  9KB  |  230 lines
  1. ==============================================================================
  2.   Professional Diz Adder v2.3 - © 1997 Henrik Lundquist (Boz/5Byte^Software)
  3. ==============================================================================
  4.  
  5.  
  6. Introduction
  7. ============
  8. The Professional Diz Adder v2.3 (PDA) is a tool that generates file_id.diz's
  9. for packed files (lha, lzx, dms) and also some other filetypes (gif, jpg, txt)
  10.  If you have ever had a lot of files without any description, and you don't
  11. like to make diz after diz and add to your archives, this is the perfect tool
  12. for you.
  13.  With about 40 fileheaders, you are able to generate nice looking diz's, with-
  14. out putting too much effort in to it, by using this software.
  15.  There are two different versions of the program. One unregistered and one
  16. registered. The unregistered have certain limitations such as:
  17.  
  18. · Only 8 fileheaders in the default list (explained later) - The registered
  19.   version can have as many as you can monitor on your screen! (About 40 using
  20.   Pal:Hires, more if you have a higher resolution.)
  21.  
  22. · No ad-stripping in packed archives.
  23.  
  24. · An irritating reminder popping up everytime you are about to add/view a diz
  25.   to/in a file.
  26.  
  27. If you are interested in getting registered, contact the author (look at the
  28. last lines in this textfile). It's cheap (only 50 SKR (about $9 or £4)) so
  29. it's affordable for everyone.
  30.  
  31.  
  32. Installation
  33. ============
  34. Use the installprogram that's included (PDA_Install.exe) - or if you want to
  35. do it by hand, copy the files in the 'C/' drawer to C:, the files in the 'S/'
  36. drawer to S: and the files in 'Header/' to a directory of your own choice.
  37. Then you MUST assign the Header drawer - open your 'S:User-Startup' file with
  38. an appropriate texteditor and add the following at the end of it:
  39.  
  40. Assign Header: <here you write the path to the drawer>
  41.  
  42. After that, open a shellwindow and do the same assign there.
  43.  
  44. Then you'll need to get your hands on lha, lzx and dmsdescript from somewhere.
  45. I recommend you to call a BBS in your surroundings.
  46.  
  47.  
  48. Requirements
  49. ============
  50. You'll need the following programs to make PDA work properly:
  51.  
  52. LHA - Copyright © Stefan Boberg
  53.  
  54. LZX - Copyright © Data Compression Technologies
  55.  
  56. DMS - Copyright © PanCom Software
  57.  
  58. DMSDESCRIPT - Copyright © Remo(Mystic/X-DeSign)
  59.  
  60.  
  61. Usage
  62. =====
  63. You use PDA through a dos-shell or by using it in a dos-compatible environment
  64. (for example the NiKom BBS-System).
  65.  
  66. Syntax: PDA <file> <fileheader>
  67.  
  68. As you can see above, PDA accepts two parameters. But what will happen if you
  69. forget one of them or even both?
  70.  
  71.  
  72. An example where both parameters have been left out. Only a syntax is shown.
  73.  
  74. -------------------------------------------------------------
  75. Professional Diz Adder (PDA) v2.3 - ©`1997 Boz/5Byte^Software
  76. -------------------------------------------------------------
  77.        Supports: DMS, LHA, LZH, LZX, GIF, JPG and TXT.
  78.  
  79.              How 2 use: PDA <file> <fileheader>
  80. -------------------------------------------------------------
  81. Registered to: UNREGISTERED!!! Only 50 SKR to register!
  82. -------------------------------------------------------------
  83.  
  84.  
  85. And like this it'll look like if you leave out the fileheader - a default
  86. file_id.diz header list will appear - an easy and comfortable way to add your
  87. diz's! And above all - EXCELLENT when used as a file_id.diz viewer/adder in a
  88. BBS-system! (Remember that only the 8 first will show if you have an un-
  89. registered version!)
  90.  
  91. ===============================================================
  92. No file_id.diz-header parameter given. File: PDA_Test.txt
  93. ===============================================================
  94. [ 1] 3D-stuff                   [18] Freehand_graphics
  95. [ 2] About_cracking             [19] Game
  96. [ 3] AmigaE                     [20] Hacking
  97. [ 4] Amiga_Unspecific           [21] Internet_Related
  98. [ 5] AmiXpress                  [22] Mpeg
  99. [ 6] Anarchy                    [23] Music_related
  100. [ 7] Anim5                      [24] NiKom
  101. [ 8] Animation                  [25] NTPro
  102. [ 9] Arexx                      [26] Phreaking
  103. [10] Ascii_Art                  [27] Picture_undefined
  104. [11] Assembler                  [28] Pornographic_picture
  105. [12] BBS_Övrigt                 [29] Raytrace_graphics
  106. [13] C                          [30] Source
  107. [14] Carding                    [31] Undefinable
  108. [15] Daydream                   [32] Utility_file
  109. [16] Demo_Intro                 [33] Virus_tools_and_sources
  110. [17] Drugs                      [34] WBsnap
  111. ===============================================================
  112. Headerchoice:
  113.  
  114.  
  115. After that you'll be asked for the file's description. You have up to three
  116. rows to describe the file. If you can't come up with a description, just press
  117. ENTER and the descripion in your S:PDA.DEF will be used. When you've entered
  118. your description, a file_id.ad will be added, and your file_id.diz is finished!
  119.  
  120.  
  121. Archive Contents
  122. ================
  123. These files should be included in the PDA archive:
  124.  
  125. The Header Drawer - Here your default headers reside.
  126.  
  127. S/PDA.CFG - A configuration file. Here you decide whether or not to have ad-
  128.             stripping on by giving the correct command.
  129.  
  130.             STRIPARCHIVES=NO   Tells PDA not to strip ads.
  131.             STRIPARCHIVES=YES  Here PDA will strip the ads that it has been
  132.                                told to strip (see S/PDA.STRIP).
  133.  
  134. S/PDA.STRIP - In this file you enter the ad-files to strip from archives (see
  135.               S/PDA.CFG dor further information).
  136.  
  137. S/PDA.DEF - The PDA.DEF file contains a default file_id description if there
  138.             is no description available when making a diz.
  139.  
  140. S/PDA.AD - This is a file where you put your own file_id.diz ad in. The first
  141.            line should ALWAYS be there, after that you can write how long a
  142.            file_id-ad you want.
  143.  
  144.            Example:
  145.  
  146.            <----44 chars. Don't delete this line!!---->
  147.            --------------------------------------------
  148.                 This file came from Paranoia BBS!
  149.            --------------------------------------------
  150.  
  151.  
  152.            Example of what a diz will look like:
  153.  
  154.              ______  _____ ___  _____  _____    ______
  155.            ¡_) __  ¡_)    Y   ¡_)____¡_) ___)_¡_) __  ¡
  156.            |\   '  |\     !   |\     |\  \___ |\   '  |
  157.            |    T  |    ¡   ¡ |      |      ' |    T  |
  158.            `----'--^----`---'-^------^--------^-bZ-'--'
  159.            --------------------------------------------
  160.             A pretty cool example-diz generated using
  161.             the unregistered version of PDA v2.3!
  162.             Over 40 diz's available in the registered!
  163.            --------------------------------------------
  164.                 This file came from Paranoia BBS!
  165.            --------------------------------------------
  166.  
  167.  
  168. S/PDA.HED - In this file there should be a list of your headers in the header:
  169.             drawer. One name on each row - always 'bind' your filenames
  170.             together like 'PDA_v2.3' not 'PDA v2.3' (the difference is the '_')
  171.             , so the header identifier will find it. It's important that you
  172.             write down you headernames EXACTLY as they are named in your Header:
  173.             archive. The file are full of examples you can look at using an
  174.             ordinary texteditor (such as CygnusEd Professional).
  175.  
  176. C/PDA - This is the program itself. Only 32760 bytes large and still as power-
  177.         ful as you need.
  178.  
  179.  
  180. History
  181. =======
  182. -> v2.2 - Fixing bugs, lots and lots of new functions... And so on :)
  183.  
  184.    v2.3 - Fixing ALOT of bugs (though NONE! given by E-Mail and so on.
  185.           Added REPLACE mode for the file_id.diz's in .txt files.
  186.           Improved the engine itself, rewrote several sections of badly
  187.           written code :)...
  188.  
  189.  
  190. Known bugs
  191. ==========
  192. There are only one known bug in PDA. The program doesn't accept certain letters
  193. (The Swedish letters å,ä,ö for instance) in the parameters sent to it while
  194. starting the program. This causes the program into not recognising the file in
  195. question.
  196.  
  197. Since this program is written in Pascal, it may have something to do with that.
  198. If someone knows how to fix it (or finds any other nasty bugs) please contact
  199. the author.
  200.  
  201.  
  202. Disclaimer
  203. ==========
  204. The author takes NO responsibility whatsoever of problems due to the program.
  205. If your monitor blows up or your harddrive crashes, fine, but don't blame it on
  206. me. You use this program at your own risk.
  207.  
  208.  
  209. Contact the author (for registrations and comments):
  210. ====================================================
  211. Henrik Lundquist - Boz/5Byte^Software
  212.  
  213. Voice Number:   +46-(0)13-15 40 85
  214. Paranoia BBS:   +46-(0)13-15 28 74 (Swedish speaking only!)
  215.  
  216. E-mail: b0z.5Byte-Software@linkoping.mail.telia.com
  217.  
  218.  
  219. Other
  220. =====
  221. The Professional Diz Adder (PDA) is Copyright © 1997 Henrik Lundquist. It may
  222. not be resold, hired or in any other way handed to a third part. PDA is labeled
  223. under the Shareware etiquette. NiKom, DMS, Dmsdescript, Lha, Lzx, GIF, JPG and
  224. CygnusED Professional are Copyright © their respective owners.
  225.  
  226. ALL the Ascii in the archive is also © 1997 Henrik Lundquist, and if you wish
  227. to use them in something other than PDA and file_id.diz's generated by PDA, you
  228. MUST contact the author and ask for a permission.
  229.  
  230. EOF.