home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / zip / portfoli / dosedit.lzh / dosedit.doc < prev   
Text File  |  1991-08-21  |  5KB  |  131 lines
  1.  
  2.                DOSEDIT User's Guide
  3.  
  4.                Jack Gersbach
  5.               Burlington, Vt.
  6.  
  7.  
  8. Installation
  9.  
  10. Download and copy DOSEDIT.COM onto a diskette.
  11. Type dosedit at the dos prompt and it will install itself as a
  12. resident extension to dos. If you wish to set up an aliase list,
  13. type:
  14.     DOSEDIT filespec
  15.  
  16. The file contains a list of aliases and replacement phrases
  17. as described below.
  18.  
  19.  
  20. Operational Description
  21. Special DOS EDITING KEYS
  22.  
  23. The DOS editing keys are different than the standard dos keys and are
  24. more natural for the average user. The function keys on the left side
  25. of the keyboard are not used.
  26.  
  27. The information below summarizes the functions of the new editing keys.
  28.  
  29. Right arrow:    Advances the cursor one character position.
  30. Left arrow:    Backs up the cursor one character position.
  31. Ctrl-Right:    Advances the cursor to the next word.
  32. Ctrl-Left:    Backs up the cursor to the previous word.
  33. LeftShift-tab:    Backs up the cursor to the previous tab position.
  34. RightShift-tab: Advances the cursor to the next tab position.
  35. Home:        Moves the cursor to the beginning of the line.
  36. End:        Moves the cursor to the end of the line.
  37. Del:        Erases the character at the cursor position.
  38. Back Space:    Erases the character to left of the cursor.
  39. Esc:        Erases the entire line.
  40. Ctrl-Home:    Erases from the beginning of the line to the cursor.
  41. Ctrl-end:    Erases from the cursor to the end of the line.
  42. Up arrow:    Recalls the previous instruction from the stack.
  43. Down arrow:    Recalls the following instruction from the stack.
  44. Ctrl-PgUp:    Clears the current stack of all entries.
  45. Ctrl-PgDn:    Erases the currently displayed stack entry.
  46. Ins:        Toggles the insert mode. If active, cursor size changes.
  47. Ctrl-A:     Displays aliase list when under dos control.
  48. Ctrl-Z:     End of file marker (1AH). Replaces the F6 key.
  49. F1 thru F10:    Not used.
  50.  
  51. The insert mode is automatically turned off with Enter or Esc.
  52.  
  53. Two circular stacks of 256 bytes each stores all new or edited commands
  54. that are entered from the keyboard.
  55.  
  56. One stack serves the dos command mode and the other serves calls from
  57. external commands and application programs.
  58. These programs must use
  59. Dos function call 0AH to access dosedit and the command stack.
  60.  
  61. Dosedit traps the command.com buffer segment and dedicates one stack
  62. to it and the other for all other buffers.
  63. It is recommended that DOSEDIT be loaded lower (earlier) than any
  64. other resident dos extension that calls the dos editor
  65. (function call 0AH).
  66.  
  67. After executing a command, the stack pointer is set between the current
  68. command and the next one.
  69. The previous command can then be recalled by pressing the up arrow.
  70. If the current command is new, it is placed at the end of the stack
  71. and the stack pointer points between the last command and the first
  72. one entered.
  73. The 1st command will be lost if the stack has filled up and wrapped
  74. around to the beginning.
  75.  
  76. The currently displayed command line is executed when enter is pressed.
  77. The cursor may be at any position in the line when enter or the up/down
  78. arrow keys are pressed.
  79.  
  80. If the calling program passes a line of text in it's buffer, it can be
  81. displayed and edited by pressing the End key. DOS will reshow the
  82. buffer contents if there is a carriage return character at the end
  83. of the text as indicated by the 2nd byte of the buffer.
  84.  
  85. The interface description for function call 0AH applies in all respects.
  86.  
  87. Aliases
  88.  
  89. Aliases may be defined in a separate file that DOSEDIT will read when
  90. it is installed.
  91. Refer to "installing dosedit", above.
  92.  
  93. The form of the file is:
  94.  
  95. Alias1 replacement phrase
  96. Alias2 replacement phrase
  97.    .
  98.    .
  99.    .
  100. AliasN replacement phrase
  101. EOF
  102.  
  103.  
  104. Each line must end with a carriage return - line feed combination.
  105. The file must end with an EOF mark of 1AH.
  106.  
  107. If the aliase file is unacceptable to dosedit, an error message is
  108. displayed and dosedit will not be installed.
  109.  
  110. Aliases may be displayed by pressing the "A" key while holding down
  111. the Ctrl key.
  112.  
  113. This is the standard text file format produced by text editors such
  114. as Edlin, The Personal Editor, etc.
  115.  
  116. Aliases must be limited to 8 characters and may include any character
  117. that is legal in a file name.
  118.  
  119. The replacement phrase may be any length but could cause overflow of
  120. command's text buffer at the time of substitution. If this happens,
  121. a message is displayed and a nul string is returned by dosedit.
  122. Aliases are only active while in the dos command mode. The replacement
  123. string is never displayed but is returned to command.com in the command
  124. text buffer.
  125.  
  126. When an alias is used on a command line, it must be the first word of
  127. the line although a drive specifier may preceed it. For example,
  128. if fmt is an alias for format, C:fmt will cause dos to assume that
  129. format.com will be found on drive C.
  130.