home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / SEEPM2.ZIP / SEE.TXT < prev    next >
Text File  |  1989-10-30  |  9KB  |  225 lines
  1. SEE editor.
  2. -----------
  3.  
  4. I wrote this editor three years ago as an answer to many MS-DOS editors which 
  5. need many keystrokes and confirmations to do a single thing (Are you sure to 
  6. quit ?) (Are you sure to overwrite this file ?). Now I converted it to OS/2
  7. and it also works under OS/2 as a Presentation Manager program. 
  8. Requirements:
  9. OS/2 1.1 and up and 70 K disk space. Even IBM and Microsoft didn't provide a
  10. PM editor yet. The MEP (provided with C 5.1) and E (provided by IBM) are just
  11. character mode editors.
  12.  
  13. Font problems.     
  14. --------------
  15.  
  16. I also supply SEEFONTS.DLL with this editor for a 7*12 pixel font, and a
  17. small 6*8 font. The first allows more than 80 columns on the screen and the
  18. second allows a 100 column screen on VGA and EGA and 55 line screen on VGA.
  19. For using this font you must copy SEEFONTS.DLL to the directory pointed to by
  20. the LIBPATH parameter in your CONFIG.SYS file. When this file is not found,
  21. the smallest Courier font will be loaded.
  22. You must install the Courier font first (if you haven't done it yet) with the 
  23. Control Panel, otherwise SEE won't work with Courier. For the other fonts you 
  24. don't need Courier.
  25. Unfortunately, there is a problem with this font (a bug in OS/2 1.1). I used 
  26. the smallest available Courier font (the others are proportional and not 
  27. suitable for a text editor and the larger Courier fonts are too large for 
  28. text editing less than 70 columns per line when SEE uses the entire screen).
  29. The lowest scan line is missing in this font, so an underscore looks like a 
  30. space and a lowercase g as a q. When you have OS/2 1.2 installed, this bug 
  31. may be fixed.
  32.  
  33. Command line options.
  34. ---------------------
  35.  
  36. Invocation: SEE <filename> [<linenumber>] [<options>]
  37. -6    small font (60 lines/screen)
  38. -a    assembly mode: tabs 8 and special insert
  39. -b    not a bold cursor line
  40. -cxxx color attribute (0 is different colors on color screen)
  41. -f    start in full screen mode (maximized window)
  42. -i    overwrite mode at startup
  43. -y    find/replace case insensitive
  44. -z    line buffer marking by characters
  45. -0    translates all nulls to hex 80 chars and back
  46. -tnn  sets tab to nn
  47. -wnn  sets right column value to nn and enables auto wrap
  48.  
  49. Colors.
  50. -------
  51.  
  52. The default colors will be according to the Window Text, Window Static TEXT 
  53. and Window Background as set in the Control Panel.
  54.  
  55. When the option -cxxx has been set the colors of the text are set to this 
  56. value. When -c0xFF is set, there is more color variation.
  57.  
  58. The command line options -mxx, -nxx, -oxx, -pxx, -qxx and -rxx
  59. where xx is a hexadecimal number sets the color of the
  60.  
  61. -m normal text
  62. -o header text
  63. -p header reverse
  64. -q help colors 1
  65. -r help colors 2
  66. -s help colors 3
  67.  
  68. The colors are an ORed value of: 
  69.  01h  blue  foreground
  70.  02h  green foreground
  71.  04h  red   foreground
  72.  08h  highlighted foreground
  73.  10h  blue  background
  74.  20h  green background
  75.  40h  red   background
  76.  80h  blinking
  77.  
  78. Config file.
  79. ------------
  80.  
  81. See searches first the current directory and then the directory in which 
  82. SEE.EXE is for a file called SEE.CNF.
  83. This file can contain command line options (without / or -, each option on a 
  84. new line), e.g.
  85.  
  86. c0xff
  87. y
  88. a
  89. w80
  90. m2h
  91. n4h
  92.  
  93. sets more color variarion, case ignore for search, tabs 8 (assembly mode), 80 
  94. column word wrap, green normal text, red current line.
  95.  
  96. Line number.
  97. ------------
  98.  
  99. A line number can be invoked directly by see <file> <linenumber>.
  100.   E.g.  SEE test.c 34 will start the editor in TEST.C at line 34.
  101.  
  102. Large files.
  103. ------------
  104.  
  105. SEE can normally handle files up to 48 KB (extendable to 60 KB in one buffer),
  106. but when larger files are loaded the first 48 K will be loaded first (except 
  107. in the case a line number is given which is not in the first 48 K).
  108. For the next 48 K press Ctrl-PgDn and for the next 48 K following the current 
  109. line press Ctrl-U (which updates all previous text). A temporary file named 
  110. @SEETEMP will be created and when the entire file is updated, this file will 
  111. be renamed to the original file name. One buffer back is, unfortunately not 
  112. possible (only with Ctrl-PgUp, reinitialize file at line 1). All functions 
  113. working on the entire file (e.g. Ctrl-O(verall replace) or (Ctrl-K T(ab 
  114. conversion)) will work only in the current text buffer. For find Again the + 
  115. and - (numeric keypad) functions will only work within the text buffer. 
  116. Ctrl-A searches the next text buffer(s) for a matching string. The 
  117. Ctrl-L(ine number) function works on the entire file, thus will load another 
  118. buffer if necessary.
  119.  
  120. Note for Multi tasking environments (OS/2, Windows/386, VM/386, etc.)
  121.    Be careful with editing two large files in the same directory in two
  122. different sessions!
  123.  
  124. Limitations
  125. -----------
  126. The limits are:
  127. Maximum 300 characters per line.
  128. Maximum 2560 lines or 48 KB per text buffer (the one which is reached first).
  129.  
  130. Return value.
  131. -------------
  132. SEE exits with ERRORLEVEL 0 unless exited by F3 or Ctrl-Break. Then it exits 
  133. with errorlevel 1. (Handy for a edit-compile batch file).
  134.  
  135. DOS screen.
  136. -----------
  137. Because SEE runs in the Presentation Manager session, in cannot read the 
  138. screen of a character mode session, so it must get the information of that 
  139. session from a file.
  140. SEE reads a file (normally called ERR) but can be changed by option
  141. -efilename. This file is viewed by the View entry on the menu bar or the F9 
  142. key. The first line will be in the title bar and the remaining 25 lines will 
  143. be shown in the dialog box. The program READ.EXE reads the screen of a 
  144. character mode session. You can also redirect the output of your compiler to 
  145. the ERR file.
  146. E.g.
  147.  
  148. echo "Compiler errors" > err
  149. cl -Zi -Od file.c >> err
  150.  
  151. When SEE is invoked now and F9 is pressed, the error messages will be shown 
  152. under the title "Compiler errors".
  153.  
  154.  
  155. Goes down, character sequences
  156. ------------------------------
  157. The F5 key toggles the mode in which the cursor goes down instead of right 
  158. after each character or Del or F4(not Backspace).
  159. The F4 key is an increment key for digits. It enters digits 0-9 ( each time
  160. the key is pressed the next digit or char will be entered).
  161.  
  162. Special insert
  163. --------------
  164. When Shift-Ins is pressed the editor is in insert mode, except for blanks. 
  165. That means that all nonblank characters right of the cursor will be shift to
  166. the right, but the blanks right of the cursor will be overwritten until one
  167. blank remains.
  168.  
  169. Word wrap.
  170. ----------
  171. Although not designed as a text processor, a very simple text processing 
  172. feature is added. When Word-wrap mode is enabled (see <file> -wnn) or in SEE 
  173. by the 'Options' menu (Ctrl-T) nn is the right column number words will
  174. automatically wrap at that column. Ctrl K-W (Line wrap button) will wrap line
  175. by line (reformat) in that mode.
  176.  
  177. Set buffer
  178. ----------
  179. Normally in SEE the buffer (Copy or delete) is set by entire lines, but when 
  180. Ctrl-T  (or invoking see with the -z option) is enabled the buffer can be
  181. barked by each point in the text. When the buffer marker is set (by the 
  182. inverse screen bar/point, it can also be ended by the mouse button.
  183.  
  184.  
  185. Search
  186. ------
  187. Normally the Find/Replace functions are case sensitive but you can disable
  188. them by Ctrl-T + marking check box or invoking see with the -y option. For
  189. finding a control character press Ctrl-A after Ctrl-F(ind) or Ctrl-R(eplace)
  190. and fill in the value.
  191.  
  192. ASCII values, color values.
  193. ---------------------------
  194. These can be entered decimally or in hex in the form 0xnn or nnh.
  195.  
  196. Null characters and Ctrl-Z characters.
  197. --------------------------------------
  198. Normally a file is loaded in the buffer until the first Ctrl-Z (EOF) or null 
  199. character. When the -0 option is invoked, null characters and EOFs are loaded
  200. too and the nulls are translated into hex 80 characters temporarily and reset 
  201. to nulls wnen written to a file. Moreover no additional CR-LF will be added 
  202. in that mode. Handy for small config files.
  203.  
  204. Various functions.
  205. ------------------
  206. Try out the functions under Ctrl-K.  (Special menu in OS/2 version) Ctrl-K G
  207. and Ctrk-K [/{/( and Ctrl-K B are very useful for C programmers. Ctrl-K G
  208. inserts a "/* " at the cursor position and a " */" at the end of the current
  209. line. When there is already a "/* " and " */" (both with space) they will be
  210. removed. Handy for quick commenting out debug lines. Ctrl-K (brace open) will
  211. search a matcing close brace. Ctrl-K B (Bracket count button) will count the
  212. number of ( and )s in a single line (for checking complex expressions).
  213. Ctrl-K 7(Ascii button) will AND all characters above 80h ascii with 7Fh.
  214.  
  215.  
  216. SEE is developed by:
  217.  
  218.  Klaas van Ditzhuyzen
  219.  c/o DATAD data communications
  220.  PO Box 371
  221.  3900 AD Veenendaal
  222.  Holland
  223.  
  224. using MS-C 5.1
  225.