home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 1 / CD_Magazyn_EXEC_nr_1.iso / eXec / FAQ / ParM.lzx / ParM_V6.02 / ParM.DocE < prev    next >
Text File  |  2008-02-24  |  26KB  |  687 lines
  1.  
  2. ParM stands for Parametrable Menu.
  3.  
  4. ParM  allows  you to build your own menus in order to run all the programs
  5. you  can  have  on  one ore more disks.  This is very useful for hard disk
  6. owners  who  have  programs deeply enclosed in subdirectories.  With ParM,
  7. you  can run them without going through directories under either WorkBench
  8. or CLI.
  9. With  ParM,  you  can start programs in either WorkBench or CLI mode.  The
  10. advantage  of  WorkBench mode is that the default directory of the program
  11. you run is the one in which the program file is.  But not all programs can
  12. be run in this mode.
  13. ParM  now  has an integrated SunMouse, screen blank, mouse accelerator...
  14. We decided to implement this since an input-handler was already present in
  15. parm.library,  and  we  had 3 windows in the workbench screen's title bar.
  16. One  for  sunmouse,  one  for  memory/time display, and the useless ParM's
  17. window.  So now, ParM's window is usefull, and is easier to catch for menu
  18. access.
  19.  
  20.  
  21.  
  22. Using ParM:
  23. -----------
  24.     Reading  this documentation can make you being confused with all modes
  25. you  can  use to run your favorite tools.  So, you will find at the end of
  26. this  text  a  tutorial about what modes you'd better use.
  27.  
  28.  
  29. Installation:
  30. -------------
  31.     Put ParM and SetMouse with their icons wherever you want, and just put
  32.     the  default  config  file  "ParM.cfg"  in  S:  if you use it.  If you
  33.     don't,  you'll  have to specify the config file in the command line or
  34.     in  the tool types of the icon, otherwise, you will have to cancel the
  35.     requester and won't have any menus.  Since version 2.6r, you must also
  36.     put parm.library in your LIBS: directory.
  37.  
  38.  
  39. Running:
  40. --------
  41.     It  is  recommended  to run ParM from CLI if you want your programs to
  42.     have  a default path other than the current directory and C:  which is
  43.     the case if you start it from WorkBench.
  44.  
  45. ParM can work in three ways.
  46. 1)    You  can  attach  ParM to the CLI you are using.  In this case, if you
  47.     don't specify any of the window options, the menus will be attached to
  48.     the  CLI  window  you  start  it  from.  You may then only "Run" it to
  49.     prevent  you from closing the CLI.  In this case, commands launched in
  50.     RUN mode will use the cli/shell window for their input/output.  If you
  51.     dont  want your shell to be trashed by these commands, use the USENULL
  52.     option.
  53.  
  54. 2)    ParM can have its own window.  This is allways the case when it is run
  55.     from  WorkBench, but you can also tell it to open it's own window when
  56.     run from CLI using OWNWINDOW option or any of the window options.  You
  57.     should then "RunBack" it to be able to close the CLI later.
  58.  
  59. 3)    ParM can be attached to Workbench, ala MyMenu.
  60.  
  61.  
  62.     ParM  have  some  options  which  are  available  for most either from
  63.     WorkBench  or from CLI.  Arguments documentation is now available from
  64.     within  ParM  itself.  Just type ParM ?, and then ?  again.  Arguments
  65.     with  /S  are  switches,  and  arguments with /K are keywords and need
  66.     something more (a number, ON or OFF, a filename,...). added /N are for
  67.     numeric arguments.
  68.     From  workbench,  keywords  are the same.  You just have to add  =TRUE
  69.     for switches, or =Argument for keywords.
  70.  
  71.     CLIWINDOW and USENULL are not available from WorkBench.
  72.  
  73.     ParM's CLI Help:
  74.  
  75. MYMENU/S,CLIWINDOW/S,OWNWINDOW/S,LEFTEDGE/K/N,TOPEDGE/K/N,DETAILPEN/K/N,BLOCKPEN/K/N,
  76. DRAGBAR/K,DEPTH/K,AUTOFRONT/K,SHOWMEM/K,SHOWTIME/K,REFRESHTIME/K/N,MTDETAILPEN/K/N,
  77. MTBLOCKPEN/K/N,MENUCOLOR/K/N,STACKSIZE/K/N,CONFIGFILE/K,USENULL/K: ?
  78.  
  79. ParM V4.2 © 1990-92 by S.R. & P.C.
  80. MYMENU            Attach menus to Workbench's (Like MyMenu)
  81. CLIWINDOW         Attach menus to CLI/Shell Window
  82. OWNWINDOW         Open its own window (default)
  83. LEFTEDGE          Left edge of ParM Window (default 0)
  84. TOPEDGE           Top edge of ParM Window (default 0)
  85. DETAILPEN         Detail pen of ParM Window (default 1)
  86. BLOCKPEN          Block pen of ParM Window (default 2)
  87. DRAGBAR   ON|OFF  Drag bar (You can't move ParM window) (default on)
  88. DEPTH     ON|OFF  Depth gadgets (default off)
  89. AUTOFRONT ON|OFF  Automatic window to front (default: on)
  90. SHOWMEM   ON|OFF  Show available memory (default off)
  91. SHOWTIME  ON|OFF  Show time. (default off)
  92. REFRESHTIME       Interval time for Mem/Time refresh in 0.1s (default 1s)
  93. MTDETAILPEN       DetailPen for Mem/Time (default: DetailPen)
  94. MTBLOCKPEN        BlockPen for Mem/Time (default: BlockPen)
  95. MENUCOLOR         Color for ParM's main menu (defaut: DetailPen)
  96. STACKSIZE         Default stack size for commands (defaut: ParM process stack)
  97. CONFIGFILE        Configuration file (default: S:ParM.cfg)
  98. USENULL   ON|OFF  Redirect output to NULL: (or NIL:) for commands in RUN mode (default: off)
  99.  
  100.  
  101. Environnement variable ParMOpt:
  102. -------------------------------
  103.     In  addition to the command line, your preferences can now be saved in
  104.     the Env:ParMOpt variable.  Just snap your cli arguments and paste them
  105.     into your text editor.  Then, save the file as Env:ParMOpt.  This file
  106.     will  be  parsed  first,  and  then  the  CLI/WB arguments, which will
  107.     override the environnement variable. (See example given).
  108.  
  109.  
  110. Configuration file:
  111. -------------------
  112.     You  will  best  understand what follows if you have in front of you a
  113.     printout of the config file supplied.
  114.  
  115.     A  configuration  file  looks  like  a structured program.  You should
  116.     indent your lines to make the file as readable as possible.
  117.  
  118.     The  default  configuration file should be in the S:  directory and be
  119.     named ParM.cfg.
  120.  
  121.     The  configuration  file defines the menus you want, and what commands
  122.     they will run.  Comments begin with a #, and continue until the end of
  123.     the line.  Upper and lowercase do not make a difference.
  124.  
  125.  
  126.     Keywords:
  127.     ---------
  128.  
  129.     CMDWIN  console_name
  130.  
  131.         This  will  override  the  default console used for Command output
  132.         which is "CON:0000/0011/0640/0100/Command window/AUTO/CLOSE/WAIT".
  133.         This should be placed anywhere in the file but better be at top of
  134.         it.  This console will in 2.0 have a close gadget, a defered open,
  135.         and wait user to hit close gadget before closing window.
  136.         Under 2.0, if you use Command in Simple mode, you MUST specify the
  137.         /WAIT  option  for your console, or it will close before you could
  138.         read it.
  139.  
  140.     SHELLWIN  console_name
  141.  
  142.         This  will  override  the  default console used for SHELL commands
  143.         which  is  "CON:0000/0011/0640/0100/Shell/Auto/Close/Wait".   This
  144.         should be placed anywhere in the file but better be at top of it.
  145.  
  146.  
  147.     SHORTCUTQUAL qual
  148.  
  149.         This  can  be  used  to  add keys to access menus short-cuts.  For
  150.         example,  you can use Left-Amiga, ALT, SHIFT or Ctrl.  If you want
  151.         several keys, you just have to add qualifiers listed below:
  152.  
  153.             Left-Shift        1
  154.             Right-Shift        2
  155.             Ctrl            8
  156.             Left-Alt        16
  157.             Right-Alt        32
  158.             Left-Amiga        64
  159.  
  160.         If for example you want both left and right ALT keys to work for
  161.         menu shortcuts:        ( 16 + 32 = 48 ! )
  162.             SHORTCUTQUAL 48
  163.  
  164.         If  you  want shortcuts without a qualifier key, you can use 32768
  165.         (IEQUALIFIER_RELATIVEMOUSE),  which  is  allways present in RAWKEY
  166.         events. (Use with great care).
  167.         This  works  only when ParM has its own window or when attached to
  168.         Workbench.
  169.  
  170.  
  171.     ACTIVATEKEY [SCREENTOFRONT] [PASSTHROUGH] [NOCHECK] qualifier rawkey
  172.  
  173.         This  gives  you access to the simple but powerfull parm's library
  174.         input  handler.  Be carefull, rawkey is the keyboard key code, not
  175.         the ASCII code of the key.
  176.         This  gives  you the possibility to define one or more hot keys to
  177.         activate  parm's window, or any parm.library user, like "The Great
  178.         BrowserII".
  179.  
  180.         Options:
  181.             1. SCREENTOFRONT
  182.                 The screen which contains ParM's window comes to front.
  183.             2. PASSTHROUGH
  184.                 This may be hard to understand for non-programmers, but is
  185.                 powerfull  and  quite simple.  Let's say that if you don't
  186.                 use  this  option,  the  hot-key will just activate ParM's
  187.                 window, and that's all.  If you use it, the event will not
  188.                 be  removed  from list, and as ParM's window has just been
  189.                 activated,  it  will receive the raw key.  So, if this raw
  190.                 key is also a menu short cut, it will be executed without
  191.                 having to activate ParM's window with the mouse.
  192.  
  193.                 Example:
  194.  
  195.                     SHORTCUTQUAL 64                    (Left-Amiga)
  196.                     ACTIVATEKEY PASSTHROUGH 64 50    (Left-Amiga - X)
  197.  
  198.                     Menu System
  199.                         Item {X} Xoper RUN Xoper
  200.  
  201.                     This  allways  runs Xoper, without touching the mouse,
  202.                     even if ParM's window is not the active one.
  203.  
  204.                 Another example:
  205.  
  206.                     # Left ALT - Right Mouse Button
  207.                     ACTIVATEKEY PASSTHROUGH SCREENTOFRONT 8208 105
  208.  
  209.                     This activate ParM's menus, in a single click. No more
  210.                     need to search for little ParM's window.
  211.  
  212.             3. NOCHECK
  213.                 The  library keeps a list of hot-keys.  When you add a new
  214.                 hot-key  with  ACTIVATEKEY command, ParM controls if it is
  215.                 not already used.  If it is, you will be requested, and it
  216.                 will  be ignored.  If you specify NOCHECK, hot-key will be
  217.                 inserted  in  head  of  the list, and will take precedence
  218.                 over the old one.
  219.                 Here  is what I do with that:  I have a hot-key in ParM to
  220.                 load  BrowserII.  The same hot-key has the NOCHECK flag in
  221.                 BrowserII.menu.   So,  if BrowserII is already loaded, the
  222.                 hot-key   brings   BrowserII's   screen  to  front,  else,
  223.                 BrowserII is loaded by ParM.  Nice, isn't it ?
  224.  
  225.                 ParM.cfg :
  226.  
  227.                     SHORTCUTQUAL 64
  228.  
  229.                     # Left Amiga - Z   (Load BrowserII)
  230.                     ACTIVATEKEY PASSTHROUGH 64 49
  231.  
  232.                     menu Tools
  233.                         item {Z} BrowserII        RUN    HD:Tools/BrowserII
  234.  
  235.                 BrowserII.menu :
  236.  
  237.                     SHORTCUTQUAL 64
  238.  
  239.                     # Left Amiga - Z
  240.                     ACTIVATEKEY SCREENTOFRONT NOCHECK 64 49
  241.  
  242.  
  243.     COLOR n
  244.  
  245.         This  will  set  the  foreground pen color for new items.  You can
  246.         change this as often as you want.  The arguments is the pen number
  247.         to  use.   The  default  is  window  detail pen.  If the color was
  248.         window  block pen, the item would be invisible, in this case, ParM
  249.         replaces the color with window detail pen.
  250.  
  251.     MENU menu_name
  252.  
  253.         Creates  a  new  menu.   Each  menu must have at least one item or
  254.         submenu.
  255.  
  256.     SUBMENU submenu_name
  257.  
  258.         Creates  a  new submenu.  Each submenu must have at least one item
  259.         and can't have submenus.
  260.         Each SUBMENU must end with an ENDSUBMENU
  261.  
  262.     ENDSUBMENU
  263.  
  264.         See SUBMENU.
  265.  
  266.     ITEM [{command-char}] item_name [WBTF] [REQUEST] command_def
  267.  
  268.         Defines  a  new  menu  item.   Each  item  definition must have an
  269.         item_name  and  an associated command.  Each item is linked to the
  270.         current  menu  or  submenu.  An ENDSUBMENU statement tells ParM to
  271.         attach  next  items to the current menu rather than to the current
  272.         submenu.   If  any of the menu, submenu and item names may contain
  273.         whitespaces.   In this case, enclose the name in double quotes.  A
  274.         command  character may be defined for the menu item by putting the
  275.         character  after  the  ITEM  keyword  and  surround  it with {}'s.
  276.         WBTF is optional. Brings workbench to front just after running the
  277.         command.  REQUEST is also optional. Opens a requester enabling you
  278.         to modify the command before running it. Not available for WB mode
  279.         Command syntax is decribed below.
  280.  
  281.         command_def
  282.  
  283.             Programs  can  be run in three ways:  RUN, SHELL, and WB.
  284.             For  all modes, STACK and PRI are optionnal.  If STACK is less
  285.             than  4000  bytes, or if no stack is specified, the stack will
  286.             be  set to the ParM task Stack.  That is to say the stack size
  287.             at  time  ParM  was  run.   There's  an exception:  If ParM is
  288.             resident, ParM stack will allways be 4000 bytes.
  289.  
  290.  
  291.             1) RUN syntax
  292.  
  293.             RUN [WIN console_window] [STACK n] [PRI n] command [args][;command [args]]...
  294.  
  295.             This  mode  creates  a  background shell.  This mode should be
  296.             used for scripts.  If the bit s of your script file is set, it
  297.             is  automaticaly sourced (No need of the execute command).  In
  298.             this mode, commands won't be detached if ParM is attached to a
  299.             CLI  (except if you use USENULL option).  Redirection  can  be
  300.             done in this mode.
  301.             You can specify several commands separated with semicolons ;.
  302.  
  303.  
  304.             2) SHELL syntax
  305.  
  306.             SHELL [WIN console_window] [STACK n] [PRI n] command [args][;command [args]]...
  307.  
  308.             This mode now does the same as RUN, but if no window is given,
  309.             the default shell window is taken.
  310.  
  311.  
  312.             3) WB syntax
  313.  
  314.             WB [STACK n] [PRI n] command
  315.  
  316.             Execute  command  in WorkBench mode.  No arguments are allowed
  317.             in  this  mode.  Warning:  If STACK is specified here, it will
  318.             override the stack specified in the icon of the command.  Your
  319.             command may crash if you ask a smaller stack than in the icon.
  320.             Do it at your own risk.
  321.  
  322.  
  323.             5) CFG action
  324.  
  325.             CFG ConfigFile
  326.  
  327.             ParM  loads  the  new  ConfigFile like ParM->Open in the Menu.
  328.             Very  usefull  to  use different cfg file on different disk to
  329.             choose programs on this disk.
  330.  
  331.     BARLABEL
  332.  
  333.         Adds a bar between last item and next one.
  334.  
  335.  
  336.     For  all  modes  but  WB,  your  command is searched first in resident
  337.     list  and  then in CLI Path at time ParM was run.  To know the path in
  338.     which  ParM  search  its  commands, just issue the Path command in the
  339.     requester of ParM Command command, or open a newcli or shell from ParM
  340.     and issue the Path command.
  341.  
  342.     A config file is given with ParM as an example.
  343.  
  344.  
  345. ParM commands:
  346. --------------
  347.     Open:        Pops up a requester asking to select the new config file.
  348.     UpDate:        UpDate the menu reloading the config file.  Usefull if you
  349.                 modify the config file while ParM is running.
  350.     Std Cfg:    Load   the   standard   'S:ParM.cfg'  configuration  file.
  351.                 Usefull  to  return in your favorite cfg when you are lost
  352.                 in one disk cfg.
  353.     Command:    Execute  cli  commands.  Your CMDWIN console MUST have the
  354.                 /Wait  option  if  you want to be able to read the command
  355.                 output.
  356.     Change Dir: Changes ParM current directory.  Commands run in all modes
  357.                 but WB will inherit ParM's current directory.
  358.     Quit:        Why? You don't like it!
  359.  
  360.  
  361. Separated commands:
  362. -------------------
  363.   End:
  364.  
  365.     The  End command can now close a CLI in which a ParM is attached.  End
  366.     needs  EndCLI  to  work.  If there is no ParM attached to the CLI, End
  367.     will  only  do  an  EndCLI.   End  and EndCLI can be made resident for
  368.     maximum  speed.   You  can for example put ParM in your CLI-Startup or
  369.     Shell-Startup  to  have  menus in all of your CLI/Shells and you'll be
  370.     able  to  leave them with the End command without worrying about ParM.
  371.     Don't use this command in a WShell since it loads EndCLI from disk and
  372.     WShell only accept its built in EndCLI command.
  373.  
  374.  
  375.   ParMCD:
  376.  
  377.     The  ParMCD  change  the  current directory of the ParM attched to the
  378.     current  cli window.  Without argument, ParM will take the cli current
  379.     dir.  Otherwise, you can specify a directory as an argument to ParMCD.
  380.  
  381.  
  382.   Note:
  383.   -----
  384.     These commands do not work if you use the console replacement DHOpts.
  385.     DHOpts doesn't support packet ACTION_DISK_INFO when ParM has installed
  386.     it's menu on the console window. THIS IS NOT A PARM BUG.
  387.  
  388.  
  389. Limitations:
  390. ------------
  391.     If  a  command  in  RUN or SHELL mode can't be started, you will never
  392.     know, except you won't see it working.
  393.  
  394.     When  attached  to  a  CLI,  commands  executed  in  RUN mode won't be
  395.     detached,  which  means that you won't be able to close the cli before
  396.     those  commands  end.  This is the same problem as if you had run your
  397.     command in a CLI with
  398.             1> Run mycommand
  399.     By  the  way,  theses  commands will have their output file handles in
  400.     this  window, and advantages can be taken from that.  You can redirect
  401.     these  to  NIL:   or  use USENULL option to avoid trashing of your cli
  402.     window.  In this case, commands will be detached.
  403.  
  404.  
  405. Known bugs:
  406. -----------
  407.  
  408.     See notes for external commands.
  409.     RUN PRI 1 NewShell        does not work. Pri is allways 0. Not a ParM bug.
  410.  
  411.  
  412. Future plans:
  413. -------------
  414.  
  415.     Localization.
  416.  
  417.  
  418. Release notes:
  419. --------------
  420.  
  421.     1.0:    Internal. Major MyMenu rework.
  422.  
  423.     1.1:    First official release. (Sent to Fred Fish)
  424.             Old CLI option changed to RB (stands for RunBack).
  425.             New CLI option added.
  426.             Config file syntax changed. (Old was MyMenu's one).
  427.  
  428.     1.4:    Internal. Option -l -d and WBRun enhanced.
  429.             Now you can run projects icons which have no file. For example
  430.             Serial, Pointer and Printer in the Prefs drawer.
  431.  
  432.     1.6:    Second official realease. 29/09/90
  433.             Code Cleanup
  434.             New CFG option added.
  435.             New 'Std cfg' menu added.
  436.  
  437.     1.7:    Internal
  438.             No more uses c16.lib, but use my owns instead.
  439.             Code size about 1.5K smaller.
  440.  
  441.     2.0:    Third Official release. 13/10/90.
  442.             ParM can now be made resident.
  443.             End command created.
  444.             Directory path string built in 'Change Dir'.
  445.  
  446.     2.1:    ParMCD command created.
  447.     2.1r:    This version uses the great req.library (r for req!)
  448.  
  449.     2.2r:    No more RB and CLI modes. New modes are ARUN, RUN, and SHELL.
  450.             STACK and PRI available in all modes but WB now.
  451.             No more need of the Run command in your C: directory.
  452.             Syntax errors in config file will now be reported with a line
  453.             and char number.
  454.  
  455.     2.3r:    You will never see again 'Workbench processes still active'.
  456.             ParM now creates a public MsgPort to handle workbench replies
  457.             and leave it if there's still messages to be replied.
  458.             Now, if your console has a close gadget, ParM will end if you
  459.             hit it. This is usefull for lucky owners of WShell.
  460.             Characters of ascii value over 127 now supported. (accents)
  461.             WAITCMD added.
  462.  
  463.     2.4r:    WB mode rewriten. STACK and PRI available in all modes now.
  464.             WB mode no more crashes if command not found. You can now run
  465.             tools that haven't an associated icon.
  466.             Memory for menus items is allocated by 1 K blocks to decrease
  467.             fragmentation.
  468.  
  469.     2.5r:    -s and -o option added.
  470.             -s (stack) is specially usefull when ParM is resident  because
  471.             in this case ParM stack is allways 4000 bytes whereas it takes
  472.             the default stack size of your cli when it is not resident. As
  473.             all commands run from ParM take as default the ParM stack size
  474.             you can specify a higher stack with this option.
  475.  
  476.     2.51r:    Minor update. Bug fixes.
  477.             ParM  no  more  crashes when run from workbench if arp.library
  478.             cannot be found.
  479.  
  480.     2.6r:    ParM now implemented as a shared library. This allow BrowserII
  481.             to take advantage of ParM's parsing and creating parametrables
  482.             menus. Put "parm.library" in LIBS:, and ParM at the same place
  483.             as before.
  484.             When  ParM  is used with it's own window, menus short-cuts can
  485.             be  accessed with  Left-Amiga  as well as standard Right-Amiga
  486.             key, except for M and N which are intuition private.
  487.             ParM window is now autofront. (user request).
  488.  
  489.     2.7:    -o  option  now  attempt to use NULL:  rather than NIL:, which
  490.             allow  to  really redirect output for RUN commands to NIL:  or
  491.             better  to  say  NULL: !  This prevent programs which open "*"
  492.             after the cli from which ParM was run to crash if cli has been
  493.             closed.  With NULL:, RUN mode is now perfectly safe and should
  494.             work in all cases.  If NULL:  isn't found, NIL:  will be used.
  495.             'r'  removed  from  version  number.   Making  a version which
  496.             doesn't use req.library is no more planned.
  497.  
  498.     2.8:    Bug fixes.
  499.             Qualifier for menu short-cuts now parametrable.
  500.  
  501.     2.9:    Implementation  of  an input handler in parm.library. It makes
  502.             possible to run a command with a hot-key, without touching the
  503.             mouse,  or  to activate ParM's menus without activating ParM's
  504.             window.
  505.  
  506.     3.0:    As a user request, ParM can now be attached to Workbench, just
  507.             like  MyMenu.  (Code stolen from MyMenu once again). Sorry and
  508.             thanks, Darin and John.
  509.             ParM now works with Console-Buffer. With some limitations. You
  510.             MUST run ParM AFTER CB, and leave ParM BEFORE CB.
  511.             You can now put several commands, separated by a ; in RUN mode
  512.             and in Command, like in SHELL mode.
  513.  
  514.     3.1:    Bug fix in workbench menus coordinates.
  515.  
  516.     3.2:    First version of SunMouse/Accelerator...
  517.             SetMouse V1.0 for Mouse Opts settings.
  518.             Optionnal Mem/Time display in ParM's window.
  519.             ParM arguments now handled with GADS() (amiga standard style).
  520.  
  521.     3.3:    InputHandler rewritten. Intuition calls done from a separate
  522.             process rather than from input-handler (prevent dead locks).
  523.  
  524.     3.4:    InputHandler and RUN mode now works under KickStart 2.0.
  525.             VGA and SuperHires video modes not yet supported.
  526.             Default Shell Command is now NewShell (for OS 2.0).
  527.             Default Shell/Command window have 2.0 specifications.
  528.             Command in Simple mode is asynchronous under 2.0 and handle
  529.             inputs and CTRL-C properly.
  530.             SetMouse V1.1. Added Qualifier for WindowToFront.
  531.  
  532.     3.5:    Bug fix. (incompatibility between USENULL and CLIWINDOW).
  533.  
  534.     3.6:    Bug fix in workbench startup.
  535.             ParM can now be attached to Workbench 2.0 menus.
  536.             You no more need NULL: under 2.0
  537.             Under 2.0, you can specify a console window for the RUN mode.
  538.  
  539.     4.0:    Internal. First 2.0 only version.
  540.             No more arp nor req libraries.
  541.             Handler for SetMouse handle all screen resolutions now.
  542.             parm.library NOT compatible with previous releases. You MUST
  543.             replace all utilities which use parm.library with new ones.
  544.             SHELLCMD, WAITCMD, TMPDIR removed. Remove these commands from
  545.             your S:ParM.cfg and S:BrowserII.menu if any.
  546.             External command WaitReturn no more needed with /Wait consoles
  547.             ParM can no more be made resident. Who used this ?
  548.  
  549.     4.1:    Still internal. BarLabel available.
  550.             Better handling of ASCII chars > 127 in parse.
  551.  
  552.     4.2:    Added REQUEST flag, and WBTF handled in ParM.
  553.             Bug fixes.
  554.                 Tags for NewCreateProc same as Workbench in WBRun().
  555.                     (More V37.4 crashed in WB mode)
  556.                 Input Handler initialised in ParMHandlerTask.
  557.                 CliArg CONFIGFILE/K didn't work.
  558.                 Added /N for all numerical args in command line.
  559.             First special 2.0 release.
  560.  
  561.     4.3:    Localized. (Only French available for now).
  562.  
  563.     4.4:    Handle Stack in Project icons for WB Startup.
  564.             New option NEWLOOKMENUS for AmigaDOS 3.0. This turns off the
  565.             possibility to have individual colors for items, but enhance
  566.             item highlightening for multicolored screens.
  567.  
  568.     4.5:    SHOWMEM now shows Retina available memory if you have such
  569.             a board! :-)
  570.  
  571.     4.6:    ParM gets a copy of the Workbench's Path when started from
  572.             workbench. You can now put it in your WBStartup drawer and
  573.             it will run without loosing your path.
  574.             New Options in Setmouse. (MMB usage).
  575.             Recompiled using SAS 6.50.
  576.  
  577.     4.x:    forgoten enhencment
  578.  
  579.     4.y:    Add  show  of  GigaMem  memory  if the GigaMem's vmem.library was
  580.             unstalled ( show 0 KB if GigaMem was not started)
  581.  
  582.     5.0:    Add KEY, KEYTEXT & ... 
  583.  
  584.     5.1:    16/03/95
  585.             Add show of VMM memory ( overwite GigaMem memory)
  586.  
  587.     5.11:    03/06/95, Public
  588.             Pierre CARRETTE died in a motorbik accident on 12 May 1995.
  589.             No longuer support of French doc (don't have time to support 2
  590.             different doc now)
  591.             Be warned that cli-window attach had not been tested for a long time.
  592.  
  593.     6.00:    19/06/95
  594.             Add  ScreenNotify  support.   Now  ParM autmaticaly close/open its
  595. windows when WB screen prefs change
  596.             remove  attach to Workbench and CLI window support.  Is still there
  597. somebody  using  it  ?.   This  permit me to clean up src since this is our
  598. first serious prg, there some mistake in the src layout.
  599.  
  600.     6.01:    19/06/95
  601.             ParM allways refresh its window as in V5.11
  602.  
  603.     6.02: 02/07/95
  604.             ParM don't always reopen its window after screen change. try to fix that.
  605.  
  606.  
  607. Tutorial:
  608. ---------
  609.         Now you read about all ParM was able to do, I think you'd like to
  610.     know which mode you should use to run your favorite tools.
  611.  
  612.     First, when you want to add a manu item, you should know:
  613.  
  614.     1) Does your tool support workbench run ?
  615.     2) Do you want your tool to inherit ParM's current dir, or have its own ?
  616.     3) Do you want your tool to inherit ParM's CLI Path ?
  617.     4) Do you want your tool to use a console window for its output ?
  618.  
  619.  
  620.     SHELL mode is now the same as RUN but with a default console
  621.     if not specified.
  622.     So, choice between RUN and WB is easy.
  623.     If you need a console or the Path, use RUN mode.
  624.     Else, you can use WB mode.
  625.  
  626.  
  627. SetMouse:
  628. ---------
  629.  
  630.     SetMouse is self explanatory.
  631.  
  632.     WToFront Qual:
  633.         Key to be hold while double clicking to bring window to front.
  634.  
  635.     Screen Blank is done by turning off DMA.
  636.     Mouse Blank is done by turning off DMA Sprites.
  637.     Handler Pri can be changed for eventual compatibility problems with
  638.     other input handlers. It is 51 by default. If changed, it will become
  639.     active next reset. (Or parm.library must be flushed then reopen)
  640.  
  641.     Note: Mouse utility will be active as long as parm.library has a user.
  642.           (BrowserII, ParM, or SetMouse actually).
  643.  
  644.  
  645. Acknowledgements:
  646. -----------------
  647.  
  648.     The  first  release (internal) of ParM was a major rework of MyMenu by
  649.     Darin Johnson.  The problem was that it wasn't possible to have MyMenu
  650.     without workbench, and program started from MyMenu didn't have a Path.
  651.  
  652.     So, lots of thanks to Darin Johnson for menu allocations and workbench
  653.     run.  The idea of attaching menus to the CLI and some other ideas came
  654.     from a friend who also made a menu but wasn't easy to configure.
  655.  
  656.     Thanks to S.R. and P.C. for ParM!
  657.     Thanks to Darin Johnson for MyMenu.
  658.     Thanks to William S. Hawes for ARexx and WShell.
  659.     Thanks to Pierre Ardichvili for his help to me and to Amiga.
  660.     Thanks to CygnusSoft and ASDG for their GREAT CygnusEd 2.
  661.     Thanks again to Pierre CARRETTE, a very good friend.
  662.  
  663.  
  664. Signature:
  665. ----------
  666.  
  667.     S.R. & P.C.
  668.     This is not Status Register and Program Counter but
  669.     Sylvain Rougier & Pierre Carrette.
  670.     We are Frenchies so we hope the documentation is readable.  We put our
  671.     work  in  making english language comments, but it isn't allways easy,
  672.     so be fair with us.
  673.  
  674.  
  675. Donations:
  676. ----------
  677.  
  678.     This program is not public domain.  This program is ShareWare.  If you
  679.     use  it  or if you want the last revision, send $10 ($25 for both ParM
  680.     and BrowserII) and/or bugs report to:
  681.  
  682.         Sylvain Rougier
  683.         39 rue Carnot
  684.         86000 Poitiers
  685.         France.
  686.         EMail:rougier@ss3;univ-poitiers.fr
  687.