home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / b / bbsads2.zip / BBS-ADS.DOC < prev    next >
Text File  |  1993-02-28  |  12KB  |  286 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                   BBS-ADS 2.0
  7.  
  8.              Copyright (C) 1993 by Main Street Programming Services
  9.                              & Madison Farrell, III
  10.  
  11.  
  12.  
  13.  
  14.                                SHAREWARE VERSION
  15.  
  16.           You may try this program for 30 days.  After this evaluation
  17.                period, you must register the program or erase it.
  18.  
  19.                      Registration for version 2.0 is $7.00
  20.  
  21.  
  22.  
  23.                                TABLE OF CONTENTS
  24.  
  25.  
  26.     Disclaimer........................................................ 1
  27.     
  28.     Introduction to BBS-ADS/Limitations............................... 2
  29.     
  30.     Installation of BBS-ADS/File syntax............................... 3
  31.     
  32.     Final Notes & Caveats/Contacting us............................... 4
  33.     
  34.     Registration Form................................................. 5
  35.     
  36.  
  37.  
  38.  
  39.                                      DISCLAIMER
  40.  
  41.               Users of BBS-ADS must accept  this  disclaimer  of  warranty: 
  42.          "BBS-ADS  is supplied as is.  The author disclaims all warranties, 
  43.          expressed  or  implied,   including,   without   limitation,   the 
  44.          warranties of merchantability and of fitness for any purpose.  The 
  45.          author assumes no liability for damages,  direct or consequential, 
  46.          which may result from the use of BBS-ADS." 
  47.               BBS-ADS is a "shareware program" and is provided at no charge 
  48.          to  the  user  for  evaluation.  Feel  free  to share it with your 
  49.          friends,  but please do not give it away altered  or  as  part  of 
  50.          another  system.  The  essence  of "user-supported" software is to 
  51.          provide personal computer users with quality software without high 
  52.          prices,  and yet to provide incentive for programmers to  continue 
  53.          to develop new products.  
  54.               If  you  find  BBS-ADS to be a useful program and continue to 
  55.          use it after a reasonable trial period (30 days),  you must make a 
  56.          registration payment of $7.00 to Madison Farrell,  III.  The $7.00 
  57.          registration fee will license one copy for use on any one computer 
  58.          at any one time. 
  59.               Anyone distributing BBS-ADS for any kind of remuneration must 
  60.          first  contact  Main  Street  Programming  Services at the address 
  61.          below  for  authorization.  Main  Street Programming Services must 
  62.          be advised so that the distributor can be kept up-to-date with the 
  63.          latest  version  of  BBS-ADS.
  64.               You are encouraged to pass a copy of BBS-ADS  along  to  your 
  65.          friends  for  evaluation.  Please encourage them to register their 
  66.          copy if they find that they can use it.  
  67.  
  68.  
  69.  
  70.                                INTRODUCTION TO BBS-ADS
  71.          
  72.                           
  73.               BBS-ADS is a program designed to include a BBS  advertisement 
  74.          inside  an archive file.  While some may frown upon this practice, 
  75.          the addition of such advertisements has become quite common.  BBS-
  76.          ADS simplifies this task,  inserting a differently named file into 
  77.          each   archive   it   processes.    BBS-ADS   will   also   delete 
  78.          advertisements from archive files that  are  transmitted  to  your 
  79.          system,  allowing  you  to unclutter the archive or easily replace 
  80.          the advertisement from some other system with one of your own.
  81.  
  82.  
  83.                         LIMITATIONS OF THE SHAREWARE VERSION
  84.  
  85.                  
  86.               The  SHAREWARE  version  of  BBS-ADS  is  limited only by the 
  87.          number of ad-filenames it can select for  inclusion  or  deletion.  
  88.          It  is  fully  functional  in every other aspect.  This version of 
  89.          BBS-ADS can only process five ad-filenames.  
  90.  
  91.               You may use BBS-ADS for 30 days.  After  30  days,  you  must 
  92.          register the program or delete it.  
  93.  
  94.  
  95.  
  96.  
  97.                                INSTALLATION OF BBS-ADS
  98.  
  99.  
  100.               In order for BBS-ADS to  operate  properly,  you  must  first 
  101.          create  three files:  BBS-ADS.CFG,  BBS-ADS.LST,  and BBS-ADS.DEL.  
  102.          These files  should  be  created  in  the  same  sub-directory  as 
  103.          BBS-ADS.EXE.
  104.          
  105.          * VERSION 1.0 users please note that the format of BBS-ADS.CFG has 
  106.            changed!  You will need to create the file using the DOS COPY 
  107.            CON command or BBS-ADS built-in editor (explained below). 
  108.  
  109.               This version  of  BBS-ADS  has  a  built-in  editor  to  make 
  110.          creating these necessary files easier.  To invoke the BBS-ADS file 
  111.          editor,  type  "BBS-ADS  /ADS"  at the DOS prompt and press ENTER.  
  112.          The editor will present you with options to create each individual 
  113.          file as well as  return  to  DOS.  The  editor  will  accept  most 
  114.          characters  generated  by  the  keyboard,  but  please  note  that 
  115.          pressing ENTER without any input will retain the old data for that 
  116.          particular entry.  (ie.  Pressing ENTER when prompted for the  new 
  117.          archive  add  command when the old archive add command is PKZIP -a 
  118.          will retain the PKZIP -a in the new file)  
  119.  
  120.  
  121.                              SYNTAX OF ADDITIONAL FILES
  122.  
  123.  
  124.               BBS-ADS.CFG contains the  configuration  data  necessary  for 
  125.          BBS-ADS.EXE  to  process your archive.  The syntax for BBS-ADS.CFG 
  126.          is:  
  127.  
  128.          Line 1 ---> The name of your archive utility plus the command it 
  129.                      uses to add a file to an archive.
  130.          
  131.          Line 2 ---> The name of your archive utility plus the command it
  132.                      uses to delete a file from an archive.
  133.  
  134.          Line 3 ---> The filename of the master ad-file you want included
  135.                      inside of processed archives.
  136.  
  137.                   An example configuration file might read as this: 
  138.  
  139.                                     (1) PKZIP -a
  140.                                     (2) PKZIP -d
  141.                                     (3) MASTER.AD
  142.  
  143.               BBS-ADS.LST contains the listing of filenames that are to  be 
  144.          chosen from during the selection of names for the ad-file.  
  145.  
  146.  
  147.  
  148.          *  Please note that this list is limited to only five filenames in 
  149.             the shareware version of BBS-ADS; however, registered users may 
  150.             include up to 99 files in this list.  
  151.  
  152.                          An example configuration might be:
  153.  
  154.                           (1) readme.now
  155.                           (2) whatthis.txt
  156.                           (3) super.bbs
  157.                            .
  158.                            .
  159.                            .
  160.                          (99) megabord.bbs
  161.  
  162.               BBS-ADS.DEL  is  configured  just  as  BBS-ADS.LST;  however, 
  163.          filenames  included  in  BBS-ADS.DEL  are  deleted  from  archives 
  164.          processed by BBS-ADS.EXE.  
  165.  
  166.          * These files can be created from the BBS-ADS built-in editor, any 
  167.            ASCII editor, or the DOS COPY CON command.
  168.  
  169.               After creating the files necessary for BBS-ADS to operate, it 
  170.          will need to be included in whatever batch file executes  AFTER  a 
  171.          file upload.
  172.  
  173.                         The proper syntax for BBS-ADS.EXE is:
  174.  
  175.                                 BBS-ADS filename.ext
  176.  
  177.               In  most  cases,  the  filename.exe  is  passed  from the BBS 
  178.          software to the batch file in parameter %1.  This  may  vary  from 
  179.          software  to  software.  Please  consult the information that came 
  180.          with your BBS software.  
  181.  
  182.  
  183.  
  184.  
  185.                                FINAL NOTES AND CAVEATS
  186.  
  187.  
  188.               BBS-ADS will  execute  after  EVERY  successful  upload.  You 
  189.          should  be warned that if you execute this particular file on more 
  190.          than one occasion with a previously verified file then  more  than 
  191.          one ad-file will be included in the archive.  For example,  if you 
  192.          are  using  PCBoard  and  run  a  TEST  on   a   file   previously 
  193.          uploaded/scanned  and processed by BBS-ADS,  then you will run the 
  194.          risk of inserting another ad-file into the archive.  
  195.  
  196.               In most instances,  this should not present a  problem  since 
  197.          files  are  generally  verified  and  processed only one time on a 
  198.          system.
  199.  
  200.          
  201.                                 CONTACTING US
  202.  
  203.  
  204.                 Should you have any  questions,  comments,  or  suggestions 
  205.          about  this  particular  program,  then  please do not hesitate to 
  206.          contact me. (While preference is given to registered users, I will 
  207.          also listen to anything an unregistered user  might  have  to  say 
  208.          about BBS-ADS.)
  209.  
  210.                          Please send all correspondence to:
  211.  
  212.                                 Madison Farrell, III
  213.                                 Rt.3 Box 658
  214.                                 Walterboro, SC  29488
  215.  
  216.                             This address is always valid.
  217.  
  218.                  You can also contact us through our support board:
  219.          
  220.               Main Street -- (803) 538-4084 -- 12/24/96/14.4/38.4 kbps
  221.              We operate 24 hours a day with 105 megs currently on-line. 
  222.          
  223.  
  224.  
  225.  
  226.                               REGISTRATION INFORMATION
  227.  
  228.          BBS-ADS  is  SHAREWARE.  If  you find the program of use to you or 
  229.          your computer system, you are REQUIRED to pay for it.  The current 
  230.          registration fee is only $7.00.  If after 30 days you do not  find 
  231.          the program worth $7.00 then you must erase it from your system.   
  232.  
  233.         Please  fill  out the following information and return it with your 
  234.         remittance.  
  235.  
  236.         (PLEASE PRINT)
  237.  
  238.         ___________________________________________________________________
  239.         NAME
  240.         ___________________________________________________________________
  241.         COMPANY
  242.         ___________________________________________________________________
  243.         ADDRESS
  244.         ___________________________________________________________________
  245.         CITY/STATE                     ZIP                  COUNTRY
  246.         ___________________________________________________________________
  247.         TELEPHONE
  248.         ___________________________________________________________________
  249.         PASSWORD (16 letters max.)
  250.         ___________________________________________________________________
  251.         YOUR BOARD'S NAME AND NUMBER
  252.  
  253.         WOULD YOU LIKE A COPY OF THE SOURCE CODE?: Y ____ N ____
  254.         SOURCE CODE IS AN ADDITIONAL $15.00.
  255.  
  256.         VERSION OF BBS-ADS BEING REGISTERED IS:_______
  257.  
  258.         Your registration will entitle you to access  on  Main  Street  and 
  259.         program  support.  You  will  also  receive a registered version of 
  260.         BBS-ADS which allows more than five ad-files to be processed.  
  261.  
  262.         ADDITIONAL COMMENTS OR SUGGESTIONS:
  263.         
  264.         ___________________________________________________________________
  265.  
  266.         ___________________________________________________________________
  267.  
  268.         ___________________________________________________________________
  269.  
  270.         ___________________________________________________________________ 
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.                   Thanks to each sysop that has registered BBS-ADS!  
  282.  
  283.  
  284.  
  285.  
  286.