home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / ed32eng1.zip / english / edit32.HLP (.txt) < prev    next >
OS/2 Help File  |  1994-09-21  |  18KB  |  517 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Extended Help ΓòÉΓòÉΓòÉ
  3.  
  4. Edit32 is a simple programmer's editor.  Its only advantage over the standard 
  5. OS/2 System Editor is that Edit32 displays line and column numbers -- something 
  6. that is essential when attempting to interpret compiler diagnostics. It also 
  7. shows a asterix in front of the line number if any changes on the text had been 
  8. occured after last opening or saving. 
  9.  
  10. All standard editing features are supported, including undo/redo, cut, copy, 
  11. paste (using the system clipboard), search/replace, and Go to line. 
  12.  
  13. Standard cursor control keys are available when editing.  CUA standards are 
  14. followed for most  functions. 
  15.  
  16. More help can be obtained on any of the main menu items (and their associated 
  17. pull-down menus) by double-clicking on one of the following: 
  18.  
  19. File 
  20. Edit 
  21. Help 
  22.  
  23. Brian R. Anderson 
  24. British Columbia Institute of Technology 
  25. 3700 Willingdon Avenue 
  26. Burnaby, B.C.  V5G 3H2 
  27. CANADA 
  28.  
  29. Thomas K. G╨ñtz 
  30. Bremerhaven 
  31. Germany 
  32.  
  33.  
  34. ΓòÉΓòÉΓòÉ 2. File Menu Explained ΓòÉΓòÉΓòÉ
  35.  
  36. The File menu allows access to disk files.  File size must not exceed 64K.  To 
  37. edit more than one file, start multiple copies of the editor by double-clicking 
  38. on the Edit32 entry in a Desktop Manager menu or from the command line: 
  39.  
  40. [C: \WORK] START Edit32 
  41.  
  42. With multiple copies of the editor running, you can use the clipboard to move 
  43. or copy text from one file to another (see Edit menu for more details). 
  44.  
  45. For more information, double-click on one of these topics: 
  46.  
  47. New 
  48. Open 
  49. Save 
  50. Save as 
  51. Exit 
  52.  
  53.  
  54. ΓòÉΓòÉΓòÉ 3. New Explained ΓòÉΓòÉΓòÉ
  55.  
  56. New clears the edit window so that you can create a new file. If the contents 
  57. of the edit window have changed since the last time you saved, you will be 
  58. given a chance to save before the window is cleared. 
  59.  
  60. Unless you want to discard the changes that you have made to your file, select 
  61. Yes when prompted; if you select No, the file will not be saved.  If you select 
  62. Cancel, you will be returned to the edit window without any action. 
  63.  
  64. To activate this command, select New from the menu, or use the keyboard 
  65. accelerator: Ctrl+N. 
  66.  
  67.  
  68. ΓòÉΓòÉΓòÉ 4. Open Explained ΓòÉΓòÉΓòÉ
  69.  
  70. Open allows you to access existing files on any disk or within any directory. 
  71. The dialog box that results from choosing Open contains two list boxes -- one 
  72. with disks/directories, the other with files. 
  73.  
  74. To change to another disk or directory, simply double-click on the disk or 
  75. directory of interest -- the files list box will immediately show the files in 
  76. that directory. 
  77.  
  78. To select a file, simply double-click on the required file and it will be 
  79. opened and read into the edit window. 
  80.  
  81. You may also open files using just the keyboard:  Of course, you may simply 
  82. type the name of the file that you want to open, followed by the Enter key. 
  83. Use the tab key to switch from one part of the dialog box to another.  Use the 
  84. up and down Arrow keys to scroll through the disk/directory and file list 
  85. boxes.  Use the Enter key to make your selection.  Use the Escape key to cancel 
  86. without making a selection. 
  87.  
  88. To activate this command, select Open from the menu, or use the keyboard 
  89. accelerator: Ctrl+O. 
  90.  
  91. If you select Open when you are already editing a file (and the file has 
  92. changed since the last time you saved), you will be given the opportunity to 
  93. save before the new file is opened. 
  94.  
  95.  
  96. ΓòÉΓòÉΓòÉ 5. Save Explained ΓòÉΓòÉΓòÉ
  97.  
  98. Save will save the contents of the edit window to the current file.  If the 
  99. edit window contains new text that has never been saved, you will be prompted 
  100. for a filename.  The current filename (if any) appears in the title bar. 
  101.  
  102. To activate this command, select Save from the menu, or use the keyboard 
  103. accelerator: Ctrl+S. 
  104.  
  105. After saving with this command, the asterix if any in front of the line number 
  106. will disappear. 
  107.  
  108.  
  109. ΓòÉΓòÉΓòÉ 6. Save as Explained ΓòÉΓòÉΓòÉ
  110.  
  111. Save as allows you to save the contents of the edit window under a different 
  112. filename (i.e., different from previous saves and/or different from the 
  113. original filename).  Unlike Save, (which saves using the existing name) Save as 
  114. always prompts for a new filename. 
  115.  
  116. Save as is useful for two distinct purposes: saving an altered file under a 
  117. different name (to preserve the original file); and splitting a file. 
  118.  
  119. Splitting a file is tricky, and should only be attempted after first saving a 
  120. backup copy of the entire file.  Here are the steps involved in splitting a 
  121. file: 
  122.  
  123. 1.  Cut one portion of the text to the clipboard. 
  124. 2.  Save the remaining text to a new file. 
  125. 3.  Delete the text that was just saved to the file. 
  126. 4.  Paste the text that was previously Cut to the clipboard. 
  127. 5.  Save the retreived text to a second new file. 
  128.  
  129. To activate this command, select Save as from the menu, or use the keyboard 
  130. accelerator: Ctrl+A. 
  131.  
  132. After saving with this command, the asterix if any in front of the line number 
  133. will disappear. 
  134.  
  135.  
  136. ΓòÉΓòÉΓòÉ 7. Exit Explained ΓòÉΓòÉΓòÉ
  137.  
  138. Exit terminates the editor session, and returns you to the operating system 
  139. (Work Place Shell or OS/2 command prompt, depending upon how you started the 
  140. program).  If you have changed the contents of the edit window since the last 
  141. time that you saved, you will be given the opportunities to save the contents 
  142. to a file, to quit without saving or to cancel Exit and return to the editor. 
  143.  
  144. To activate this command (i.e., quit the editor), you may select Exit from the 
  145. menu, select Close from the system menu, click on the End Task pushbutton from 
  146. the task list, or use the keyboard accelerator: F3. 
  147.  
  148.  
  149. ΓòÉΓòÉΓòÉ 8. Edit Menu Explained ΓòÉΓòÉΓòÉ
  150.  
  151. The Edit menu provides various text manupulation functions. For more 
  152. information, double-click on one of these topics: 
  153.  
  154. Undo 
  155. Cut 
  156. Copy 
  157. Paste 
  158. Delete 
  159. Find 
  160. Find next 
  161. Replace 
  162. Go to line 
  163.  
  164.  
  165. ΓòÉΓòÉΓòÉ 9. Undo Explained ΓòÉΓòÉΓòÉ
  166.  
  167. Undo provides a single-level undo/redo function to allow you to recover from 
  168. mistakes.  This menu selection will be greyed  (i.e., unavailable) if the 
  169. editor does not have an action that it can recover from.  For example, it is 
  170. not possible to undo a save. 
  171.  
  172. Undo is most useful when you accidently delete something that you meant to 
  173. keep.  It is important to realize that Edit32 can recover only the most recent 
  174. action -- if you delete something and don't realize it until after you have 
  175. started typing, it is too late! 
  176.  
  177. Undo can also recover from an accidental undo -- i.e., it can re-do.  Again, 
  178. the same caution applies -- if you don't realize that the undo was a mistake 
  179. (and do something else), you will not be able to re-do, because Edit32 can undo 
  180. only your latest action. 
  181.  
  182. To activate this command, select Undo from the menu, or use the keyboard 
  183. accelerator: Alt+Backspace. 
  184.  
  185.  
  186. ΓòÉΓòÉΓòÉ 10. Cut Explained ΓòÉΓòÉΓòÉ
  187.  
  188. Cut allows you to move text from one part of a document to another, or even 
  189. between two different documents. 
  190.  
  191. Cut (or Copy) places text on the clipboard, where it may be later retreived by 
  192. Paste.  Text remains on the clipboard even if you exit the program, and is 
  193. available to other processes (e.g., other running copies of Edit32). 
  194.  
  195. To cut a section of text, you must first highlight  the text. You can do this 
  196. either with the mouse or the keyboard.  With the mouse, you point to the 
  197. beginning of the area that you want to cut, depress and hold the left mouse 
  198. button, and then move the mouse to the end of the area that you want to cut. 
  199. With the keyboard, you move the text cursor (with the Arrow or Page Up/Page 
  200. Down keys) to the beginning of the area that you want to cut, depress (and 
  201. hold) the Shift key and then move (using the same keys as before) to the end of 
  202. the area that you want to cut. In either case (mouse or keyboard) the result is 
  203. that the selected text is marked by changing colors (usually by making the text 
  204. reverse video, but may be different if you have changed the default colors on 
  205. your computer). 
  206.  
  207. Once the text has been chosen (highlighted ) select Cut from the menu, or use 
  208. the keyboard accelerator: Shift+Del. 
  209.  
  210. If no text has been selected, the Cut menu item will be greyed  (i.e., 
  211. disabled). 
  212.  
  213. Cut and Copy are somewhat similar (in that both result in the selected text 
  214. being placed on the clipboard), but very different (in that Cut results in the 
  215. text being deleted, while Copy does not). 
  216.  
  217.  
  218. ΓòÉΓòÉΓòÉ 11. Copy Explained ΓòÉΓòÉΓòÉ
  219.  
  220. Copy allows you to duplicate text from one part of a document to another, or 
  221. even between two different documents. 
  222.  
  223. Copy (or Cut) places text on the clipboard, where it may be later retreived by 
  224. Paste.  Text remains on the clipboard even if you exit the program, and is 
  225. available to other processes (e.g., other running copies of Edit32). 
  226.  
  227. To copy a section of text, you must first highlight  the text. You can do this 
  228. either with the mouse or the keyboard.  With the mouse, you point to the 
  229. beginning of the area that you want to copy, depress and hold the left mouse 
  230. button, and then move the mouse to the end of the area that you want to copy. 
  231. With the keyboard, you move the text cursor (with the Arrow or Page Up/Page 
  232. Down keys) to the beginning of the area that you want to copy, depress (and 
  233. hold) the Shift key and then move (using the same keys as before) to the end of 
  234. the area that you want to copy.  In either case (mouse or keyboard) the result 
  235. is that the selected text is marked by changing colors (usually by making the 
  236. text reverse video, but may be different if you have changed the default colors 
  237. on your computer). 
  238.  
  239. Once the text has been chosen (highlighted ) select Copy from the menu, or use 
  240. the keyboard accelerator: Ctrl+Ins. 
  241.  
  242. If no text has been selected, the Copy menu item will be greyed  (i.e., 
  243. disabled). 
  244.  
  245. Copy and Cut are somewhat similar (in that both result in the selected text 
  246. being placed on the clipboard), but very different (in that Cut results in the 
  247. text being deleted, while Copy does not). 
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 12. Paste Explained ΓòÉΓòÉΓòÉ
  251.  
  252. Paste works in conjunction with Cut or Copy to either move or duplicate 
  253. sections of text.  After text has been highlighted  and then placed on the 
  254. clipboard, Paste retreives the text from the clipboard and inserts it into the 
  255. edit window at the current cursor position. 
  256.  
  257. To activate this command, select Paste from the menu, or use the keyboard 
  258. accelerator: Shift+Ins. 
  259.  
  260. Paste does not remove the text from the clipboard  -- i.e., the same text can 
  261. be retreived multiple times. 
  262.  
  263. If text is highlighted  at the time that Paste is selected, the clipboard data 
  264. replaces the highlighted text. Although this feature  can sometimes be useful, 
  265. it is usually a mistake -- fortunately, even this operation can be reversed by 
  266. the Undo command. 
  267.  
  268.  
  269. ΓòÉΓòÉΓòÉ 13. Delete Explained ΓòÉΓòÉΓòÉ
  270.  
  271. Delete allows you to remove text from a document.  The text does not go to the 
  272. clipboard, but can be retreived (if done immediately) by Undo 
  273.  
  274. To delete a section of text, you must first highlight  the text. You can do 
  275. this either with the mouse or the keyboard.  With the mouse, you point to the 
  276. beginning of the area that you want to delete, depress and hold the left mouse 
  277. button, and then move the mouse to the end of the area that you want to delete. 
  278. With the keyboard, you move the text cursor (with the Arrow or Page Up/Page 
  279. Down keys) to the beginning of the area that you want to delete, depress (and 
  280. hold) the Shift key and then move (using the same keys as before) to the end of 
  281. the area that you want to delete.  In either case (mouse or keyboard) the 
  282. result is that the selected text is marked by changing colors (usually by 
  283. making the text reverse video, but may be different if you have changed the 
  284. default colors on your computer). 
  285.  
  286. Once the text has been chosen (highlighted ) select Delete from the menu, or 
  287. use the keyboard accelerator: Del. 
  288.  
  289. If no text has been selected, the Delete menu item will be greyed  (i.e., 
  290. disabled), however the Del key will still operate: it deletes the current 
  291. character. 
  292.  
  293.  
  294. ΓòÉΓòÉΓòÉ 14. Find Explained ΓòÉΓòÉΓòÉ
  295.  
  296. Find allows you to search for one or more occurrences of a word or phrase (up 
  297. to about 50 characters). 
  298.  
  299. To activate this command, select Find from the menu, or use the keyboard 
  300. accelerator: Ctrl+F. 
  301.  
  302. When activated, you will be prompted to enter a string to search for. After 
  303. typing in the target string, press the Enter key or click on the Find 
  304. pushbutton.  If the search is successful, the cursor will move to the first 
  305. occurrence of the string; the editor will also highlight  the string in the 
  306. edit window. 
  307.  
  308. If the target string is not found, a message box informs you of that. 
  309.  
  310. If you do not specify a target string, Find will exit without doing anything. 
  311. Depressing the Escape key or clicking on the Cancel pushbutton has the same 
  312. effect. 
  313.  
  314. If you activate the Find again, the previous word will already appear in the 
  315. target field, allowing you to more easily continue the search (for multiple 
  316. occurrences) -- just hit the Enter key or click on the Find pushbutton. 
  317.  
  318. Find starts its search from the cursor position, and continues to the end of 
  319. the edit window. 
  320.  
  321.  
  322. ΓòÉΓòÉΓòÉ 15. Find next Explained ΓòÉΓòÉΓòÉ
  323.  
  324. Find next continues Find. When activated, searching is started immediately 
  325. without prompting. It uses the string typed in at the the Find action. 
  326.  
  327. To activate this command, select Find next from the menu, or use the keyboard 
  328. accelerator: Ctrl+V. 
  329.  
  330.  
  331. ΓòÉΓòÉΓòÉ 16. Replace Explained ΓòÉΓòÉΓòÉ
  332.  
  333. Replace allows you to search, and optionally replace text (a word or phrase up 
  334. to about 50 characters). 
  335.  
  336. To activate this command, select Replace from the menu, or use the keyboard 
  337. accelerator: Ctrl+R. 
  338.  
  339. When activated, you will be prompted to enter a string to search for. (You may 
  340. optionally enter the replacement string at this time as well). After typing in 
  341. the target string, press the Enter key or click on the Find pushbutton.  If the 
  342. search is successful, the cursor will move to the first occurrence of the 
  343. string; the editor will also highlight  the string in the edit window. 
  344.  
  345. Once the first occurrence of the target is found, the Replace dialog box will 
  346. reappear (this time with the Replace and Replace All pushbuttons active).  You 
  347. may now enter the replacement string (if you leave it blank, the target is 
  348. replaced with nothing -- i.e., the target is deleted).  You may now choose Find 
  349. (searches for next occurrence without replacing), Replace (replaces the 
  350. highlighted occurrence of the target), Replace All (replaces every occurrence 
  351. of the target, or Cancel (does nothing). 
  352.  
  353. If the target string is not found, a message box informs you of that. 
  354.  
  355. In the case of Replace All, a message box informs you when it has replaced all 
  356. occurrences of the target. 
  357.  
  358. If you do not specify a target string, Replace will exit without doing 
  359. anything.  Depressing the Escape key or clicking on the Cancel pushbutton has 
  360. the same effect. 
  361.  
  362. Replace starts its search from the cursor position, and continues to the end of 
  363. the edit window. 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ 17. Go to line Explained ΓòÉΓòÉΓòÉ
  367.  
  368. Go to line allows you to go directly to a specified line. 
  369.  
  370. To activate this command, select Go to line from the menu, or use the keyboard 
  371. accelerator: Ctrl+G. 
  372.  
  373. This feature is particularly helpful when you are using compiler diagnostic 
  374. messages (which reports syntax errors by line number) to locate and fix program 
  375. bugs. 
  376.  
  377. You will find it easier if you first fix the syntax errors that occur near the 
  378. end of the file, as changes made (added or deleted lines) will not affect line 
  379. numbering of syntax errors that occur near the beginning of the file. 
  380.  
  381.  
  382. ΓòÉΓòÉΓòÉ 18. Help Menu Explained ΓòÉΓòÉΓòÉ
  383.  
  384. The Help menu gives you access to several types of help, including help for 
  385. using the help system, general help about this program, a list of keys used by 
  386. this program, an index of available help topics, and copyright information 
  387. about Edit32. 
  388.  
  389. For more information, double-click on one of these topics: 
  390.  
  391. Help index 
  392. Extended help 
  393. Help for help 
  394. Keys help 
  395. About 
  396.  
  397.  
  398. ΓòÉΓòÉΓòÉ 19. Help index Explained ΓòÉΓòÉΓòÉ
  399.  
  400. Help index give an alphebetic listing of all available help topics.  The index 
  401. is organized in two levels (main topic and subtopic). All topics related to 
  402. this application are subtopics of the main topic Editor. 
  403.  
  404. Each item in the index is a hypertext link: double-click or depress the Enter 
  405. key to get help on a topic in the index. 
  406.  
  407.  
  408. ΓòÉΓòÉΓòÉ 20. Extended help Explained ΓòÉΓòÉΓòÉ
  409.  
  410. Extended help is actually a rather abbreviated explanation of this application. 
  411. Hypertext links (shown in light green) give you access to other available help 
  412. for this application (e.g., instructions for using each of the menu options). 
  413.  
  414.  
  415. ΓòÉΓòÉΓòÉ 21. Help for help Explained ΓòÉΓòÉΓòÉ
  416.  
  417. Help for help gives information about using the OS/2 help system (known as the 
  418. Information Presentation Facility ). The various features and services are 
  419. explained, and the keystrokes used by the help system are listed and explained. 
  420.  
  421.  
  422. ΓòÉΓòÉΓòÉ 22. Keys help Explained ΓòÉΓòÉΓòÉ
  423.  
  424. Keys help lists the keystrokes used by this application. 
  425.  
  426.  
  427. ΓòÉΓòÉΓòÉ 23. About Explained ΓòÉΓòÉΓòÉ
  428.  
  429. About displays copyright information about this application. 
  430.  
  431.  
  432. ΓòÉΓòÉΓòÉ 24. Keys Help ΓòÉΓòÉΓòÉ
  433.  
  434. Editing Keys 
  435.  
  436. F1 
  437.         Help 
  438.  
  439. Ctrl+N 
  440.         New File 
  441.  
  442. Ctrl+O 
  443.         Open Other File 
  444.  
  445. Ctrl+S 
  446.         Save File 
  447.  
  448. Ctrl+A 
  449.         Save File As 
  450.  
  451. F3 
  452.         Exit 
  453.  
  454. Alt+Backspace 
  455.         Undo/Redo 
  456.  
  457. Shift+Del 
  458.         Cut 
  459.  
  460. Ctrl+Ins 
  461.         Copy 
  462.  
  463. Shift+Ins 
  464.         Paste 
  465.  
  466. Del 
  467.         Delete Block or Character 
  468.  
  469. Ctrl+F 
  470.         Find (Search) 
  471.  
  472. Ctrl+V 
  473.         Find Next 
  474.  
  475. Ctrl+R 
  476.         Replace (Search and Replace) 
  477.  
  478. Ctrl+G 
  479.         Go to line 
  480.  
  481. Page Up 
  482.         Scroll Text (Vertical) 
  483.  
  484. Page Down 
  485.         Scroll Text (Vertical) 
  486.  
  487. Ctrl+Page Up 
  488.         Scroll Text (Horizontal) 
  489.  
  490. Ctrl+Page Down 
  491.         Scroll Text (Horizontal) 
  492.  
  493. Home 
  494.         Beginning of Line 
  495.  
  496. End 
  497.         End of Line 
  498.  
  499. Ctrl+Home 
  500.         Beginning of Document 
  501.  
  502. Ctrl+End 
  503.         End of Document 
  504.  
  505. Ctrl+Right Arrow 
  506.         Next Word 
  507.  
  508. Ctrl+Left Arrow 
  509.         Previous Word 
  510.  
  511. Insert 
  512.         Toggle Insert/Overwrite 
  513.  
  514. Del 
  515.         Delete Character or Block 
  516.  
  517.