home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / PWRGIF12.ZIP / POWRGIF.DOC < prev    next >
Encoding:
Text File  |  1992-12-31  |  11.7 KB  |  232 lines
  1.                                                                          
  2.  
  3.                                     Power*GIF 
  4.                                  V1.2 - 12/31/92
  5.  
  6.         Generates GIF Preview Files Using GIFDESK for PowerBBS Systems 
  7.  
  8.                                 Copyright (c) 1992
  9.                                  Stephen W. Nolen
  10.                                ProtoWrxs! Software
  11.                                    P O Box 0247
  12.                              Tecumseh, OK 74873-0247
  13.  
  14.            For other ProtoWrxs! products call our BBS, The ProtoBoard!
  15.                 12/24/9600 USRobotics v.32/v.42bis 24 Hrs / 7 Days
  16.                       Node 1 (405) 275-6827 1:147/38 FidoNet
  17.  
  18.                                   * NOTICES *
  19.                       PowerBBS is copyright (c) Russell Frey 
  20.             Power*GIF should not be confused with any products that 
  21.            Russell Frey is/willbe marketing and is not associated with 
  22.                       Russell Frey and/or PowerBBS Software. 
  23.                   Windows is copyright (c) MicroSoft Corporation
  24.  
  25.                                      OVERVIEW 
  26.         
  27.         Power*GIF is a PowerLang program that will generate a GIF preview 
  28.         file from the GIF filenames provided by the BBS user.  Power*GIF 
  29.         was/is an exercise in programming in PowerLang after seeing a 
  30.         generic door program that does the same thing. Power*GIF will ask 
  31.         the user for the layout they wish to use and then prompt for the 
  32.         proper GIF filenames to include in the preview GIF.  It then uses 
  33.         Jay Wherley's GIFDESK program to actually generate the file. 
  34.         Power*GIF also offers a link to list files, search files and 
  35.         change the current forum while entering GIF filenames. 
  36.         
  37.         
  38.         Power*GIF should work on any PowerBBS system v1.91 or higher and 
  39.         should properly run under multi-node systems and under the 
  40.         Windows or DOS versions without problems. Power*GIF requires a 
  41.         PowerBBS version that at least supports the |UPDIR| macro.
  42.  
  43.                              Even with that in mind,
  44.                                     DISCLAIMER
  45.  
  46.         ProtoWrxs!  and it's employees make no warranty of any kind, 
  47.         expressed or implied, including without limitation, any 
  48.         warranties of merchantability and/or fitness of ProtoWrxs! 
  49.         products for a particular purpose.  Stephen W.  Nolen and 
  50.         ProtoWrxs! Software shall not be liable for any damages, whether 
  51.         direct or indirect, special or consequential arising from a 
  52.         failure of this program or the functions contained in the 
  53.         included files.  Stephen W. Nolen and ProtoWrxs!  Software shall 
  54.         not be liable for any damage to data or property which may be 
  55.         caused directly or indirectly by the use or mis-use of this 
  56.         program or the functions contained in the included files.  In no 
  57.         event shall Stephen W. Nolen or ProtoWrxs! Software, be liable to 
  58.         you for any damages, including lost profits, lost savings, or 
  59.         other incidental or consequential damages arising from the use or 
  60.         inability to use this product or for any claim by any other party. 
  61. 2
  62.                              OPERATION / INSTALLATION 
  63.         
  64.                    STEP ONE - Setup and Configure the POW File
  65.         
  66.         First you must put the POWRGIF.POW file in your PowerBBS 'source' 
  67.         directory, usually \POWRBBS\SOURCE. You will also need to create 
  68.         a numbered POW file that matches the command number you have 
  69.         given for this option, such as the 99.pow included, that contains 
  70.         at least the following; 
  71.  
  72.         RUN "C:\POWRBBS\SOURCE\POWRGIF"
  73.  
  74.         If you use a different primary hard drive then make the 
  75.         appropriate changes as required.  If you do NOT understand how to 
  76.         add external commands or PowerLang files to your PowerBBS system 
  77.         then read the documentation on the subject. 
  78.         
  79.         Use your favorite non-document editor, edit the POWRGIF.POW file 
  80.         and make the changes as suggested at the beginning of the 
  81.         program.  You must provide;
  82.         
  83.         1) S4 as the drive letter of where PowerBBS resides. This is 
  84.         normally set at C: 
  85.         
  86.         2) S5 as the drive and subdirectory to place the generated GIF 
  87.         files, this should ALWAYS end in a \ character. (be SURE to add 
  88.         this to your DLDIR.DAT file or the system will not be able to 
  89.         find the new GIFs to download) 
  90.         
  91.         We suggest that you include in your daily maintenance batch file 
  92.         the command to delete all GIF files in the subdirectory where the 
  93.         generated files are placed.  This way the system will 
  94.         automatically do the house cleaning for you.  
  95.         
  96.         3) S6 as the directories that Power*GIF is to look into for the 
  97.         GIF files. These are all of the directories that Power*GIF should 
  98.         look into to try and find the requested GIF files. These should 
  99.         also end in the \ character. Note that the entries are separated 
  100.         by a space and the limit for the string length is set at 72 
  101.         characters based on PowerBBS documentation.
  102.  
  103.         If you currently do NOT have your GIF files grouped into 
  104.         subdirectories, we suggest that you rearrange your system to do 
  105.         so since it is MUCH easier to maintain the system in this manner 
  106.         and speeds the execution of Power*GIF.                 
  107.         
  108.         If you have some forums that have access to limited distribution 
  109.         GIF files such as an Adult forum, you can provide for this by 
  110.         setting S11 to the EXACT FORUM NAME, including any UPPER/lower 
  111.         case lettering. If you are going to do this, run the PowerBBS 
  112.         config program and write down the forum names exactly as they are 
  113.         shown and then read the program comment lines to set these up.
  114.         
  115.         4) S7 as the drive you will install GIFDESK onto. You should 
  116.         select a drive that has adequate free space since each requested 
  117.         GIF is temporarily copied to this drive and GIFDESK requires and 
  118.         additional 768K to create the preview file.
  119. 3
  120.         
  121.         5) S8 as the base subdirectory of where you are going to put 
  122.         GIFDESK. The |NODE#| will be added to this automatically. We 
  123.         suggest that you use \GIFDESK. DO NOT PUT A TRAILING \ ON THIS 
  124.         ENTRY SINCE THE NODE NUMBER MUST BE APPENDED TO IT. 
  125.         
  126.                 STEP TWO - Create Subdirectories and Setup GIFDESK
  127.         
  128.         Power*GIF requires GIFDESK v4.x to run.  This freeware program is 
  129.         included in the Power*GIF archive.  You must create the
  130.         subdirectory(ies) for GIFDESK on the drive and named as you have 
  131.         set the values S7 and S8 above. This is required for EACH node 
  132.         that will run Power*GIF and the suggested name is \GIFDESK<node#> 
  133.         where <node#> is the number of the node, i.e.  0, 1, 2, etc. If, 
  134.         for example, if you run a TWO node system AND have a local '0' 
  135.         node, you would need to have the following subdirectories 
  136.         available; 
  137.  
  138.         \GIFDESK0
  139.         \GIFDESK1
  140.         \GIFDESK2
  141.         
  142.         In EACH of these directories, copy the GIFDESK4.EXE file and run 
  143.         the self extracting archive by typing GIFDESK4 and pressing 
  144.         RETURN.  You can then delete the GIFDESK4.EXE file.  Each node 
  145.         MUST have it's OWN GIFDESK program due to the way GIFDESK 
  146.         operates using the GIFDESK.CMD file.  Power*GIF works by copying 
  147.         the requested GIF files to these subdirectories so make sure that 
  148.         the hard drive that is to be used has enough free space to move 
  149.         the files to. 
  150.         
  151.         Power*GIF will create a batch file called POWRGIF<node#>.BAT in 
  152.         the |UPDIR| subdirectory which when executed will copy the GIF 
  153.         files and tell GIFDESK what to do.  This file is erased after 
  154.         each time a user runs Power*GIF on that particular node. 
  155.         
  156.         Once these steps are completed, you can run Power*GIF from the 
  157.         BBS.  If you are logged on locally, you will see the freeware 
  158.         notice and see the files as they are being copied.  Your users, 
  159.         however, will only see the status information from GIFDESK when 
  160.         logged onto a normal COM port. 
  161.         
  162.                                      TROUBLES
  163.         
  164.         If you receive an 'Out of Environment' error in the batch file, 
  165.         try adding SET GIFDESK=FILE to your AUTOEXEC.BAT file.
  166.  
  167.         GIFDESK requires 768K of hard drive space to run AFTER the GIF 
  168.         files have been copied. If the program keeps aborting without 
  169.         generating a file, check you hard drive free space. 
  170.  
  171.         If you get 'file not found' errors or you know the GIFs are out 
  172.         there but they are not being copied, then you have not setup the 
  173.         proper directories in the POWRGIF.POW file or have not installed 
  174.         the GIFDESK program(s) properly. 
  175.        
  176.         Sorry, there is nothing that can be done about the tone when the 
  177.         GIF file has been written. That is inside of GIFDESK. Talk to Jay 
  178.         about that one. :)
  179.  
  180. 4
  181.                                    DISTRIBUTION 
  182.                 
  183.         Power*GIF is COPYRIGHTED by ProtoWrxs!  Software and Stephen W.  
  184.         Nolen and all rights are reserved.  This program is being 
  185.         distributed as FREEWARE software and and no further registration 
  186.         is required. I do ask that you strongly consider supporting the 
  187.         shareware concept since this the one of the primary reasons there 
  188.         are so many try-before-you-buy programs available.
  189.         
  190.         Power*GIF may be copied freely with the following restrictions: 
  191.  
  192.         o The program must be supplied in it's original unmodified form, 
  193.           including documentation. The following files must be included:
  194.  
  195.                 POWRGIF.POW  - Executable PowerLang File 
  196.                 99.POW       - Sample starting PowerLang file.
  197.                 POWRGIF.DOC  - DOCumentation file in ASCII format
  198.                 GIFDESK4.EXE - Self Extracting Archive of GIFDESK v4 
  199.                 FILE_ID.DIZ  - Program description Text
  200.                 DESC.SDI     - Program description Text
  201.                 
  202.         o Power*GIF may not be distributed as part of any other 
  203.           application or service without the express written consent of 
  204.           the author. 
  205.       
  206.         o The preferred filename and description for BBS Sysops to use is 
  207.           as follows:
  208.           
  209.           PWRGIFxx.ZIP - GIF Preview Generator for PowerBBS Systems 
  210.         
  211.         The x's should be the current major/minor release versions.
  212.  
  213.         If you'd like to see other ProtoWrxs!  Software products, feel 
  214.         free to call The ProtoBoard!  Node 1 at 405-275-6827 12/24/9600 
  215.         v.32.  Visiting sysops that reciprocate access with Stephen W.  
  216.         Nolen are allowed special access to the board. 
  217.  
  218. 5
  219.                                      HISTORY
  220.  
  221.         v1.0Beta - 12/01/92 - BETA Test version on The ProtoBoard! BBS 
  222.         v1.1     - 12/15/92 - First Released Public Version 
  223.         v1.2     - 12/31/92 - Added File List link, drive choices
  224.                               special forum access routines and links.
  225.  
  226.                              BUGS AND OTHER VARMENTS
  227.         If you should find any bug and/or other varments in Power*GIF, 
  228.         give The ProtoBoard!  a call and leave a comment to me in the 
  229.         ProtoWrxs!  forum.  I'll check out the problem and make the fix 
  230.         available if required.  That's all folks! 
  231.  
  232.