home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / editors / sky100.arj / EDIT.HLP < prev    next >
Text File  |  1992-02-21  |  6KB  |  122 lines
  1. SKYWRITER Version 1.0 COPYRIGHT 1991 James J. Keene, Ph.D.
  2.  
  3.  ---- EDIT Text Files
  4.  
  5. Edit is a simple word-processing utility, called by "E" on the SOS Main Menu.
  6. Edit can be used to correct or write text files.
  7.  
  8. 13. Edit prompts the user to enter the text file path (if applicable), name
  9. and extension (see sections 4 to 6).
  10.     If the Device (disk drive) or the Device & Path are unspecified by
  11. pressing "Enter" only, then the DOS default (working directory) is used.
  12.     If "Enter" only is pressed for either name or extension, you exit Edit
  13. to the SOS Main Menu.  (Warning: if you are in the process of storing edited
  14. text under a new file specification in the End command described below, do
  15. not exit to SOS before you finish storing your work.)
  16.  
  17. 14. NEW file prompt:  If the described text file cannot be found, there are
  18. two possibilities:
  19.     (1) you wish to create a new file & type "Y" & "Enter"; or
  20.     (2) you were looking for an existing file and erred in your description,
  21. in which case type "Enter" only (same as "N" & "Enter") and Edit will
  22. restart at step 13.
  23.  
  24. 15. Edit Screen & Commands:  The Edit screen displays command options:
  25.  
  26. ...<^v>  Move the cursor in the 22 line text work area using the direction
  27. keys.  The "SPACE bar" (right), "Backspace" (left), "Tab" (tab right) and
  28. "Enter" (left margin of the next line) keys also move the cursor.
  29.  
  30. ...Advance  "A" scrolls the text displayed up or down.  With the "Tell Me
  31. HOW MANY LINES" prompt, type in a positive (scroll down) or negative number
  32. (scroll up) and "Enter".
  33.  
  34. ...Page Up  Page Dn  Display the previous or next text.
  35.  
  36.     NOTE: Although all of the Edit Commands are spelled out in full for easy
  37. reference on the screen, only the first letter in upper or lower case (e.g.,
  38. "A" or "a") invokes a command.
  39.     NOTE: For all Edit Commands that prompt for further information, the
  40. user may invoke them accidentally.  If so (except for End), simply press
  41. "Enter" only, and the cursor returns to the text work area without
  42. implementation of that command.
  43.  
  44. ...Change  "C" followed by one or more characters of "text" terminated by
  45. any non-printing character, such as the direction keys or "Enter" will
  46. insert the "text" characters for those previously on the screen.  "C" is
  47. a useful combination of deleting a number of characters and then inserting,
  48. at the same place, the same number of characters.
  49.  
  50. ...Delete or "D"  Cause one character of text to be deleted.
  51.  
  52. ...End  Terminates the editing session.  To avoid accidental exits, the
  53. "CtrlE" is required (press "E" while the "Ctrl" key is depressed).
  54.     First, you are asked if you want to save the text (Y/N).  Perhaps you
  55. used the program just to read or inspect the text.  If "Y", you are asked,
  56. if there was an existing text file, if you wish to store the edited text
  57. under the same file specification (Y/N).
  58.     If "Y", the text is stored and Edit returns to step 13 above.
  59.     If "N", the new file specifications are requested, before storing the
  60. text and returning to step 13.
  61.  
  62. ...Find  Prompts for one or more characters of "text" to find.  If the
  63. "text" is found, it is positioned at the top of the screen with the cursor
  64. on the first character of the "text".  If not found, Edit writes a NOT FOUND
  65. message on the screen and does not reposition the display.
  66.  
  67. ...Insert or "I" followed by "text" terminated by a non-printing character
  68. inserts the text starting at the initial cursor position.  When in this
  69. mode, the cursor will appear in the shape of a box.
  70.  
  71.     NOTE: Edit assumes "Inserting."  That is, if any printable character key
  72. is pressed (except those that invoke Edit commands), an Insert command is
  73. commenced.  This feature often saves an "I" keystroke.
  74.     If the cursor is beyond existing text, Insert is always assumed.
  75.  
  76. ...Kill  "K" deletes one or more lines of text starting with the cursor
  77. position.  If the cursor is at the left margin, the user is prompted to type
  78. the number of lines to Kill.  If the cursor is to the right of the left
  79. margin, "K" (will not prompt the user) deletes the rest of the text line and
  80. appends the next line to the current line.
  81.  
  82. ...Line  "L" inserts one or more blank lines starting with the cursor.  If
  83. the cursor is at the left margin, the user is prompted to specify the number
  84. of lines to insert.  At other cursor positions, "L" moves all text starting
  85. with the cursor down one line leaving the remainder of the current line
  86. blank.
  87.     NOTE: The "K" and "L" commands may be viewed as opposite operations.
  88.  
  89. ...Replace  "R" replaces one or more characters with one or more characters
  90. from the cursor position to the end of the file.  The user is prompted to
  91. type the text to be replaced and then the replacement.
  92.  
  93. ...Save  "S" selects one or more lines of text starting with the cursor for
  94. later placement elsewhere by the Unsave command "U".  Text saved in one file
  95. may be unsaved in a subsequent file.
  96.  
  97. ...Unsave  "U" inserts one or more lines which have been previously saved by
  98. "S" and "U" inserts saved text at the current cursor position.  The "U"
  99. command can be used repeatedly with the same saved text.
  100.  
  101. ...Width  "W" prompts the user to specify the right margin used to format
  102. lines if an insert causes a line to exceed the then effective line width.
  103.     Then, if the user desires, Edit will reformat the text to the right
  104. margin specified.  Edit starts with width equal to 78 characters.
  105.  
  106. ...Tab  Moves the cursor a user-specified number of spaces to the right.
  107. When the "Tab" key is first used, the user is asked for the tab width.
  108.  
  109.                    HOW EDIT INPUTS A FILE
  110.  
  111. Edit will input and display ASCII text files from SKYWRITER, many other
  112. kinds of text files from various word-processing programs and virtually
  113. anything else.  But NOTE the following:  Inputing the file, Edit deletes
  114. certain special character codes (namely, 7,8,9,11,12,28,29 and 30).  This
  115. will not affect the input file unless you save the file with Edit.  There
  116. is an advantage to this procedure: (1) you can input and look at almost
  117. anything (minus the above characters) and (2) certain "strange" codes in
  118. text files can be "cleaned out" by using Edit to input the file and then
  119. save it.
  120.  
  121. Copyright 1991 James J. Keene, Ph.D.
  122.