# 5.4. Menubar Commands

## 5.4.1. File Management and Printing

This section covers the functions that KDevelop provides about files; accessed via the File-menu in the menubar or by the according icons in the toolbar:

- New Ctrl+N Opens the "New File " dialog, allowing to create a new file. The file can be created using different templates and the filename has to be given as well as the path where the file will be created.

- Open Ctrl+O displays the "Open File..." dialog and lets you choose a file to be opened.

- Close Ctrl+W Closes the file in the top editing window

- Save Ctrl+S Saves the file opened in the top editing window. If the file has not been saved yet, the "Save File As..." dialog will be opened to let you choose a path and filename for the file to be saved.

- Save As... Opens the "Save File As..." dialog to let you save the current file under a new filename

- Save All Saves all changed files

- Print... Ctrl+P Opens the "Print File" dialog where you can set various options for printing either using enscript or lpr

- Quit Ctrl+Q Exits KDevelop. If files are changed, you will be asked if you want to save these files.

## 5.4.2. Editing Files

Here, the "Edit" menu and the according icons in the toolbar are covered which provide editing files. Also the editing functions are available via a context-menu in the editor .

- Undo Ctrl+Z Reverts the last editing operation

- Redo Ctrl+Y lets you do the last undo step again

- Cut Ctrl+X cuts out a selection and copies it to the system clipboard.

- Copy Ctrl+C copies a selection to the system clipboard. This also counts for selections made in the documentation browser.

- Paste Ctrl+V inserts the clipboard contents at the current cursor position.

- Indent Ctrl+I Indent moves a selection to the right

- UnIndent Ctrl+U UnIndent moves a selection to the left

- Insert File...Ctrl+Insert Lets you select a file and inserts its contents at the current cursor position

- Search... Ctrl+FOpens the Search dialog that looks for an expression in the current file. For a search across several files, "Search in files..." should be used.

- Repeat Search F3 Repeats the last search for an expression. This also counts for searches that were made across the documentation, where more than one hit was found in the same page. The next hit will be displayed by choosing "Repeat Search" or F3 and signed as marked.

- Replace... Ctrl+R Opens the "Search and Replace" dialog that allows the search for an expression and replaces the found text with a new expression.

- Search in files... Ctrl+Alt+FDisplays the "Search in files..." dialog, that handles `grep` on whole directories with wildcards. Search results are displayed with a list of the filenames, line and expression. Choosing an entry will open the file and the cursor is set to the line of the search result

- Select All Ctrl+A Selects the whole text of the file currently opened in the top editing window

- Deselect All Deselects the whole text of the current file. This is often used for multiple selections so you don't have to deselect each one separately

- Invert Selection Inverts the selection, meaning that a selection becomes deselected and text which is not selected becomes selected.

## 5.4.3. View Configuration

The View-Menu covers closing and opening functions for windows and commands to enable/disable the tool- and statusbar as well as to jump errors in the code.

- Goto Line... Ctrl+GOpens a "Go to Line..." dialog that lets you insert a linenumber to show in the actual file. The last linenumber is remembered and marked, so you can either jump to that line again or just enter a new linenumber you want to see.

- Next Error F4Jumps to the next error KDevelop detects from the output . The output message of Make or other tools should give you a descriptive help what the problem is, so you can correct the error.

- Previous Error Shift+F4 Jumps to the previous error that was reported.

- Dialogeditor Ctrl+D Switches to the dialog editor

- Tree-View Ctrl+T en/disables the Tree window on the left side of the main view containing the Class Browser, LFV , RFV and DOC -tree.

- Output-View Ctrl+B en/disables the Output window on the bottom of the main view.

- Toolbar en/disables the toolbar.

- Browser-Toolbar en/disables the browser toolbar, containing the back, forward and search buttons for the browser

- Refresh rescans all files to rebuild the Class Browser. The scanning progress is shown in the statusbar progress display.

## 5.4.4. Creating and Maintaining Projects

This section describes functions that are available in the "Project"-menu and are supposed to cover the creation and maintaining of projects

- New... Starts the KAppWizard and allows you to create a new project by choosing application type, name, version and other options.

- Open Shows the Open Project dialog, where you can choose a KDevelop project file to be opened. After selection, the project will be loaded.

- Open recent project... contains a submenu with the last 5 opened projects. You can open a project more easily using the recent project menu.

- CloseCloses the current project. This is mostly done automatically when you quit KDevelop, invoke the KAppWizard or open another project.

- New Class ...Starts the class generator to create a new class that will be added to the current project. The class generator lets you specify classname, inheritance and filenames for the new class.

- Add existing File(s) Opens a selection dialog where you can choose the files that you want to add to the current project and the path where they will be copied to. If you choose a destination that was currently not included in the project, e.g. creating a new subdirectory, KDevelop will copy the files to add to the new subdirectory and create a new Makefile.am . After the copy process, your project will be rebuild by automake and autoconf to include the new subdirectory into the make-process.

- Add new translation file Opens a language selection dialog that lets you choose the translation file language that will be added to the project. This is mostly used by translators who can easily add their language to the project and work on the translation without having to care about the Makefile.am 's

- File Properties Shift+F7 Opens the File Properties dialog showing a copy of the LFV and the project file options. Here, the properties for your files have to be set like installation path and file type.

- Make messages and merge This is intended to create the messages file for your project. The message file is the one containing all strings that are set up in the sources for internationalization and is used by translators to create the .po file for their target language.

- Make API -Doc Calls KDoc on your header files and generates a HTML output with the documentation of your project classes .

- Make User-Manual runs KSgml2Html on your manual SGML file, creating a HTML user manual. If KSgml2Html is not installed, sgml2html will be used to do this.

- Make Distribution:

  - tar.gz creates a distribution file of your current project in the project directory that is ready to ship to the end-users containing the sources of your project. The end-user has to `tar zxvf yourproject.tar.gz` to unpack it to a source directory and use the standard commands `./configure, make` and `make install`.

- Options F7 Opens the Project Options dialog that lets you change various settings for your project. This could be a new version number or the compiler options to set to -02 for a release with optimization.

## 5.4.5. Building Projects

This section describes the Build menu that covers all actions to be done with make or actions like rebuilding the project's online help or API documentation.

- Compile file... Ctrl+F8Active, if the top editing window is the C++ Window. This only compiles the current implementation file and lets you save time in case you suspect errors .

- Make F8 Invokes the make-command to your project and builds the target.

- Rebuild All Rebuilds all object files and the target of you project.

- Clean Rebuild All Cleans the project directory from all make-created files and rebuilds the target.

- Stop Build F10 Stops the current process.

- Execute F9 Executes your target after building the program with make.

- Execute with Arguments Alt+F9 Executes your target with arguments. First, a dialog appears to let you specify the execution arguments (which are saved in the project for the next session), then your application uses the entered commandline. Mind that your application program is started from the project directory directly

- Debug... Opens KDbg in the Tools -Window to debug your application. In this case, KDbg automatically opens the file containing the main() function and executes your application.

- Distclean Removes all files that are generated by the project like object files etc. Distclean has to be done before distributing your project, so the distribution file doesn't contain any platform-specific files like those that were generated by your Compiler .

- Autoconf and automake Calls Make on the file Makefile.dist , located in your main project directory. Makefile.dist contains all commands for automake , autoconf etc. to build your project. If you added files manually or changed macros yourself, you should run Autoconf afterwards, followed by Configure to recreate all Makefile s.

- Configure Executes the configure-script generated by autoconf . If this command cannot be executed, run Autoconf and then Configure again.

## 5.4.6. Calling Tools

The Tools -menu contains by default the entries for the following programs if installed: KDbg , KIconEdit and KTranslator . These are checked by the KDevelop installation program and inserted in the given order into the menu. Invoking a tool will open the "Tools "-window and start the selected program inside this window. The Tools menu can be edited by the Tools -entry in the Options-menu; see \|\|Tools " Menu" name="Configuring the "Tools " Menu">.

## 5.4.7. Changing KDevelop's settings

The Options-menu contains all entries for invoking configuration dialog s with which you can change KDevelop's default settings. Major settings like those for the editor or printing have their own entries; general settings of KDevelop's behavior can be made with the KDevelop Setup dialog.

- Editor... Allows the configuration of the editor's behavior like word-breaking, selections etc.

- Editor Colors... Here, you can set the color-configuration of the editor like e.g. the background.

- Editor Defaults... This sets the default display like font and fontsize for the editor

- Syntax-Highlighting This dialog lets you configure the fonts and colors for the highlighting of several programming languages, including HTML .

- Documentation Browser In this tab-dialog, you can set the fonts, sizes and colors for the internal Helpbrowser

- Configure Printer... Contains the entries for the printer configuration dialog s.

  - enscript Configures the printer for use with enscript . See Printing for more information.

- Tools ... Opens the Configure Tools dialog. Here, you can configure the "Tools " menu by adding or removing programs that will be started in the Tools -window.

- KDevelop Setup Opens the KDevelop Setup dialog. The first tabulator configures general settings, followed by the key-configuration and the Documentation settings. The Documentation settings also include the generation of a new set of HTML -library documentation and the rebuilding of the search index for the Helpbrowser .

## 5.4.8. The Window Menu

The Window menu contains a list with all currently open files. This allows a quick switch to another file you're currently working on.

## 5.4.9. Managing Bookmarks

The Bookmarks menu is intended for adding and removing bookmarks you want to set in the current editing file. As KDevelop uses two editing windows, each one configures it's bookmarks separately.

- Set Bookmark Opens a context-menu with up to nine configurable bookmarks . This allows setting a bookmark to a certain entry in the bookmarks menu by logical reasons.

- Add Bookmark Ctrl+Alt+A Adds the line of the current cursor position to the bookmarks menu as a bookmark. Mind that this could overwrite a bookmark set with the Set Bookmark-option. If the browser is opened, a bookmark will be added to the Browser-Window bookmarks menu.

- Clear Bookmarks Ctrl+Alt+C Clears the bookmark-entries for the top editing window or the browser, e.g. if the Header-Window is visible and you call Clear Bookmarks, the entries for the Header-Window are deleted.

- Header-Window Contains the bookmark-list for the Header-Window. Selecting a bookmark will set the cursor to the selected bookmarks ' line. Mind that bookmarks are only assigned to the file they are set to, so if you change to another file, the bookmarks are not deleted but choosing a bookmark won't change to the file they are assigned to as well.

- C/C++-Window Contains the bookmark-list for the C/C++-Window. The preferences are the same as for the Header-Window.

- Browser Window Contains the browser bookmarks . Selecting a bookmark will open the browser with the selected page.

## 5.4.10. Online Help

The Help-menu contains entries for navigating in the Helpbrowser as well as entries for library and online-documentation for the most recently used cases. Accessing additional online-documentation can be achieved with the DOC -tree in the treeview automatically opened (if Autoswitch is enabled) when changing to the Documentation Browser window.

- Back Alt+ Left Arrow Opens the page opened before the actual one.

- Forward Alt+ Right Arrow Opens the next page of the browser-history, available after a "Back"-action.

- Search Marked Text F2 Scans the search-index for text currently marked in the editing windows or the browser-window. After the search, a result page is shown which lets you select the help-page to switch to. After choosing a page, the browser will highlight the found entry for the expression the search was invoked for. With the F3 key the next search result on the same page will be displayed if more than one hit was reported for the search on one page.

- Search for Help on... Opens the Search for Help on... dialog that lets you search for a specific expression you want help on.

- The User Manual to KDevelop F1 Opens the User's Manual to KDevelop index page (this handbook).

- The KDevelop Programming Handbook Opens the KDevelop Programming Handbook index page. This handbook contains a complete programming guide to KDE development.

- KDE Application Tutorials Changes to the index page of the KDE Application Tutorials handbook. This handbook explains how to build the Qt tutorial applications and introduces you to KDE programming by developing an example application.

- The KDE Library Reference Guide Changes to the index page of the KDE Library Reference Guide. This handbook contains detailed information about using the KDE/Qt libraries separated on topics such as event handling.

- The KDE 2 Developer´s Guide Changes to the index page of the KDE 2 Developer´s Guide. This Handbook contains information about the most recent KDE development and how to prepare your application to be KDE 2-ready.

- C/C++ Reference Displays the language reference index page. If the reference is not installed, an error page shows you how to get the reference and how to install it correctly.

- Tip of the Day Opens the Tip of the Day dialog to inform you about KDevelop's features.

- KDevelop Homepage Opens the KDevelop Homepage in the browser window if Internet access is provided.

- Bug Report ... Opens the KDevelop Bug Report dialog, where you can send a bug-report directly to the KDevelop Team by email. See Bug Reporting

- Project-API-Doc Changes to the project's class-documentation index file.

- Project-User-Manual Opens the User manual's index file of your current project. This can be used to review the HTML -output generated by KSgml2Html

- About KDevelop... Shows the aboutbox of KDevelop containing the used version number and the authors' names and email-addresses as well as reference to the licensing of KDevelop.