home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / keyboard / commando.arc / COMMANDO.DOC next >
Encoding:
Text File  |  1988-11-15  |  8.2 KB  |  210 lines
  1.  
  2.  
  3.                             Commando version 1.0
  4.                             ====================
  5.  
  6.                   Copyright (c) Brent McPherson 1988, 1989
  7.  
  8.  
  9. Commando is a Shareware TSR utility that extends the DOS command line editing
  10. environment. It is designed to be relatively small, powerful,
  11. and user configurable. Commando was programmed in WATCOM C (small model).
  12.  
  13. These are the main features of Commando:
  14.  
  15.         1.  Ability to recall and edit previous commands.
  16.         2.  Separate buffers for DOS and other applications such as DEBUG.
  17.         3.  Filename completion and wildcard expansion on the command line.
  18.         4.  List matching filenames.
  19.         5.  Search facility for recalling previous commands.
  20.         6.  Multiple commands per command line using a separator.
  21.         7.  Function key binding.
  22.         8.  Aliases with optional parameter substitution and multiple commands
  23.             per alias.
  24.         10. Ability to define new aliases after startup.
  25.         11. Fully configurable along with many other features.
  26.  
  27. Usage:
  28. ======
  29.  
  30. Commando [options] [alias_file]
  31.  
  32. type "Commando ?" to see the options and default settings.
  33.  
  34. ex.  "Commando /s /m /t=3 /b=2k alias.def"
  35.         Produces the following configuration:
  36.          - operate silently
  37.          - copy recalled commands to end of buffer
  38.          - dont save commands of length 3 characters or less
  39.          - use a 2K DOS buffer
  40.          - read alias definitions from file alias.def
  41.  
  42.  
  43. Options:
  44. ========
  45.  
  46. START IN INSERT /i
  47.         Commando will always start in insert mode. The default is
  48.         overwrite mode.
  49.  
  50. SILENT /s
  51.         Turn off warning bell.
  52.  
  53. COMMAND WRAP /w
  54.         This causes the command recall buffer to act like
  55.         a circular list. The default is a linear list.
  56.  
  57. COPY LAST COMMAND /m
  58.         Any command that is recalled and executed will become the
  59.         last command in the recall buffer (if it is not already there).
  60.         The default is not to place re-executed commands at the end of
  61.         the buffer.
  62.  
  63. THROWAWAY /t=<number>
  64.         Commando will not save commands <= throwaway length.
  65.         Can prevent small commands such as "dir" from cluttering
  66.         the command recall buffer.
  67.  
  68. BUFFER SIZE /b=<number>[k]  (default 1024 bytes)
  69.         Used to configure the size of the command recall buffer.
  70.  
  71. ALT BUFFER SIZE /a=<number>[k]  (default 256 bytes)
  72.         Used to configure the size of the application recall buffer.
  73.  
  74. EXTRA MEMORY /e=<number>[k]  (default 128 bytes)
  75.         Specifies the amount of memory Commando reserves for adding
  76.         new aliases with the "_alias" directive.
  77.  
  78. COMMAND SEPARATOR /c=<character>   (default '!')
  79.         Specifies the character to separate multiple commands on the editing
  80.         line. The default is '!'. Note that the separator character can be
  81.         generated by typing two in a row. (ex. "!!" generates a single '!')
  82.  
  83. REINSTALL /r
  84.         Causes Commando to be installed, even if a version is already resident.
  85.  
  86.  
  87.  
  88. Editing commands:
  89. =================
  90.  
  91. CURSOR_LEFT             - move left
  92. CURSOR_RIGHT            - move right
  93. CTRL CURSOR_LEFT        - move left 1 word
  94. CTRL CURSOR_RIGHT       - move right 1 word
  95. HOME                    - move to start of line
  96. END                     - move to end of line
  97. INS                     - toggles between insert and overwrite mode
  98. DEL                     - delete character
  99. BACKSPACE               - delete character to left of cursor
  100. ESC                     - delete line
  101. CTRL END                - delete to end of line
  102. F3 or CTRL L            - delete word left
  103. F4 or CTRL R            - delete word right
  104. TAB                     - expand filenames. Very useful!
  105.                           Commando will attempt to complete the path and filename
  106.                           of the word immediately before the cursor.
  107.                           If there are wildcards ('*' or '?') in the
  108.                           word before the cursor then all matching filenames
  109.                           will be placed on the command line.
  110. SHIFT TAB or CTRL D     - List matching filenames. If you are typing a command
  111.                           and have typed a partial pathname executing this
  112.                           function will list all matching files and display a
  113.                           new command prompt after the list.
  114. !                       - command separator. Very useful!
  115.                           Can be used to type multiple commands on a command
  116.                           line. (ex. "cc main.c ! dir *.err")
  117.                           Note: This may be changed (see /c option)
  118. _alias                  - used to define aliases after Commando is installed.
  119.                           see section below on adding aliases.
  120.  
  121. (Note: Use alt-keypad sequences to generate extended characters)
  122.  
  123.  
  124. Recall buffer commands:
  125. =======================
  126.  
  127. CURSOR_UP               - retrieve previous command
  128. CURSOR_DOWN             - retrieve next command
  129. PAGE_UP                 - retrieve first command
  130. PAGE_DOWN               - retrieve last command
  131. F1 or CTRL F            - search for last matching command. Very Useful!
  132.                           Searches for the last command that starts with the
  133.                           character sequence before the cursor. Can be
  134.                           used to scroll through matching commands.
  135.                           (ex. "abc<F1>" will recall the last command
  136.                            beginning with "abc")
  137. F2 or CTRL A            - abort command. This saves the command into the
  138.                           recall buffer without executing it.
  139.                           (Useful for situations when you've typed a long
  140.                            command but have to issue another command first.
  141.                            You simply abort the command and recall it later.)
  142.  
  143.  
  144.  
  145. Alias definition file:
  146. ======================
  147.  
  148. An alias file is a file of definitions used by Commando to bind function keys
  149. or cause text substitutions to occur.
  150.  
  151.  
  152. sample alias file:
  153. ------------------
  154.  
  155. ----------- cut here ------------
  156.  t       type
  157.  lc      dir
  158.  <f5>    some text to insert
  159.  <f6>    !dir
  160.  o       cd ..\%1
  161.  u       cd ..
  162.  files   dir *.c ! dir *.h
  163.  ld      cd %1 ! dir %2
  164.  hi      echo hello!!
  165.  cc      wcc %1.c /w3 /ox %2 %3
  166. ------------ cut here -----------
  167.  
  168. The alias file contains definitions of the following form:
  169.  
  170. 1. word  string         - when "word" appears as the first word on the
  171.                           line, it will be substituted with "string"
  172.                           before being passed to dos.
  173.  
  174. 2. word  string containing one or more occurrences of %n (n=0..9)
  175.                         - this is the similar to dos parameter substitution.
  176.                           Each occurrence of "%n" in "string"
  177.                           is replaced with its corresponding word
  178.                           on the input line.
  179.                           (ex. using the example file above, "o test" would
  180.                            cause the command cd ..\test to be passed to dos)
  181.                           Note: use "%%" to generate a '%' character
  182.  
  183. 3. <key> string         - when <key> is hit, Commando behaves as if "string"
  184.                           were typed. <key> may be any of the following:
  185.                           function keys         <F1>  to  <F10>
  186.                           alt function keys     <AF1> to  <AF10>
  187.                           ctrl function keys    <CF1> to  <CF10>
  188.                           shift function keys   <SF1> to  <SF10>
  189.  
  190. 3. <key> !string        - as previous, but a <RETURN> is generated
  191.                           following "string"
  192.  
  193.  
  194. Adding aliases
  195. ==============
  196.  
  197. Commando also supports definition of new aliases after installation.
  198. This is accomplished using the "_alias" directive. The amount of
  199. aliases that may be defined this way is limited to the amount of extra
  200. memory reserved at startup. (see /e option)
  201. The alias format is exactly the same as the file format described above.
  202.  
  203. Examples: (as typed at command prompt)
  204.  
  205.                 "_alias <F5> !cd \user\work\games"
  206.                 "_alias mov  copy %1 a:\backup\%1"
  207.  
  208.  
  209. Note: typing "_alias" will list all the current aliases
  210.