═══ 1. Extended Help ═══ Edit32 is a simple programmer's editor. Its only advantage over the standard OS/2 System Editor is that Edit32 displays line and column numbers -- something that is essential when attempting to interpret compiler diagnostics. It also shows a asterix in front of the line number if any changes on the text had been occured after last opening or saving. All standard editing features are supported, including undo/redo, cut, copy, paste (using the system clipboard), search/replace, and Go to line. Standard cursor control keys are available when editing. CUA standards are followed for most functions. More help can be obtained on any of the main menu items (and their associated pull-down menus) by double-clicking on one of the following: File Edit Help Brian R. Anderson British Columbia Institute of Technology 3700 Willingdon Avenue Burnaby, B.C. V5G 3H2 CANADA Thomas K. GФtz Bremerhaven Germany ═══ 2. File Menu Explained ═══ The File menu allows access to disk files. File size must not exceed 64K. To edit more than one file, start multiple copies of the editor by double-clicking on the Edit32 entry in a Desktop Manager menu or from the command line: [C: \WORK] START Edit32 With multiple copies of the editor running, you can use the clipboard to move or copy text from one file to another (see Edit menu for more details). For more information, double-click on one of these topics: New Open Save Save as Exit ═══ 3. New Explained ═══ New clears the edit window so that you can create a new file. If the contents of the edit window have changed since the last time you saved, you will be given a chance to save before the window is cleared. Unless you want to discard the changes that you have made to your file, select Yes when prompted; if you select No, the file will not be saved. If you select Cancel, you will be returned to the edit window without any action. To activate this command, select New from the menu, or use the keyboard accelerator: Ctrl+N. ═══ 4. Open Explained ═══ Open allows you to access existing files on any disk or within any directory. The dialog box that results from choosing Open contains two list boxes -- one with disks/directories, the other with files. To change to another disk or directory, simply double-click on the disk or directory of interest -- the files list box will immediately show the files in that directory. To select a file, simply double-click on the required file and it will be opened and read into the edit window. You may also open files using just the keyboard: Of course, you may simply type the name of the file that you want to open, followed by the Enter key. Use the tab key to switch from one part of the dialog box to another. Use the up and down Arrow keys to scroll through the disk/directory and file list boxes. Use the Enter key to make your selection. Use the Escape key to cancel without making a selection. To activate this command, select Open from the menu, or use the keyboard accelerator: Ctrl+O. If you select Open when you are already editing a file (and the file has changed since the last time you saved), you will be given the opportunity to save before the new file is opened. ═══ 5. Save Explained ═══ Save will save the contents of the edit window to the current file. If the edit window contains new text that has never been saved, you will be prompted for a filename. The current filename (if any) appears in the title bar. To activate this command, select Save from the menu, or use the keyboard accelerator: Ctrl+S. After saving with this command, the asterix if any in front of the line number will disappear. ═══ 6. Save as Explained ═══ Save as allows you to save the contents of the edit window under a different filename (i.e., different from previous saves and/or different from the original filename). Unlike Save, (which saves using the existing name) Save as always prompts for a new filename. Save as is useful for two distinct purposes: saving an altered file under a different name (to preserve the original file); and splitting a file. Splitting a file is tricky, and should only be attempted after first saving a backup copy of the entire file. Here are the steps involved in splitting a file: 1. Cut one portion of the text to the clipboard. 2. Save the remaining text to a new file. 3. Delete the text that was just saved to the file. 4. Paste the text that was previously Cut to the clipboard. 5. Save the retreived text to a second new file. To activate this command, select Save as from the menu, or use the keyboard accelerator: Ctrl+A. After saving with this command, the asterix if any in front of the line number will disappear. ═══ 7. Exit Explained ═══ Exit terminates the editor session, and returns you to the operating system (Work Place Shell or OS/2 command prompt, depending upon how you started the program). If you have changed the contents of the edit window since the last time that you saved, you will be given the opportunities to save the contents to a file, to quit without saving or to cancel Exit and return to the editor. To activate this command (i.e., quit the editor), you may select Exit from the menu, select Close from the system menu, click on the End Task pushbutton from the task list, or use the keyboard accelerator: F3. ═══ 8. Edit Menu Explained ═══ The Edit menu provides various text manupulation functions. For more information, double-click on one of these topics: Undo Cut Copy Paste Delete Find Find next Replace Go to line ═══ 9. Undo Explained ═══ Undo provides a single-level undo/redo function to allow you to recover from mistakes. This menu selection will be greyed (i.e., unavailable) if the editor does not have an action that it can recover from. For example, it is not possible to undo a save. Undo is most useful when you accidently delete something that you meant to keep. It is important to realize that Edit32 can recover only the most recent action -- if you delete something and don't realize it until after you have started typing, it is too late! Undo can also recover from an accidental undo -- i.e., it can re-do. Again, the same caution applies -- if you don't realize that the undo was a mistake (and do something else), you will not be able to re-do, because Edit32 can undo only your latest action. To activate this command, select Undo from the menu, or use the keyboard accelerator: Alt+Backspace. ═══ 10. Cut Explained ═══ Cut allows you to move text from one part of a document to another, or even between two different documents. Cut (or Copy) places text on the clipboard, where it may be later retreived by Paste. Text remains on the clipboard even if you exit the program, and is available to other processes (e.g., other running copies of Edit32). To cut a section of text, you must first highlight the text. You can do this either with the mouse or the keyboard. With the mouse, you point to the beginning of the area that you want to cut, depress and hold the left mouse button, and then move the mouse to the end of the area that you want to cut. With the keyboard, you move the text cursor (with the Arrow or Page Up/Page Down keys) to the beginning of the area that you want to cut, depress (and hold) the Shift key and then move (using the same keys as before) to the end of the area that you want to cut. In either case (mouse or keyboard) the result is that the selected text is marked by changing colors (usually by making the text reverse video, but may be different if you have changed the default colors on your computer). Once the text has been chosen (highlighted ) select Cut from the menu, or use the keyboard accelerator: Shift+Del. If no text has been selected, the Cut menu item will be greyed (i.e., disabled). Cut and Copy are somewhat similar (in that both result in the selected text being placed on the clipboard), but very different (in that Cut results in the text being deleted, while Copy does not). ═══ 11. Copy Explained ═══ Copy allows you to duplicate text from one part of a document to another, or even between two different documents. Copy (or Cut) places text on the clipboard, where it may be later retreived by Paste. Text remains on the clipboard even if you exit the program, and is available to other processes (e.g., other running copies of Edit32). To copy a section of text, you must first highlight the text. You can do this either with the mouse or the keyboard. With the mouse, you point to the beginning of the area that you want to copy, depress and hold the left mouse button, and then move the mouse to the end of the area that you want to copy. With the keyboard, you move the text cursor (with the Arrow or Page Up/Page Down keys) to the beginning of the area that you want to copy, depress (and hold) the Shift key and then move (using the same keys as before) to the end of the area that you want to copy. In either case (mouse or keyboard) the result is that the selected text is marked by changing colors (usually by making the text reverse video, but may be different if you have changed the default colors on your computer). Once the text has been chosen (highlighted ) select Copy from the menu, or use the keyboard accelerator: Ctrl+Ins. If no text has been selected, the Copy menu item will be greyed (i.e., disabled). Copy and Cut are somewhat similar (in that both result in the selected text being placed on the clipboard), but very different (in that Cut results in the text being deleted, while Copy does not). ═══ 12. Paste Explained ═══ Paste works in conjunction with Cut or Copy to either move or duplicate sections of text. After text has been highlighted and then placed on the clipboard, Paste retreives the text from the clipboard and inserts it into the edit window at the current cursor position. To activate this command, select Paste from the menu, or use the keyboard accelerator: Shift+Ins. Paste does not remove the text from the clipboard -- i.e., the same text can be retreived multiple times. If text is highlighted at the time that Paste is selected, the clipboard data replaces the highlighted text. Although this feature can sometimes be useful, it is usually a mistake -- fortunately, even this operation can be reversed by the Undo command. ═══ 13. Delete Explained ═══ Delete allows you to remove text from a document. The text does not go to the clipboard, but can be retreived (if done immediately) by Undo To delete a section of text, you must first highlight the text. You can do this either with the mouse or the keyboard. With the mouse, you point to the beginning of the area that you want to delete, depress and hold the left mouse button, and then move the mouse to the end of the area that you want to delete. With the keyboard, you move the text cursor (with the Arrow or Page Up/Page Down keys) to the beginning of the area that you want to delete, depress (and hold) the Shift key and then move (using the same keys as before) to the end of the area that you want to delete. In either case (mouse or keyboard) the result is that the selected text is marked by changing colors (usually by making the text reverse video, but may be different if you have changed the default colors on your computer). Once the text has been chosen (highlighted ) select Delete from the menu, or use the keyboard accelerator: Del. If no text has been selected, the Delete menu item will be greyed (i.e., disabled), however the Del key will still operate: it deletes the current character. ═══ 14. Find Explained ═══ Find allows you to search for one or more occurrences of a word or phrase (up to about 50 characters). To activate this command, select Find from the menu, or use the keyboard accelerator: Ctrl+F. When activated, you will be prompted to enter a string to search for. After typing in the target string, press the Enter key or click on the Find pushbutton. If the search is successful, the cursor will move to the first occurrence of the string; the editor will also highlight the string in the edit window. If the target string is not found, a message box informs you of that. If you do not specify a target string, Find will exit without doing anything. Depressing the Escape key or clicking on the Cancel pushbutton has the same effect. If you activate the Find again, the previous word will already appear in the target field, allowing you to more easily continue the search (for multiple occurrences) -- just hit the Enter key or click on the Find pushbutton. Find starts its search from the cursor position, and continues to the end of the edit window. ═══ 15. Find next Explained ═══ Find next continues Find. When activated, searching is started immediately without prompting. It uses the string typed in at the the Find action. To activate this command, select Find next from the menu, or use the keyboard accelerator: Ctrl+V. ═══ 16. Replace Explained ═══ Replace allows you to search, and optionally replace text (a word or phrase up to about 50 characters). To activate this command, select Replace from the menu, or use the keyboard accelerator: Ctrl+R. When activated, you will be prompted to enter a string to search for. (You may optionally enter the replacement string at this time as well). After typing in the target string, press the Enter key or click on the Find pushbutton. If the search is successful, the cursor will move to the first occurrence of the string; the editor will also highlight the string in the edit window. Once the first occurrence of the target is found, the Replace dialog box will reappear (this time with the Replace and Replace All pushbuttons active). You may now enter the replacement string (if you leave it blank, the target is replaced with nothing -- i.e., the target is deleted). You may now choose Find (searches for next occurrence without replacing), Replace (replaces the highlighted occurrence of the target), Replace All (replaces every occurrence of the target, or Cancel (does nothing). If the target string is not found, a message box informs you of that. In the case of Replace All, a message box informs you when it has replaced all occurrences of the target. If you do not specify a target string, Replace will exit without doing anything. Depressing the Escape key or clicking on the Cancel pushbutton has the same effect. Replace starts its search from the cursor position, and continues to the end of the edit window. ═══ 17. Go to line Explained ═══ Go to line allows you to go directly to a specified line. To activate this command, select Go to line from the menu, or use the keyboard accelerator: Ctrl+G. This feature is particularly helpful when you are using compiler diagnostic messages (which reports syntax errors by line number) to locate and fix program bugs. You will find it easier if you first fix the syntax errors that occur near the end of the file, as changes made (added or deleted lines) will not affect line numbering of syntax errors that occur near the beginning of the file. ═══ 18. Help Menu Explained ═══ The Help menu gives you access to several types of help, including help for using the help system, general help about this program, a list of keys used by this program, an index of available help topics, and copyright information about Edit32. For more information, double-click on one of these topics: Help index Extended help Help for help Keys help About ═══ 19. Help index Explained ═══ Help index give an alphebetic listing of all available help topics. The index is organized in two levels (main topic and subtopic). All topics related to this application are subtopics of the main topic Editor. Each item in the index is a hypertext link: double-click or depress the Enter key to get help on a topic in the index. ═══ 20. Extended help Explained ═══ Extended help is actually a rather abbreviated explanation of this application. Hypertext links (shown in light green) give you access to other available help for this application (e.g., instructions for using each of the menu options). ═══ 21. Help for help Explained ═══ Help for help gives information about using the OS/2 help system (known as the Information Presentation Facility ). The various features and services are explained, and the keystrokes used by the help system are listed and explained. ═══ 22. Keys help Explained ═══ Keys help lists the keystrokes used by this application. ═══ 23. About Explained ═══ About displays copyright information about this application. ═══ 24. Keys Help ═══ Editing Keys F1 Help Ctrl+N New File Ctrl+O Open Other File Ctrl+S Save File Ctrl+A Save File As F3 Exit Alt+Backspace Undo/Redo Shift+Del Cut Ctrl+Ins Copy Shift+Ins Paste Del Delete Block or Character Ctrl+F Find (Search) Ctrl+V Find Next Ctrl+R Replace (Search and Replace) Ctrl+G Go to line Page Up Scroll Text (Vertical) Page Down Scroll Text (Vertical) Ctrl+Page Up Scroll Text (Horizontal) Ctrl+Page Down Scroll Text (Horizontal) Home Beginning of Line End End of Line Ctrl+Home Beginning of Document Ctrl+End End of Document Ctrl+Right Arrow Next Word Ctrl+Left Arrow Previous Word Insert Toggle Insert/Overwrite Del Delete Character or Block