home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / MWIZ3G1.ZIP / MENUWIZ.DOC < prev    next >
Encoding:
Text File  |  1994-11-16  |  17.5 KB  |  410 lines
  1.  
  2.  
  3.                ███╗   ███╗ ███████╗ ███╗   ██╗ ██╗   ██╗
  4.                ████╗ ████║ ██╔════╝ ████╗  ██║ ██║   ██║
  5.                ██╔████╔██║ █████╗   ██╔██╗ ██║ ██║   ██║
  6.                ██║╚██╔╝██║ ██╔══╝   ██║╚██╗██║ ██║   ██║
  7.                ██║ ╚═╝ ██║ ███████╗ ██║ ╚████║ ╚██████╔╝
  8.                ╚═╝     ╚═╝ ╚══════╝ ╚═╝  ╚═══╝  ╚═════╝
  9.  
  10.  
  11.            ██╗    ██╗ ██╗ ███████╗  █████╗  ██████╗  ██████╗
  12.            ██║    ██║ ██║ ╚══███╔╝ ██╔══██╗ ██╔══██╗ ██╔══██╗
  13.            ██║ █╗ ██║ ██║   ███╔╝  ███████║ ██████╔╝ ██║  ██║
  14.            ██║███╗██║ ██║  ███╔╝   ██╔══██║ ██╔══██╗ ██║  ██║
  15.            ╚███╔███╔╝ ██║ ███████╗ ██║  ██║ ██║  ██║ ██████╔╝
  16.             ╚══╝╚══╝  ╚═╝ ╚══════╝ ╚═╝  ╚═╝ ╚═╝  ╚═╝ ╚═════╝
  17.  
  18.              The ultimate menu editor for RemoteAccess 2.0X
  19.  
  20.                              version 3.00
  21.  
  22.                         Developed by Alon Gingold
  23.  
  24.                              Hitch Hiker's BBS
  25.                                   2:405/0
  26.                                +972-9-984-259
  27.  
  28.                        email: gingold@datasrv.co.il
  29.  
  30.  
  31.  
  32.  
  33.         INTRODUCTION
  34.         ------------
  35.  
  36.         Welcome to Menu Wizard !
  37.         If you have not registered MenuWiz , please check MENUWIZ.REG for
  38.         more information about registration. Writing MenuWiz took an
  39.         amazing number of hours , so Please register.
  40.  
  41.         MenuWiz is a sophisticated menu editor for RemoteAccess. It now
  42.         supports ONLY RemoteAccess 2.0X. It is VERY user friendly , and
  43.         allows the sysop to easily find his way around his menus.
  44.  
  45.         MenuWiz features include :
  46.  
  47.         * BBS Simulation lets you 'walk around' the BBS and zoom in on
  48.           a menu you wish to change. Display is exactly like as logged in.
  49.  
  50.         * Desktop of unlimited number of open menus at the same time.
  51.  
  52.         * Each entry in the menu is displayed as a single line. This line
  53.           will only display selected fields. 4 different line display
  54.           configurations.
  55.  
  56.         * Configurable external list of RemoteAccess menu types.
  57.  
  58.         * Full support for multi languages.
  59.  
  60.         * Full support for RA's Limits, Groups and Nodes limits !
  61.  
  62.         * Use of HOTKEYS both in the BBS simulation AND the menus themselves.
  63.           A Hot key of 'Goto/Gosub/Return' commands will automatically open
  64.           and focus on the correct menu. (Registered only)
  65.  
  66.         * Enhanced Search & Replace. You can modify all the menus
  67.           in all the languages with one action ! (Registered only)
  68.  
  69.         * Execution of external editors and shell (i.e. you can run
  70.           Thedraw or other ANS/ASC/AVT/RIP editors directly from
  71.           MenuWiz. (Registered only)
  72.  
  73.         * Full control over the program's COLORS.
  74.  
  75.         * Comprehensive Online help.
  76.  
  77.         * Full Mouse support.
  78.  
  79.  
  80.         This document is not complete. It will not explain all of MenuWiz
  81.         functions. You may find more information in the online help.
  82.         Anyone willing to rewrite/change this document will be more then
  83.         welcomed (and will receive a free registration , of course)
  84.         Please write me if you wish to do so.
  85.  
  86.  
  87.         History
  88.  
  89.             MenuWiz was originaly developed for QuickBBS in the days of
  90.             Adams, and later modified for RemoteAccess. This version
  91.             doesn't support QuickBBS at all , since I , as many others in
  92.             the 'shareware world' usually write software for their own
  93.             use, and I use RemoteAccess.
  94.  
  95.             This version of MenuWiz was supposed to get release about few
  96.             years ago <grin>. I'm sorry for all the folks who waited until
  97.             now for MenuWiz that supports RemoteAccess 2. I have to
  98.             emphasize that the registrations for the previous versions of
  99.             MenuWiz did not cover much of my development time, so I moved
  100.             to some more profitable sources of incoming ;-)
  101.  
  102.  
  103.         Development tools
  104.  
  105.             MenuWiz was written using Borland's Turbo Pascal with the
  106.             Turbo Vision user interface. I would like to say that Turbo
  107.             vision is a great environment to use. It gives Menuwiz the
  108.             multi windowing which allows multiple menus to be opened at
  109.             the same time.
  110.  
  111.  
  112.  
  113.         Credits and Acknowledgments
  114.  
  115.  
  116.             Thanks for all the people who helped me in the development
  117.             and testing of MenuWiz.
  118.  
  119.             Dror Tirosh - who help me in troubleshooting many Turbo Vision
  120.                           problems.
  121.  
  122.             Gal Hammer  - who nagged me to get the new version out, and
  123.                           found some bugs for me to fix.
  124.  
  125.             I would also like to thank Andrew Milner for allowing me to be
  126.             in the RemoteAccess beta team.
  127.  
  128.  
  129.             Turbo Pascal is a trademark of Borland International.
  130.             RemoteAccess is a trademark of Wantree Development & Andrew Milner
  131.  
  132.  
  133.         Technical Support
  134.  
  135.             If you have any problems using MenuWiz please let me know.
  136.             I will check such problems and will do my best to get them
  137.             fixed ASAP. Ideas for new features will be welcomed as well.
  138.  
  139.             Fidonet    :    Alon Gingold , 2:405/166
  140.             RANet      :    Alon Gingold , 73:7725/0
  141.             Internet   :    gingold@datasrv.co.il
  142.             Compuserve :    Alon Gingold , 100274,2301
  143.  
  144.  
  145.  
  146.         INSTALLATION
  147.         ------------
  148.  
  149.         Installation is very easy. Simply create a subdirectory and open
  150.         this archive there. Make sure you have the 'RA' dos variable set
  151.         correctly.
  152.  
  153.         Please don't try to use MenuWiz with RA 1.11. I'm not sure what
  154.         that will do, but it will certainly not work.
  155.  
  156.         The files you have just opened are :
  157.  
  158.           MWIZ.EXE    - the executable program.
  159.           MENUWIZ.DOC - this doc file.
  160.           MENUWIZ.HLP - MenuWiz online help.
  161.           MENUWIZ.CMD - RemoteAccess Menu types. This is a text file
  162.                         that MenuWiz build the type selection menu from.
  163.                         You can edit it and rearrange it as you wish.
  164.                         Just make sure to save the original file in
  165.                         case you trash it.
  166.           MENUWIZ.REG - Registration information.
  167.  
  168.  
  169.         Before running MenuWiz please make a backup of all your menus.
  170.         MenuWiz works great here, but any problem that might cause the loss
  171.         of your menus is not my responsebility !
  172.  
  173.         Now you can simply run MWIZ. Ignore the error message about the
  174.         configuration file that was not found. Just press ENTER.
  175.  
  176.         If everything is ok , you should see your TOP menu.
  177.  
  178.  
  179.  
  180.  
  181.         GETTING STARTED
  182.         ---------------
  183.  
  184.         On the top line you can see the Menu. Each entry in the menu can
  185.         be accessed by pressing Alt and the first letter of that Entry.
  186.         The system menu can be accessed with Alt-Space.
  187.  
  188.         On the right you can see the current active language. 'Default'
  189.         means the language set in RACONFIG System -> Paths -> Menus.
  190.  
  191.         On the Bottom right corner you can see the amount of free memory
  192.         available for use. If this number is less then 50000  ,you're
  193.         short in memory. Don't try opening too many menus at the same time.
  194.  
  195.         The rest of the screen is used for the menu window itself. You can
  196.         use your mouse to close the menu (press the BOX in the left upper
  197.         side of the window) , move it (press the title , move the mouse
  198.         and release the mouse), resize it (catch the bottom left corner
  199.         and move it) and scroll in it by pressing on the scroller.
  200.         All these functions can be done by Keyboard. Check the Windows
  201.         menu.
  202.  
  203.         The Title include the menu Language (meaning the menu was loaded
  204.         from that language menu directory) , the Ruler number (a Ruler
  205.         is a configuration of fields that are shown in the window. Ruler
  206.         [1] is set , at startup, to include all fields), and the menu name.
  207.  
  208.         You can scroll to the right to see the rest of the fields not
  209.         visible in the window.
  210.  
  211.         Below are some basics about the use of MenuWiz functions. You may
  212.         find more information in the online help.
  213.  
  214.         Rulers
  215.  
  216.           Try using Alt-F1 to switch to the other Rulers (there are 4 rulers).
  217.           You can setup the rulers in the Config -> Rulers , where you can
  218.           define which fields will be visible in each ruler: You can select
  219.           How the 'Type' field will be shown (as the Command number , or as
  220.           the description) , you can select which other fields will be
  221.           visible, and you can select the visible width of the Data field.
  222.  
  223.  
  224.         Editing Fields
  225.  
  226.  
  227.           To edit a field press ENTER or click with the mouse.
  228.           Press Enter to accept or ESC to cancel. Fields that open up a
  229.           dialog box, can also be accepted by click on the OK button, or
  230.           canceled with a click on the Cancel button.
  231.  
  232.  
  233.           Type    - The RemoteAccess Menu Type. Pressing ENTER will open
  234.                     a popup menu where you can change the Type.
  235.                     This popup menu is built from the MENUWIZ.CMD file,
  236.                     so you can modify it to fit your needs (i.e. change
  237.                     the language).
  238.  
  239.           Key     - Press Ctrl-A for Automatic execution type.
  240.  
  241.           Flags   - You can use 'X','O','-' or Space to toggle. Use the
  242.                     left and right arrows to move.
  243.  
  244.           Limits  - Press Enter on the '' to open a dialog where you can
  245.                     set all the other limitations on the current menu
  246.                     entry.
  247.  
  248.           Groups  - Press Enter on the '' to set which groups should be
  249.                     able to run this command.
  250.                     Press Tab once and then use the arrow keys to move
  251.                     around the flags. Use 'X' to tag and '-' to untag
  252.                     or Space to toggle. Each line is a set of 32 flags.
  253.                     The number on the left of the line is the Group
  254.                     number of the first flag. The number on the right is
  255.                     the last. You'll probably never use anything from
  256.                     the second line to the last.
  257.  
  258.           Nodes   - Press Enter on the '' to set which nodes should be
  259.                     able to run this command. The use of this field
  260.                     is exactly like the Groups field.
  261.  
  262.  
  263.           Textline- This field is the text that will be written for each
  264.                     line. Most of you will never use these lines. Make
  265.                     sure to have a ';' in each line so that RA will not
  266.                     type a CR/LF for each menu entry. New menu items created
  267.                     by MenuWiz will always have a ';' in the text field. If
  268.                     you don't use the text field, you can use the Ruler setup
  269.                     to remove it from the display !
  270.                     For now, there's no way to modify the color and highlight
  271.                     color of the text line. The reason is, that I've only now
  272.                     realized it while writing this line <grin>. Since this
  273.                     field is mostly never used, I'll leave this to the
  274.                     'bugfix' version.
  275.  
  276.  
  277.         Simulation
  278.  
  279.           One of the great features of MenuWiz is it's BBS simulation.
  280.           You can see the Menus as they look to the users, and you can
  281.           zoom in any menu you want.
  282.  
  283.           To Run the BBS simulation Press Alt-B.
  284.  
  285.           To start simulation at the currently active menu , press
  286.           Alt-A (Registered only).
  287.  
  288.           You can use the Hotkeys that are defined in the menus. If a
  289.           HotKey is a goto/gosub/return type, it will open the correct
  290.           menu and display it. Other functions will open a message box
  291.           with the function and it's data.
  292.           Pressing Space will open the current shown menu. Esc will exit.
  293.  
  294.           You can setup if you want to simulate in Ascii/Ansi , the
  295.           security level to use for the simulation , the Flags to use
  296.           and the simulated Baud rate. Use Alt-U to set these values
  297.           up. Use the Config -> Simulate to set the default values
  298.           of the above parameters that will be loaded with MenuWiz.
  299.  
  300.           You can also set the first menu where the Simulation will start
  301.           (Auto Menu) in the Config -> Defaults.
  302.  
  303.           MenuWiz can start in simulation mode as soon as it's loaded. To
  304.           set that up , set the 'Auto Simulate' in the Config -> Defaults.
  305.  
  306.  
  307.         Externals (Registered only)
  308.  
  309.           You can setup external Editors and other shells to be used
  310.           in MenuWiz. You can , by a key press load an external editor
  311.           that will load the Ansi/Ascii 'Hot keys display' text , or any
  312.           other text in your menu. MenuWiz will automatically change to
  313.           the text file directory before executing the editors, and will
  314.           change to the menus directory before executing other shells.
  315.           You can setup the shells in the Config -> Externals. Read
  316.           the online help about what kind of parameters are possible to
  317.           use.
  318.  
  319.  
  320.         Search & Replace (Registered only)
  321.  
  322.           The search and replace is a very smart engine. It can be used
  323.           to search menu items by Type,Data substring, Flags, Sec level and
  324.           KEY. It can also search all the open menus on the desktop, or all
  325.           matching a wildcard. The Search & Replace can be executed on all
  326.           the languages at once. Press Alt-R to enter the Search & Replace
  327.           dialog.
  328.  
  329.           This dialog is divided into three parts : The 'Search for' box,
  330.           the 'Replace with' box and the 'Options dialog'. Use OK to confirm
  331.           or ESC to cancel. You can set Search for any combination of the
  332.           six fields :
  333.  
  334.           <Type>  Will search for entries with this type only.
  335.  
  336.           <Data>  Will search for entries that has this substring in
  337.                   their Data field. The replace Data field will either
  338.                   replace all the Data field or only the Substring found
  339.                   (configurable).
  340.  
  341.           <Flags> The flags search and replace may be either in RA style,
  342.                   or in a full match and replace. (configurable)
  343.  
  344.           <Min-S> Search for this Sec level.
  345.  
  346.           <Max-S> Search for this Max Sec level.
  347.  
  348.  
  349.           The options dialog sets the behavior of the search & replace.
  350.  
  351.           <Data field> If the search included a string in the Data field,
  352.                        and an entry is found that has that string in it's
  353.                        Data field (substring) then 'Change only' will tell
  354.                        MenuWiz to replace that substring in the found entry
  355.                        with the string that's in the replace Data field.
  356.                        'Full Replace' will Replace ALL the Data Field in
  357.                        the found entry with the Replace Data field. If the
  358.                        search did not include any string in the Data field,
  359.                        a Full Replace is forced.
  360.  
  361.           <Flags Search> 'Full match' will only match entries that their
  362.                        flags field is EXACTLY like the search flags field.
  363.                        'RA match' will match entries who will match each 'X'
  364.                        and 'O' that are set in the search flags.
  365.                        Any flag that is not set (i.e. '-') in the search
  366.                        flags will not be checked.
  367.  
  368.           <Flags Replace> 'Full Replace' will replace the entire Flags
  369.                        field with the one in the replace flags field.
  370.                        'Change only' will Set or Unset the flags that are
  371.                        set with 'X' or 'O' and will leave the flags that are
  372.                        set with '-' as they were.
  373.  
  374.           <Menus to search> Will set the search to include the current menu,
  375.                        All the menus that are open in the desktop, or a group
  376.                        of menus that can be selected by a wildcard (i.e. '*'
  377.                        will select ALL the menus in the menus directory !!).
  378.  
  379.           <Menus Wildcards> This field is only used when 'Wildcards' is used
  380.                        in the Menus to search.
  381.  
  382.           <Languages> If this will be set to 'All', not only the menus set
  383.                        in the 'Menus to search' will be searched , but also
  384.                        the same menus in all other languages. (i.e.
  385.                        selecting a '*' in the 'menus to search' and 'All'
  386.                        in the Languages to search will search ALL the
  387.                        menus in ALL the languages !!)
  388.  
  389.           <Options> 'Case sensitive' - will set a case sensitive Data field
  390.                        search. 'No-Ask' - will NOT ask to confirm replace
  391.                        on each entry found. 'Menus No-Ask' will NOT ask to
  392.                        confirm the search on every menu that is to be
  393.                        searched (If more then one menu is set for the
  394.                        search, i.e. Wildcards,Desktop or All Languages)
  395.  
  396.  
  397.  
  398.  
  399.      This is as much as I can get myself to write. Any problems you can't
  400.      solve ? and crashes or UFOs ? tell me all about it :
  401.  
  402.  
  403.      Alon Gingold
  404.      Hitch Hiker's BBS
  405.      Fidonet    : 2:405/166
  406.      RANet      : 73:7725/0
  407.      Internet   : gingold@datasrv.co.il
  408.      Compuserve : Alon Gingold , 100274,2301
  409.  
  410.