home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / pcboard / lwmenu10.zip / LWMENU.DOC < prev    next >
Text File  |  1993-06-28  |  17KB  |  437 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.0
  35.              ╚═══ ╚╝  ╚╝     ║    ║ ╚═══ ║  ╚╝ ╚══╝
  36.  
  37.  
  38.                     Copyright 1992,1993 by Bob DaCastello
  39.  
  40.  
  41.              The BEST REMOTE MENU EDITOR for Remote Access 2.x !!
  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.0'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 140k 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 by default will create
  103.   a .BAK copy of the .MNU menu file you choose to edit, but 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.  
  141.    LWMENU.EXE   - Main program
  142.    LWMENU.DOC   - Your readin' it!
  143.    LWMENU.CTL   - Control file ... Edit as needed
  144.    LW_REG.FRM   - Registration form for ALL LlanoWare Doors
  145.    FILE_ID.DIZ  - Well, you need to know what the file is, right?
  146.    LWMWHATS.NEW - Release/Changes history
  147.  
  148. {+} THE ONE AND ONLY REGISTERED FEATURE of this program is a MUST HAVE!
  149.     If you are creating a new menu especially, or just as useful for editing
  150.     an existing menu, wouldn't it be GREAT to be able to display the menu to
  151.     you as the users would see it?  Even better, If you have menus that
  152.     display an ANSI, ASCII, Text, or Bulletin file as/with the menu, that
  153.     also will be displayed to you in LWMENU when you choose to (S)how Menu.
  154.     INCLUDES support for textfiles codes!!!
  155.  
  156.                                       2
  157.  
  158.  
  159.                                ╔══════════════╗
  160.                                ║ INSTALLATION ║
  161.                                ╚══════════════╝
  162.    Upgrading from v0.9: Copy ALL the new files over the old ones and edit 
  163.    the CTL file.  Thats it!
  164.  
  165.    Installation is fairly easy and straight-forward. The following steps and
  166.    examples should have you up and running in a very short period of time.
  167.    It is assumed that you are familiar with setting up DOORS on your system;
  168.  
  169.          1) Edit the LWMENU.CTL file to reflect your name, your BBS name,
  170.             your registration numbers (if registered) ... for more
  171.             information regarding the CTL file, see the instructions
  172.             contained inside of the sample CTL file.
  173.          2) Place a copy of LWMENU.EXE wherever you wish. For multiple
  174.             configurations, place a copy of the .CTL file in each node
  175.             directory, otherwise it is best to reside in the same
  176.             directory with LWMENU.EXE.
  177.  
  178.    Install LWMENU as a type 7 exit with an optional data line of:
  179.  
  180.    C:\PATH\LWMENU.EXE
  181.  
  182.    Insert the correct pathname to find LWMENU. Memory swapping with the *M
  183.    should not be needed unless you are running RA in an environment that
  184.    has less than 460k available. No other optional data is required.
  185.  
  186.  
  187.                                 ╔═══════════╗
  188.                                 ║ OPERATION ║
  189.                                 ╚═══════════╝
  190.  
  191.   LWMENU REQUIRES THAT THERE IS AN ANSI DRIVER PRESENT IN THE REMOTE SYSTEM
  192.   ALTHOUGH ONE IS NOT REQUIRED ON THE HOST (BBS) SYSTEM FOR THE DOOR TO RUN.
  193.  
  194.    LWMENU may also be run locally with one of two command line parameters:
  195.  
  196.    /L - prompts you for a name to "login" to the door with
  197.    /S - quick sysop login ... takes sysop name out of the CTL file
  198.  
  199.  
  200.    USING THE DOOR:
  201.    After the initial screen, a list of languages installed on your system
  202.    will be displayed. If you only have one language installed, it will skip
  203.    this screen and go directly to a list of your .MNU menu files. Type the
  204.    name of the menu you want to edit or the name of a new menu to create.
  205.    A screen similar to the one you see when in the RACONFIG Menu Editor
  206.    will be displayed. A few commands appear across the bottom of the screen.
  207.  
  208.    Here is a quick rundown of those commands:
  209.  
  210.    Enter the line number to edit - Enter the menu line number of the entry
  211.    you want to edit. This will bring you to the full screen view of this
  212.    menu line for editing.
  213.  
  214.    S)how Menu - {+} Displays the currently selected menu as the user would
  215.                     see it, including support for textfiles codes!
  216.                     ie: 3 would be substituted with "UsersHandle".
  217.  
  218.                                       3
  219.  
  220.  
  221.  
  222.    I)nsert New - Insert a new line in the menu. Selecting this will prompt
  223.                  you to enter a line number to insert your new line BEFORE.
  224.                  If you want to insert a new line on Line 22, you would put
  225.                  23 in for the prompt. This will only insert a blank line on
  226.                  the menu, so unless this line is to remain blank, you would
  227.                  then select line 22 to edit. If you just want to append a
  228.                  new line to the bottom, LWMENU will tell you the line
  229.                  number to insert at.
  230.  
  231.    Once you are in a specific menu item to edit, the prompts should take
  232.    you through everything you need. It is beyond the scope of this document
  233.    to explain how to edit your menus by itemeized menu type commands.
  234.  
  235.    HOWEVER, one GREAT feature of this program is that when you choose to
  236.    edit the Menu Type (Action), you may scroll through all of the RemoteAccess
  237.    Menu types to find the one you want. All of the RA Menu Types by name and
  238.    number are hardcoded into LWUSER, such as "Display Only (Type 0)" or
  239.    "Download Any File (Type 55)". Sure is easier than pulling out the manual
  240.    every time, huh?!  You may scroll through all menu types with the "<"
  241.    and ">" keys (shifted period and comma).  Refer to your RA SysOp Manual
  242.    for a detailed description of commands, their effects, and optional data
  243.    lines available.
  244.  
  245.    LWMENU WILL ALWAYS ASK YOU IF YOU WANT TO SAVE THE CHANGES TO EACH MENU
  246.    LINE WHEN YOU FINISH EDITING A MENU. NO CHANGES ARE SAVED MADE UNLESS YOU
  247.    PRESS "Y".
  248.  
  249.  
  250.                                ╔══════════════╗
  251.                                ║ LOCKED PORTS ║
  252.                                ╚══════════════╝
  253.  
  254.    LWMENU should not require any special attention for locked ports,
  255.    however if you run into a problem such as getting nothing but junk
  256.    characters when you load the door, you can un-comment the LOCKED
  257.    variable in the CTL file(s) and change the number to your locked rate,
  258.    or you can add a /B to the optional data field of the menu entry like
  259.    this:
  260.  
  261.    C:\PATH\LWMENU.EXE /B38400 or whatever your locked speed is.
  262.    (DON'T PUT A *B ... The /B is to identify locked rate, not current baud)
  263.  
  264.    If you run multi-node and have different ports locked at different
  265.    speeds, you will need to maintain separate .CTL files in the node
  266.    directories reflecting the locked speed of each node's port. LWMenu
  267.    checks the current directory first for the CTL file.
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.  
  280.  
  281.                                       4
  282.  
  283.  
  284.  
  285.                                ╔══════════════╗
  286.                                ║ REGISTRATION ║
  287.                                ╚══════════════╝
  288.  
  289.    BENEFITS: First and foremost, knowing that you have supported the author
  290.    so he can continue his work!  Besides that, the nagging "Unregistered"
  291.    message goes away and enables the invaluable registered feature of being
  292.    able to display the menu to you as the users would see it.
  293.  
  294.    HOW: For a $10.00 donation sent to the address below, you will be given
  295.    a registration number personalized just for you! If you have a valid
  296.    FIDONET address, the registration number will be sent to you directly.
  297.    Otherwise, the registration number will be sent to you via snailmail
  298.    (US Postal service). All registrations will be sent out within
  299.    3 days of receipt. See LW_REG.FRM for more info.
  300.  
  301.                 Make checks payable to and send donations to:
  302.  
  303.                                 Bob DaCastello
  304.                                 P.O. Box 53
  305.                                 Llano, CA  93544-0053
  306.  
  307.          Your comments/suggestions are welcomed and encouraged!!!!
  308.  
  309.   If you have ANY problems, remarks, suggestions, PLEASE contact me via
  310.   netmail ASAP at 1:102/1313, or log into my BBS at (805) 264-0443.
  311.                    (fidonet)
  312.  
  313.  
  314.                                ╔══════════════╗
  315.                                ║ DISTRIBUTION ║
  316.                                ╚══════════════╝
  317.  
  318.   You may make this file available for downloading from your BBS or you may
  319.   upload it to any BBS of your choice, provided that you do not make any
  320.   changes to the contents of the archive. The archive and its individual
  321.   contents may not be distributed used by any service that charges any
  322.   money whatsoever, without the written permission of the author.
  323.  
  324.  
  325.                              ╔══════════════════╗
  326.                              ║ ACKNOWLEDGEMENTS ║
  327.                              ╚══════════════════╝
  328.   Big Thanks to:
  329.  
  330.   Mark Mistretta for beta testing and all his input into making LWMENU
  331.   what it is, and for writing these docs! (I hate doc-writing)
  332.  
  333.   Pam Smith of Window in Time BBS for her assistance.
  334.  
  335.   Thanks to Mike Janke (author of RACE user editor) for his TP assistance!
  336.  
  337.   Scott Baker for writing DoorDriver 5.0!
  338.  
  339.   Andrew Milner and all the great RA support Teams for a great BBS program!!
  340.  
  341.   All of the sysops who reported bugs and operational problems in the
  342.   previous releases, thereby helping me make this GREAT release!
  343.  
  344.                                       5
  345.  
  346.  
  347.  
  348.                             ╔════════════════════╗
  349.                             ║ DISTRIBUTION SITES ║
  350.                             ╚════════════════════╝
  351.  
  352.                            Author's BBS - Llano, CA
  353.                            Bob DaCastello (That's Me!)
  354.                            805-264-0443 (14.4k HST)
  355.                            FIDONET: 1:102/1313
  356.  
  357.                            Off Roaders BBS - Palmdale, CA
  358.                            Mark Mistretta
  359.                            805-272-9792 (16.8k Dual Standard)
  360.                            805-272-9793 (14.4 HST)
  361.                            805-272-9795 (14.4 v.32bis)
  362.                            805-273-9796 (9600 v.32)
  363.                            FIDONET: 1:102/1314
  364.                                     1:102/1315
  365.  
  366.                            Window In Time - Phoeniz, AZ
  367.                            Pam Smith
  368.                            602-253-1946 (9600 v.32)
  369.                            602-253-7069 (2400)
  370.                            602-253-7169 (2400)
  371.                            FIDONET: 1:114/203
  372.  
  373.                            Tumbleweed BBS - Lancaster, CA
  374.                            Bruce & Cheryl Bergstrom
  375.                            805-946-3332 (16.8k Dual Standard)
  376.                            FIDONET: 1:102/1308
  377.  
  378.     The latest versions of LWMENU and LWUSER should always be available
  379.     for download from one of the above systems, or:
  380.  
  381.     Freq Magic Name LWMENU - for the Remote Menu Editor
  382.     Freq Magic Name LWUSER - for the Remote User Editor
  383.     Freq Magic Name LWEDIT - for both of em!
  384.  
  385.     They are also being sent out through various distribution networks
  386.     and should be available at The TruckStop BBS, Pacific Coast Micro,
  387.     RA-USA and many other RA Support Sites.
  388.  
  389.  
  390.                              ╔══════════════════╗
  391.                              ║ TROUBLE SHOOTING ║
  392.                              ╚══════════════════╝
  393.  
  394.     I have tried to encourporate as much error checking as possible into
  395.     this version, most errors should show you what/where the problem may be.
  396.  
  397.     Error 102 or 100 usually indicates a file/directory is not found.  Most
  398.     of these should be caught by LWMENU.
  399.  
  400.     If you are using locked com ports and are expierencing garbage at the
  401.     remote end, the first thing should be to insure that your fossil driver
  402.     is locked at the same speed as RA.
  403.     Sample X00.SYS command line:
  404.     DEVICE=c:\X00.SYS E 1 b,0,38400
  405.                             ^note that a "0" here indicates com 1
  406.  
  407.                                       6
  408.  
  409.  
  410.  
  411.  
  412.     LWMENU looks in the current directory FIRST for the needed CONFIG.RA,
  413.     LANGUAGE.RA and LWUSER.CTL files it needs, if not found it then looks
  414.     where the LWMENU.EXE file is kept for the LWMENU.CTL file and checks the
  415.     RA environment as defined in your autoexec.bat with SET RA=c:\ra for
  416.     the CONFIG.RA and LANGUAGE.RA files.
  417.  
  418.     LWMENU REQUIRES that the MENU path and TEXTFILE path be properly setup
  419.     in the language editor.  It does NOT use the default paths setup in
  420.     RAConfig>Paths.  If you have problems with menu/textfiles not being found,
  421.     please check here first.
  422.  
  423.     If you expierence any problems, PLEASE contact me ASAP, I am always
  424.     glad to help and will respond ASAP!
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.                                       7
  436.  
  437.