home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / SEE303.ZIP / SEE.TXT < prev    next >
Text File  |  1990-02-07  |  11KB  |  278 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. Type SEE -? to show a dialog box with all options.
  37.  
  38. Invocation: SEE <filename> [<linenumber>] [<options>]
  39. -4    medium font (36 lines/screen on VGA)
  40. -6    small font (60 lines/screen on VGA)
  41. -a    assembly mode: tabs 8 and special insert
  42. -b    not a bold cursor line
  43. -cxxx color attribute (0 is different colors on color screen)
  44. -f    start in full screen mode (maximized window)
  45. -l    start in lower half of PM screen
  46. -h    start in upper half of PM screen
  47. -u    enable error beeps (must also be enabled in Control Panel)
  48. -i    overwrite mode at startup
  49. -y    find/replace case insensitive
  50. -z    line buffer marking by characters
  51. -0    translates all nulls to hex 80 chars and back
  52. -tnn  sets tab to nn
  53. -wnn  sets right column value to nn and enables auto wrap
  54.  
  55. Colors.
  56. -------
  57.  
  58. The default colors will be according to the Window Text, Window Static TEXT 
  59. and Window Background as set in the Control Panel.
  60.  
  61. When the option -cxxx has been set the colors of the text are set to this 
  62. value. When -c0xFF is set, there is more color variation.
  63.  
  64. The command line options -mxx, -nxx, -oxx, -pxx, -qxx and -rxx
  65. where xx is a hexadecimal number sets the color of the
  66.  
  67. -m normal text
  68. -o header text
  69. -p header reverse
  70. -q help colors 1
  71. -r help colors 2
  72. -s help colors 3
  73.  
  74. The colors are an ORed value of: 
  75.  01h  blue  foreground
  76.  02h  green foreground
  77.  04h  red   foreground
  78.  08h  highlighted foreground
  79.  10h  blue  background
  80.  20h  green background
  81.  40h  red   background
  82.  80h  blinking
  83.  
  84. Config file.
  85. ------------
  86.  
  87. See searches first the current directory and then the directory in which 
  88. SEE.EXE is for a file called SEE.CNF.
  89. This file can contain command line options (without / or -, each option on a 
  90. new line), e.g.
  91.  
  92. c0xff
  93. y
  94. a
  95. w80
  96. m2h
  97. n4h
  98.  
  99. sets more color variarion, case ignore for search, tabs 8 (assembly mode), 80 
  100. column word wrap, green normal text, red current line.
  101.  
  102. Mouse control.
  103. --------------
  104.  
  105. The left button of the mouse sets the cursor in the position where the arrow 
  106. pointer is. When the 'buffer mark mode' is on, clicking the left button 
  107. finishes the marking. E.g. when Ctrl-B is pressed and then the left button is 
  108. clicked, ih has the same effect as Ctrl-B again.
  109. When the left button is held down and the middle or right is pressed, the 
  110. current line will be deleted (same as Ctrl-Y). Pressing the middle or right 
  111. button only copies the line (or buffer marked by Ctrl-B or Ctrl-D) at the 
  112. point where the mouse arrow is. This is convenient for moving lines in a text 
  113. or source code.
  114.  
  115. Run program.
  116. ------------
  117.  
  118. With the F12 key you can start a new shell from SEE. When nothing is filled 
  119. in, SEE will call the CMD.EXE dos shell with no parameters.
  120. Otherwise, SEE will append .EXE to the first word and look in the current 
  121. path for a matching program file. If it finds it, it will call the program 
  122. file with the parameters specified, or otherwise it will call the dosshell 
  123. CMD.EXE with the original string. So you can also enter COPY *.* A: for 
  124. example. When you mark 'Background' see will remain the active window and 
  125. when the program is finished, the window of that program will clear. 
  126. Otherwise, the title bar will show 'Completed' when it ends and press Alt,C 
  127. or click the upper left '-' button. Then, the Task manager will appear which 
  128. I don't like but could not prevent yet.
  129.  
  130. Drive full/not ready.
  131. ---------------------
  132.  
  133. When A or B is selected and when they are not ready, SEE ignores it. 
  134.  
  135. Wildcards.
  136. ----------
  137.  
  138. On the command line or in the Edit file menu (^E) wildcards are also allowed. 
  139. The next file can be get by pressing the Escape key. Ctrl-E (edit file menu) 
  140. clears the wildcard.
  141.  
  142. Line number.
  143. ------------
  144.  
  145. A line number can be invoked directly by see <file> <linenumber>.
  146.   E.g.  SEE test.c 34 will start the editor in TEST.C at line 34.
  147.  
  148. Large files.
  149. ------------
  150.  
  151. SEE can normally handle files up to 48 KB (extendable to 60 KB in one buffer),
  152. but when larger files are loaded the first 48 K will be loaded first (except 
  153. in the case a line number is given which is not in the first 48 K).
  154. For the next 48 K press Ctrl-PgDn and for the next 48 K following the current 
  155. line press Ctrl-U (which updates all previous text). A temporary file named 
  156. @SEETEMP will be created and when the entire file is updated, this file will 
  157. be renamed to the original file name. One buffer back is, unfortunately not 
  158. possible (only with Ctrl-PgUp, reinitialize file at line 1). All functions 
  159. working on the entire file (e.g. Ctrl-O(verall replace) or (Ctrl-K T(ab 
  160. conversion)) will work only in the current text buffer. For find Again the + 
  161. and - (numeric keypad) functions will only work within the text buffer. 
  162. Ctrl-A searches the next text buffer(s) for a matching string. The 
  163. Ctrl-L(ine number) function works on the entire file, thus will load another 
  164. buffer if necessary.
  165.  
  166. Note for Multi tasking environments (OS/2, Windows/386, VM/386, etc.)
  167.    Be careful with editing two large files in the same directory in two
  168. different sessions!
  169.  
  170. Limitations
  171. -----------
  172. The limits are:
  173. Maximum 300 characters per line.
  174. Maximum 2560 lines or 48 KB per text buffer (the one which is reached first).
  175.  
  176. Return value.
  177. -------------
  178. SEE exits with ERRORLEVEL 0 unless exited by F3 or Ctrl-Break. Then it exits 
  179. with errorlevel 1. (Handy for a edit-compile batch file).
  180.  
  181. DOS screen.
  182. -----------
  183. Because SEE runs in the Presentation Manager session, in cannot read the 
  184. screen of a character mode session, so it must get the information of that 
  185. session from a file.
  186. SEE reads a file (normally called ERR) but can be changed by option
  187. -efilename. This file is viewed by the View entry on the menu bar or the F9 
  188. key. The first line will be in the title bar and the remaining 25 lines will 
  189. be shown in the dialog box. The program READ.EXE reads the screen of a 
  190. character mode session. You can also redirect the output of your compiler to 
  191. the ERR file.
  192. E.g.
  193.  
  194. echo "Compiler errors" > err
  195. cl -Zi -Od file.c >> err
  196.  
  197. When SEE is invoked now and F9 is pressed, the error messages will be shown 
  198. under the title "Compiler errors".
  199.  
  200.  
  201. Goes down, character sequences
  202. ------------------------------
  203. The F5 key toggles the mode in which the cursor goes down instead of right 
  204. after each character or Del or F4(not Backspace).
  205. The F4 key is an increment key for digits. It enters digits 0-9 ( each time
  206. the key is pressed the next digit or char will be entered).
  207.  
  208.  
  209. Special insert
  210. --------------
  211. When Shift-Ins is pressed the editor is in insert mode, except for blanks. 
  212. That means that all nonblank characters right of the cursor will be shift to
  213. the right, but the blanks right of the cursor will be overwritten until one
  214. blank remains.
  215.  
  216. Word wrap.
  217. ----------
  218. Although not designed as a text processor, a very simple text processing 
  219. feature is added. When Word-wrap mode is enabled (see <file> -wnn) or in SEE 
  220. by the 'Options' menu (Ctrl-T) nn is the right column number words will
  221. automatically wrap at that column. Ctrl K-W (Line wrap button) will wrap line
  222. by line (reformat) in that mode.
  223.  
  224. Set buffer
  225. ----------
  226. Normally in SEE the buffer (Copy or delete) is set by entire lines, but when 
  227. Ctrl-T  (or invoking see with the -z option) is enabled the buffer can be
  228. barked by each point in the text. When the buffer marker is set (by the 
  229. inverse screen bar/point, it can also be ended by the mouse button.
  230.  
  231.  
  232. Search
  233. ------
  234. Normally the Find/Replace functions are case sensitive but you can disable
  235. them by Ctrl-T + marking check box or invoking see with the -y option. For
  236. finding a control character press Ctrl-A after Ctrl-F(ind) or Ctrl-R(eplace)
  237. and fill in the value.
  238.  
  239. ASCII values, color values.
  240. ---------------------------
  241. These can be entered decimally or in hex in the form 0xnn or nnh.
  242.  
  243. Null characters and Ctrl-Z characters.
  244. --------------------------------------
  245. Normally a file is loaded in the buffer until the first Ctrl-Z (EOF) or null 
  246. character. When the -0 option is invoked, null characters and EOFs are loaded
  247. too and the nulls are translated into hex 80 characters temporarily and reset 
  248. to nulls wnen written to a file. Moreover no additional CR-LF will be added 
  249. in that mode. Handy for small config files.
  250.  
  251. Problems.
  252. ---------
  253. When the main window is minimized and the user wants to close SEE with the 
  254. system menu, the dialog box 'Ignore the changes' does not appear properly. 
  255. This is due to a bug in WinSetWindowPos() in OS/2 1.1.
  256.  
  257. Various functions.
  258. ------------------
  259. Try out the functions under Ctrl-K.  (Special menu in OS/2 version) Ctrl-K G
  260. and Ctrk-K [/{/( and Ctrl-K B are very useful for C programmers. Ctrl-K G
  261. inserts a "/* " at the cursor position and a " */" at the end of the current
  262. line. When there is already a "/* " and " */" (both with space) they will be
  263. removed. Handy for quick commenting out debug lines. Ctrl-K (brace open) will
  264. search a matcing close brace. Ctrl-K B (Bracket count button) will count the
  265. number of ( and )s in a single line (for checking complex expressions).
  266. Ctrl-K 7(Ascii button) will AND all characters above 80h ascii with 7Fh.
  267.  
  268.  
  269. SEE is developed by:
  270.  
  271.  Klaas van Ditzhuyzen
  272.  c/o DATAD data communications
  273.  PO Box 371
  274.  3900 AD Veenendaal
  275.  Holland
  276.  
  277. using MS-C 5.1
  278.