home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d5xx / d587 / gmc.lha / GMC / english.docs / GMC.Doc next >
Text File  |  1992-01-04  |  22KB  |  691 lines
  1.  
  2.      GMC V9.11                  Operating Manual                     Page 1
  3.  
  4.  
  5.  
  6.  
  7.                             ›4mGMC --- Console-Handler›0m 
  8.  
  9.  
  10.  
  11.      ›1mOverview 
  12.  
  13.                ›0mGMC was written to replace the already existing console
  14.           handler like  CON,  NewCON,  ConMan  etc.    Beside  of  the
  15.           wellknown features, GMC provides a number of new features to
  16.           make the life with the keyboard easier.  
  17.  
  18.                The primary mission of GMC lies  in  team-work  with  a
  19.           shell  or  the  CLI,  that  had  to work up to now with CON,
  20.           NewCON, or ConMan. Applications should  restrict  mainly  to
  21.           pure  text  output because GMC can affect the output so that
  22.           the result may look  not  very  well.    Problems  are  also
  23.           possible  if the shell isn't a real shell but only a program
  24.           that waits  for  inputs  and  starts  then  other  programs.
  25.           Instead  the  team-work  with  the standard shell or the ARP
  26.           shell (or with "Csh -a" (AUX mode)) is very good.  
  27.  
  28.           GMC-Handlers with a version 9.9 or greater run only under KS
  29.           2.0.4/V37.  The version for  KS  1.2/3  is  running  without
  30.           errors  for  more than six month but it is technical border.
  31.           However bugs should be reported to the author.  
  32.  
  33.           GMC provides the following features: 
  34.  
  35.              - Command line editing 
  36.  
  37.              - Function key assignment in four levels 
  38.  
  39.              - Command line history 
  40.  
  41.              - Online help for functions of the handler 
  42.  
  43.              - Iconify function and window/screen shifting 
  44.  
  45.              - File/Directory name completer 
  46.  
  47.              - Command search function 
  48.  
  49.              - Printout of the recent outputs to printer and window 
  50.  
  51.              - Script function for storage of all outputs 
  52.  
  53.              - Undo-Funktion for the command line 
  54.  
  55.              - Command line finish without execution 
  56.  
  57.              - Actual directory path in window title 
  58.  
  59.              - Beep function on prompt display 
  60.  
  61.              - Title flags for Kickstart 2.0 
  62.  
  63.              - Snip function like in CON 2.0 
  64.  
  65.              - Fast Scrolling 
  66.  
  67.  
  68.      GMC V9.11                                                     11/05/91
  69.  
  70.  
  71.      GMC V9.11                  Operating Manual                     Page 2
  72.  
  73.  
  74.              - Local and global configuration 
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      GMC V9.11                                                     11/05/91
  138.  
  139.  
  140.      GMC V9.11                  Operating Manual                     Page 3
  141.  
  142.  
  143.      ›1mCommand line editing 
  144.  
  145.                ›0mThe  command  line  editing  bases  on  the   following
  146.           functions: 
  147.  
  148.  
  149.        Delete functions 
  150.  
  151.           Delete character before cursor (1) 
  152.           Backspace 
  153.  
  154.           Delete character under cursor (2) 
  155.           Del 
  156.  
  157.           Delete from cursor position to start of block (3) 
  158.           Ctrl-Backspace 
  159.  
  160.           Delete from cursor position to end of block (4) 
  161.           Ctrl-Del 
  162.  
  163.           Delete from cursor position to start of word (5) 
  164.           Shift-Backspace 
  165.  
  166.           Delete from cursor position to end of word (6) 
  167.           Shift-Del 
  168.  
  169.           Delete from cursor position to start of line (7) 
  170.           Alt-Backspace 
  171.  
  172.           Delete form cursor position to end of line (8) 
  173.           Alt-Del 
  174.  
  175.           Delete the whole line (9) 
  176.           Alt-Backspace,Alt-Del 
  177.  
  178.  
  179.        Cursor movement 
  180.  
  181.           Character left/right (1/2) 
  182.           "Cursor left/right" 
  183.  
  184.           Block left/right (3/4) 
  185.           Ctrl-"Cursor left/right" 
  186.  
  187.           Word left/right (5/6) 
  188.           Shift-"Cursor left/right" 
  189.  
  190.           Start/End of line(7/8) 
  191.           Alt-"Cursor left/right" 
  192.  
  193.  
  194.        Insert/Overwrite mode 
  195.  
  196.                The  default  mode (insert) can be toggled only for the
  197.           current line or durable.  Toggle for  the  current  line  is
  198.           made by  Ctrl-A.    After  RETURN is pressed the old mode is
  199.           activated.  
  200.  
  201.                The mode  can  be  changed  durable  with  SetGMC  (see
  202.           SetGMC.Doc).  
  203.  
  204.  
  205.  
  206.      GMC V9.11                                                     11/05/91
  207.  
  208.  
  209.      GMC V9.11                  Operating Manual                     Page 4
  210.  
  211.  
  212.                In  block movement and block delete, words are not only
  213.           separated by spaces like words but also by ':' '/'  '.'  '('
  214.           ')' and '|'. With this feature quick editing of pathnames is
  215.           possible.   If  the cursor is placed on or behind one of the
  216.           separators only the separator will be erased.  
  217.  
  218.                The above listed line edit functions can be  assign  to
  219.           different  keys  with  SetGMC.  The  list  above is only the
  220.           default assignment.  The numbers in brackets  refer  to  the
  221.           belonging functions.  
  222.  
  223.  
  224.  
  225.      ›1mFunctionkey assignment 
  226.  
  227.                ›0mAll  function  keys  can  be  assigned  in  four levels
  228.           (alone, or with pressed Shift,  Ctrl,  or  Alt  key).    The
  229.           assignment is done again with SetGMC.  
  230.  
  231.                The function keys can also be switched on and off.  The
  232.           settings  are  not touched by switching the function keys on
  233.           or off.  
  234.  
  235.  
  236.  
  237.      ›1mCommand line history 
  238.  
  239.                ›0mAll commands are stored (maximum 2048 Bytes, each  line
  240.           needs  10  Bytes  extra)  and  can  be recalled in different
  241.           ways.  The last typed line is  stored  at  the  end  of  the
  242.           list.   If  the  list is too long, the lines at the start of
  243.           the list are shifted out.  Lines with the length 1 won't  be
  244.           saved in the command line history.  
  245.  
  246.             -  With  "cursor  up/down"  the  list  will  be  shown  in
  247.                direction start/end of the list.  
  248.  
  249.             -  With  Shift-"cursor  up"  the  list  will  be  searched
  250.                through  line-wise  on  basis  of the partial line as a
  251.                pattern given-in up to this point in time.  
  252.  
  253.             -  With Shift-"cursor down" a jump behind the end  of  the
  254.                list will be performed.  
  255.  
  256.  
  257.  
  258.      ›1mOnline help functions 
  259.  
  260.                ›0mThe  help  key  (alone or together with Shift, Ctrl, or
  261.           Alt) shows four different helps: 
  262.  
  263.             -  Help: 
  264.                Display of the functions of the cursor keys,  Backspace
  265.                and Del key, and the additional help functions.  
  266.  
  267.             -  Shift-Help 
  268.                Display  of  the  first  characters of the function key
  269.                settings.  
  270.  
  271.             -  Ctrl-Help 
  272.                Output of information how  to  set  function  keys  and
  273.  
  274.  
  275.      GMC V9.11                                                     11/05/91
  276.  
  277.  
  278.      GMC V9.11                  Operating Manual                     Page 5
  279.  
  280.  
  281.                insert/overstrike mode.  
  282.  
  283.             -  Alt-Help 
  284.                Display of  the command line history with numbers.  The
  285.                output can be stopped and  continued  by  pressing  any
  286.                key.  It can be breaked by pressing RETURN.  
  287.  
  288.  
  289.  
  290.      ›1mIconify function and window›0m/›1mscreen shifting 
  291.  
  292.                ›0mThe Iconify function can be assigned with SetGMC to any
  293.           function key.    For  that  purpose the function key must be
  294.           assigned to ICONIFY.  
  295.  
  296.                The Iconify function will be executed immediately.  The
  297.           produced small window can be shifted around and brought back
  298.           to its old size by a double click.  If the window is in  the
  299.           reduced size,  output  is  possible.    The  window  will be
  300.           inactive so no wrong input is possible.  The contents of the
  301.           window won't be affected.  
  302.  
  303.                The iconify function is  disabled  if  GMC  runs  under
  304.           dos.library > 34 (Kickstart 2.0).  
  305.  
  306.                There  are three new function to change the window size
  307.           and position in the KS 2.0 version: 
  308.  
  309.             -  ZIPWINDOW: 
  310.                Replace for ICONIFY, equivalent to  click  on  the  ZIP
  311.                gadget.  
  312.  
  313.             -  MINWINDOW: 
  314.                The  window  is  reduced  to  its  minimal size and the
  315.                position specified by SetGMC.  A (any) workbench window
  316.                is activated.  
  317.  
  318.             -  MAXWINDOW: 
  319.                The window's size and position get the values specified
  320.                by SetGMC.  
  321.  
  322.                See also SetGMC XY.  
  323.  
  324.                It is possible to make a window/screen the  front  most
  325.           with a  function  key.    Therefore  the  key must be set to
  326.           SHIFT_WIN/SHIFT_SCR.  A  (any)  workbench  window  will   be
  327.           activated if the window is shifted in the background.  
  328.  
  329.  
  330.  
  331.      ›1mFile›0m/›1mDirectory name completer 
  332.  
  333.                ›0mThe command line can be expanded by the new function of
  334.           the tab key.  
  335.  
  336.                When TAB is pressed, an interpretation of the currently
  337.           given-in command  line is performed.  First the line will be
  338.           split in parts that are separated by blanks.  The  part,  in
  339.           which or  after which the cursor is located, is saved.  This
  340.           copy will only be overwritten when the line  is  changed,  a
  341.           cursor key  or RETURN is pressed.  If the cursor stands on a
  342.  
  343.  
  344.      GMC V9.11                                                     11/05/91
  345.  
  346.  
  347.      GMC V9.11                  Operating Manual                     Page 6
  348.  
  349.  
  350.           blank and the character in front of the  cursor  is  also  a
  351.           blank,  an  empty  string  will  be  used  for the following
  352.           actions.  
  353.  
  354.                The stored part of the line is interpreted  as  a  path
  355.           and/or filename.  If the path contains no root directory the
  356.           current directory  of  the CLI or Shell process is used.  As
  357.           process  only  that  process  is  used   that   opened   the
  358.           input/output stream  the  first  time.   The part behind the
  359.           last '/' or the ':' is used as the pattern to  select  files
  360.           or directories.   This  part can also contain wildcards.  If
  361.           no wildcards are given an invisible "#?"  is appended.   The
  362.           directory refered by the path is searched through.  
  363.  
  364.                If  a file is found which has the same beginning as the
  365.           pattern the command line will be completed with  this  file.
  366.           By  pressing  the  TAB  key  once  more  the  search will be
  367.           continued.  If no other files are found the old command line
  368.           is displayed again.  
  369.  
  370.                The directory scanning and the display of  of  matching
  371.           is performed asynchronous.  
  372.  
  373.                A  '/' is appended to directory names and a ' ' to file
  374.           names.  
  375.  
  376.                The TAB can be configurated like the cursor keys.   The
  377.           syntax and semantics is described in SetGMC.Doc.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.                With  Ctrl-RETURN the currently entered line is used as
  384.           a pattern to search commands in a list.   If  a  command  is
  385.           found that starts the same way, it will be shown.  
  386.  
  387.  
  388.  
  389.      ›1mPrintout of the recent outputs to printer and window 
  390.  
  391.                ›0mThe  printout function is assigned to a function key in
  392.           the same way as the iconify function (with  PRT_SCR  instead
  393.           of ICONIFY).  
  394.  
  395.                With SetGMC it is possible to defined the page lenth of
  396.           the printer at the beginning of every printout.  
  397.  
  398.                The  buffer  size  is  4KByte  at  the  startup  of the
  399.           handler.  This can also be changed by SetGMC.  
  400.  
  401.                The buffer can also be displayed in the window.    With
  402.           Ctrl-"cursor   up"   the  start  of  the  buffer  is  shown.
  403.           Ctrl-"cursor down"  shows  the  next  page  in  the  buffer,
  404.           Alt-"cursor down" shows the next line.  
  405.  
  406.                At  the  bottom  of  the  window  the percentage of the
  407.           displayed buffer is shown.  
  408.  
  409.                If a character shall be output to the window or  a  key
  410.           is pressed, the buffer output scrolls up to its end.  
  411.  
  412.  
  413.      GMC V9.11                                                     11/05/91
  414.  
  415.  
  416.      GMC V9.11                  Operating Manual                     Page 7
  417.  
  418.  
  419.      ›1mScript function for storage of all outputs 
  420.  
  421.                ›0mGMC supports  a  script function.  With this ability it
  422.           is possible to record all  outputs  including  the  echo  of
  423.           inputs in a file.  
  424.  
  425.                The  function  is  activated by SetGMC. The script file
  426.           remains opened until the window is closed or  it  is  closed
  427.           explicitly by SetGMC or another script file is opened.  
  428.  
  429.                While  a  script  file  is opened, it isn't possible to
  430.           display older parts of the window output.  
  431.  
  432.  
  433.  
  434.      ›1mUndo function for the command line 
  435.  
  436.                ›0mBefore every change in the command line its  old  state
  437.           is saved.    It can be brought back by pressing the ESC key.
  438.           With the aid  of  this  buffer  the  command  line  is  also
  439.           restored after the window was resized.  
  440.  
  441.                The buffer allows to get back a command line that isn't
  442.           finished  yet  and  is modified by pressing the help key, by
  443.           executing a command line history or the window output recall
  444.           function or an unwished delete function.  
  445.  
  446.                By pressing the ESC key  the  contents  of  the  actual
  447.           command line and the buffer is exchanged.  The cursor is set
  448.           also to its old position.  
  449.  
  450.                If  the  ESC  key is pressed directly after the TAB key
  451.           the filename completion will be stopped  without  change  in
  452.           the command  line (equivalent to cursor keys etc.).  This is
  453.           useful for going in a deep directory.  
  454.  
  455.  
  456.  
  457.      ›1mCommand line finish without execution 
  458.  
  459.                ›0mTo avoid that a started  command  line  must  be  again
  460.           deleted  because  one had recognized another command must be
  461.           executed first, the RETURN key has now two functions.  
  462.  
  463.                Without Shift key there is no change.  With  the  Shift
  464.           key  the  command  line  is  only stored in the command line
  465.           history but not sent  to  the  Shell/CLI.    Now  the  other
  466.           command  can  be  typed and executed in the standard way and
  467.           then one can recall the old command by pressing  "cursor-up"
  468.           twice.  
  469.  
  470.  
  471.  
  472.      ›1mActual directory path in window title 
  473.  
  474.                ›0mBeside   the  normal  title  from  the  startup  window
  475.           description it  is  also  possible  to  display  the  actual
  476.           directory path  in  the  window title section.  This special
  477.           function like others and the following beep function must be
  478.           switched on explicitly by SetGMC.  
  479.  
  480.  
  481.  
  482.      GMC V9.11                                                     11/05/91
  483.  
  484.  
  485.      GMC V9.11                  Operating Manual                     Page 8
  486.  
  487.  
  488.      ›1mBeep function on prompt display 
  489.  
  490.                ›0mIf this function is activ, on the reception of  a  READ
  491.           packet  the time is appointed since the last READ packet was
  492.           replied.  If this interval is greater than a given  value  a
  493.           sound signal is sent.  It is possible to determine that this
  494.           should  happened only if the GMC window isn't the front most
  495.           on the front most screen.  There will  be  no  beep  in  RAW
  496.           mode.  
  497.  
  498.  
  499.  
  500.      ›1mTitle flags for Kickstart 2›0m.›1m0 
  501.  
  502.                ›0mUnder  KS  2.0  GMC supports the following title flags:
  503.           AUTO, CLOSE, NOCLOSE,  SMART,  SIMPLE,  INACTIVE,  BACKDROP,
  504.           NOBORDER,  NOSIZE,  NODRAG,  NODEPTH,  WAIT, SCREEN, WINDOW.
  505.           The number of flags has no specific limit.  
  506.  
  507.                The KS 2.0 version of has SIMPLE_REFRESH as the default
  508.           refresh type.  To get a window  like  under  KS  1.2/3,  the
  509.           title flag SMART must be added.  
  510.  
  511.  
  512.  
  513.      ›1mSnip function like in CON 2›0m.›1m0 
  514.  
  515.                ›0mGMC  provides  by  the  console.device  the  same  snip
  516.           function like the standard CON-Handler. Text can  be  marked
  517.           by  moving  the  mouse  while the left mouse key is pressed.
  518.           RAmiga-C stores the  marked  text  in  an  internal  buffer.
  519.           RAmiga-V  copied the stored text in any window that supports
  520.           this ship function.  The function can also be  performed  in
  521.           the reverse  way and only inside the GMC window.  If ConClip
  522.           is running RAmiga-C stores then text in the clipboard.device
  523.           and RAmiga-V takes it from there.  
  524.  
  525.                To make the mouse selection  possible  the  ability  to
  526.           activate a Workbench window had to be removed.  
  527.  
  528.  
  529.  
  530.      ›1mFast Scrolling 
  531.  
  532.                ›0mWhen the cursor reaches the last line of the window and
  533.           the  window  is  covered  partially  by  other  windows, the
  534.           contents of the window is scrolled up a given  number  lines
  535.           before the output is continued.  
  536.  
  537.  
  538.  
  539.      ›1mLocal and global configuration 
  540.  
  541.                ›0mAs   repeatedly   mentioned,   GMC   processes  can  be
  542.           configurated in  a  local  and  a  global   way.      Global
  543.           configuration  has  effects only to those GMC processes that
  544.           are started  after  the  configuration.    Therefore  global
  545.           configuration should be made in the startup-sequence.  Local
  546.           configuration  affects only the GMC process in its window it
  547.           is executed.  
  548.  
  549.  
  550.  
  551.      GMC V9.11                                                     11/05/91
  552.  
  553.  
  554.      GMC V9.11                  Operating Manual                     Page 9
  555.  
  556.  
  557.                A  detailed  description  of  the  program  SetGMC   is
  558.           available with the enclosed operating manual.  
  559.  
  560.  
  561.  
  562.      ›1mMiscellaneous 
  563.  
  564.                ›0mCtrl  keys, except Ctrl-A, Ctrl-C..F, Ctrl-M and Ctrl-\
  565.           have no function and aren't sent to the Shell/CLI.  
  566.  
  567.                In RAW mode all keystrokes (except Ctrl-C..F)  will  be
  568.           transmitted without  any  translation.    In  CON  mode  the
  569.           following "Report" messages  from  the  console.device  will
  570.           also be passed through: 
  571.  
  572.             -  Cursor Position 
  573.  
  574.             -  Window Bounds 
  575.  
  576.             -  Raw Events (except NEWSIZE-,CLOSE- und Raw Key Event) 
  577.  
  578.  
  579.                GMC don't work with the module terminal.mod of M2Amiga.
  580.           In  this case GMC causes an error during the startup and the
  581.           window will be closed again.  This happens  always  then  if
  582.           someone  tries  to  add  a close gadget and it isn't the way
  583.           that is taken under Kickstart 2.0.  
  584.  
  585.                On the output of a script file  one  should  take  care
  586.           that   it  could  contain  hidden  report  request  for  the
  587.           console.device.  If these reports are  sent  a  second  time
  588.           there  is  nobody  who is interested and so they are sent to
  589.           the Shell/CLI. Therefore it can happen that the next command
  590.           isn't understood.    Scrolling  down  the  window  cause  no
  591.           problems in  this  way.    But script files should be better
  592.           displayed by editors or text display programs.  
  593.  
  594.                When the right mouse button (menu  button)  is  pressed
  595.           and  released  the  GMC  window  will be inactivated and the
  596.           workbench window will be activated.  When  the  right  mouse
  597.           button  is  pressed  again  the workbench menu is displayed.
  598.           This is  useful  if  PopUpMenu  is  installed.    It  avoids
  599.           resizing of the GMC window and additional mouse movements.  
  600.  
  601.  
  602.  
  603.      ›1mInstallation 
  604.  
  605.                ›0mFirst  of  all GMC-Handler (and ExtFuncProc for KS1.2/3
  606.           versions) must be copied in the  L:  directory.    Then  the
  607.           mountlist  entry  descriped  below should be inserted in the
  608.           mountlist in the DEVS: directory.  SetGMC should  be  copied
  609.           in a command directory like C:.  
  610.  
  611.                GMC  is  installed by "Mount GMC:". This command should
  612.           be executed in the startup-sequence.  GMC will used  as  the
  613.           console-handler  if  it is given in the window specification
  614.           (NewShell GMC:xxx... or as  a  ToolType  WINDOW=GMC:xxx...).
  615.           If   the  window  specification  (xxx...)  is  not  or  only
  616.           partially given GMC will used default values.  Window  sizes
  617.           and/or  positions  that exceed the screen limits are reduced
  618.  
  619.  
  620.      GMC V9.11                                                     11/05/91
  621.  
  622.  
  623.      GMC V9.11                  Operating Manual                    Page 10
  624.  
  625.  
  626.           by Intuition.  
  627.  
  628.                Another possibility is to remove CON:  by  the  command
  629.           "Assign  CON:  remove"  and the installation of GMC: as CON:
  630.           with "Mount CON:". In the mountlist must stand CON:  instead
  631.           of  GMC:.  The  installation as CON: won't work with M2Amiga
  632.           programs which used the module terminal.mod.  
  633.  
  634.  
  635.        MountList entry 
  636.  
  637.           GMC: 
  638.                  Handler = L:GMC-Handler 
  639.                  Stacksize = 2500 
  640.                  Priority = 5 
  641.                  GlobVec = -1 
  642.           # 
  643.  
  644.  
  645.  
  646.      ›1mAcknowledgement 
  647.  
  648.                ›0mSpecial thanks to Volker Rudolph, Joachim  Strubel  and
  649.           Jörg  Mayer for tests and suggestions and to all people that
  650.           use and support GMC (if there is  someone  outside  Germany)
  651.           and paid the shareware fee.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.  
  687.  
  688.  
  689.      GMC V9.11                                                     11/05/91
  690.  
  691.