home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / LWMENU12.ZIP / LWMENU.DOC < prev    next >
Text File  |  1993-10-10  |  18KB  |  439 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 1.2
  35.              ╚═══ ╚╝  ╚╝     ║    ║ ╚═══ ║  ╚╝ ╚══╝
  36.  
  37.  
  38.                     Copyright 1992,1993 by Bob DaCastello
  39.  
  40.  
  41.              The BEST REMOTE MENU EDITOR for Remote Access 2.01!!
  42.                  ^^^^
  43.  
  44.  
  45.                                ╔══════════════╗
  46.                                ║ INTRODUCTION ║
  47.                                ╚══════════════╝
  48.  
  49.    Ok, since the release of RemoteAccess 2.00g1 everyone has been crying
  50.    for a remote menu editor, so.........HERE IT IS!  Llanoware also offers
  51.    a REMOTE USER EDITOR!! Check the end of these docs under Distribution
  52.    and Beta Sites.
  53.  
  54.    ALL ITEMS MARKED WITH A {+} ARE FEATURES/OPTIONS ENABLED BY REGISTERING.
  55.    PLEASE SUPPORT YOUR SHAREWARE AUTHORS AND REGISTER THEIR WAREZ!!
  56.  
  57.  
  58.                                  ╔══════════╗
  59.                                  ║ FEATURES ║
  60.                                  ╚══════════╝
  61.  
  62.  * Allows you to edit ANY/ALL aspect of your .MNU Menu files by remote
  63.  
  64.  * Allows you to add or delete menu items or entire menus by remote.
  65.  
  66.  * {+} Capable of displaying the menu to you by remote as it would be seen
  67.    by users, and even displays the ANSI/ASCII/BULLETIN/TEXT file with the
  68.    menu on menus containing the "Display ANS/ASC File" command on that menu!
  69.  
  70.  * Fully built-in support for all of RA 2.01's new menu functions including
  71.    groups, nodes, times, restrictions, emulations, etc etc.
  72.  
  73.  * Supports multiple languages and their specific menus
  74.  
  75.  * Supports an unlimited number of nodes via a small CTL file to be
  76.    kept with the EXE file, or multiple configurations by placing CTL
  77.    files in the node directories.
  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 200k so swapping usually isn't necessary.
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.                                       1
  95.  
  96.  
  97.                                ╔═════════════╗
  98.                                ║ LEGAL STUFF ║
  99.                                ╚═════════════╝
  100.  
  101.   As with any new utility, you should ALWAYS MAKE A BACK UP of your
  102.   files before playing with the new utility. LWMENU will NOT create a
  103.   backup copy of the .MNU menu file you choose to edit. It's always best
  104.   to do a quick backup of the files that this program will be altering until
  105.   you determine that LWMENU will function properly with your system and files.
  106.  
  107.   WARRANTY:
  108.   Yea right! There's ain't none. You download it at your own risk,
  109.   you install it at your own risk, and you use it at your own risk ...
  110.   simple enough? In the event the use of this program, at any time, causes
  111.   damage, corruption, or loss of data, what you'll get from me is a big
  112.   "Didn't you do a backup first?". In the event the use of this program, at
  113.   any time, causes a hardware failure, hard drive crash, or otherwise causes
  114.   your system to explode into 5,000 pieces, the scope of my guarantee to you
  115.   is that you may keep whatever pieces you can find ... and if you ask me
  116.   real nice, I'll tell you where you can go to buy superglue.
  117.  
  118.   In legal mumbo jumbo, the bottom line is: The author shall not be
  119.   responsible for direct, indirect, incidental, or consequential damages
  120.   resulting from any bug, defect, error, or failure to perform.
  121.  
  122.  
  123.                                ╔══════════════╗
  124.                                ║ REQUIREMENTS ║
  125.                                ╚══════════════╝
  126.  
  127.  * RemoteAccess 2.00 of course!  LWMENU will NOT work on versions of
  128.    RA prior to RA 2.00g1.
  129.  
  130.  * Any IBM Compatible with DOS 3.1 or better should work just fine. Color
  131.    monitor preferred but not required.
  132.  
  133.  * Fossil driver such as BNU or X00 is also highly recommended (Since RA
  134.    requires a fossil driver, this SHOULD be taken care of, RIGHT?!)
  135.  
  136.  * An ANSI driver MUST be installed in the calling system for proper
  137.    operation of the door by remote.
  138.  
  139.  The Distribution Archive:
  140.    LWMENU.EXE   - Main program
  141.    LWMENU.DOC   - Your readin' it!
  142.    LWMENU.CTL   - Control file ... Edit as needed
  143.    LW_REG.FRM   - Registration form for ALL LlanoWare Doors
  144.    FILE_ID.DIZ  - Well, you need to know what the file is, right?
  145.    LWMWHATS.NEW - Release/Changes history
  146.  
  147.     THE REGISTERED FEATURE's of this program are a  MUST HAVE!
  148.     If you are creating a new menu especially, or just as useful for editing
  149.     an existing menu, wouldn't it be GREAT to be able to display the menu to
  150.     you as the users would see it?  Even better, If you have menus that
  151.     display an ANSI, ASCII, Text, or Bulletin file as/with the menu, that
  152.     also will be displayed to you in LWMENU when you choose to (S)how Menu.
  153.     INCLUDES support for textfiles codes!!!
  154.     The ability to copy menu lines to the same menu, a different menu, or even
  155.     to another languages menu!
  156.  
  157.                                       2
  158.  
  159.  
  160.                                ╔══════════════╗
  161.                                ║ INSTALLATION ║
  162.                                ╚══════════════╝
  163.    Upgrading from v0.9: Copy ALL the new files over the old ones and edit 
  164.    the CTL file.  Thats it!
  165.  
  166.    Installation is fairly easy and straight-forward. The following steps and
  167.    examples should have you up and running in a very short period of time.
  168.    It is assumed that you are familiar with setting up DOORS on your system;
  169.  
  170.          1) Edit the LWMENU.CTL file to reflect your name, your BBS name,
  171.             your registration numbers (if registered) ... for more
  172.             information regarding the CTL file, see the instructions
  173.             contained inside of the sample CTL file.
  174.          2) Place a copy of LWMENU.EXE wherever you wish. For multiple
  175.             configurations, place a copy of the .CTL file in each node
  176.             directory, otherwise it is best to reside in the same
  177.             directory with LWMENU.EXE.
  178.  
  179.    Install LWMENU as a type 7 exit with an optional data line of:
  180.  
  181.    C:\PATH\LWMENU.EXE
  182.  
  183.    Insert the correct pathname to find LWMENU. Memory swapping with the *M
  184.    should not be needed unless you are running RA in an environment that
  185.    has less than 460k available. No other optional data is required.
  186.  
  187.  
  188.                                 ╔═══════════╗
  189.                                 ║ OPERATION ║
  190.                                 ╚═══════════╝
  191.  
  192.   LWMENU REQUIRES THAT THERE IS AN ANSI DRIVER PRESENT IN THE REMOTE SYSTEM
  193.   ALTHOUGH ONE IS NOT REQUIRED ON THE HOST (BBS) SYSTEM FOR THE DOOR TO RUN.
  194.  
  195.    LWMENU may also be run locally with one of two command line parameters:
  196.  
  197.    /L - prompts you for a name to "login" to the door with
  198.    /S - quick sysop login ... takes sysop name out of the CTL file
  199.  
  200.  
  201.    USING THE DOOR:
  202.    After the initial screen, a list of languages installed on your system
  203.    will be displayed. If you only have one language installed, it will skip
  204.    this screen and go directly to a list of your .MNU menu files. Type the
  205.    name of the menu you want to edit or the name of a new menu to create.
  206.    A screen similar to the one you see when in the RACONFIG Menu Editor
  207.    will be displayed. A few commands appear across the bottom of the screen.
  208.  
  209.    Here is a quick rundown of those commands:
  210.  
  211.    Enter the line number to edit - Enter the menu line number of the entry
  212.    you want to edit. This will bring you to the full screen view of this
  213.    menu line for editing.
  214.  
  215.    S)how Menu - {+} Displays the currently selected menu as the user would
  216.                     see it, including support for textfiles codes!
  217.                     ie: 3 would be substituted with "UsersHandle".
  218.  
  219.                                       3
  220.  
  221.  
  222.  
  223.    I)nsert New - Insert a new line in the menu. Selecting this will prompt
  224.                  you to enter a line number to insert your new line BEFORE.
  225.                  If you want to insert a new line on Line 22, you would put
  226.                  23 in for the prompt. This will only insert a blank line on
  227.                  the menu, so unless this line is to remain blank, you would
  228.                  then select line 22 to edit. If you just want to append a
  229.                  new line to the bottom, LWMENU will tell you the line
  230.                  number to insert at.
  231.  
  232.     T)emplate  - Edit the Template displays for all 32 flags and up to
  233.                  12 security levels.  Uses the same template files as LWUSER.
  234.  
  235.  
  236.    Once you are in a specific menu item to edit, the prompts should take
  237.    you through everything you need. It is beyond the scope of this document
  238.    to explain how to edit your menus by itemeized menu type commands.
  239.  
  240.    HOWEVER, one GREAT feature of this program is that when you choose to
  241.    edit the Menu Type (Action), you may scroll through all of the RemoteAccess
  242.    Menu types to find the one you want. All of the RA Menu Types by name and
  243.    number are hardcoded into LWUSER, such as "Display Only (Type 0)" or
  244.    "Download Any File (Type 55)". Sure is easier than pulling out the manual
  245.    every time, huh?!  You may scroll through all menu types with the "<"
  246.    and ">" keys (shifted period and comma).  Refer to your RA SysOp Manual
  247.    for a detailed description of commands, their effects, and optional data
  248.    lines available.
  249.  
  250.    When you choose to edit the Optional Data fields you will also be shown
  251.    some of the options that are available for you to use.
  252.  
  253.    LWMENU WILL ALWAYS ASK YOU IF YOU WANT TO SAVE THE CHANGES TO EACH MENU
  254.    LINE WHEN YOU FINISH EDITING A MENU. NO CHANGES ARE SAVED MADE UNLESS YOU
  255.    PRESS "Y".
  256.  
  257.  
  258.                                ╔══════════════╗
  259.                                ║ LOCKED PORTS ║
  260.                                ╚══════════════╝
  261.  
  262.    LWMENU should not require any special attention for locked ports,
  263.    however if you run into a problem such as getting nothing but junk
  264.    characters when you load the door, you can un-comment the LOCKED
  265.    variable in the CTL file(s) and change the number to your locked rate,
  266.    or you can add a /B to the optional data field of the menu entry like
  267.    this:
  268.  
  269.    C:\PATH\LWMENU.EXE /B38400 or whatever your locked speed is.
  270.    (DON'T PUT A *B ... The /B is to identify locked rate, not current baud)
  271.  
  272.    If you run multi-node and have different ports locked at different
  273.    speeds, you will need to maintain separate .CTL files in the node
  274.    directories reflecting the locked speed of each node's port. LWMenu
  275.    checks the current directory first for the CTL file.
  276.  
  277.  
  278.  
  279.  
  280.                                       4
  281.  
  282.  
  283.  
  284.                                ╔══════════════╗
  285.                                ║ REGISTRATION ║
  286.                                ╚══════════════╝
  287.  
  288.    BENEFITS: First and foremost, knowing that you have supported the author
  289.    so he can continue his work!  Besides that, the nagging "Unregistered"
  290.    message goes away and enables the invaluable registered feature of being
  291.    able to display the menu to you as the users would see it and be able to
  292.    copy menu lines within the same menu, to another menu, or even to a menu
  293.    in another language!
  294.  
  295.    HOW: For a $10.00 donation sent to the address below, you will be given
  296.    a registration number personalized just for you! If you have a valid
  297.    FIDONET address, the registration number will be sent to you directly.
  298.    Otherwise, the registration number will be sent to you via snailmail
  299.    (US Postal service). All registrations will be sent out within
  300.    3 days of receipt. See LW_REG.FRM for more info.
  301.  
  302.                 Make checks payable to and send donations to:
  303.  
  304.                                 Bob DaCastello
  305.                                 P.O. Box 53
  306.                                 Llano, CA  93544-0053
  307.  
  308.          Your comments/suggestions are welcomed and encouraged!!!!
  309.  
  310.   If you have ANY problems, remarks, suggestions, PLEASE contact me via
  311.   netmail ASAP at 1:102/1313, or log into my BBS at (805) 264-0443.
  312.                    (fidonet)
  313.  
  314.  
  315.                                ╔══════════════╗
  316.                                ║ DISTRIBUTION ║
  317.                                ╚══════════════╝
  318.  
  319.   You may make this file available for downloading from your BBS or you may
  320.   upload it to any BBS of your choice, provided that you do not make any
  321.   changes to the contents of the archive. The archive and its individual
  322.   contents may not be distributed used by any service that charges any
  323.   money whatsoever, without the written permission of the author.
  324.  
  325.  
  326.                              ╔══════════════════╗
  327.                              ║ ACKNOWLEDGEMENTS ║
  328.                              ╚══════════════════╝
  329.   Big Thanks to:
  330.  
  331.   Mark Mistretta for beta testing and all his input into making LWMENU
  332.   what it is, and for writing these docs! (I hate doc-writing)
  333.  
  334.   Pam Smith of Window in Time BBS for her assistance.
  335.  
  336.   Thanks to Mike Janke (author of RACE user editor) for his TP assistance!
  337.  
  338.   Scott Baker for writing DoorDriver 5.0!
  339.  
  340.   Andrew Milner and all the great RA support Teams for a great BBS program!!
  341.  
  342.   All of the sysops who reported bugs and operational problems in the
  343.   previous releases, thereby helping me make this GREAT release!
  344.  
  345.                                       5
  346.  
  347.  
  348.  
  349.                             ╔════════════════════╗
  350.                             ║ DISTRIBUTION SITES ║
  351.                             ╚════════════════════╝
  352.  
  353.                            Author's BBS - Llano, CA
  354.                            Bob DaCastello (That's Me!)
  355.                            805-264-0443 (14.4k HST)
  356.                            FIDONET: 1:102/1313
  357.  
  358.                            Off Roaders BBS - Palmdale, CA
  359.                            Mark Mistretta
  360.                            805-272-9792 (16.8k Dual Standard)
  361.                            805-272-9793 (14.4 HST)
  362.                            805-272-9795 (14.4 v.32bis)
  363.                            805-273-9796 (9600 v.32)
  364.                            FIDONET: 1:102/1314
  365.                                     1:102/1315
  366.  
  367.                            Window In Time - Phoeniz, AZ
  368.                            Pam Smith
  369.                            602-253-1946 (9600 v.32)
  370.                            602-253-7069 (2400)
  371.                            602-253-7169 (2400)
  372.                            FIDONET: 1:114/203
  373.  
  374.                            TumbleWeed BBS - Lancaster, CA
  375.                            Bruce & Cheryl Bergstrom
  376.                            805-946-3332 (16.8k Dual Standard)
  377.                            FIDONET: 1:102/1308
  378.  
  379.     The latest versions of LWMENU and LWUSER should always be available
  380.     for download from one of the above systems, or:
  381.  
  382.     Freq Magic Name LWMENU - for the Remote Menu Editor
  383.     Freq Magic Name LWUSER - for the Remote User Editor
  384.     Freq Magic Name LWEDIT - for both of em!
  385.     Freq Magic Name LLANOWARE for a complete list of LlanoWare files.
  386.  
  387.     They are also being sent out through various distribution networks
  388.     and should be available at The TruckStop BBS, Pacific Coast Micro,
  389.     RA-USA and many other RA Support Sites.
  390.  
  391.  
  392.                              ╔══════════════════╗
  393.                              ║ TROUBLE SHOOTING ║
  394.                              ╚══════════════════╝
  395.  
  396.     I have tried to encourporate as much error checking as possible into
  397.     this version, most errors should show you what/where the problem may be.
  398.  
  399.     Error 102 or 100 usually indicates a file/directory is not found.  Most
  400.     of these should be caught by LWMENU.
  401.  
  402.     If you are using locked com ports and are expierencing garbage at the
  403.     remote end, the first thing should be to insure that your fossil driver
  404.     is locked at the same speed as RA.
  405.     Sample X00.SYS command line:
  406.     DEVICE=c:\X00.SYS E 1 b,0,38400
  407.                             ^note that a "0" here indicates com 1
  408.  
  409.                                       6
  410.  
  411.  
  412.  
  413.  
  414.     LWMENU looks in the current directory FIRST for the needed CONFIG.RA,
  415.     LANGUAGE.RA and LWUSER.CTL files it needs, if not found it then looks
  416.     where the LWMENU.EXE file is kept for the LWMENU.CTL file and checks the
  417.     RA environment as defined in your autoexec.bat with SET RA=c:\ra for
  418.     the CONFIG.RA and LANGUAGE.RA files.
  419.  
  420.     LWMENU REQUIRES that the MENU path and TEXTFILE path be properly setup
  421.     in the language editor.  It does NOT use the default paths setup in
  422.     RAConfig>Paths.  If you have problems with menu/textfiles not being found,
  423.     please check here first.
  424.  
  425.     If you experience any problems, PLEASE contact me ASAP, I am always
  426.     glad to help and will respond ASAP!
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.                                       7
  438.  
  439.