home *** CD-ROM | disk | FTP | other *** search
/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / Dloads / UTILITIE / ZIPLOGO5.ZIP / ZIPLOGO.DOC < prev    next >
Text File  |  1991-11-21  |  24KB  |  513 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.         
  13.         
  14.         
  15.  
  16.  
  17.         
  18.  
  19.                                  ZIPLOGO Version 5.0      
  20.                              (c) 1991 Magic Software Ltd. 
  21.                               Written by Steven Debruyn   
  22.                                                           
  23.                                                           
  24.                                Add comments to ZIP-files  
  25.                                Add comments to ARJ-files  
  26.  
  27.  
  28.  
  29.  
  30. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.
  31.  
  32.  
  33. Disclaimer
  34. ----------
  35.  
  36.  
  37. This Software is Copyrighted, unauthorised duplication
  38. prohibited. Not for commercial use.
  39.  
  40. This Software is distributed as Shareware, you can evaluate
  41. it for a period of 30 days, after which you are requested to
  42. pay a registration fee of 500 BEF or equivalent in your
  43. currency.
  44.  
  45. This Software is provided "as is". Magic Software is not
  46. responsible for any damages that may result in the ability or
  47. inability to use this program. NONE at all !!!
  48. USE AT OWN RISK !!!
  49.  
  50. Comments, Bug reports ,Registrations can be sent to :
  51.  
  52.            Steven Debruyn
  53.            Welleplein 29/22
  54.            9473  Welle
  55.            Belgium
  56.  
  57. Or write me message on Fido 2:294/60
  58. Username Steven Debruyn
  59. (this is the first time I'm using this Fido net, so I'm not sure
  60. wether I will get your messages fast or not at all ...)
  61. This Fido node is not Magic BBS, but a BBS I call regularly !
  62.  
  63.  
  64. Or Call our BBS !!!!!
  65.  
  66.            Magic BBS  +32-53-67.19.11
  67.  
  68. On-Line daily 24/24
  69.  
  70. Or Fax us at +32-53+67.38.44
  71.  
  72. ╔══════════════════════════════════════════════════════════════════════╗
  73. ║ I M P O R T A N T                                                    ║
  74. ║                                                                      ║
  75. ║ Please make sure you are using recent version of PKZIP and ARJ !     ║
  76. ║ For PKZIP version 110 and for ARJ version 221. (or above)            ║
  77. ║ Some of the previous versions have bugs and don't work with ZIPLOGO  ║
  78. ║ If you use an old version none of your original dates will be kept ! ║
  79. ╠══════════════════════════════════════════════════════════════════════╣
  80. ║ You must ALWAYS provide a full path to your logofile ! Even if the   ║
  81. ║ file is in your current directory !                                  ║
  82. ║                                                                      ║
  83. ╚══════════════════════════════════════════════════════════════════════╝
  84.  
  85.  
  86.  
  87.  
  88. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.        
  89.  
  90.  
  91.  
  92. I Wrote ZIPLOGO because there just wasn't any program that
  93. could do what I wanted it to do. Which was :add a logo to my
  94. zip-files on my BBS; there was one little utility that could
  95. add a comment to my zip-files, ZIPTXT, a PD program by Louis
  96. Van Geel, but it could only handle one file at a time.
  97.  
  98. If you wanted to add a logo to all your zip-files this could
  99. take many hours of hard work. Accordingly, since I'm not such
  100. a hard worker I developed this little program.
  101.  
  102. ZIPLOGO is completely written in Extended Batch Language.
  103. The colourscreens were converted with ANSI2BAT, also a Magic
  104. Software Ltd. Utility.
  105.  
  106. It took me one month to complete this program, it's not easy
  107. to tell a zip-file how to behave... it took me another two
  108. months to find out how to add a logo to an ARJ-file without
  109. altering the date.
  110.  
  111. After many hours of testing the program finally does what I
  112. want it to do : Add comments to Zip-files, big deal you say?
  113. Maybe, but do you know of any other program that can handle
  114. ALL your ZIP and ARJ -files with a single command ???????
  115.  
  116. Yes that's right ONE command to process your entire harddisk !
  117.  
  118. So now you no longer have a reason not to update all those
  119. old zip-files with the old On-Line hours or a co-sysop's name
  120. in it you would prefer not to see...
  121.  
  122. Anyway, this program is just what you always wanted, but were
  123. afraid to ask !!!
  124.  
  125.  
  126. Ladies and gentlemen, Magic Software Ltd. proudly presents :
  127.  
  128.  
  129.                    ZIPLOGO.EXE
  130.  
  131.  
  132. And now in version 5.0 ZIPLOGO also can add a logo to ARJ-files !
  133. Thanks go to Magnus Ostergren for making my life impossible by
  134. constantly asking me to adapt ZIPLOGO so it could process ARJ's.
  135. It took me a two months to find the correct algorithm, but now
  136. the original date is not updated (unless you use /new)
  137.  
  138.  
  139. Feel free to use it for a trail period of 30 days, if you
  140. want to continue using it, you should register !!!!!
  141.  
  142. Registration gives you the right to a registration key,
  143. this key contains information about your BBS-name.
  144. It will have "Registered to ......... BBS" in it instead of
  145. the "UNREGISTERED VERSION".
  146. So have a heart, register.
  147. Together we can keep shareware alive !!!!!
  148.  
  149.  
  150.  
  151. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.        
  152.  
  153.  
  154.  
  155.  
  156. Features
  157. --------
  158.  
  159. 1) Add any Logo to your zip-files
  160.  
  161. 2) Can process ALL your zip-files with a single command
  162.  
  163. 3) Fully ANSI supported
  164.  
  165. 4) Keeps original Zip-date
  166.  
  167. 5) Process your entire HD with just one command
  168.  
  169. 6) Automatic update facility
  170.  
  171. 7) Give system date to your uploads
  172.  
  173. 8) Check for corrupt or defective ZIP-files
  174.  
  175. 9) All the above for ARJ-files
  176.  
  177.  
  178. Command Line parameters
  179. _______________________
  180.  
  181.  
  182. type ZIPLOGO [ZIPNAME] [LOGOFILE]
  183.  
  184. to process one zip-file
  185.  
  186.  
  187. type ZIPLOGO [LOGOFILE] [/ALL]
  188.  
  189. to process ALL zip-files in your current directory
  190.  
  191.  
  192. type ZIPLOGO [LOGOFILE] [/ALL] [/CFG]               
  193.                                                      
  194. to process ALL zip-files on your Hard Disk
  195. (please read chapter 5 to see how CFG-file should be made.)
  196.  
  197.  
  198. type ZIPLOGO [LOGOFILE] [/NEW]                       
  199. to process all ZIP-files in directory and give Systemdate
  200. ╔══════════════════════════════════════════════════════════════════════════╗
  201. ║ type [/ARJ] AFTER each of the commands to process ARJ instead of ZIP !!! ║
  202. ╚══════════════════════════════════════════════════════════════════════════╝
  203.  
  204.  
  205. Notes :
  206.  
  207. You need PKZIP by PKWARE to process your ZIP-files.
  208. You need ARJ by Robert K Jung to process your ARJ-files.
  209. ZIPNAME should not have an extension, ZIP or ARJ is presumed.
  210.  
  211.  
  212. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.        
  213.  
  214.  
  215.  
  216. [1] ADD ANY LOGO TO YOU ZIP-FILES
  217. _________________________________
  218.  
  219. Using an ASCII editor like DGEDIT or WORDSTAR you can create
  220. an Logo File. After processing the zipped file with ZIPLOGO,
  221. your logo will be displayed each time the file is unzipped.
  222.  
  223. A logo could look like this :
  224.                                                                     
  225.                                                                     
  226.   ╔════════════════════════════════════════════════════════════════╗
  227.   ║                    Welcome to the world of                     ║
  228.   ║                                                                ║
  229.   ║       ▌▌     ▌▌    ▌▌▌▌▌     ▌▌▌▌▌▌▌▌   ▌▌▌    ▌▌▌▌▌▌▌▌        ║
  230.   ║       ▌▌▌   ▌▌▌   ▌▌   ▌▌   ▌▌▌               ▌▌▌              ║
  231.   ║       ▌▌▌▌▌▌▌▌▌   ▌▌▌▌▌▌▌   ▌▌    ▌▌▌   ▌▌▌   ▌▌               ║
  232.   ║       ▌▌▌ ▌ ▌▌▌  ▌▌▌   ▌▌▌  ▌▌▌    ▌▌   ▌▌▌   ▌▌▌              ║
  233.   ║       ▌▌▌   ▌▌▌  ▌▌▌   ▌▌▌   ▌▌▌▌▌▌▌    ▌▌▌    ▌▌▌▌▌▌▌▌        ║
  234.   ║                                                                ║
  235.   ║              On-Line Daily 24/24 2400B MNP2-5                  ║
  236.   ╚═════╦═══════════════════════════════════════════════════╦══════╝
  237.         ║   32+53-67.19.11  Your Sysop : Steven Debruyn     ║       
  238.         ╚═══════════════════════════════════════════════════╝       
  239.                                                                     
  240.  
  241.  
  242.  
  243. [2] PROCESS ALL YOUR ZIP-FILES WITH A SINGLE COMMAND
  244. ____________________________________________________
  245.  
  246.  
  247. Use the /ALL parameter
  248.  
  249. e.g.  ZIPLOGO c:\pb\bbstxt /all
  250.  
  251. will update all zip-files in your current directory.
  252.  
  253.  
  254. This feature by itself should be worth registering.
  255.  
  256.  
  257.  
  258. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.        
  259.  
  260.  
  261.  
  262. [3] FULLY ANSI SUPPORTED
  263. ________________________
  264.  
  265.  
  266. If your zip-file contains ANSI codes, it will be displayed in
  267. colour when unzipping it with the -q option.
  268.  
  269. e.g. PKUNZIP MAGIC.ZIP -q
  270.  
  271. will display the Logofile in colour (if any)
  272.  
  273. To make colour screens you could use THEDRAW.
  274.  
  275. For ARJ-files with ansi the command is :
  276.  
  277. ARJ X -JA [FILENAME]
  278.  
  279.  
  280. [4] KEEP ORIGINAL ZIPDATE
  281. _________________________
  282.  
  283.  
  284.  
  285. The original Zipdate is left unaltered, because most BBS
  286. programs use this date to check for new files.
  287.  
  288.  
  289.                                                                                
  290.                                                                                 
  291. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.                             
  292.                                                                                 
  293. [5] PROCESS YOUR ENTIRE HD WITH 1 COMMAND                                       
  294. _________________________________________                                       
  295.                                                                                 
  296.                                                                                 
  297. Syntax :  ZIPLOGO  [LOGOFILE]  [/ALL]  [/CFG]                                   
  298.                                                                                 
  299. You need a file called ZIPLOGO.CFG                                              
  300.                                                                                 
  301. This file should contain a list of your paths to process.                       
  302.                                                                                 
  303. To create one:                                                                  
  304. e.g.                                                                            
  305.                                                                                 
  306. COPY CON ZIPLOGO.CFG                                                            
  307. c:\pb\hack                                                                      
  308. d:\data\files1                                                                  
  309. c:\zip\files\new                                                                
  310. e:\bbs\up                                                                       
  311. ^Z                                                                              
  312.                                                                                 
  313.                                                                                 
  314. This option was included for Sysops who want to process all their files in      
  315. all their different subdirectories. (Useful the first time you use ZIPLOGO     
  316. on your BBS.) If you have lots of files in lots of  subdirs, this option is
  317. the solution or if you want to install a brand new logo.                          
  318.                                                                                 
  319. You write the ZIPLOGO.CFG file, run ZIPLOGO and just sit back and relax         
  320. (or go out and have a drink if you have a huge HD), by the time you get         
  321. back all your zip-files will contain your new Logo !!!                          
  322.  
  323.  
  324. NOTE : Depending on the ammount of files the building of the programlist can
  325. take several minutes. In version 5.0 these routines have been speeded up by
  326. as much as 80% 
  327.  
  328.  
  329.                                                                                
  330.                                                                                 
  331. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.                             
  332.                                                                                 
  333.                                                                                 
  334.                                                                                 
  335. [6] AUTOMATIC UPDATE FACILITY                                                   
  336. _____________________________                                                   
  337.                                                                                 
  338.                                                                                 
  339. If you have files that already contain a logo, made by another similar          
  340. program, ZIPLOGO will sense that and automatically update it with your          
  341. new Logo. The old logo will be displayed on the screen.(if any)                 
  342.                                                                                 
  343. So feel free to use ZIPLOGO on ALL your zip-files, that's why it was written    
  344. in the first place. You needn't fear for zip-files with old logos, they        
  345. will simply be updated.                                                         
  346.                                                                                 
  347.                                                                                 
  348.                                                                                 
  349. In Short :                                                                      
  350.                                                                                 
  351. - The old logo is removed                                                       
  352.                                                                                 
  353. - The new logo is added                                                         
  354.                                                                                 
  355. - No matter what program made the old logo !!!  
  356.                                                                                 
  357.                                                                                 
  358. [7] Give system date
  359. ____________________
  360.  
  361. You can give the system date to all your zipfiles in the current directory
  362. Handy for the uploads ... they will then be shown as new files since most
  363. BBS programs look for the date of the files.
  364. I have made it so that the /NEW feature doesn't work with the CFG-file so
  365. that even the dumbest Sysop can't mess up his entire HD ...
  366.  
  367.  
  368. [8] Check Zip-files
  369. ___________________
  370.  
  371. All Zip-files are now checked for errors, if an error occurs a file called
  372. ZIPLOGO.ERR will be written, containing the name of the file and the error 
  373. that occured .
  374.  
  375. A logo will not be given to the corrupted files so you can use PKZIPFIX on 
  376. them.                                                                           
  377.                                                                                
  378. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.                             
  379.                                                                                 
  380.                                                                                 
  381. [9] All the above for ARJ-files
  382.  
  383. -------------------------------
  384.  
  385. If you want to process ARJ-files just add [/ARJ] after the other
  386. commandline parameters.
  387.  
  388.  
  389.  
  390.                             TROUBLE SHOOTING                                    
  391.                             ================                                    
  392.                                                                                 
  393.                                                                                 
  394. Q. I used ZIPLOGO and after I unzipped one of my files the logo contains        
  395.    a line of ASCII, a blank line,a line of ASCII, a blank line...               
  396.                                                                                 
  397. A. Simple, you must make sure that your Logo-file does not contain spaces      
  398.    at the end of EACH line.  You can solve this problem (and you can see it)    
  399.    by taking an ASCII wordprocessor and use the "End" key. If you don't jump    
  400.    to the last ASCII character on that line, delete all the spaces after it !!   
  401.    Repeat this process for each line.                                           
  402.                                                                                 
  403. Q. An other program made my old Logo. It's not a well-known program.             
  404.    Will it be compatible ???                                                    
  405.                                                                                 
  406. A. Yes, it will. This program senses old Logo's, and will automatically update  
  407.    them. If you're still not convinced, copy one of your old zip-files          
  408.    containing your old logo in a subdir and try it out. You'll see there was    
  409.    nothing to worry about.                                                      
  410.                                                                                 
  411. Q. I used an ANSI-file as my logo. When I unzip it I see a lot of rubbish       
  412.    but no colours. When I update it again I can see my colours.                 
  413.    This is driving me crazy !!!  What am I doing wrong ???                      
  414.                                                                                 
  415. A. When using an ANSI-file as your Logo, you should unzip it with the           
  416.    [-q] option.                                                                 
  417.    e.g. PKUNZIP XPROMPT -q                                                      
  418.    and behold, there are your colours !!!!                                      
  419.    This is not a limitation of ZIPLOGO but one of the defaults of PKZIP         
  420.    I don't know why they don't give ANSI-support without the -q parameter.      
  421.  
  422. Q. Ziplogo seems to hang when I use it. Is that a BUG ?
  423.  
  424. A. Could be a bug, but check is you gave a full path to your logo-file
  425.    You MUST give a full path !!! Even if the logo-file is in your current
  426.    directory !
  427.  
  428. Q. I used a /All and it doen't work !
  429.    
  430. A. /All or /Arj is not the same as /ALL or /all or /ARJ or /arj !
  431.    You should mix ! Use only upper or only lower case !
  432.    The same goes for /CFG or any other parameter !!!
  433.  
  434.  
  435.                                                                                
  436.                                                                                 
  437. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.                             
  438.                                                                                 
  439.                                                                                 
  440. Q. I live in the U.S.A., how can I register this wonderful program ???         
  441.    I would like to see my name instead of the "UNREGISTERED VERSION"            
  442.    What country is Belgium in anyway ???                                        
  443.                                                                                 
  444. A. That's one of the many things our BBS is for !!! You can call Magic BBS      
  445.    +32-53-67.19.11  or write to Steven Debruyn                                  
  446.                                 Welleplein 29/22                                
  447.                                 9473  Welle                                     
  448.                                 Belgium                                         
  449.                                                                                 
  450.    for future updates and registrations.                                        
  451.    or fax your registration form or questions to +32-53-67.38.44              
  452.    
  453.    Fill in the registration form and upload it or send it by mail. We have      
  454.    Z-modem, Y-modem, X-modem, Lynx, Puma and Bimodem protocols. 
  455.    Your registration key will be made. You can either download your    
  456.    registration key or it can be sent to you by mail. If you choose mail,        
  457.    please add 100 BEF for postage and packaging.                                     
  458.    As soon as the money reaches me, your copy will be put on the BBS as a       
  459.    personal file, or will be sent by mail.                                      
  460.                                                                                 
  461. Q. How much is 500 BEF ???                                                      
  462.                                                                                 
  463. A. BEF stands for Belgian Franks. Go to your local Bank, they can tell you      
  464.    how much that is in your local currency. (It's not much!!!)                  
  465.    I think 100 BEF is about 3 $ (more or less...)                         
  466.    If you send money, only send notes and make sure that the enveloppe
  467.    is sealed properly !!!
  468.                                                             
  469.                                                                                 
  470.                                                                                 
  471.                                                                                 
  472.                                                                                
  473. ZIPLOGO  Version 5.0  (c) 1991  Magic Software Ltd.  
  474.  
  475.                        ZIPLOGO REGISTRATION FORM                                
  476.                                                                                 
  477. BBS NAME : _____________________________________________                        
  478.                                                                                 
  479. Sysop Name : ___________________________________________                        
  480.                                                                                 
  481. Your real Name : _______________________________________                        
  482.                                                                                 
  483. Where did you obtain ZIPLOGO :__________________________
  484.  
  485. Name to put in Registered Version :                                             
  486. Registered to __________________________________________                        
  487.                                                                                 
  488. Your Data Phone : ______________________________________                        
  489. Your Voice Phone : _____________________________________                        
  490. Your Fax Phone : _______________________________________                        
  491.                                                                                 
  492. Your On-Line Hours : ___________________________________                        
  493.                                                                                 
  494. Address : ______________________________________________
  495.          _______________________________________________                        
  496.          _______________________________________________                        
  497.          _______________________________________________                        
  498.          _______________________________________________                        
  499.          _______________________________________________                        
  500.                                                                                 
  501.                                                                                 
  502. I would like to register _____ copies of ZIPLOGO                                
  503.                       x  500 BEF              Send to : Steven Debruyn          
  504.                       _________                         Welleplein 29/22        
  505.                                                         9473 Welle              
  506.                       .........  BEF                    Belgium                 
  507.                    +  .........  BEF (postage)                                  
  508.                       _________                  FAX : +32-53-67.38.44          
  509.                                                  BBS : +32-53-67.19.11          
  510.                       .........  BEF                                            
  511.                                                                                
  512.  
  513.