home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / LWBULL21.ZIP / LWBULL.DOC < prev    next >
Encoding:
Text File  |  1994-09-21  |  16.6 KB  |  414 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.       ║      ║       ╔══╗  ╔╗   ║ ╔════╗   ║    ║  ╔══╗  ╔════╗ ╔═════
  24.       ║      ║      ╔╝  ╚╗ ║║   ║ ║    ║   ║    ║ ╔╝  ╚╗ ║    ║ ║
  25.       ║      ║      ║    ║ ║╚╗  ║ ║    ║   ║    ║ ║    ║ ║    ║ ║
  26.       ║      ║      ╠════╣ ║ ╚╗ ║ ║    ║   ║ ╔╗ ║ ╠════╣ ╠═╦══╝ ╠═══
  27.       ║      ║      ║    ║ ║  ╚╗║ ║    ║   ║╔╝╚╗║ ║    ║ ║ ╚╗   ║
  28.       ╚═════ ╚═════ ║    ║ ║   ╚╝ ╚════╝   ╚╝  ╚╝ ║    ║ ║  ╚═╗ ╚═════
  29.  
  30.                                    Presents
  31.  
  32.              ║    ║    ║    ╔══╗  ║  ║ ║    ║
  33.              ║    ║ ╔╗ ║ ───╠══╩╗ ║  ║ ║    ║
  34.              ║    ║╔╝╚╗║    ║   ║ ║  ║ ║    ║  VERSION 2.1
  35.              ╚═══ ╚╝  ╚╝    ╚═══╝ ╚══╝ ╚═══ ╚═══
  36.  
  37.                     Copyright 1992,1993,1994 by Bob DaCastello
  38.  
  39.  
  40.              The News and Bulletin Door for Remote Access 2.x !!
  41.                  
  42.  
  43.  
  44.                                ╔══════════════╗
  45.                                ║ INTRODUCTION ║
  46.                                ╚══════════════╝
  47.  
  48.    Ever wanted your users to be able to view your bulletins, news files,
  49.    score files from your door or any other information files?  Well, now you
  50.    can!!
  51.    LWBULL will allow you present your bulletins or other information to you
  52.    and they will be able to see which ones are new since the last time they
  53.    logged on!
  54.    Once registered you will also be able to set individual selections as
  55.    Mandatory reading!
  56.  
  57.  
  58.                                  ╔══════════╗
  59.                                  ║ FEATURES ║
  60.                                  ╚══════════╝
  61.  
  62.  * Allows you present News, Bulletins, Door Scores or any other Text Files
  63.    to your users and informing them of which ones are new since the last
  64.    time they logged on to your BBS.
  65.  
  66.  * Allows you to edit the descriptions of the individual entrys.
  67.  
  68.  * {+} You can mark items as MANDATORY, the user will then be required 
  69.    to view the file before leaving the door.  If the item is marked as
  70.    Mandatory and it is a new file then they must view it at least once!
  71.  
  72.  * Allows either ANSi or ASCII files to be displayed.  If the caller is  
  73.    using ANSi and there is no *.ANS file to be displayed, LWBULL will show 
  74.    them the *.ASC file.
  75.  
  76.  * Supports an unlimited number of nodes via a small CTL file to be
  77.    kept with the EXE file.
  78.  
  79.  * Supports locked communications ports
  80.  
  81.  * Completely Multi-Node aware, successfully tested under DOS 3.3, DOS 5.0,
  82.    DOS 6.0, Lantastic, Novell, DesqView/QEMM on machines ranging from
  83.    XT's to 486's.
  84.  
  85.  * Only requires about 180k so swapping usually isn't necessary.
  86.  
  87.  * Supports almost all the RA user and system codes, including color codes!
  88.  
  89.  * Unlimited file size!
  90.  
  91.                                ╔═════════════╗
  92.                                ║ LEGAL STUFF ║
  93.                                ╚═════════════╝
  94.  
  95.   WARRANTY:
  96.   Yea right! There's ain't none. You download it at your own risk,
  97.   you install it at your own risk, and you use it at your own risk ...
  98.   simple enough? In the event the use of this program, at any time, causes
  99.   damage, corruption, or loss of data, what you'll get from me is a big
  100.   "Didn't you do a backup first?". In the event the use of this program, at
  101.   any time, causes a hardware failure, hard drive crash, or otherwise causes
  102.   your system to explode into 5,000 pieces, the scope of my guarantee to you
  103.   is that you may keep whatever pieces you can find ... and if you ask me
  104.   real nice, I'll tell you where you can go to buy superglue.
  105.  
  106.   In legal mumbo jumbo, the bottom line is: The author shall not be
  107.   responsible for direct, indirect, incidental, or consequential damages
  108.   resulting from any bug, defect, error, or failure to perform.
  109.  
  110.  
  111.                                ╔══════════════╗
  112.                                ║ REQUIREMENTS ║
  113.                                ╚══════════════╝
  114.  
  115.  * RemoteAccess 2.0x of course!  LWBULL will NOT work on versions of
  116.    RA prior to RA 2.00g1.  
  117.  
  118.  * Any IBM Compatible with DOS 3.1 or better should work just fine. Color
  119.    monitor preferred but not required.
  120.  
  121.  * Fossil driver such as BNU or X00 is also highly recommended (Since RA
  122.    requires a fossil driver, this SHOULD be taken care of, RIGHT?!)
  123.  
  124.  * SHARE must be loaded if your running multi-node.  Not needed with some
  125.    lan systems.
  126.  
  127.  The Distribution Archive:
  128.  
  129.    LWBULL.EXE   - Main program
  130.    LWBULL.DOC   - Your readin' it!
  131.    LWBULL.CTL   - Control file, please edit as needed (see installation
  132.                    instructions for more info)
  133.    LW_REG.FRM   - Registration form for ALL LlanoWare Doors
  134.    FILE_ID.DIZ  - Well, you need to know what the file is, right?
  135.    LWBULL.ANS   - Sample ANSi Header file
  136.    LWBULL.ASC   - Sample ASCII Header file
  137.    LWBULLH.ANS  - Sample help file, edit to your taste
  138.    LWBULLH.ASC  - ASCII version of above (MUST exist!!!!!)
  139.    LW_AD.COM    - Brighten things up, take a look!
  140.  
  141.  This file will be created the first time you run LWBULL:
  142.  
  143.    LWBULL.DAT   - Contains data about your listings
  144.  
  145.  
  146. {+} THE ONE AND ONLY REGISTERED FEATURE of this program is a MUST HAVE!
  147.     Being able to mark certain items (files) as Mandatory is something we
  148.     all (well, almost all) have always wanted!  Ever had that news item that
  149.     everyone seems to skip and it makes you grind your teeth!?!?  Well, you 
  150.     can save yourself some dentists bills now! :{)  With the SysOp editor 
  151.     you can mark as many items as you want as Mandatory!
  152.  
  153.  
  154.  
  155.  
  156.                                ╔══════════════╗
  157.                                ║ INSTALLATION ║
  158.                                ╚══════════════╝
  159.  
  160.    Installation is fairly easy and straight-forward. The following steps and
  161.    examples should have you up and running in a very short period of time.
  162.    It is assumed that you are familiar with setting up DOORS on your system;
  163.  
  164.          1) Unarchive the files into a directory.
  165.          2) Edit the LWBULL.CTL file to reflect your name, your BBS name,
  166.             your registration numbers (if registered) ... for more
  167.             information regarding the CTL file, see the instructions
  168.             contained inside of the sample CTL file.
  169.          3) Place a copy of LWBULL.EXE wherever you wish. Place a copy of
  170.             the LWBULL.CTL file in each nodes directory.  You may optionally
  171.             only have one copy of the LWBULL.CTL in the same directory as 
  172.             LWBULL.EXE, LWBull will use the one in the nodes directory first
  173.             if found there.
  174.          4) Create a LWBULL.A?? file in the same dir.  This is the header
  175.             file that will apear on the top 1 to 7 lines of the door.
  176.          5) Create the LWBULL??.A?? files as needed, no leading 0's!
  177.                 ie: LWBULL1.ANS   <-correct
  178.                     LWBULL01.ANS  <-INCorrect
  179.          6) LWBULL can be used in any of the following ways:
  180.                A) Install LWBULL as a type 7 exit and optional data line of:
  181.                     C:\PATH\LWBULL.EXE
  182.                   Insert the correct pathname to find LWBULL.  *M (memory
  183.                   swapping) should not be unless you are running RA in an
  184.                   environment that has less than 460k available.  No other
  185.                   optional data is required.
  186.                B) Install as TextFile shell, be sure you have Allow TextFile
  187.                   shell set to YES in RACONFIG.  Command line of:
  188.                     C:\PATH\LWBULL.EXE|
  189.                   Same info about swapping as in example A.
  190.                C) Install in your Q-A files as:
  191.                      EXEC C:\PATH\LWBULL.EXE 
  192.                   Same info about swapping as in example A.
  193.   
  194.           7)  Your all set!  :{)
  195.  
  196.  
  197.    Insert the correct pathname to find LWBULL. Memory swapping with the *M
  198.    should not be needed unless you are running RA in an environment that
  199.    has less than 460k available. No other optional data is required.
  200.  
  201.  
  202.                         ╔══════════════════════════╗
  203.                         ║ RUNNING ADDITIONAL COPYS ║
  204.                         ╚══════════════════════════╝
  205.  
  206.    Ok, this is one of the neat parts!  You may run AS MANY COPYS as you want!
  207.    The secret?  Oh yea, guess you would want to know that huh? :{)
  208.    Just follow these simple steps:
  209.      1) Copy LWBULL.EXE to another filename, such as:
  210.            copy LWBULL.EXE NEWS.EXE
  211.         or:
  212.            copy LWBULL.EXE SCORES.EXE
  213.         Only two rules apply here, first, only valid DOS filenames are
  214.         allowed, second (IMPORTANT!) the filename MUST NOT be any longer
  215.         than 6 characters.  This is to allow the ANSi and ASCII files
  216.         the 1 or 2 chracters needed, such as: NEWS1.A?? or SCORES24.A??
  217.      2) Create another header file called NEWS.A?? or SCORES.A??. These
  218.         Files MUST have the same filename as the EXE file you copied.
  219.      3) Create new help files such as NEWSH.A??, SCORESH.A??
  220.      4) Create your new news/bulletin/scores/other information files, 
  221.         such as: NEWS1.A??, NEWS3.A??, SCORES1.A?? SCORES23.A?? etc.
  222.      5) Install as type 7 menu commands, textfile shells or in your
  223.         Q-A  files as above substituting the new names.
  224.      Note: You do *NOT* need to make additional CTL files, the LWBULL.CTL
  225.            is the only one(s) needed and will ALWAYS be read.
  226.  
  227.  
  228.                                 ╔═══════════╗
  229.                                 ║ OPERATION ║
  230.                                 ╚═══════════╝
  231.  
  232.    LWBULL does NOT need an ANSI driver to operate.
  233.  
  234.    LWBULL may also be run locally with one of two command line parameters:
  235.  
  236.    /L - prompts you for a name to "login" to the door with
  237.    /S - quick sysop login ... takes sysop name out of the CTL file
  238.  
  239.  
  240.    USING THE DOOR:
  241.    The user will be shown a screen with up to 24 items (files) that you  
  242.    can configure.  Ones that are new since the last time they logged on are
  243.    indicated as such by a "N" next to the item.  Ones that you have marked 
  244.    as Mandatory{+} reading are marked with a "M".  If you have sysop access,
  245.    you can go to the sysop editor and install, delete (blank out the line),
  246.    change colors and mark as Mandatory{+} reading any of the 24 items.
  247.  
  248.  
  249.                                ╔══════════════╗
  250.                                ║ LOCKED PORTS ║
  251.                                ╚══════════════╝
  252.  
  253.    LWBULL should not require any special attention for locked ports,
  254.    however if you run into a problem such as getting nothing but junk
  255.    characters when you load the door, you can un-comment the LOCKED
  256.    variable in the CTL file(s) and change the number to your locked rate,
  257.    or you can add a /B to the optional data field of the menu entry like
  258.    this:
  259.  
  260.    C:\PATH\LWBULL.EXE /B38400 or whatever your locked speed is.
  261.  
  262.    If you run multi-node and have different ports locked at different
  263.    speeds, you will need to maintain separate .CTL files in the node
  264.    directories reflecting the locked speed of each node's port. LWBULL
  265.    checks the current directory first for the CTL file.
  266.  
  267.  
  268.  
  269.  
  270.                                ╔══════════════╗
  271.                                ║ REGISTRATION ║
  272.                                ╚══════════════╝
  273.  
  274.    BENEFITS: First and foremost, knowing that you have supported the author
  275.    so he can continue his work!  Besides that, the nagging "Unregistered"
  276.    message goes away and enables the invaluable registered feature of being
  277.    able to mark items as Mandatory reading.
  278.  
  279.    HOW: For a $10.00 donation sent to the address below, you will be given
  280.    a registration number personalized just for you! If you have a valid
  281.    FIDONET address, the registration number will be sent to you directly.
  282.    Otherwise, the registration number will be sent to you via snailmail
  283.    (US Postal service). All registrations will be sent out within
  284.    3 days of receipt. See LW_REG.FRM for more info.
  285.  
  286.                 Make checks payable to and send donations to:
  287.  
  288.                                 Bob DaCastello
  289.                                 P.O. Box 53
  290.                                 Llano, CA  93544-0053
  291.  
  292.          Your comments/suggestions are welcomed and encouraged!!!!
  293.  
  294.   If you have ANY problems, remarks, suggestions, PLEASE contact me via
  295.   netmail ASAP at 
  296.          (805)264-0443  1:102/1313@fidonet (28.8)
  297.                    or
  298.          (805)264-0448  1:102/1331@fidonet (14.4)
  299.  
  300.                                ╔══════════════╗
  301.                                ║ DISTRIBUTION ║
  302.                                ╚══════════════╝
  303.  
  304.   You may make this file available for downloading from your BBS or you may
  305.   upload it to any BBS of your choice, provided that you do not make any
  306.   changes to the contents of the archive. The archive and its individual
  307.   contents may not be distributed used by any service that charges any
  308.   money whatsoever, without the written permission of the author.
  309.  
  310.  
  311.                              ╔══════════════════╗
  312.                              ║ ACKNOWLEDGEMENTS ║
  313.                              ╚══════════════════╝
  314.   Big Thanks to:
  315.  
  316.   CheryL Bergstrom for her invaliable ANSI input!
  317.  
  318.   Mark Mistretta for his assistance and for writing these docs! (I hate
  319.   doc-writing)
  320.  
  321.   Pam Smith of Window in Time BBS for her assistance.
  322.  
  323.   Thanks to Mike Janke (author of RACE user editor) for his TP assistance!
  324.  
  325.   Scott Baker for writing DoorDriver 5.0!
  326.  
  327.   Andrew Milner and all the great RA support Teams for a great BBS program!!
  328.  
  329.  
  330.  
  331.                             ╔════════════════════╗
  332.                             ║ DISTRIBUTION SITES ║
  333.                             ╚════════════════════╝
  334.  
  335.                            Author's BBS - Llano, CA
  336.                            Bob DaCastello (That's Me!)
  337.                            805-264-0443 (1200-28.8)
  338.                            805-264-0448 (1200-14.4)
  339.                            FIDONET: 1:102/1313
  340.                                     1:102/1331
  341.  
  342.                            TumbleWeed BBS - Lancaster, CA
  343.                            Bruce & Cheryl Bergstrom
  344.                            805-946-3332 (28.8)
  345.                            FIDONET: 1:102/1308
  346.  
  347.                            Pegasus II - Houston, TX
  348.                            William Thompson
  349.                            713-337-5349 (14.4)
  350.                            FIDONET: 1:106/6647
  351.                            
  352.  
  353.     The latest versions of all LlanoWare doors should always be
  354.     available for download from one of the above systems, or:
  355.  
  356.     Freq Magic Name LWBULL - for the Bulletin Door
  357.     Freq Magic Name LW_MGR - The Complete RA 2.0x Editor/Manager
  358.     Freq Magic Name EZBING - Bingo Door Game 
  359.     Freq Magic Name EZHANG - Hangman Door Game
  360.     Freq Magic Name EZSLOT - Slot Machine Door Game
  361.  
  362.     They are also being sent out through various distribution networks
  363.     and should be available at The TruckStop BBS, Pacific Coast Micro,
  364.     RA-USA and many other RA Support Sites.
  365.  
  366.  
  367.                              ╔══════════════════╗
  368.                              ║ TROUBLE SHOOTING ║
  369.                              ╚══════════════════╝
  370.  
  371.     I have tried to encourporate as much error checking as possible into
  372.     this version, most errors should show you what/where the problem may be.
  373.  
  374.     Error 102 or 100 usually indicates a file/directory is not found.  Most
  375.     of these should be caught by LWBULL.
  376.  
  377.     If you are using locked com ports and are expierencing garbage at the
  378.     remote end, the first thing should be to insure that your fossil driver
  379.     is locked at the same speed as RA.
  380.     Sample X00.SYS command line:
  381.     DEVICE=c:\X00.SYS E 1 b,0,38400
  382.                             ^note that a "0" here indicates com 1
  383.  
  384.     LWBULL looks in the current directory FIRST for the LWUSER.CTL file it
  385.     needs, if not found it then looks where the LWBULL.EXE file is kept for
  386.     the LWBULL.CTL file.  LWBULL also reads the EXITINFO.BBS file in the
  387.     current directory.
  388.  
  389.  
  390.     If you experience any problems, PLEASE contact me ASAP, I am always
  391.     glad to help and will respond ASAP!
  392.  
  393.  
  394.  
  395.                                ╔═════════╗
  396.                                ║ HISTORY ║
  397.                                ╚═════════╝
  398.  
  399.     v1.2 First public release.
  400.     v1.3 Changed status line.
  401.          Added fossil support for 38400.
  402.          Corrected problem with improper reporting of a new file when there
  403.          was only a *.ASC file and the user has ANSi on.
  404.          Added support for almost ALL RA 2.01 user and system codes!  
  405.     v2.0 Added support for locked baud rates to 115,200.
  406.          Supports RA versions 2.00g through 2.02.
  407.          Now uses "HotKeys" for item selection.
  408.          <s>top and <c>ontinious added to page pause.
  409.          Supports almost ALL RA 2.02 use and system codes.
  410.     v2.1 corrected problem with inactivity time out routine.
  411.  
  412.  
  413.  
  414.