home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_09 / RUNNER.ZIP / MENU_BAR.HLP < prev    next >
Text File  |  1992-05-25  |  28KB  |  525 lines

  1.  
  2.         
  3.                         Runner -- A Desktop Alternative
  4.  
  5.         
  6.                                   GEM MENU BAR
  7.  
  8.                              Files / Menus / Colors
  9.  
  10.  
  11.                        Copyright (C) 1993 by Dave Thorson
  12.                        Version 1.61     November 18, 1993
  13.  
  14.  
  15.         Runner lets you use the traditional GEM menu bar for the most 
  16.         common commands.  Notice that when you move the mouse into the 
  17.         menu bar, the arrow turns into a pointing hand.  While the hand 
  18.         is visible, you cannot select anything EXCEPT what's in the GEM 
  19.         menus.  Press the left mouse button (outside of any pull-down 
  20.         menus and below the menu bar) to change the hand back to an 
  21.         arrow.
  22.  
  23.  
  24.         
  25. $$      Desk
  26.         ---------------------------------------------------------------
  27.           Desk     File     Menus     Colors
  28.         ---------------------------------------------------------------
  29.          | About....        |
  30.          | Use Accessories  |
  31.           ------------------
  32.         
  33.         Desk - About....
  34.  
  35.         Under Desk you will find About...   Click on it to see my name, 
  36.         Runner's version number, and the approximate amount of free RAM 
  37.         (Runner uses lots of stuff internally that gets cleared before a 
  38.         program is run, and there's no good way to tell exactly how much 
  39.         space will be available to the program -- this estimate may be 
  40.         off by several thousand bytes).
  41.  
  42.  
  43.         Desk - Use accessories
  44.  
  45.         Click on Use Accessories to get to any of the shaded desk 
  46.         accessories in the Desk menu.  The screen will clear and a 
  47.         single Desk menu will appear.  Accessories can be freely used 
  48.         now, although many of them leave behind "holes" in the screen 
  49.         (depending on your color choices).  Under the Desk menu, the 
  50.         second item is now called End Accessories.  Click on this to 
  51.         quit using accessories and get back to the Runner program.
  52.  
  53.  
  54.  
  55. $$      File
  56.         ---------------------------------------------------------------
  57.           Desk     File     Menus     Colors
  58.         ---------------------------------------------------------------
  59.                   | Load config    |
  60.                   | Save config    |
  61.                   | Background     |
  62.                   | Installed Apps |
  63.                   |----------------|
  64.                   | Fix (rerun)    |
  65.                    ----------------
  66.         
  67.         The File menu contains Load, Save, Installed Apps, Background 
  68.         and Fix options.  Note that Quit is not available here as it is 
  69.         in most File menus.  Exit Runner is available from the top level 
  70.         Runner menu or by pressing the Undo key.
  71.  
  72.  
  73. $$      File - Load config
  74.  
  75.         Load lets you load RUNNER.CFG.  It opens a file selector showing 
  76.         Runner's home directory, but you can change to another directory 
  77.         or load a different configuration file.  There is no warning to 
  78.         save any changes you may have made to the configuration already 
  79.         in memory, so be careful.  Loading a new .CFG file will replace 
  80.         anything already in memory except the picture.  Clicking on 
  81.         Cancel in the file selector box will stop the load operation.
  82.  
  83.  
  84. $$      File - Save config
  85.  
  86.         Save lets you preserve your current setup for the next time you 
  87.         run Runner.  Program configurations and descriptions, menus, 
  88.         menu structures, initial and text color palettes and the main 
  89.         title are all saved in the configuration file (as well as lots 
  90.         of other stuff).  Use the name RUNNER.CFG if you want that 
  91.         configuration to be auto-loaded the next time you start Runner, 
  92.         or give it another name if you choose.  "File - Load config" 
  93.         lists all files in Runner's home directory that end with ".CFG", 
  94.         so you should use this extension (.CFG) for any configuration 
  95.         files you save.  Clicking on Cancel in the file selector box 
  96.         will stop the save operation.
  97.  
  98.         Note: File - Save may also create a picture configuration file 
  99.         recording any changes in menu list position, menu space display 
  100.         attributes (how much of the underlying background picture is 
  101.         blanked out by spaces around the menu), background picture 
  102.         palette, and any Regions information for the picture if you have 
  103.         changed any of these since loading the picture.  These files 
  104.         have the same name as the current picture in memory, but with a 
  105.         file extension of .CF1, .CF2 or .CF3 to match the picture's 
  106.         screen resolution.  If you loaded MOUNTAIN.PI1, File - Save 
  107.         might create a MOUNTAIN.CF1 picture configuration file.  If you 
  108.         want to force the save of a picture configuration file without 
  109.         updating the RUNNER.CFG file on your disk, hold down Control 
  110.         when selecting the "Save config" command.
  111.  
  112.         Safety Feature: Both Runner configuration and picture 
  113.         configuration files are saved using this procedure:
  114.  
  115.           1. Create ".TMP" filename (ex: MYCONFIG.CFG becomes 
  116.              MYCONFIG.TMP)
  117.           2. Write file to disk using ".TMP" filename
  118.           3. If successful:
  119.           3a. Delete any file matching desired save name (ex: 
  120.              MYCONFIG.CFG)
  121.           3b. Rename ".TMP" file to desired name (ex: MYCONFIG.CFG)
  122.  
  123.         If a save is NOT successful (disk full or other problems) then 
  124.         your original file is not changed in any way.  You may want to 
  125.         erase any ".TMP" files Runner creates, although they won't cause 
  126.         any problems for Runner.  There is no good way to check disk 
  127.         space requirements for saving a file without a lot of extra code 
  128.         in memory.  If you try to save a file and fail, you will see 
  129.         Runner's main error message dialog box, giving you the choice of 
  130.         exiting Runner or returning to Runner.  You can always select 
  131.         the option to return to Runner and try again to save the file to 
  132.         a different disk.
  133.  
  134.  
  135. $$      File - Installed apps
  136.  
  137.         This is not exactly a "file" operation but this used to be where 
  138.         you came to "Install Apps", and it's been left here for the 
  139.         convenience of long-time Runner users.  Selecting this option 
  140.         displays a list of any installed applications.  Each application 
  141.         is shown following the file extension that triggers it.  If more 
  142.         than one extension is used to trigger an application, each one 
  143.         appears on a separate line.  If there are too many lines to fit 
  144.         on one screen, press a key to see the next part of the list.  At 
  145.         the end of the list, press a key to return to Runner's normal 
  146.         menu list display.  For information on how to install 
  147.         applications, see the file DIALOG.HLP, which describes the 
  148.         Add/Change dialog box where applications are installed.
  149.  
  150.  
  151. $$      File - Background
  152.  
  153.         Background lets you load and unload pictures or select a fill 
  154.         pattern for the Runner "desktop".  If no picture is displayed, a 
  155.         dialog box asks to choose between:
  156.         
  157.                       Load Pic     Def Fill     Cancel
  158.         
  159.         "Def Fill" shows another dialog box that lets you chose a fill 
  160.         pattern.  Instructions tell you to move the mouse left or right 
  161.         to change patterns, and up or down to change colors (oddly, this 
  162.         does nothing on monochrome monitors).  When you see a pattern 
  163.         and color combination you like, click a mouse button.  You can 
  164.         use different fill pattern settings in each screen resolution; 
  165.         they are all remembered in RUNNER.CFG when you save it.  If you 
  166.         have a picture already displayed you will have to "Unload" it 
  167.         (see below) before you can get to Def Fill.
  168.  
  169.         "Load Pic" lets you select a picture file to use as a background 
  170.         for your Runner menus.  A file selector will appear showing all 
  171.         the .PIx and .PCx (x=1,2,3) files for the current resolution in 
  172.         Runner's home directory.  Use the file selector box to move to 
  173.         another disk or directory if needed.  Select the picture you 
  174.         want, and it will become the background for Runner's screen.
  175.         
  176.         If a picture is already displayed when you select Background, 
  177.         you will be asked if you want to load another picture or unload 
  178.         the one you've got.  Unloading a picture frees 32,000 bytes of 
  179.         memory for larger applications.  Loading a new picture replaces 
  180.         the old one and brings in the color palette for the new picture.
  181.         This dialog box also shows the name of the current picture file 
  182.         and now has a Cancel option in case you don't want to change....
  183.  
  184.         Clicking on Cancel from the file selector box will stop the 
  185.         picture load operation and leave the current picture (if any) in 
  186.         memory.
  187.  
  188.         If a picture has an associated picture configuration file (.CF1, 
  189.         .CF2 or .CF3 extension), it will be loaded along with the 
  190.         picture.  And, if a Runner .CFG config file is found in the 
  191.         same directory as the picture file, with the same name (except 
  192.         for the extension), it will be loaded as well.  This will 
  193.         replace all menus in memory so be sure to save them first if 
  194.         needed.  This feature lets you have customized menu lists for 
  195.         each picture.  If no matching .CFG file is found, the menus in 
  196.         memory are not affected by loading a new background pic.  As an 
  197.         example, if you load MOUNTAIN.PI1, Runner will also try to load 
  198.         MOUNTAIN.CF1 and MOUNTAIN.CFG.  If a matching picture config 
  199.         file is not found, the default picture parameters are used.  If 
  200.         a matching .CFG file is not found, the menus and related info in 
  201.         memory are left unchanged for the new picture.
  202.         
  203.         *        
  204.         There is one exception to the above: if a picture file called 
  205.         RUNNER*.PIx or RUNNER*.PCx is selected, and it has the name of a 
  206.         picture file in it instead of picture data (see below), and a 
  207.         matching .CFG file is not found, then RUNNER.CFG will be loaded 
  208.         from Runner's home directory.
  209.         *
  210.  
  211.         Note that a picture file can also contain the filename of 
  212.         another picture to load, instead of picture data.  In this case, 
  213.         the filename read from this "faux" picture file is used to 
  214.         determine the .CFx and .CFG filenames to look for.  Use the 
  215.         RPICNAME.PRG program as an aid to create these faux pic files.
  216.         
  217.         A picture list file created from RPICSEL.PRG can also be loaded 
  218.         here; Runner will pick one of the pictures in the list at 
  219.         random.
  220.  
  221.         Background pictures can also be loaded by pressing a shifted 
  222.         number key (from the top keyboard row, not the keypad).  For 
  223.         this to work, the picture name must be assigned to the key 
  224.         within the Regions program.  If no picture file is assigned, the 
  225.         key does nothing.  The same filenames can also be assigned to a 
  226.         screen region within the Regions program; then clicking within 
  227.         that region will load the appropriate picture and config files.
  228.  
  229.         Note that if the color registers used for the background color 
  230.         and the text color have color values that are too close, you may 
  231.         not be able to read text on the screen.  You'll need to change 
  232.         colors.  This is described in detail in KEYBOARD.HLP, but for 
  233.         now hold Control and press G to make the background palette the 
  234.         current colors.  Press 0 on the numeric keypad to select the 
  235.         background color, and press R, G or B to change the background 
  236.         colors.  Now you should be able to see what you are doing.  
  237.         You'll need to change the picture's palette with a paint program 
  238.         to make the change permanent, or select Save from the File menu 
  239.         to save the changed colors in a configuration file for the 
  240.         picture.
  241.         
  242.         Even more confusion: starting with Runner version 1.60c, you can 
  243.         load picture config files instead of pictures.  This lets you 
  244.         use Regions without a picture in memory, and you can load the 
  245.         .CFx file from one picture and use it with another.  See 
  246.         STARTUP.HLP for more info.  (use Regions to copy picture config 
  247.         files from one screen resolution to another!)
  248.  
  249.  
  250. $$      File - Fix (re-run)
  251.  
  252.         This command lets you "fix" Runner when an unruly application 
  253.         messes it up.  Fix simply reloads Runner, but this is often 
  254.         enough to solve most problems.  For example, after running an 
  255.         older version of ST Writer, Runner has serious problems with 
  256.         clearing inverse video colors and restoring what the mouse 
  257.         covered.  After spending hours searching for a solution (to 
  258.         absolutely no avail) I realized that other applications might 
  259.         cause different problems, and that Runner's size would grow 
  260.         considerably if code had to be added to handle any condition.
  261.         
  262.         Fix is clean and simple....   Running a program via Mini-Run 
  263.         should also isolate most problems from Runner.  Lest you think 
  264.         that these problems are common, I should point out that the ONLY 
  265.         two problem programs I've seen are ST Writer and Word Writer 
  266.         (which forgets to clear its buttons from memory - they get 
  267.         redrawn even after exiting Word Writer).  I regularly use GFA 
  268.         BASIC, Laser C, Degas Elite, Spectrum 512, DO-IT!, Turbo ST, 
  269.         Atari Planetarium, Flash, Real Time, and several other programs 
  270.         and games with no problems!  The only programs I've found that 
  271.         do not work with Runner, other than self-booting games, are 
  272.         Diablo and MidiDraw from Intelligent Music.
  273.         
  274.         Since Fix is potentially dangerous (any menu changes you haven't 
  275.         saved will be lost), it is separated from the other menu choices 
  276.         by a -------- line, and its keyboard equivalent is "^F" 
  277.         (Control/F) instead of just "F".  An ounce of prevention.....
  278.  
  279.         
  280.         
  281. $$      Menus
  282.         ---------------------------------------------------------------
  283.           Desk     File     Menus     Colors
  284.         ---------------------------------------------------------------
  285.                            | add Program    |
  286.                            | add Menu       |
  287.                            | Change         |
  288.                            | Drop           |
  289.                            | Restore        |
  290.                            | QuickKeys Show |
  291.                             ----------------
  292.  
  293.         The Menus menu contains add Program, add Menu, Change, Drop, 
  294.         Restore and Quickkeys show.  This is where you change Runner's 
  295.         program menus to contain the programs you use most often, and 
  296.         configure those programs to run the way you like them.
  297.  
  298.  
  299. $$      Menus - add Program
  300.  
  301.         This option lets you add a new program to Runner's menu lists.  
  302.         It places the new program in the currently displayed menu, and 
  303.         makes an effort to keep things in alphabetical order with 
  304.         submenus at the top and programs at the bottom.
  305.  
  306.         Add Program displays a file selector box.  Select a .PRG, .APP, 
  307.         .TTP or .TOS file from any disk or directory, or select cancel 
  308.         if you decide not to add a new program after all.  Note that if 
  309.         you already have fifteen programs or menu names in the list 
  310.         displayed on the screen, Add Program will do nothing.  In this 
  311.         case you must first remove something, or move to another menu.  
  312.         If you have pressed the Tab key to show all items in the menu 
  313.         regardless of screen resolution, then you might try to press Tab 
  314.         to hide the ones for the wrong resolution and see if you then 
  315.         have room to add another item.  It is possible to have more than 
  316.         15 items in a menu if some of them are hidden via the resolution 
  317.         flags (see DIALOG.HLP for more info).  
  318.  
  319.         You can also add non-program files to Runner's menus.  They can 
  320.         be text files (such as Runner's .HLP files) that you want to 
  321.         access quickly, or they can be data files or documents with file 
  322.         extensions that will trigger an installed application to run and 
  323.         then load the file [see DIALOG.HLP].
  324.         
  325.         If you select Cancel or select OK with a blank filename, no 
  326.         change takes place and Runner's menu list reappears.  Otherwise, 
  327.         you will see Runner's Add/Change Dialog Box.  Operation of this 
  328.         box is described in detail in DIALOG.HLP, but for now just 
  329.         change the name in the Description line to the way you want it 
  330.         to look in Runner's menu list and press Return or the right 
  331.         mouse button.  All the other default values should normally be 
  332.         okay, and you can easily change them later.
  333.  
  334.  
  335. $$      Menus - add Menu
  336.  
  337.         Adding a menu works the same as adding a program, except that 
  338.         instead of a file selector you are prompted at the top of the 
  339.         screen for the menu name to add.  Then you will see the same 
  340.         Add/Change dialogue box used for "add Program".  The Hold Screen 
  341.         and Use Mini-Run options don't have any effect on Menus, but to 
  342.         save memory the same dialogue box is used for both menus and 
  343.         programs.  Don't worry about it.  Other options not compatible 
  344.         with menus are not displayed or are disabled.  If you leave the 
  345.         Description line empty, no menu is added.  See DIALOG.HLP for 
  346.         more information.
  347.  
  348.         As with programs, if you already have fifteen programs or menus 
  349.         displayed, Add Menu has no effect.  Menus can be nested, that 
  350.         is, a menu list can contain menus which can, in turn, contain 
  351.         more menus.  Simply click on Add Menu while you're inside 
  352.         another menu, and the new menu will be nested inside the current 
  353.         menu.  Menus can be nested in this fashion up to maximum of 
  354.         fifteen levels deep, probably more than you could ever use.  
  355.         Since one purpose of Runner is to avoid all the folder opening 
  356.         that goes on from the Desktop, you may want to use as few menus 
  357.         as necessary.  This is still easier than on the desktop since 
  358.         you're only dealing with program names and don't need a separate 
  359.         menu to group together all the .RSC, data, font files and 
  360.         anything else needed for a program.  Folders continue to do this 
  361.         quite well.
  362.  
  363.  
  364. $$      Menus - Change
  365.  
  366.         Change lets you change the configuration for any program, 
  367.         document/data file or menu.  When you click on Change, a prompt 
  368.         at the top of the screen tells you to select a menu or program 
  369.         that you want to change.  Use the mouse to pick a menu item, and 
  370.         you will again see the Add/Change Dialog Box.  Change the 
  371.         description or any of the other options, and press Return or the 
  372.         right mouse button when finished.  See DIALOG.HLP for more 
  373.         information.
  374.  
  375.         When the "Select to Change" prompt is visible, clicking the left 
  376.         mouse button away from the programs, menus and GEM menu bar will 
  377.         exit the change prompt.
  378.  
  379.         If you select the title line for Change, you can change Runner's 
  380.         main title.  The main title only appears on Runner's top level 
  381.         menu (the one you see when Runner starts).  On lower level menus 
  382.         the name of the menu appears instead.  Click on any of these 
  383.         title lines to change the main title.  The new title is saved to 
  384.         disk when you save a configuration file.  Add your own name or 
  385.         whatever you like!
  386.  
  387.         It's possible to change (and Drop - see the next section on 
  388.         Menus - Drop) programs or menus that appear only in a resolution 
  389.         you're not in at the time.  Press the Tab key to show ALL 
  390.         programs and menus; a "registered" symbol ("R" inside a circle) 
  391.         appears in front of anything you normally can't see in the 
  392.         current resolution.  These menus or programs can now be changed 
  393.         or dropped normally.  Press Tab again to hide items from the 
  394.         wrong resolution.
  395.  
  396.  
  397. $$      Menus - Drop
  398.  
  399.         Drop lets you delete a program or menu from the display.  It 
  400.         DOES NOT change the programs on disk.  Drop is similar to 
  401.         Change.  Click on Drop and a prompt appears telling you to 
  402.         select a program or menu to drop.  Click on the program or menu 
  403.         you no longer want in the list.  If you drop a menu, EVERYTHING 
  404.         in the menu is dropped as well -- all its programs and submenus.
  405.  
  406.         Remember that none of your changes are permanent until you save 
  407.         this new configuration back to disk with the Save command in the 
  408.         Files menu.  The Tab key (see above section on Menus - Change) 
  409.         is also useful with Drop.
  410.  
  411.  
  412. $$      Menus - Restore
  413.  
  414.         When you Drop a menu or program name from a menu list, it goes 
  415.         into a "drop buffer" for safe keeping.  Selecting Restore brings 
  416.         it back, and inserts it into whatever menu list you're looking 
  417.         at.  This lets you move menus or programs around in your lists, 
  418.         or recall something you dropped by accident.  Note that the 
  419.         contents of a menu that is dropped are also restored with it, so 
  420.         whole menus can be moved wherever you like.  Also note: there is 
  421.         only one drop buffer; when you drop a second item it clears the 
  422.         old information from the drop buffer first.  If an item assigned 
  423.         to a QuickKey is dropped, it will no longer appear on the 
  424.         QuickKeys list either.  Restoring it will return it to the list, 
  425.         unless that QuickKey is reassigned to another program first.
  426.  
  427.         Restore also places a restored item in alphabetical order, so if 
  428.         any of your menus get out of order, simply drop and restore the 
  429.         items you wish to resequence.  Alphabetical order is determined 
  430.         by the contents of the Description line in the Add/Change Dialog 
  431.         Box -before- you see it, so by changing the first few characters 
  432.         of a description it may get out of alphabetical order.
  433.  
  434.  
  435. $$      Menus - QuickKeys show/hide
  436.  
  437.         This option lets you display a list of QuickKeys assignments 
  438.         instead of the normal Runner menus.  Programs in the list can be 
  439.         selected for running as usual, and the Change option works also.  
  440.         Programs Dropped from the QuickKeys list are not dropped from 
  441.         your normal menus, they are simply deassigned from the 
  442.         corresponding QuickKey.  Restore is disabled in the QuickKeys 
  443.         list, and new QuickKeys or menus cannot be added.  Selecting 
  444.         this option a second time returns to the normal menu display.  
  445.         Holding down BOTH mouse buttons works the same as selecting this 
  446.         option.  To view the list of "shifted" QuickKeys, hold down 
  447.         Shift when requesting the list (either Shift will also show the 
  448.         other list, which makes some amount of sense since you need 
  449.         Shift with the QuickKey to run a program in the "shifted" list).
  450.  
  451.         The exit line at the top of a QuickKeys list is different: it 
  452.         lets you view the other set of QuickKeys.  The right mouse 
  453.         button alone does this also (remember that in normal menu lists, 
  454.         the right button moves you to the top menu, similar to selecting 
  455.         the exit line).
  456.  
  457.  
  458. $$      Colors
  459.         ---------------------------------------------------------------
  460.           Desk     File     Menus     Colors
  461.         ---------------------------------------------------------------
  462.                                      |  desKtop    |
  463.                                      |x iNitial    |
  464.                                      |  backGround |
  465.                                      |  Text       |
  466.                                       -------------
  467.         
  468.         The color menu lets you select which color palette you want to 
  469.         use when a program runs.  If no picture is loaded, palette 
  470.         changes affect Runner's screen as well.  If a picture is loaded, 
  471.         a new palette is displayed only briefly, then the picture's 
  472.         palette is restored.  This lets you use a reasonable palette for 
  473.         running programs while displaying a picture that uses colors too 
  474.         disgusting for most programs.  A checkmark (represented by "x" 
  475.         above) appears in front of the currently selected palette, also 
  476.         known as the "Current Palette".
  477.  
  478.         If you want to use a different palette for displaying a picture, 
  479.         hold down the Control key when selecting the palette.  You can 
  480.         always restore the picture's original palette by selecting 
  481.         backGround, or by selecting another palette without holding down 
  482.         Alternate.
  483.  
  484.         Four palettes are available:
  485.  
  486.              Initial - the palette loaded from Runner's configuration 
  487.                     file
  488.  
  489.              Desktop - the colors in the desktop palette before Runner 
  490.                     was started
  491.  
  492.              Background - the colors from the last picture loaded into 
  493.                     Runner
  494.  
  495.              Text - the palette used for viewing files from the file
  496.                     selector (also loaded from Runner's config file)
  497.  
  498.         Runner uses the concept of the "Current Palette".  The Current 
  499.         Palette is the set of colors Runner switches to when running a 
  500.         program.  It is a copy of one of the other palettes listed above 
  501.         (you can select which one from the menu bar -- it always starts 
  502.         out as a copy of the Initial Palette).
  503.  
  504.         If no picture is loaded then the Current Palette is used for 
  505.         Runner's menu screen as well.  If a picture IS loaded, its 
  506.         palette normally overrides the Current Palette while the picture 
  507.         is visible, but the Current Palette is still used when running 
  508.         programs (you normally don't want your picture's colors when 
  509.         running your word processor).  If a palette is selected with 
  510.         Control depressed, then the picture is displayed using the new 
  511.         Current Palette.
  512.  
  513.         A separate Initial Palette is maintained for each resolution.  A 
  514.         single Text Palette is also saved in your config file and shared 
  515.         by all resolutions.  Note that the Text palette is ALWAYS used 
  516.         when in File View, but you may select it for use at other times 
  517.         as well.
  518.  
  519.         Individual colors within a palette can also be changed; see 
  520.         KEYBOARD.HLP for more information.
  521.         
  522.  
  523.         [end of MENU_BAR.HLP]
  524.         
  525.