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

  1.  
  2.         
  3.                         Runner -- A Desktop Alternative
  4.         
  5.  
  6.                             ADD / CHANGE DIALOG BOX
  7.                     Parameters / Installed Apps / QuickKeys
  8.  
  9.  
  10.                        Copyright (C) 1993 by Dave Thorson
  11.                        Version 1.61     November 18, 1993
  12.  
  13.  
  14.  
  15.         Runner uses a single dialog box to obtain much of the 
  16.         information it needs to run your programs and manage your menus.  
  17.         This "Add/Change Dialog Box" (ACDB) appears whenever you add a 
  18.         program or menu.  The same ACDB appears if you choose to change 
  19.         a program's information, a menu name, or Runner's title line.  
  20.         The ACDB looks at least a little like this for one program:
  21.         
  22.         ---------------------------------------------------------------
  23.           Desk     File     Menus     Colors
  24.         ---------------------------------------------------------------
  25.  
  26.                              Mr. Dave's Runner
  27.         
  28.                           -----------------------
  29.                          |   CYBRMATE.PRG        |      t m p
  30.                          |                       |
  31.                          |   Description:        |
  32.                          |>> Cybermate^_________ |        m p
  33.                          |                       |
  34.                          | x Low    Hold Screen  |        m p
  35.                          | x Med    Use Mini-Run |        m p
  36.                          | x High x Low or Med   |        m p
  37.                          |   QuickKey:  (none)   |        m p
  38.                          |   Colors:    current  |          p
  39.                          |   Install:   (none)   |          p
  40.                          |                       |
  41.                          |   Comment (wait):     |          p
  42.                          |   ^__________________ |          p
  43.                           -----------------------
  44.         
  45.         The components of this box vary for menus, programs, and title 
  46.         line changes, but each works about the same whenever it appears.  
  47.         The t, m and p shown to the right of the box indicate when that 
  48.         part of the box is available (title, menu, or program/data/ 
  49.         document file).  "x" represents a checkmark.  The ">>" symbol 
  50.         indicates which of the two text lines is active for changes.
  51.  
  52.         To exit the ACDB and return to Runner's menu list, press Return 
  53.         or click the right mouse button.  There is no Cancel function, 
  54.         but then there's not much to go wrong!
  55.  
  56.         In the example, the top line gives the actual filename of the 
  57.         program.  For menus, this line will say "Menu".  For title 
  58.         changes, this line says "Title".  For program and data/document 
  59.         files, the path to the file is displayed in the GEM menu bar 
  60.         area.
  61.         
  62. $$      (Program Name) -- cannot be changed for "Menu" or "Title"
  63.         
  64.         By clicking on the actual name of a program or data/document 
  65.         file (not the Description line), you can change which program is 
  66.         assigned to the menu item you are editing.  This is very handy 
  67.         if you get a new version of a program and want to keep the new 
  68.         version number in the filename on the disk, or if you move a 
  69.         program or data file from one folder or disk to another.
  70.         A file selector appears to allow you to select a new program or 
  71.         data file from the disk.  Nothing else in the Add/Change Dialog 
  72.         Box is changed, so your description and QuickKey assignements 
  73.         and other settings remain the same.  Much easier than dropping 
  74.         and re-adding a program!
  75.         
  76.         
  77. $$      ADCB: Description
  78.         
  79.         This is the text that will appear in Runner's menu lists.  Put 
  80.         in whatever you like.  When adding programs, Runner attempts to 
  81.         "beautify" the program name by dropping the extension, 
  82.         converting to lower case, and inserting spaces where it thinks 
  83.         it makes sense.  Runner is not always right, but you can change 
  84.         the description as much as you want.  Click on this line to edit 
  85.         it if the ">>" arrow is not already pointing at it.  Backspace 
  86.         moves the cursor (a triangle in the program) one space left, 
  87.         erasing the last character in the line.  The Esc key clears the 
  88.         line altogether, unless it's on a blank line; then Esc will 
  89.         recall the line that you saw when the ACDB first appeared.
  90.  
  91.                 
  92.         The following functions are only available in menu and program 
  93.         changes or adds:
  94.  
  95.                 
  96. $$      ADCB: Low / Med / High
  97.  
  98.         These are screen resolution indicators.  They control whether a 
  99.         program or menu name will be visible in a menu list for each 
  100.         resolution (apologies to TT and Falcon users; if someone would only send me 
  101.         one of these machines for testing I might be able to add the 
  102.         other three resolutions ;-).
  103.         
  104.         So, for a program like Word Writer that doesn't work in low res, 
  105.         click on Low to turn off the checkmark in front of it.  When you 
  106.         use Runner in low res, Word Writer will not appear in a menu.  
  107.         Click on Low, Med or High to turn the checkmarks on and off 
  108.         ("on" means the item will appear in that resolution).  Default 
  109.         values are all on.
  110.         
  111.         Note: if you hide a program from the resolution you're currently 
  112.         using, it will NOT appear on the menu when you exit the 
  113.         Add/Change Dialog Box.  Press the Tab key to show items hidden 
  114.         from the current screen resolution; press Tab again to hide 
  115.         them.  You can create a "hidden" menu for things like installed 
  116.         applications or Strip Poker by clearing the checkmark from all 
  117.         three resolutions.  Due to a programming constraint, if an item 
  118.         is hidden in all resolutions and doesn't use Mini-Run (see 
  119.         below), then Hold Screen is forced to be on.  Don't worry about 
  120.         it!
  121.         
  122.         By hiding programs or menus, it's possible to get over 15 in the 
  123.         same list.  Pressing TAB will show only the first 15.
  124.  
  125.         
  126. $$      ADCB: Hold Screen (ignored for menus)
  127.         
  128.         This is the default for .TTP programs.  If a check mark appears 
  129.         here, Runner will prompt for a key press or mouse button click 
  130.         before clearing the screen and returning to Runner's screen when 
  131.         a program exits.
  132.  
  133.  
  134. $$      ADCB: Use Mini-Run (ignored for menus)
  135.         
  136.         Click here to force the program to be run via Mini-Run instead 
  137.         of directly from Runner.  If a checkmark appears in this line, 
  138.         Mini-Run will be used regardless of the Mini-Run flag on 
  139.         Runner's menu list screen.  See OTHERS.HLP for more info on 
  140.         Mini-Run.
  141.  
  142.                 
  143. $$      ADCB: Low or Med (ignored for menus)
  144.         
  145.         The check mark always appears here because one of these options 
  146.         is always selected.  Clicking here cycles through the three 
  147.         options:
  148.         
  149.         Low or Med: program will run in either low or medium res, 
  150.                     whatever mode the computer is in
  151.         
  152.         Low => Med: forces computer in low resolution to run the program 
  153.                     in a medium res screen
  154.  
  155.         Med => Low: forces computer in medium res to run the program in 
  156.                     a low res screen
  157.         
  158.         This is simply a way to fool GEM into displaying the desired 
  159.         resolution, but the mouse control or other things may not be 
  160.         what you expect.  These options can be useful, but try them to 
  161.         be sure they work for a given program.  You might find several 
  162.         programs that are at least usable in the wrong resolution.
  163.  
  164.                 
  165. $$      ADCB: QuickKey
  166.  
  167.         You can assign up to twenty QuickKeys for menu items you use 
  168.         frequently.  When you press a QuickKey, it acts exactly as if 
  169.         you had selected its associated menu item from the menu (you can 
  170.         even force Mini-Run to be used for programs by holding Control 
  171.         as you press the QuickKey, or press Esc before pressing the 
  172.         QuickKey).  QuickKeys can be used no matter which menu is 
  173.         currently displayed.
  174.  
  175.         To assign a QuickKey to the menu item you are adding or 
  176.         changing, click on the "QuickKey" line in the ACDB.  A brief 
  177.         menu appears in the menu bar area at the top of the screen:
  178.         
  179.            Avail: F1 F2 F3 F4 F5 F6 F7 F8 F9 10 (Esc=Clear)
  180.         
  181.         In low res, you may only see the first few choices.  From this 
  182.         menu, press one of the function keys listed ("10" is used for 
  183.         "F10") to assign that key as a QuickKey.  If you have assigned 
  184.         all the QuickKeys already, the message "(none)" appears instead 
  185.         of any function key numbers.  If you press Esc or click the 
  186.         Right mouse button, then no QuickKey assignment is made.
  187.  
  188.         If you select the QuickKey option for a menu item that already 
  189.         has a QuickKey assigned, the QuickKey option lets you clear the 
  190.         assignment.  If, for example, QuickKey F6 had been assigned to 
  191.         CYBRMATE.PRG, and keys F4 and F7 were also available, the 
  192.         QuickKey menu would be:
  193.         
  194.            Avail: F4 F6 F7 (Esc=Clear)
  195.         
  196.         Notice that F6 has ALREADY been cleared from CYBRMATE.PRG, and 
  197.         you must press F6 to reassign this QuickKey if you want to keep 
  198.         using it for this program.  "F6" still appears in the ACDB below 
  199.         as a reminder, in case you forget which key was assigned.
  200.  
  201.  
  202. $$      Ten More Quickeys!
  203.                 
  204.         An alternate set of QuickKeys is available for a total of twenty 
  205.         QuickKeys.  Press Shift when selecting the QuickKey line in the 
  206.         ACDB to assign or clear from the alternate set.  The menu then 
  207.         appears as:
  208.         
  209.            Shift: F1 F2 F3 F4 F5 F6 F7 F8 F9 10 (Esc=Clear)
  210.         
  211.         Press Shift when pressing the desired function key.  To use this 
  212.         QuickKey after leaving the ACDB, press Shift and the function 
  213.         key.  Shifted and regular QuickKeys are really two separate 
  214.         lists but both work the same way.
  215.  
  216.         QuickKey assignments can be viewed in place of the normal Runner 
  217.         menus by selecting "QuickKeys show" from the "Menus" menu in the 
  218.         Gem menu bar, or by pressing BOTH mouse buttons.  Use either of 
  219.         these actions return to the normal Runner menu lists.  To view 
  220.         the alternate set, hold down Shift when requesting the QuickKeys 
  221.         list.  You can also press the right mouse button when looking at 
  222.         a QuickKeys list to see the other list, or click on the line at 
  223.         the top of the QuickKeys list that says "Show other QuickKeys" 
  224.         or something close to that....
  225.  
  226.         When the QuickKeys list is displayed, you can run any of the 
  227.         programs on it, or go to any menu listed on it, as if you were 
  228.         in Runner's usual menus, by using mouse or arrow keys and Return 
  229.         as usual.  Use the TAB key to see QuickKeys assigned to programs 
  230.         hidden from the current resolution, just as in menu lists.
  231.  
  232. $$      Changing QuickKeys
  233.                         
  234.         You can use the Change command to modify any program attributes.  
  235.         Drop works differently: here it only clears a QuickKey 
  236.         assignment (the program disappears from the QuickKeys list, but 
  237.         is not dropped from Runner's normal menus).  Restore is 
  238.         disabled, and you cannot add programs or menus or assign 
  239.         QuickKeys here (how would you pick a program to assign?).
  240.  
  241.         
  242. $$      ADCB: Colors
  243.         
  244.         The ACDB lets you select which color palette to use when running 
  245.         a program.  The default is "Current", meaning that the Current 
  246.         Palette will be used.  Clicking on the Colors line switches to 
  247.         "desKtop", "iNitial", "backGround", "Text" and back to 
  248.         "Current".  Any selection but "Current" will override the 
  249.         Current Palette while running the program.
  250.         
  251.         
  252. $$      ADCB: Install
  253.         
  254.         Here is where you can install an application in Runner.  This is 
  255.         similar to Install Applications in the Desktop, under the Set 
  256.         Preferences menu, but Runner doesn't know what's installed in 
  257.         the Desktop any more than the Desktop know's what Runner has.  
  258.         Any program can be installed in Runner: you tell Runner what 
  259.         file extensions (such as .PI1 or .DOC) should trigger the 
  260.         program to run, then when you select a file whose name ends with 
  261.         that extension, Runner loads the program.  The selected filename 
  262.         is also passed to the program so it can load the file for you.  
  263.         Not all programs will do this, but some (like Word Writer) 
  264.         handle it nicely.
  265.         
  266.         As an example, say you installed Word Writer (WWRITER.PRG) to be 
  267.         triggered by the extension ".DOC".  When you select a file like 
  268.         "DEAR_SIR.DOC", Word Writer will run and load DEAR_SIR.DOC for 
  269.         you, all with a single mouse click!
  270.  
  271.         When you select the Install line in the ACDB, this menu appears:
  272.         
  273.                        Add/Change/Drop/Next/Quit   [none]
  274.  
  275.         Press A to add a new file extension.  You'll get this prompt:
  276.         
  277.                        Add/Change/Drop/Next/Quit   >.
  278.  
  279.         which is asking you to type in a one to three letter file 
  280.         extension.  You can use the wildcard characters ? and * if 
  281.         needed (? matches any single character and * matches anything 
  282.         from that character position to the end of the extension).  So, 
  283.         if you enter ".P?1", then selecting files ending in .PI1 or .PC1 
  284.         will trigger the application.  Be careful though, if you enter 
  285.         ".P*" or ".P??" with the intent of catching .PI1, .PC2, and so 
  286.         on, you will also trigger your application with any .PRG files!  
  287.         You can use Backspace to erase characters; press Return when 
  288.         done.  Now the extension appears in the menu line like this:
  289.  
  290.                        Add/Change/Drop/Next/Quit   [.P?1]
  291.  
  292.         To change this extension, press C.  To drop it, press D.  Runner 
  293.         lets you install multiple extensions per program if needed; 
  294.         press A to add another one.  Pressing N displays each one in the 
  295.         list for that program, circling back to the start from the end 
  296.         of the list.  C and D only work on the extension displayed.  
  297.         When you have the extensions set the way you want, press Q or 
  298.         the Right mouse button.
  299.         
  300.         A total of 63 applications can be installed.  You can assign 63 
  301.         to a single program or one to each of 63 programs or any 
  302.         combination in between.  Overhead in memory is small; 2 bytes 
  303.         for each program with at least one installed application and 7 
  304.         bytes for each extension used.  If an installed application is 
  305.         dropped (using "Drop" in the Menus menu) then the extensions it 
  306.         used are fair game for installing elsewhere.  If you do not 
  307.         reassign them before restoring the program ("Restore" in the 
  308.         Menus menu) then they will still be intact.  Runner doesn't 
  309.         prevent you from assigning the same extension to more than one 
  310.         program but you will get a warning message telling you to clear 
  311.         the extension from one of the programs.  If you use the same 
  312.         extension twice then the first program found installed for that 
  313.         extension will be run.  Since it's harder to describe how Runner 
  314.         finds programs than to tell you not to do this, Don't Do This!
  315.  
  316.         Within Runner's menu list screen you can view a list of all 
  317.         installed applications by selecting "Installed apps" from the 
  318.         File menu, or by pressing the "I" key.
  319.  
  320.         
  321. $$      ADCB: Comment / Parameter
  322.         
  323.         Clicking on this line cycles through four possibilities:
  324.         
  325.         -  Comment (wait)
  326.         -  Comment (auto)
  327.         -  Parameter (wait)
  328.         -  Parameter (auto)
  329.         
  330.         These will be described below; they all work with the text field 
  331.         directly underneath this line.  To get to the text field, click 
  332.         on it with the left mouse button or press the Tab key to move 
  333.         between Comment/Parameter text and the Description text field at 
  334.         the top of the ACDB.  A ">>" symbol indicates which of the text 
  335.         fields is active.  The Comment/Parameter text field can be 
  336.         edited just like the Description text field (described near the 
  337.         start of this file).
  338.  
  339.         The Comment/Parameter function is probably the most confusing 
  340.         thing in Runner so don't worry if you don't use it.  The idea 
  341.         here is that many programs, in particular those with a ".TTP" 
  342.         (TOS - Takes Parameters) file extension, will accept a list of 
  343.         parameters (also called arguments or even a command line).  The 
  344.         ARC program is a classic example.  It's filename is ARC.TTP; it 
  345.         expects parameters.  If you double click on ARC.TTP from the 
  346.         desktop, a dialog box opens to ask you for the parameters.  You 
  347.         might enter a string such as "L E:\CBURST.ARC *.DOC" to list the 
  348.         names of all the files ending with ".DOC" within the archive 
  349.         file CBURST.ARC in the root directory of drive E:.  Compilers 
  350.         and assemblers and directory listing programs frequently expect 
  351.         or accept parameters.
  352.         
  353.         For .TTP programs and installed applications, Runner normally 
  354.         asks you for a command line.  If the program was triggered as an 
  355.         installed application, then the name of the file is 
  356.         automatically placed in the command line for the program.  
  357.         Selecting either of the Parameter options here will override the 
  358.         normal process and will let you pass parameters to other 
  359.         programs as well.  Simply type in the command line parameters 
  360.         you want in the text field.  If you leave the field blank but 
  361.         select one of the Parameter options (either wait or auto) then 
  362.         no parameters are passed as a default.
  363.         
  364.         If you are setting up parameters for an installed application, 
  365.         then use a tilde "~" to mark where the name of the file that 
  366.         triggers the application should go.  Using the previous example 
  367.         for Arc, you might set up a parameter field like this:
  368.  
  369.                                     L ~ *.*
  370.  
  371.         Now, if you install Arc to be triggered by files with an 
  372.         extension of .ARC, and then select CBURST.ARC from drive A, the 
  373.         command line passed to Arc becomes:
  374.         
  375.                               L A:\CBURST.ARC *.*
  376.  
  377.         If, for some obscure reason, you actually need to pass a "~" 
  378.         character to a program from the parameter line, use "~~".  
  379.         Runner replaces every single "~" with a filename, and every pair 
  380.         of "~" with a single "~".
  381.         
  382.         If a "~" is followed by a period, then Runner assumes you want 
  383.         to force a different file extension onto the selected filename 
  384.         and it removes the original extension.  For example, you might 
  385.         Install your compiler to be triggered by files with a ".C" 
  386.         extension, and set up this parameter line:
  387.         
  388.                                ~ -o ~.O -l ~.LST
  389.         
  390.         If you select "C:\XYZZY.C", this line would be translated to:
  391.         
  392.                      C:\XYZZY.C -o C\:XYZZY.O -l C:\ZYXXY.LST
  393.         
  394.         Complex stuff, but if you're using a compiler then this should 
  395.         make sense to you.  Otherwise file it away into the part of your 
  396.         memory labeled: "Things that could possibly become useful to me 
  397.         under unlikely circumstances".
  398.         
  399.  
  400.         The (auto) and (wait) options are simple:  "Parameters (auto)" 
  401.         means that the command line Runner builds will be passed to the 
  402.         application or program automatically, without stopping to ask 
  403.         you anything.  "Parameters (wait)" means Runner will display the 
  404.         command line and let you edit it before running the program.
  405.         
  406.         For the Arc example, you would probably choose (wait) because 
  407.         you can then edit the first character to be E for extract, V for 
  408.         verbose list, A for add, etc. (these are all ARC functions and 
  409.         have nothing to do with Runner).  For others, such as Word 
  410.         Writer, which accepts only the name of a file to open, you 
  411.         should use (auto) with a default parameter list of "~".
  412.         
  413.         
  414. $$      Program Comments
  415.         
  416.         If you don't use parameters for a program, you can use this line 
  417.         as a comment to yourself.  Selecting "Comment (auto)" means the 
  418.         comment will only appear in the ACDB.  Possibly useful for 
  419.         recording the version number of the program, or maybe you could 
  420.         use "Docs on disk 57".
  421.         
  422.         If you select "Comment (wait)" then before the program runs a 
  423.         dialog box will display the comment text and give you the choice 
  424.         of running the program or canceling the request.  A blank 
  425.         comment line, even if "Comment (wait)" is selected, is ignored 
  426.         by Runner.  (wait) comments can be used for messages like "Key 
  427.         disk in A:" or other reminders.
  428.  
  429.         
  430. $$      Priority for Parameters and other Settings
  431.         
  432.         Since there could be some confusion if you set up options for 
  433.         an installed application, and then set different options for 
  434.         a document/data file that triggers it, the following rules 
  435.         tell who wins:
  436.  
  437.         *  Options set for a triggering file override options for an 
  438.            installed application.
  439.  
  440.         *  Exception 1: use of a parameter option always overrides use of 
  441.            a comment option.
  442.  
  443.         *  Exception 2: Hold Screen and Mini-Run will be activated if 
  444.            either a triggering file or a program request them.
  445.  
  446.         
  447.         [end of DIALOG.HLP]
  448.         
  449.