═══ 1. About Shell ═══ View on-line documentation xTech development system (XDS(tm)) is a professional system available for most popular platforms, including IBM PC (PC/MS-DOS, OS/2, Windows NT, Windows 95, Linux versions), Unix workstations (Sun, HP, DEC, MIPS, etc), Macintosh, Amiga, etc. XDS provides a uniform programming environment for all mentioned platforms and allows to design and implement truly portable software. The system contains both Modula-2 and Oberon-2 compilers that generates either the ANSI C source code or native object code for the platform. The ANSI C code generation is available for all platforms. A number of platforms for which a native code compiler is available is constantly extended. The XDS Modula-2 compiler implements ISO standard of Modula-2. The ISO standard library set is accessible for both Modula-2 and Oberon-2. XDS also includes a set of utility libraries and an interface to the ANSI C library set. XDS allows the programmer to mix Modula-2, Oberon-2, C, Assembler, and often Pascal and Fortran modules and libraries in a single project. ═══ 2. File Menu ═══ The File menu contains commands that you use to create, open, and save source files. It also contains a list of files (up to 15) that were most recently opened or saved using the Save As command. The following commands appear in the File menu: New Opens new empty window Open Opens new window with an existing file Save Saves any changes made to the current file Save As Saves the current file using a new name Autosave Toggles autosave mode on or off ═══ 3. New ═══ Use the New command to create a new empty window. The word "Nonamex" will appear in its title bar (x = 0,1,2,...). You'll have to specify a name for the new file when you save it. Mouse shortcut: Toolbar ═══ 4. Open ═══ Use the Open command to open an existing file. A dialog will appear, showing you a list of files in the directory the most recently opened file was from. After you select a file, it will be loaded into the new window. You can select a different drive/directory first. Mouse shortcut: Toolbar Keyboard shortcut: F3 ═══ 5. Save ═══ Use Save to store the current file. After the file is saved, the text remains in the window so that you can continue editing it. Mouse shortcut: Toolbar Keyboard shortcut: F2 Note: If you are editing a new (Nonamex) file, select the Save or Save as choices to display the Save as dialog so that you can name the file you are editing. A file must have a title to be saved. ═══ 6. Save As ═══ Use the Save As command to name and save a new file or to save file under a different name, or to a different location. A dialog box will appear, prompting you for a new filename. You can also select different drive/directory. ═══ 7. Autosave ═══ Use Autosave command to toggle autosave mode on or off. In autosave mode XDS automatically saves all files before exiting or starting the compiler. ═══ 8. Open dialog box ═══ To open a file: 1. Select the down arrow to the right of the Drive list to display all the drives on your system. 2. Select a drive from the Drive list. 3. Select a directory from the Directory list. 4. Select a file name from the File list or type in a file name. 5. Select the Open pushbutton. The selected file will be loaded into a new window. Detailed description of controls: Open filename Type the name of the file you want to open in the Open filename field and select the OK pushbutton. You can also type absolute or relative pathname. If you type a name containing wildcard characters (* and ?), it is considered a string filter rather than a file name. Pressing the Enter key or selecting the OK pushbutton will limit the File list to display only filenames that match the pattern you entered. Type of file Select the down arrow to the right of the Type of file field to display the available file types. XDS sets this field for all file types. Drive The Drive list displays the drives on your system. Select the drive that contains the files you want to edit. File The File list displays all the files in the directory you selected from the Directory list. Select the file you want to open. Directory The Directory list displays the directories on the selected drive. Select a directory to display the list of files from that directory in the File list box. OK Select the OK pushbutton to load the selected file into a new window or to accept a string filter. Cancel Select the Cancel pushbutton if you decide not to load a file. ═══ 9. Save as dialog box ═══ To name and save a new file of to save a file under a new name: 1. Select the down arrow to the right of the Drive list to display all the drives on your system. 2. Select a drive from the Drive list. 3. Select a directory from the Directory list. 4. Type the name of the file you want to save in the File name field and select the OK pushbutton. The file will be saved in selected directory under the name you entered. Detailed description of controls: File name Type the name of the file you want to save in the File name field and select the OK pushbutton. Type of file Select the down arrow to the right of the Type of file field to display the available file types. XDS sets this field for all file types. Drive The Drive list displays the drives on your system. Select the drive that contains the files you want to save. File The File list displays all the files in the directory you selected from the Directory list. Select the file you want to rename and save. Directory The Directory list displays the directories on the selected drive. Select a directory to display the list of files from that directory in the File list box. OK Select the OK pushbutton to save the file to the drive and directory you selected and with the file name you specified. Cancel Select the Cancel pushbutton if you decide not to save a file. ═══ 10. Edit Menu ═══ The Edit menu contains commands that you use to undo changes you've made to file, to cut, copy, paste and delete portions of text, to find and replace text, and to locate errors contained in the Message list window. The following commands appear in the Edit menu: Undo Undoes editing changes Cut Cuts selected text to the clipboard Copy Copies selected text to the clipboard Paste Inserts contents of the clipboard at the current position Clear Deletes selected text Find Searches for the string, optionally replacing it with another Find again Repeats previous find action Prev error Locates previous error from the Message List window Next error Locates next error from the Message List window ═══ 11. Undo ═══ Use the Undo command to undo changes you've made to the current file. Mouse shortcut: Toolbar Keyboard shortcut: Alt+Backspace Note: Each window has its own undo buffer of fixed size. Thus, all types (but not any number) of changes can be undone, except cutting or deleting a large block of text. ═══ 12. Cut ═══ Use the Cut command to delete selected text from the file and move it to the Clipboard. You can use the Paste command later to insert Clipboard contents at another position or even into another file. Mouse shortcut: Toolbar Keyboard shortcut: Shift+Delete ═══ 13. Copy ═══ Use the Copy command to duplicate selected text. A copy of selected text is moved to the Clipboard. You can use the Paste command later to insert Clipboard contents at another position or even into another file. Mouse shortcut: Toolbar Keyboard shortcut: Ctrl+Ins ═══ 14. Paste ═══ Use the Paste command to insert the text from the Clipboard at the cursor position in the current file. Mouse shortcut: Toolbar Keyboard shortcut: Shift+Insert ═══ 15. Clear ═══ Use the Clear command to delete selected text. Keyboard shortcut: Delete ═══ 16. Find ═══ Use the Find command to locate or change the text in the current file. A dialog box will appear, allowing you to specify find/replace patterns and various options. Mouse shortcut: Toolbar Keyboard shortcut: Ctrl+F ═══ 17. Find Again ═══ Use the Find Again command to repeat previous Find command. Mouse shortcut: Toolbar Keyboard shortcut: Ctrl+L ═══ 18. Prev Error ═══ Use the Prev Error command to locate the previous error from the Messages list window. Keyboard shortcut: F7 ═══ 19. Next Error ═══ Use the Next Error command to locate the next error from the Messages list window. Keyboard shortcut: F8 ═══ 20. Find dialog box ═══ To locate or change a specific text: 1. Type the text you want to find or change in the Find field. 2. Type the text you want to change to in the Change to field. 3. Select the required options using the Case sensitive, Find whole word and Buffers to find controls. 4. Select one of the Find pushbuttons depending on the starting point and direction desired. 5. If a text was found, select one of the Find/Change pushbuttons for appropriate action or the Cancel pushbutton to stop finding text. Detailed description of controls: Find Type the text you want to find - the find_pattern Change to Type the text you want to change the find_pattern to - the change_pattern. Case sensitive Matches case in the find_pattern. For example, the "QWERTY" and "qwerty" patterns are treated different. Find whole word Finds only text bounded with non-alphabetical characters. For example, "hole" won't be found in "whole". Buffers to find Select the buffers you want to find find_pattern in: Current, All or All except current. Find Select Find to find the next occurence of the find_pattern. Find global Select Find global to find the first occurence of the find_pattern from the beginnning of the file. Find backward Select Find backward to find the previous occurence of the find_pattern. Change, then find Select Change, then find to change the found text to change_pattern and find the next occurence of the find_pattern. Change all Select Change all to change all occurences of the find_pattern to change_pattern. Cancel Select Cancel to close the Find dialog. ═══ 21. Options Menu ═══ The Options menu contains commands that you use to set edit windows font/colors and various IDE options. The following commands appear in the Options menu: Set font Changes edit windows font Set colors Changes current edit window colors Other options Changes various IDE options ═══ 22. Set font ═══ Use the Set font command to change the font used in edit windows. A font selection dialog will appear, allowing you to select font name, size, style and emphasis. Mouse shortcut: Toolbar ═══ 23. Set colors ═══ Use the Set colors command to change the colors of the current edit window. A dialog will appear, allowing you to define foreground and background colors for selected and unselected text in a window. Main window background color can also be changed. Mouse shortcut: Toolbar ═══ 24. Other options ═══ Use the Other options command to set various IDE options, including autoindent, tab width and toolbar orientation. ═══ 25. Font dialog box ═══ To change the font used to display text in the editing windows: 1. Select the arrow to the right of the Name field to display the list of available font names. 2. Select a font name from the list. 3. Select the arrow to the right of the Size field to display the list of available font sizes. 4. Select a font size from the list. 5. Select the arrow to the right of the Style field to display the list of font styles. 6. Select a font style from the list. 7. Select a check box in the Emphasis field if you want the file text emphasized in any of the indicated ways. 8. Select Ok to put your font choices into effect. Your font selections are displayed in the Sample field as you make them. The Display check box is selected by default. Printer font selection is not enabled. Detailed description of controls: Name Select the down arrow right to the Name field to display the names of the fonts available on your system. Select the font you want to be used in the editing windows. Size Select the down arrow right to the Size field to display the list of all the sizes in which the selected font can be displayed. Select the size you want to be used for the selected font. Style Select the down arrow right to the Style field to display the list of the type styles you can choose for the selected font. Emphasis Select the kinds of emphasis for the selected font. Ok Select the Ok pushbutton to display the file text in the editing windows using the font specifications you select. Cancel Select the Cancel pushbutton if you decide not to change the font for the editing windows. ═══ 26. Set colors dialog box ═══ To change the colors of the current window: 1. Select one of the Color of radiobuttons to choose the window element. 2. Select the desired color for that element from the listbox. The sample window will reflect the change. 3. Repeat the first two steps for all elements of the window which color you want to change. 4. Select Set colors as default checkbox if you want to save the color set of the current window as default. 5. Select the Ok pushbutton. To change the color set of the current window to one of the predefined sets: 1. Select one of the Set colors radiobuttons. The Default colors radiobutton chooses the colors last set with the Set colors as default checked. Detailed description of controls: Colors Select the desired color for the window element choosed using the Color of radiobuttons. Color of Select the element of the editor window which color you want to change. You can also change the color of the "desktop" (main window background). Set colors Select one of the coloured pushbuttons to quickly change all colors to one of the predefined sets or the Default colors pushbutton for the color set previously saved as default. Set colors as default Select this check box to save the color set of the current window as default. You will then be able to recall it for another window using the Default colors pushbutton. Ok Select the Ok pushbutton to change the colors of the current window to the colors you selected. Cancel Select the Cancel pushbutton if you decide not to change the colors of the current window. ═══ 27. Miscellaneous options dialog box ═══ To change the tab width: 1. Type the new value in the Tab width field or set it using the spin buttons to the right. 2. Select the Ok pushbutton. To toggle autoindent mode on or off: 1. Select the Autoindent mode checkbox. 2. Select the Ok pushbutton. To change toolbar position: 1. Select one of the radiobuttons in the Toolbar group. 2. Select the Ok pushbutton. Detailed description of controls: Tab width Type the desired interval between tab stops or select it using the spin buttons to the right of the Tab width field. When you press the Tab key while editing a file, the cursor is advanced to the next tab stop. Autoindent mode Select the Autoindent mode checkbox to toggle autoindent mode on or off. In autoindent mode, when you press the Enter key while editing a file, the cursor is placed at the indent level of the previous line. Toolbar Select one of the Horizontal, Vertical or Hide radiobuttons to change the position of the toolbar or turn it off. Ok Select the Ok pushbutton to apply the changes. Cancel Select the Cancel pushbutton if you decide not to change the settings. ═══ 28. Project Menu ═══ The Project menu contains commands that you use to open, close and edit a project file, and to compile, make and run your program. The following commands appear in the Project menu: Open project Opens a project file Close project Closes a project file Modify project Lets you modify project using a dialog box Edit project file Lets you edit the project file manually Compile Compiles module in the current window Make Makes project Make all Rebuilds all project Run Runs resulting program Debug Starts debugger Stop Stops running program Get run history Retrieves history of crashed program procedure calls Run/debug options Sets run and debug options ═══ 29. Open project ═══ Use the Open project command to open an existing project file. A dialog will appear that allows you to select a project file. ═══ 30. Close project ═══ Use the Close project command to close the currently opened project. ═══ 31. Modify project ═══ Use the Modify project command to edit currently opened project using a dialog box. ═══ 32. Edit project file ═══ Use the Edit project file command to edit currently opened project file manually. A new window will be opened and the project file will be loaded into it. ═══ 33. Compile ═══ Use the Compile command to compile a module in the current window. Mouse shortcut: Toolbar Keyboard shortcut: Alt+C ═══ 34. Make ═══ Use the Make command to compile all changed modules in the current project and link it. Mouse shortcut: Toolbar Keyboard shortcut: Alt+M ═══ 35. Make all ═══ Use the Make all command to rebuild the current project completely. Mouse shortcut: Toolbar Keyboard shortcut: Alt+B ═══ 36. Run ═══ Use the Run command to run the resulting program after you make the project. Mouse shortcut: Toolbar Keyboard shortcut: Alt+R ═══ 37. Debug ═══ Use the Debug command to start the debugger with your program loaded into it. The debugger command line have to be specified using the Run/debug options dialog. Mouse shortcut: Toolbar Keyboard shortcut: Alt+D ═══ 38. Get run history ═══ Use the Get run history command to view procedure call stack of your last crashed program. ═══ 39. Run/debug options ═══ Use the Run/debug options command to change various run and debug options. A dialog box will appear, allowing you to set up your program command line parameters and debugger command line, and to toggle automake mode and session closing. ═══ 40. Run/debug options dialog box ═══ To change the command line parameters for your program: 1. Type them in the Run arguments field. Do NOT type the name of your program - it will be substituted automatically. 2. Select the Ok pushbutton. To set up the debugger command line: 1. Type the command line used to start the debugger in the Debugger field. Do NOT type the name of your program - it will be substituted automatically along with the command line parameters. 2. Select the Ok pushbutton. To toggle automake mode on or off: 1. Select the Automake checkbox. 2. Select the Ok pushbutton. To toggle session closing on or off: 1. Select the Close session after run checkbox. 2. Select the Ok pushbutton. Detailed description of controls: Run arguments Type the string you want to be passed to your program as the command line arguments when you issue the Run or Debug command in the Run arguments field. Debugger Type the command line you want to be used to start your debugger when you issue the Debug command in the Debugger field. Automake Select this checkbox to toggle automake mode on or off. In automake mode the make will be done automatically if you issue the Run or Debug command. Close session after run Select this checkbox to toggle session closing on or off. If it is off, the session your program was executed in will remain open until you explicitly close it. ═══ 41. Windows Menu ═══ The Windows Menu contains commands that you use to select a window and manage the windows layout. A list of all open windows is provided. ═══ 42. Messages list ═══ Use the Messages list command to switch to the Messages list window. ═══ 43. Cascade ═══ Use the Cascade command to cascade all opened windows. ═══ 44. Help Menu ═══ The Help menu contains commands that you use to display the most general help topics, the alphabetical index of all help topics, and the product information. The following commands appear in the File menu: Help index Displays an alphabetical index of references to all help topics General help Displays general information about XDS Using help Displays general inforamtion about the help facitlity Keys help Displays a list and description of keys and mouse shortcuts you can use Product information Displays the Product information dialog ═══ 45. Help index ═══ Use the Help index command to display an alphabetic list of references to the help topics for XDS. You can then select an index entry to display the help topic that is related to that index entry. ═══ 46. General help ═══ ═══ 47. Key assignments ═══ Cursor movement Arrows Move cursor by one character/line Home Move cursor to start of line End Move cursor to end of line PgUp Move cursor one window up PgDn Move cursor one window down Ctrl+PgUp Move cursor to top of file Ctrl+PgDn Move cursor to end of file Ctrl+B Save the current cursor position Ctrl+G Restore the current position Ctrl+Shift+G Swap the current position with saved Editing Ins Toggle insert/overwrite mode Tab Move cursor to the next tab stop Backspace Delete character before cursor Del Delete character after cursor or selection Ctrl+T Delete spaces or word after cursor Ctrl+Y Delete current line Alt+Up Swap current line with previous Alt+Down Swap current line with next Ctrl+Shift+Up Duplicate current line before itself Ctrl+Shift+Down Duplicate current line after itself Shift+Cursor_movement_key Move and extend selection Shift+Del Cut selected text to Clipboard Ctrl+Ins Copy selected text to Clipboard Shift+Ins Insert Clipboard contents at the cursor position Finding and changing text Ctrl+F Display the Find/Change to dialog Ctrl+L Repeat previous find action Ctrl+Up Find previous occurence of the current word Ctrl+Down Find next occurence of the current word Window management Alt+1..9 Switch to the window with corresponding number Alt+0 Switch to the Message list (if it is not empty) Ctrl+F6 Switch to the next window Ctrl+Shift+F6 Switch to the previous window Ctrl+F5 Restore current window Ctrl+F7 Move current window Ctrl+F8 Change current window size Ctrl+F9 Minimize current window Ctrl+F10 Maximize current window Ctrl+F4 Close current window Alt+F5 Restore main window Alt+F7 Move main window Alt+F8 Change main window size Alt+F9 Minimize main window Alt+F10 Maximize main window Alt+F4 Close all windows and exit XDS Menu activation Alt Activate main menu Alt+Space Activate main window system menu Alt+- Activate editing window system menu WordStar compatibility keys Ctrl+Q F Ctrl+Q A Display the Find/Change to dialog Ctrl+Q G Go to line by its number Mouse shortcuts Drag Select Drag selection Cut, then Paste Ctrl+Drag selection Copy, then Paste Double click Find next occurence of the word (does NOT affect Find/Change to) ═══ 48. Product information ═══ Use the Product information command to display the Product information dialog which contains XDS version information and copyright notice. ═══ 49. Product information dialog ═══ This dialog displays information about the application, such as version number and copyright notice. ═══ 50. OK ═══ The OK button closes the Product information dialog.