OS/2 Shareware BBS: 10 Tools/10-Tools.zip/xc212os2.zip/BIN/xds.hlp

OS/2 Help File | 1996-03-06 | 29KB | 892 lines

ΓòÉΓòÉΓòÉ 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.