3. Description of the pull-down menus

This chapter describes the pull-down menus and all their sub-menus. The main menu bar, the topmost line of the screen, is selected with the hotkey F10 or by clicking with the mouse at this line. You can walk through the menu with the cursor keys and a menu entry is selected with ENTER or by clicking with the mouse on it.

3.1 System menu
3.2 File
3.3 Edit
3.4 Search
3.5 Run
3.6 Compile menu
3.7 Debug
3.8 Project
3.9 Options
3.10 Windows
3.11 Help

3.1 System menu

This menu has its name only that one can speak about it. The symbol for this menu is the leftmost symbol in the menu bar. Alt+SPACE selects this menu.

3.1.1 About
3.1.2 Bug report
3.1.3 FSDB
3.1.4 GREP
3.1.5 GDB
3.1.6 Refresh Desktop
3.1.7 Calculator
3.1.8 Puzzle
3.1.9 Calender
3.1.10 ASCII table

3.1.1 About

This brings up a window with information about the author and the version of RHIDE.

3.1.2 Bug report

3.1.3 FSDB

3.1.4 GREP

This is a very useful function. You can type the arguments for grep in the input line, which will be shown, and after this the program grep is called. The messages from grep are redirected to the message window see section 4.8 Message window.

3.1.5 GDB

This is analog to the call of FSDB see section 3.1.3 FSDB.

3.1.6 Refresh Desktop

This function is sometimes useful, if you had run your program and it wrote some things to the screen (for redirecting stdout and stderr from your program to a window in RHIDE see section 3.9.6.3 Preferences.)

3.1.7 Calculator

There can be used also some of the standard functions like `log', `sin' and so on and it can convert also integer values between different bases (`hex', `oct', `dec').

3.1.8 Puzzle

3.1.9 Calender

3.1.10 ASCII table

3.2 File

In this menu you can find functions, which deal with files, like open, close, save and so on.

3.2.1 Open
3.2.2 New
3.2.3 Save
3.2.4 Save as
3.2.5 Save all
3.2.6 DOS Shell
3.2.7 Exit

3.2.1 Open

Brings up the file-open dialog, where you can select a file to open (hotkey F3 ). This dialog contains an input line for the filename, a list of filenames, an information window and the buttons for opening and canceling.

In the filename input line you can type directly the file, which you want to open or you can type any mask to list only some files. The default mask is `*.cc', but you can change this to anything and your last typed mask is stored as the default mask for the next use. There is also a history of your previous typed inputs available. This is selected when you hit the down key or click at the small symbol at the end of the input line with your mouse.

The list of filenames shows all the files that correspond to the mask. If this list is selected you can choose a file with the cursor keys, or you can type the first letters of the filename you want, and the bar is located at the first file, which has these letters as the first characters. To open the file simply press ENTER or double click with the mouse on it.

Below the list of filenames there is a small window with information about the selected file (complete path, size, modification time).

To leave the dialog without opening a file press ESC .

3.2.2 New

This is the menu entry for creating a new file to edit. This file gets the title 'Untitled'. If you save or close it, you will be prompted for a new name of this file by opening the file-open dialog.

3.2.3 Save

Save the file in the current editor-window to disk. If the name of the current file is 'Untitled' you will be prompted for a new name. F2 is the hotkey for this function. The modification of the file on disk is set to the time of the last modification of this file and not to the time when saving to disk.

If the file was not modified, it is not saved!!

3.2.4 Save as

Save the file in the current editor-window to disk under a different name, for which you will be prompted. For choosing the new name the file-open dialog will be opened.

3.2.5 Save all

Save all the editor files to disk. If they are not modified, they will not be saved.

3.2.6 DOS Shell

This executes a DOS-Shell. This is done by calling the program, which is set in the environment variable COMSPEC. If this variable does not exist, the program `c:/command.com' is executed. To return to the IDE type exit at the DOS-prompt. Before calling DOS, the program does a Save all see section 3.2.5 Save all automatically.

3.2.7 Exit

Here you can quit the IDE. If there are any unsaved editor-files, you will be prompted for saving them. (Alt+X is the hotkey.)

3.3 Edit

In this menu you can activate functions, which are related to the integrated editor. Most of them have a hotkey.

3.3.1 Undo
3.3.2 Redo
3.3.3 Cut
3.3.4 Copy
3.3.5 Paste
3.3.6 Show Clipboard
3.3.7 Clear
3.3.8 Copy to Windows clipboard
3.3.9 Paste from Windows clipboard
3.3.10 Expand all tabs
3.3.11 Compact text
3.3.12 Macro

3.3.1 Undo

This undoes your last change in the current editor-window. Alt+Backspace is the hotkey for this function.

3.3.2 Redo

3.3.3 Cut

This moves the selected text in the current editor-window to the clipboard. (Shift+Del is the hotkey.)

3.3.4 Copy

This copys the selected text in the current editor-window to the clipboard. (Ctrl+Ins is the hotkey.)

3.3.5 Paste

This inserts the selected text in the clipboard in the current editor-window at the current cursor-position. (Shift+Ins is the hotkey.)

3.3.6 Show Clipboard

This brings up an editor-window with the contents of the clipboard. The contents of the clipboard will be lost, if you exit the IDE.

3.3.7 Clear

This erases the selected text in the current editor-window.

3.3.8 Copy to Windows clipboard

3.3.9 Paste from Windows clipboard

3.3.10 Expand all tabs

3.3.11 Compact text

3.3.12 Macro

3.3.12.1 Record
3.3.12.2 Stop
3.3.12.3 Play

3.3.12.1 Record

(Shift+F10 is the hotkey.)

3.3.12.2 Stop

(Alt+F10 is the hotkey.)

3.3.12.3 Play

(Ctrl+F10 is the hotkey.)

3.4 Search

Menu for searching and replacing strings in the editor-window. These functions have also hotkeys.

3.4.1 Find
3.4.2 Replace
3.4.3 Search again
3.4.4 Goto line
3.4.5 Jump to function
3.4.6 Next message
3.4.7 Previous message

3.4.1 Find

Find a string in the current editor-window. You can type the string for searching in an input line and you can also select, if the search is case sensitive or not and to search for whole words only or not.

(Ctrl+Q+F is the hotkey.)

3.4.2 Replace

Find and replace a string in the current editor-window. This works in the same way like searching text, but additionally you can give a string, with which the found text will be replaced.

(Ctrl+Q+A is the hotkey.)

3.4.3 Search again

This function repeats the last search or replace operation.

(Ctrl+L is the hotkey,)

3.4.4 Goto line

After prompting for a line number (with range checking), the cursor will be located at this line.

(Ctrl+J is the hotkey.)

3.4.5 Jump to function

After selecting it you will get a dialog, from where you can select the function to which you want to jump.

(Alt+F2 is the hotkey.)

3.4.6 Next message

This selects the next message in the message window see section 4.8 Message window, but only, if there is a next message available.

(Alt+F8 is the hotkey.)

3.4.7 Previous message

This selects the previous message in the message window see section 4.8 Message window, but only, if there is a previous message available.

(Alt+F7 is the hotkey.)

3.5 Run

In this menu you find the functions for running your program.

3.5.1 Run
3.5.2 Step over
3.5.3 Trace into
3.5.4 Go to cursor
3.5.5 Program reset
3.5.6 Arguments

3.5.1 Run

If your project-target is an executable, this will be run after doing a See section 3.6.2 Make. Ctrl+F9 is the hotkey. If the build was not successful, the program will not be started. The debugging functions are only available if `-g' was used for compiling see section 2.2 Syntax of arguments.

3.5.2 Step over

When using the Shift-key, RHIDE will NOT switch to the user screen when executing the debuggee.

(hotkey F8 or hotkey Shift+F8 may be used.)

3.5.3 Trace into

When using the Shift-key, RHIDE will NOT switch to the user screen when executing the debuggee.

(hotkey F7 or hotkey Shift+F7 may be used.)

3.5.4 Go to cursor

When using the Shift-key, RHIDE will NOT switch to the user screen when executing the debuggee.

(hotkey F4 or hotkey Shift+F4 may be used.)

3.5.5 Program reset

(Ctrl+F2 is the hotkey.)

3.5.5.1 Main function

3.5.5.1 Main function

But you can use this also to debug your program at locations, which are executed normally before main is called (for instance the global constructors).

3.5.6 Arguments

Here you can type the arguments, which will be passed to your program when you do a run see section 3.5.1 Run and see section 2.2 Syntax of arguments.

3.6 Compile menu

Here are the functions to translate your source files and for updating your project.

3.6.1 Compile
3.6.2 Make
3.6.3 Link
3.6.4 Build all

3.6.1 Compile

Compile the file in the current editor-window or the selected entry in the project-window if you are there. The IDE chooses automatically the correct compiler, depending on the suffix of the file see section 2.1 Known suffixes.

(Alt+F9 is the hotkey.)

3.6.2 Make

This makes your project up to date. It works like MAKE on commandline with a makefile. F9 is the hotkey. The dependencies are checked for each item of the project. These dependencies are automatically generated, if you compile a file within the IDE.

3.6.3 Link

This function has two different results depending on the type of your project. If your project is an executable see section 2.1 Known suffixes, the linker is started. But if it is a library, all the object files are taken to build a library.

3.6.4 Build all

This builds the project completely new with compiling and linking all of the project-items.

3.7 Debug

3.7.1 Set/Reset Breakpoint
3.7.2 Evaluate/Modify
3.7.3 Watch an expression
3.7.4 Breakpoints
3.7.5 Disassembler window
3.7.6 Call stack
3.7.7 List of Functions

3.7.1 Set/Reset Breakpoint

(Ctrl+F8 is the hotkey.)

3.7.2 Evaluate/Modify

(Ctrl+F4 is the hotkey.)

3.7.3 Watch an expression

(Ctrl+F7 is the hotkey.)

3.7.4 Breakpoints

3.7.5 Disassembler window

You can step see section 3.5.2 Step over or trace see section 3.5.3 Trace into here in the same way like in an editor window and you can also debug code, which has no debugging information.

Additionally you can scroll here also forwards or backwards but scrolling backwards is very hard to implememnt and so you will get when scrolling backwards most of the time wrong output. Sorry for this, but until I find more time to implement this better you have to live with it.

3.7.6 Call stack

(Ctrl+F3 is the hotkey.)

3.7.7 List of Functions

If you want to get a list of all functions you should enter either nothing (the default), or ".*", or "?*" (both without the double quotes). The expression "*" does NOT mean all function. In fact, your entry will be interpreted as a regular expression.

After you have typed the expression and pressed Enter, you will get a list of functions that match the regular expression and for which debugging information is available.

This list is sorted by the name of the function and has three parts:

NAME | RETURN VALUE | FILE

You can walk through the list with the cursor keys or the mouse. If you hit Enter or double click a function, you will go the the source code of that function.

3.8 Project

Here you can add or remove items to or from your project

3.8.1 Open project
3.8.2 Close project
3.8.3 Add item
3.8.4 Delete item
3.8.5 Local options
3.8.6 Includes
3.8.7 Main targetname
3.8.8 Primary file
3.8.9 Clear dependencies
3.8.10 Delete rebuildable files
3.8.11 Write Makefile

3.8.1 Open project

Here is the point to open a project. After selecting this menu item, the file open dialog is opened to select a project. You can type the name of the project or select one from the list.

If you open a project in another directory than the current, RHIDE will change the current directory to this directory and then the project will be opened.

If you type here a name of a project which does not exist, a new one is created.

If no project was opened and you create a new project, all open desktop files remain open, but they are not added to the project. If a project was opened, it will be automatically closed before the new project is opened.

3.8.2 Close project

This closes the currently opened project and closes all files, which are on the desktop.

3.8.3 Add item

A dialog will be opened, from where you can choose your file to add to your project. If you are in the project window see section 4.4 Project window you can use the Ins key to activate this function within the project window.

Currently it is impossible to use relative or absolute paths as part of a project item. If you have your files in several directories, you have to setup either the search path for source files or you have to create for each directory a library that can be included in your project.

3.8.4 Delete item

This will remove the selected item in the project-window from your project. If you are in the project window see section 4.4 Project window you can use the Del key to activate this function.

3.8.5 Local options

Here you can give the selected project-item options for compiling, which will be in effect only for this item. If you are in the project window see section 4.4 Project window you can use Ctrl+O to activate this function. The options you give here are passed to GCC only, when compiling this file. For more details see see section 4.4.4 Local options for a project item.

3.8.6 Includes

This shows the dependencies for the selected item in the project window. You can use the hotkey Ctrl+I in the project window. see section 4.4 Project window

3.8.7 Main targetname

Here you can change the name of your main target. The main target is either an executable file or a library. RHIDE selects the type of the main target from the suffix of this name. If it has no suffix or the suffix `.exe', an executable will be built. If it has the suffix `.a', a library will be created.

Remember when you give it no suffix, both, the COFF image and the `.exe' file will created. If it has the `.exe' suffix, only the `.exe' file is created.

3.8.8 Primary file

Here you can give the primary source file, when you want to use the 'automake' feature of GPC. If you type a source name here, RHIDE assumes that your program is written in Pascal and does NOT check any dependencies of the project, because this is done automatically by GPC with the `--automake' option.

If you don't want to use the 'automake' feature of GPC, even when building a Pascal program, give here an empty name, which is the default.

3.8.9 Clear dependencies

This function removes all internal stored dependencies. The files are not removed. This is useful when you want to create a makefile see section 3.8.11 Write Makefile and you do not want to include all the absolute filenames for the dependencies (mostly the include files).

This function is a relict from earlier versions of RHIDE, but I have not disabled it.

3.8.10 Delete rebuildable files

This function includes the function of clearing the dependencies see section 3.8.9 Clear dependencies and removes in addition to it all the files, which can be rebuild within RHIDE.

3.8.11 Write Makefile

Here you can create a makefile that contains all the rules to build the project from the command line without starting RHIDE. For this you need the GNU make, because the generated makefile uses the features of GNU make very extensively.

If you have used environment variables in your search paths see section 3.9.1 Directories, these are not expanded in the generated makefile. But all variables you used will be defined at the beginning of the makefile with their current value.

3.9 Options

This menu contains many submenus for anything you can customize.

3.9.1 Directories
3.9.2 C/C++-Compiler
3.9.3 Libraries
3.9.4 Linker options
3.9.5 Compiler options
3.9.6 Environment
3.9.7 Save options
3.9.8 Load options

3.9.1 Directories

Here you can define all of the paths, where RHIDE and the compilers finds the needed files and where to store some files.

All the paths you can define in the several entries have the form of a semicolon separated list of directories, just like your environment variable %PATH%. You can use forward slashes and back slashes, but they are all converted to forward slashes by RHIDE. You can also use environment variables as part of your paths. The syntax of such a variable is that of a GNU makefile. If you want to use the variable `%DJDIR%', you must type `$(DJDIR)'.

3.9.1.1 Include directories
3.9.1.2 Library directories
3.9.1.3 Object directories
3.9.1.4 Sources directories
3.9.1.5 Standard headers

3.9.1.1 Include directories

Place here a list of directories, where gcc (and RHIDE) should search for header files which you use via #include ... and which are not in the default directories (like %DJDIR%/include) If you want to use for instance allegro, put here the directory, where allegro.h is.

This is the list of directories, where GCC looks for include files and RHIDE searches in this directory (after looking in the current directory) for header files.

3.9.1.2 Library directories

This is the list of directories, where GCC looks for libraries when linking. RHIDE searches in this directories (after looking in the current directory) for libraries, if you have included them directly as a project item.

3.9.1.3 Object directories

This is the list of directories where RHIDE looks for object files. If you type here only one directory this has also the effect that the object files, which are compiled, are stored in this directory.

3.9.1.4 Sources directories

This is the list of directories, where RHIDE looks for the source files (after looking in the current directory).

It enables you also one feature (like I use it mostly at any time), to have the sources in one directory tree and the objects and executables in a total different directory. Simply Go to any directory, create there your project and then add the needed files to your project. Finally specify the path to your sources here and RHIDE will find them.

3.9.1.5 Standard headers

3.9.2 C/C++-Compiler

In this submenu you can change most flags, which have to do when compiling C or C++ files or better for the options of all the currently supported compilers.

3.9.2.1 Warnings
3.9.2.2 Optimizations
3.9.2.3 Debugging
3.9.2.4 C options
3.9.2.5 CXX options
3.9.2.6 Pascal options
3.9.2.7 Fortran options
3.9.2.8 How to toggle these flags