home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / misc / command / !ComndCTRL / !Help < prev    next >
Encoding:
Text File  |  1998-06-18  |  34.2 KB  |  673 lines

  1.  
  2.  
  3.                                 Command Control
  4.                                 ===============
  5.  
  6.  
  7. Documentation for  !ComndCTRL application version 2.60 18-Jun-1998,
  8. requires RISC OS 3.1 or later.
  9.  
  10. Issue: 2.60 18-Jun-1998, replaces:      0.10 10-Jul-1990
  11.                                         0.90 30-Jul-1990
  12.                                         1.00 31-Aug-1990
  13.                                         1.01 18-Jun-1991
  14.                                         1.10 22-Apr-1992
  15.                                         1.11 23-Nov-1992
  16.                                         2.00 01-Feb-1994               
  17.                                         2.50  04-Apr-1994     
  18.                                         
  19. Author: David J Ruck
  20.  
  21. Copyright © DEEJ Technology PLC 1990-1998
  22.  
  23.  
  24.  
  25. Overview
  26. ========
  27.  
  28.  
  29. The Command Control application (!ComndCTRL) is designed to provide an  easy
  30. to use and consistent RISC OS front end to a wide range of module  *commands
  31. and command line based programs.
  32.  
  33. The aim being to replace the typing of long command strings and path names 
  34. at the command line prompt, with the intuitive RISC OS file dragging and 
  35. menu selection operations.
  36.  
  37. In this document a command is name of something that can be typed at the 
  38. operating system prompt. It can be a command provided by a module, the  name
  39. of a program or obey file, but not an application.
  40.  
  41. !ComndCTRL allows any number of command to be accessible from the icon 
  42. bar at one time, each having its own icon and menu.
  43.  
  44. When typing in a command at the operating system prompt, several different 
  45. different parts of the command must be assembled (according to its syntax)
  46. in  order to make the whole command string, these are described below along 
  47. with how !ComndCTRL can help in this process.
  48.  
  49. Firstly if the command is not from a module and is not in the current
  50. directory  or Run$Path, the full path to the command must be given each
  51. time.  !ComndCTRL will store this path so that the command can be run
  52. without  having to set the current directory.
  53.  
  54.  
  55. Parameters
  56. ----------
  57. After the path and the command names can come a number of parameters to  the
  58. command, only some of which will be needed each time. Parameters are of 
  59. three types  flags, input files and output files. !ComndCTRL allows up to 10 
  60. parameters in any combinations of the three types.
  61.  
  62. Flags (sometimes call options) are usually of the form -c or -list are used 
  63. to switch on or off various features of the command. They may be followed by 
  64. a value e.g. -lines 100. !ComndCTRL allows the selection of flags and 
  65. values from easy to use menus. Each flag parameter allows a number of flags 
  66. to be placed in the command, or to restrict the choice to one from a group.
  67.  
  68. Input files, i.e. existing files that the command process in some way, can
  69. just  be dragged onto the commands icon, removing the need to type in long
  70. path  names. The file types that will be accepted can be restricted so that
  71. commands  are only given files that they can cope with. If the command
  72. requires more  than one input file each can be dragged to the icon in turn
  73. and the command  will be automatically run when enough input files have been
  74. provided. A  selection of files can be dragged from a filer window, in which
  75. case all the  files will be delivered to the command, causing it to run
  76. every time it has  received the correct number.
  77.  
  78. Output files are file generated by the command while running, a standard 
  79. RISC OS saver box is used to obtain the name for each output file, so again 
  80. the need to type in full path names is removed. A command may have any 
  81. number of output files. When the command is run a choice of multitasking or
  82. single tasking is  available, and textual output from the command can be
  83. stored in a window and  later saved to a file. For further information see
  84. the section Running  Commands later in this document.
  85.  
  86.  
  87.  
  88. Using !ComndCTRL
  89. ================
  90.  
  91.  
  92. To start
  93. --------
  94. To start,  double click on either the !ComndCTRL application or on any 
  95. command configuration (type 'ComndCFG') file after !ComndCTRL has been 
  96. seen by the filer.
  97.  
  98. An icon will then appear on the icon bar with the name of the command 
  99. underneath or "<Command>" in grey if you double clicked on the application, 
  100. this signifies a new blank command ready to be configured.
  101.  
  102. More commands can be installed by double clicking on any command 
  103. configuration files (note, not by dragging to one of the icons), only one
  104. copy  of the program is held in memory.
  105.  
  106. Before explaining how to use command control with existing commands, it 
  107. will be useful to discuss the setting up of a new command to become familiar 
  108. with the terms used, and to see how the executable command string is formed 
  109. from its flag and file parameters.
  110.  
  111.  
  112. Setting up a command
  113. --------------------
  114. To enable a new command to be used or to alter an existing one, select the 
  115. configure option from the commands menu. This can be found by clicking the 
  116. menu button of the mouse over the commands icon on the icon bar.
  117.  
  118. Command name:             The name of command, which should be the name of a
  119.                           module *command or  the leaf name of a program may
  120.                           be entered in the name field. Only 10  characters
  121.                           are allowed so in the case of long module commands
  122.                           abbreviate the  name with a dot after the ninth
  123.                           letter.
  124.  
  125. OK:                       The OK button must be pressed after any alterations
  126.                           to setup dialog box, to  allow the program to
  127.                           update its internal state, and for the command to
  128.                           be used.  The window close icon has the same
  129.                           effect, i.e. any changes will be applied.
  130.  
  131. Path:                     If your command is a program rather than a module
  132.                           command, and it is not  accessible via your
  133.                           Run$Path you may wish to give it a filing system
  134.                           path.  This is done by clicking on the box to the
  135.                           left of the word path so that a tick  appears, the
  136.                           path name (excluding the final dot) can then be
  137.                           entered into the  box to the right. The path can be
  138.                           removed by clicking on the path box again. Path
  139.                           variables can be used as well as absolute paths,
  140.                           e.g. <Prog$Path>
  141.                           File system abbreviations can be also used,
  142.                           e.g. '%' for the current library.
  143.  
  144. Memory min & max:         The values entered in the memory maximum and memory
  145.                           minimum box  determine the amount of application
  146.                           memory given to a command. They are  used in a
  147.                           *WimpSlot before the command is run, see the RISC
  148.                           OS User  Guide for further details. 
  149.  
  150.                           Experimentation may be necessary to find the
  151.                           correct values for different  programs. Most
  152.                           commands provided by modules do not require
  153.                           application  memory and zero can be entered in
  154.                           these fields.  
  155.  
  156. Task and Window options:  Clicking on the popup menu icon will lead to a
  157.                           dialog box allowing the type of task used to run
  158.                           the command, and the type of window in which output
  159.                           is placed to be set up. The dialog is explained
  160.                           fully below.
  161.  
  162. Flag, In, Out:            Commands may have up to ten parameters of three
  163.                           different types; flags, input  files and output
  164.                           files, which determines what is placed after the
  165.                           command  name when it is run.
  166.  
  167.                           The order and types of parameters are dependant on
  168.                           the syntax of the  command. Documentation on the
  169.                           command should be studied to allow the  syntax of
  170.                           the command matched with the facilities offered by
  171.                           !ComndCTRL.
  172.  
  173.                           To select the type of parameter, click in the
  174.                           relevant radio icon. It may appear  as a round or
  175.                           diamond shaped icon, depending on your machines
  176.                           setup.
  177.  
  178.  
  179. Name:                     The name box contains the name of the parameter
  180.                           which will appear on the  commands icon bar menu,
  181.                           you may alter it from the default names given on 
  182.                           creation. In the case of input files the name will
  183.                           have a number after it, this  determines the order
  184.                           in which files dragged onto the commands icon will
  185.                           be  placed in the parameters. The number will
  186.                           change if you alter the parameter  type of a lower
  187.                           numbered input file.
  188.  
  189. Setup:                    To the right of the name is an icon which will pop
  190.                           up another dialog box for  further configuration of
  191.                           the parameter, as described below.
  192.  
  193.  
  194. Task and Window Options
  195. -----------------------
  196. This dialog effects how the command will be run and what sort of window its 
  197. output will appear in.
  198.  
  199. Multi-tasking:            Running a command as multi-tasking will allow
  200.                           other desktop applications to  continue running at
  201.                           the same time as the command. It is similar to
  202.                           running the  command from the prompt within a
  203.                           standard RISC OS task window (which  can be
  204.                           brought up by pressing CTRL-F12).
  205.  
  206.                           Running multi-tasking is suitable for most
  207.                           commands which produce output,  but not ones which
  208.                           use graphics or commands that must be run outside
  209.                           the  desktop. It is not recommended for certain
  210.                           filer operations such as  *checkmap or *format.
  211.  
  212. Multi-tasking with input: This option also runs the command in a
  213.                           multi-tasking manor with the addition  that input
  214.                           may be given to a command which requires the user
  215.                           to type  something (e.g. *GOS). While the command
  216.                           is running clicking on the  window will cause a
  217.                           caret to appear and characters typed at the
  218.                           keyboard will  be given to the task.
  219.  
  220.                           The standard multitasking option should be used in
  221.                           preference for command  which don't need input, as
  222.                           the window handling is quicker and more suitable 
  223.                           for large amounts of output.
  224.  
  225. Single Tasking:           Running a command single tasking will cause all
  226.                           other applications on the  desktop to stop until
  227.                           the command is finished. It is of most use with 
  228.                           commands that execute quickly without producing
  229.                           any output (e.g. *LIB). If  any output is produced
  230.                           it will appear in a static (non movable) window.
  231.  
  232.                           Single tasking can also be used to run programs
  233.                           that take over the whole  screen and use graphics
  234.                           etc, as long as they return to the desktop cleanly 
  235.                           afterwards.
  236.  
  237. Confirm:                  If your command performs a destructive action or
  238.                           generally requires a  complex set of parameters,
  239.                           you may wish to be asked for confirmation before 
  240.                           running the command, if so click on the confirm
  241.                           box. When the command is  run a window will appear
  242.                           showing the full command and giving the 
  243.                           opportunity to run or cancel the command.
  244.  
  245. Run in minimised window:   Instead of the full sized output window thisClose
  246.                            window after running option for commands that
  247.                            take a long time to  execute but produce little
  248.                            output, this will enable the state of the command
  249.                            to be seen while not taking up much room on the
  250.                            desktop.
  251.  
  252. Close window after         If you do not wish the output window to remain
  253. running:                   on screen after the command  has finished
  254.                            running, this option can be used. It is useful
  255.                            for commands that print simple progress
  256.                            information which can be discarded after running.
  257.                            
  258. Only if empty:             Allows the window to close only if there has been
  259.                            no output from the command.                           
  260.  
  261.  
  262. Flags Parameter Dialog
  263. ----------------------
  264. A flag type of parameter is used to hold one or more flags or options which
  265. the  command requires. Flags are usually of the form two main forms but can
  266. be  any textual strings.
  267.  
  268. The first form of flags is a set of options form which one or more can be 
  269. chosen, a commands syntax may specify flags as   -file -notabs -f -c   etc.
  270. The flags parameter should contain a list of the possible flags, more than 
  271. one flags parameter can be used to group similar flags, and enable just one 
  272. from a group to be chosen.
  273.  
  274. The other form is a prefix flag flowed by a value, and example of this
  275. syntax is   -bpp <value> where <value> is 1,2,4   etc. The flag prefix field
  276. should be  used to hold the flag, and the flags field used to give a range
  277. of possible  values. The user can chose other values using the menu as
  278. described later.
  279.  
  280. Enter flags:               In the bottom box any flags, option or value
  281.                            strings may be entered, each  separated by a
  282.                            space. These will appear as individual entries on
  283.                            the commands  parameter sub-menu. Any number of
  284.                            flags can be entered up to 224 characters  in
  285.                            total.
  286.  
  287. Flag prefix:               If the parameter is a -flag value form, the -flag
  288.                            (keyword) part should be  entered by clicking on
  289.                            the box to the left so that it is ticked, the
  290.                            keyword can  then be entered in the box to the
  291.                            right. If there should be a space between the 
  292.                            keyword and the value, it must added to the end.
  293.                            If no values are chosen when  the command is run
  294.                            the keyword part will not be used.
  295.  
  296. Exclusive selection:       When set this will only allow one flag to be
  297.                            selected from the list of flags.  When unset any
  298.                            number of flags can be selected. The -flag
  299.                            <value> form  usually requires this so as to
  300.                            prevent more than one value be used.
  301.  
  302. No spaces in command:      If set the program will not put spaces between
  303.                            any selected flags when the  command is run. This
  304.                            enables parameters such as   -fcv   instead of
  305.                            -f -c -v   (using '-' as the flag prefix). 
  306.  
  307.  
  308. Input & Output files
  309. --------------------
  310. An input file parameter is a file which the command will use when run, the 
  311. name is obtained by dragging a file onto the commands icon on the icon bar.
  312. An output file is the file used for output from the command, the name is 
  313. obtained from a standard RISC OS saver box when the command is run. For
  314. either an input file or an output file the file setup dialog box is used.
  315.  
  316. Prefix:                   If a prefix flag is required immediately before
  317.                           the filename, click on the prefix  box and enter
  318.                           the flag in the box to the right. If a space is
  319.                           needed before the  filename it must be entered as
  320.                           part of the prefix.
  321.  
  322.                           e.g. the commands syntax calls for either;
  323.                                   -f <filename>  or
  324.                                   -f<filename>
  325.  
  326.                           If your commands syntax asks for a comma separated
  327.                           list of input files, set the prefix flag to a comma
  328.                           (only, no spaces) on the second and subsequent input 
  329.                           files to achieve this.
  330.                           e.g.    -f<file1>,<file2>,...
  331.  
  332. Default name:             The default name is useful on output files, as it
  333.                           will appear as the leaf name in  the RISC OS saver
  334.                           box on running the command. On input files it will
  335.                           be  overwritten by the name of the file dragged
  336.                           onto the icon unless it is selected  on the menu
  337.                           (see later).
  338.  
  339. File types allowed:       The file type fields on an input file parameter
  340. (Input files)             will determine what file types  the command will
  341.                           recognise for this parameter when dragged onto its
  342.                           icon. Files of other types will be ignored.
  343.  
  344.                           All Types:  will allow all types of regular files,
  345.                                       i.e. not applications and  directories.
  346.  
  347.                           Dir or App: means that directories or application
  348.                                       directories my be used. This  can be
  349.                                       selected with or without all types.
  350.  
  351.                           The last option is for a user selectable file type
  352.                           which you enter in the box to  the right, either
  353.                           as a hex number (e.g. 'FFF' or '&FFF') or a
  354.                           textual name (e.g.  'Text' or 'DrawFile') if it is
  355.                           recognised by the machine. Only files of this type 
  356.                           will be recognised when dragged onto the icon.
  357.  
  358. File types allowed:       For output files these fields determine the type
  359. (Output files)            of the file produced by the  command, the file
  360.                           type will be set after the command has finished
  361.                           running  even if the command does not do this for
  362.                           itself. 
  363.  
  364.                           As input:  causes the type of the output file to
  365.                                      be taken from the first input file 
  366.                                      given to the command, useful for
  367.                                      commands which can perform a processing 
  368.                                      operation on several types of file.
  369.  
  370.                           Directory: this option should only be used for
  371.                                      commands which produce a  directory as
  372.                                      output e.g. *CDIR.
  373.  
  374.                                      Note some versions of RISC OS may not 
  375.                                      display a directory icon in the saver
  376.                                      box when using this option.
  377.  
  378.  
  379. OK:                       To finish the file setup click in the OK box. If
  380.                           you have entered a bad Hex  value or unrecognised
  381.                           name in the user file type box, an error dialog
  382.                           will be  displayed and the file setup will remain
  383.                           on screen.
  384.  
  385.  
  386. Input/Output redirection
  387. ------------------------
  388. Under the parameter fields of the command setup dialog box are the Input and 
  389. output redirection fields.
  390.  
  391. If input redirection is used any characters the command would normally ask 
  392. for from the keyboard are taken from a file. Setting up the input
  393. redirection  file is identical to that for an input file parameter described
  394. above. If output redirection is used anything normally printed on the screen
  395. by the  command is sent to a file. Setting up the output redirection file is
  396. identical to  that for an output file parameter described above.
  397.  
  398. If the output of a command which is running in a multitasking window can be 
  399. saved to a file without using output redirection by using the window menu. 
  400. Output redirection can be used when it desired to keep any control
  401. characters in the output which would be filtered out by the task window.
  402.  
  403.  
  404. The Command Main Menu
  405. ---------------------
  406. Each command has its own icon installed on the icon bar, clicking the menu 
  407. mouse button over it will display the command menu. The entries are 
  408. described below.
  409.  
  410. Information:              Displays program information and version number.
  411.  
  412. New:                      Creates a new command, installing a new icon on
  413.                           the icon bar with the name  "<untitled>" below it.
  414.                           The new command is ready to be set up as 
  415.                           described in the previous section.
  416.  
  417. Run:                      This entry runs the command with the current flags
  418.                           and input files, see the  section on Running
  419.                           Commands below.
  420.  
  421. Configure:                Brings up the configure command dialog box, see
  422.                           the Setting up a Command  section.
  423.  
  424. Save:                     The save option brings up a standard RISC OS saver
  425.                           box to save all the  command's configuration
  426.                           information.
  427.  
  428.                           Commonly used flags and filenames may be selected
  429.                           and this information will  also be saved.
  430.  
  431.                           The file is of type ComndCFG (&BAE), and can be
  432.                           reloaded by double clicking  on it in a filer
  433.                           window, but not by dragging onto another
  434.                           !ComndCTRL icon.
  435.  
  436. Parameters:               If the command has any parameters the names of
  437.                           each will appear in the  section of the menu
  438.                           between the dotted lines.
  439.  
  440.                           A sub menu is provide for each  parameter
  441.                           described below. 
  442.  
  443. Remove / Remove All:      The last entries on the menu are used to remove
  444.                           the commands from the icon  bar, if it is the last
  445.                           command the command control application itself
  446.                           will exit.
  447.  
  448.                           Any windows and memory allocated to multitasking
  449.                           commands will also be  freed by the removal. Use
  450.                           the Remove All option to quickly exit the program 
  451.                           when many commands are loaded.
  452.  
  453.  
  454. Parameter menus
  455. ---------------
  456. The sub menus for each for the different types of parameter are described 
  457. below.
  458.  
  459. Flags sub-menu            If the parameter is a flag type the sub menu will
  460.                           contain entries corresponding  to all the flags
  461.                           entered in the flag setup dialog box. In addition,
  462.                           at the bottom of the sub menu is a writable entry
  463.                           which you  can use to quickly enter a flag which
  464.                           is not displayed above, or a numeric  value to be
  465.                           used in addition to a flag. 
  466.  
  467.                           Using select mouse button (or adjust to keep the
  468.                           sub menu on the screen) the  flags can be selected
  469.                           or de-selected. Only selected flags, shown by a
  470.                           tick, are  included in the command when run, The
  471.                           writable flag must also be selected to  be included.
  472.  
  473.                           If a flag prefix is used for this flag parameter
  474.                           it is not shown the sub menu but will be included
  475.                           in the command if one (or ore) of the value flags
  476.                           is selected.
  477.  
  478.                           If exclusive selection has been set on the setup
  479.                           dialog only one flag may be  selected at a time.
  480.                           If no spaces is used then no spaces will be put
  481.                           between each  selected flag.
  482.  
  483.                           It is also perfectly valid to have no selected
  484.                           flags, in which case nothing from this parameter
  485.                           will be given to the command.
  486.  
  487. Input/Output files        For a input/output file or input/output redirection
  488. sub-menu:                 type the sub-menu will have  just one entry
  489.                           containing a filename. This will either be the
  490.                           default name or  the name of a file dragged onto
  491.                           the icon. The entry is writable allowing the  user
  492.                           to enter or modify the filename (e.g. to add
  493.                           wildcard characters).
  494.  
  495.                           If select or adjust is pressed in the sub-menu the
  496.                           filename will become ticked  meaning that it is
  497.                           fixed. If it is an input file the name will not be
  498.                           modified by  dragging files to the icon, for an
  499.                           output file a saver box will not be displayed 
  500.                           when the command is run. This is useful if you
  501.                           want to run the command  many times with the same
  502.                           input or output files. Pressing select or adjust
  503.                           again  cancels this action.
  504.  
  505.  
  506. Running a command
  507. -----------------
  508. To run a command with the current input files (or if the command does not 
  509. have any) click on the commands icon with the select mouse button or choose 
  510. run from its menu. Clicking on the icon with the adjust button will run the 
  511. command with the same input files but will ask for the names of output
  512. files,  as below.
  513.  
  514. Input files &            If the command has input files or input redirection
  515. Input redirection:       you can drag files onto its  icon. If the file is
  516.                          of a type agreeable with those chosen during , its
  517.                          name will  be used as a parameter.
  518.  
  519.                          The file is offered to the next input file
  520.                          parameter in the order used when  setting up,
  521.                          starting at the first. If the next input file has
  522.                          been selected (ticked on  menu) it will be passed
  523.                          over and the file is given to the next input file
  524.                          after  that.
  525.  
  526.                          If all the input files have been filled or
  527.                          selected, the file is offered to the input
  528.                          redirection if that is set.
  529.  
  530.                          After all files have been given the command is run. 
  531.  
  532.                          Files can be dragged singly or as a selection. If
  533.                          more files than needed are  dragged onto the the
  534.                          extra files will fill up the parameters again for
  535.                          more runs  if there enough. When this occurs a
  536.                          number of instances of the command will  be run one
  537.                          after the other.
  538.  
  539. Output files &           On running by either methods, if there is are any
  540. Output redirection:      unselected output files or output redirection, a
  541.                          saver box will be displayed for each, the. The
  542.                          title of the  saver box will be that of the
  543.                          parameter name, and the icon will reflect the type 
  544.                          of the output file that will be produced. The icon
  545.                          in the saver this can only be  dragged to a filer
  546.                          window, not an application as the file is not saved
  547.                          at this  point, only the name is obtained to be
  548.                          passed to the command.
  549.  
  550. Confirmation:            After this if confirmation has been set a window
  551.                          will appear showing the full command that will be
  552.                          run, the  command can be run or cancelled at this
  553.                          stage if the  parameters are not correct.
  554.  
  555. File selections:         If a selection of files were dragged to the icon
  556.                          and there is enough for more  than one run, the
  557.                          cycle of asking for any out files and confirmation
  558.                          will repeat. 
  559.  
  560.                          After this the command(s) will be run as described
  561.                          below.
  562.  
  563. Running single-tasking:  If single tasking is selected from the task and
  564.                          window options when setting the  command up, the
  565.                          command will run pausing the desktop briefly. If
  566.                          any output  is produced it will appear in a fixed
  567.                          window, you will be asked to press space  before
  568.                          the desktop can be used normally again.
  569.  
  570. Running multi-tasking:   Running a multitasking command will cause an task
  571.                          window  to appear similar to that provided by RISC
  572.                          OS when pressing  CTRL-F12. The command will run
  573.                          whilst other desktop tasks  continue as normal.
  574.  
  575.                          For a multi-tasking window the output will be shown 
  576.                          appending to the bottom of window unless it has
  577.                          been  scrolled up using the scroll bar.
  578.  
  579.                          If the Running Multitasking with Input option has
  580.                          been  chosen in the setup, you may give keyboard
  581.                          input to the  command by selecting the window and
  582.                          typing at the caret.
  583.  
  584.                          If several commands are to be run after dragging a
  585.                          selection they will run one  after the other,
  586.                          appending their output to the window. 
  587.  
  588.                          More instances of the command can be run while the
  589.                          task window is active, by  starting them in the
  590.                          same way as described above. A new task window will 
  591.                          appear each time as long as there is enough memory
  592.                          available.
  593.  
  594.                          When the command has been completed the title of
  595.                          the window will change to  reflect this. The window
  596.                          will remain on screen for the output to be examined 
  597.                          unless the close after running option was selected.
  598.  
  599. Task Window menu:        Pressing the menu button over the task window pops
  600.                          up a menu.
  601.  
  602.                          Save:     allows the contents of the window to be
  603.                                    saved to a file using a RISC OS  saver
  604.                                    box. It may be used at any time, even
  605.                                    while the command is running.
  606.  
  607.                          Kill:     kills the running command, the option is
  608.                                    greyed out if the command has  completed.
  609.  
  610.                          Suspend   can be used to pause and un-pause the 
  611.                          &Resume:  command while it is running.
  612.  
  613.                          Minimise: will cause the main task window to be
  614.                                    replaced with a small window giving brief
  615.                                    details of the command, it is described
  616.                                    further below.  Clicking on the close
  617.                                    icon of the window is a short cut for
  618.                                    minimise.
  619.  
  620. The minimise window:     If running minimised has been chosen or the task
  621.                          window is minimised at any time the minimise window
  622.                          is displayed.
  623.  
  624.                          The advantage of the minimised window is that
  625.                          commands run much quicker  when it is displayed and
  626.                          it takes up less room on the desktop than the full
  627.                          task  window. The title bar gives the name of the
  628.                          command and its status, the time it  was started
  629.                          and the number of lines of output produced are
  630.                          displayed in the  window.
  631.  
  632.                          The task window can be brought up at any time by
  633.                          clicking on the Full  Window button or clicking on
  634.                          close with the adjust mouse button. Kill Task and
  635.                          Suspend buttons work in the same way to the task
  636.                          window  menu items, the Suspend button changes to
  637.                          Resume while the command is paused.
  638.  
  639.  
  640.  
  641. Supplied Command CFG files
  642. ==========================
  643.  
  644.  
  645. Command configuration files for a large number of module *commands and 
  646. utility programs from the Acorn developers toolkit and C-tools have been 
  647. provided for the users reference. Parameters and memory requirements 
  648. contained in the supplied files may not be suitable for different versions
  649. of  modules and utility programs the user may have.
  650.  
  651.  
  652. !CommandC
  653. ---------
  654. A utility program !CommandC is included to help manage the supplied  command
  655. configuration (ComndCFG) files. It should be located in the same directory
  656. as !ComndCTRL, and is best used by placing it on the icon bar or backdrop
  657. using Pinboard.
  658.  
  659. Either drag !CommandC onto the backdrop, or put an AddTinyDir command in
  660. your desktop boot file (see RISC OS User Guide for details).
  661.  
  662. To use !CommandC click on its icon, two filer windows will appear, one for 
  663. commands built into RISC OS and one for other commands/programs (don’t 
  664. worry if you don't have all the programs). Any commands you wish to use can 
  665. be started by double clicking on the appropriate ComndCFG file.
  666.  
  667. You may save any new ComndCFG files in the filer windows using the save 
  668. option from the !ComndCTRL menu. To close the filer windows, click on the 
  669. !CommandC icon again.
  670.  
  671.  
  672. End of !ComndCTRL.!Help.
  673.