Volker
Paul
2006-02-22

# Command Reference

The shortcut key combinations shown in this chapter are the default ones. They can be changed.

## The Menubar

Note that some menu entries only appear when they are applicable. Especially, some entries are linked to plugin functionality which is only available when the plugin is enabled.

### The File Menu

&Ctrl;N File New

  Creates a new file. The user is prompted to select the directory (default: the current project's source directory) and enter a file name. The file type can be selected from a list. Also, the user can choose whether the file is to be added to the project. Then the Automake Manager asks which target to add the new file to.

&Ctrl;O File Open

  Opens an existing file in a simple dialog box.

File Open Recent

  For opening the most recently edited files. Once you have clicked on this option, a list of recently edited files will appear. Select the file you want and KWord will open the file.

&Alt;&Ctrl;O File Quick Open File

  Presents a list of files in the current project's source directory. The user can select from this list or type a filename. That file is then opened.

&Ctrl;S File Save

  Saves the current file.

File Save As...

  Uses the Save As... dialog box to let you save a copy under a new name.

File Save All

  Saves all open files.

F5 File Reload

  Reloads current file to show changes made by different programs. (Note that such changes are normally detected automatically and the user is prompted whether the file is to be reloaded.) .

File Revert all

  Reverts all changes in opened files. Prompts to save changes so the reversion can be canceled for each modified file.

&Ctrl;P File Print...

  Prints the current file.

File Export

  Exports the current file. Currently the following export formats are supported:

  HTML

    Syntax-highlighted HTML file

  Other formats may follow in future KDevelop versions.

&Ctrl;F4 File Close

  Closes current file.

File Close All

  Closes all open files.

File Close All Others

  Closes all files except the current one. Very useful if you opened a lot of files and you want to concentrate on the current one. Without this, you would have to close them all and re-open the current one.

  Note there is a similar command in the Window menu.

&Ctrl;Q File Quit

  Quits KDevelop.

### The Edit Menu

Most of the following commands operate on the current file, also simply called "document".

&Ctrl;Z Edit Undo

  Reverses the last action you performed.

&Ctrl;&Shift;Z Edit Redo

  Reverses the last Undo performed.

&Ctrl;X Edit Cut

  Deletes the selected (highlighted) text from the document, and places a copy in the clipboard.

&Ctrl;C Edit Copy

  Places a copy of the selected text in the clipboard.

&Ctrl;V Edit Paste

  Inserts a copy of the clipboard into the current cursor position. If there is selected text, KDevelop replaces it with the contents of the clipboard. The clipboard is not altered.

&Ctrl;A Edit Select All

  Immediately selects all text of the current file.

&Ctrl;&Shift;A Edit Deselect

  Every simple cursor movement (e.g. left, right etc. without Shift pressed) deselects at the same time, i.e. if there was highlighted text before, after the cursor action it will appear non-highlighted again. This command does an explicit Deselect without cursor action.

&Ctrl;&Shift;B Edit Block Selection Mode

  KDevelop's editor can operate linewise or block-oriented. Linewise means: Text is seen as a sequence of characters that may span several lines. A selection ranges from the first to the last character and includes all lines in-between completely.

  Block-oriented means: Text is seen as a rectangular matrix. You can select a rectangular block (called rectangle in (X)Emacs) that leaves out the beginnings and ends of all lines. The commands Cut and Copy then operate only on that block, and place it in the clipboard.

  Thus you can e.g. indent all lines of a block: Select the block, Cut it, then place the cursor in the first line at the beginning of the area you want to put the block, e.g. 3 characters to the right of the old position. There, Paste it, and all lines will be indented.

  This would be very useful if it honored the overwrite flag (e.g. block comment). It doesn't, and I see this as a bug. TODO: - report bug - work out more examples how block mode is useful (extra chapter?) - links to alternate methods (for indent: Edit - Reformat Source, comment)

Insert Edit Overwrite Mode

  Toggles Insert/Overwrite Mode.

&Ctrl;F Edit Find

  Calls the Find dialog box. You can search simple text or a regular expression.

F3 Edit Find Next

  After first using Find (see above), finds the same text or regular expression again.

&Shift;F3 Edit Find Previous

  After first using Find (see above), finds the same text or regular expression again, searching upwards.

&Ctrl;R Edit Replace

  Opens the Find/Replace dialog box. You can search simple text or a regular expression. You can replace by simple text or placeholders of the regular expression.

&Ctrl;G Edit Go to Line

  Prompts for a line number and jumps to that line. You can show/hide line numbers with View - Show/Hide Line Numbers (F11).

&Alt;&Ctrl;F Edit Find in Files

  Finds text in several Files, like the grep Unix command. Matches will be displayed, and you can switch to a match directly. TODO!!!

&Ctrl;&Shift;R Edit Find-Select-Replace

  Opens the project wide string replacement dialog. There you can enter a string or a regular expression which is then searched for within all files in the locations you specify. Matches will be displayed in the Replace window, you can replace them with the specified string, exclude them from replace operation or cancel the whole replace.

Edit Reformat Source

  Reformats Source code using the astyle library. If there is a selection, only the selection will be formatted. Otherwise the entire file will be formatted.

&Ctrl;J Edit Expand Text

  A list of reasonable completions of the current word is presented, the user can select one of them, and this is then placed in the text. For example, if the user has typed "whi" and calls this command, "while" and "while ( ) { }" are offered. If the user selects the latter, the whole structure of a while command is entered and the cursor is placed in the brackets to enter the condition. TODO: BUG: Ctrl-J doesn't work

&Ctrl;L Edit Expand Abbreviation

  Expands abbreviation. Abbreviations can be defined in Settings - Configure KDevelop - Abbreviations.

&Ctrl;Space Edit Complete Text

  Completes current expression using memory class store for the current project and persistent class stores for external libraries. TODO

F2 Edit Make Member

  Creates a class member function in implementation file based on the member declaration at the current line. TODO

### The View Menu

View Back

  Moves back in the list of tabs.

View Forward

  Moves forward in the list of tabs.

&Ctrl;/ View Switch to...

  Presents a dialog box to select a tab buffer an moves there.

&Alt;C View Raise Editor

  Places the focus on the editor.

F4 View Next Error

  Switches to the file and line the next (compilation) error was reported from.

&Shift;F4 View Previous Error

  Switches to the file and line the previous (compilation) error was reported from.

&Shift;F View Full Screen Mode

  In normal mode: Switches to Full Screen Mode. Only KDevelop's window will be shown, without the frame.

  In Full Screen Mode: Switches back to normal mode. Other windows will be visible again, KDevelop's window gets its frame again.

&Ctrl;F12 View Switch Header/Implementation

  When in a C++ implementation file, switches to the corresponding header file, and vice versa.

View Tool Views

  Puts the focus on one of KDevelop's various tools resp. its output. Switch back to the editor with the View - Raise editor command above.

View Tool Docks

  KDevelop's GUI has a Top, Bottom, Left and Right Tool Dock. With this command, you can select and switch to any of them.

F7 View Switch to Command Line

  KDevelop uses Katepart as editor. Katepart has a command line to enter editing commands directly. This menu item switches to the Katepart Command Line. For a list of available editing commands, enter ``help` `list`` here.

View Schema

  Schema TODO ???

F10 View Dynamic Word Wrap

  Switches Dynamic Word Wrap on and off. If it is on, then lines that don't fit on the screen will be broken and continued on the next line.

View Dynamic Word Wrap Indicators

  Selects Dynamic Word Wrap Indicators option:

  Off

    Indicators (folded arrows in the line number border) are not displayed

  Follow line numbers

    If line numbers (see command below) are displayed (in the line number border), then Dynamic Word Wrap Indicators are displayed as well

  Always On

    Dynamic Word Wrap Indicators are always displayed, which causes the border to be present

View Show/Hide Static Word Wrap Marker

  Shows/Hides the Static Word Wrap Marker, a vertical line drawn at the word wrap column as defined in Settings - Configure Editor - Editing - Static Word Wrap. (TODO: Bug: the line is not shown. Static word wrap works for newly changed lines)

F6 View Show/Hide Icon Border

  Shows/Hides the Icon Border which is used to show e.g. bookmark and breakpoint symbols.

F11 View Show/Hide Line Numbers

  Show/Hide Line Numbers on the left side, in the line number border. This may also cause dynamic word wrap markers to be displayed, see above.

View Show/Hide Scrollbar Marks

  Show/Hide Scrollbar Marks. TODO: No effect, bug?

F9 View Show/Hide Folding Marks

  Shows/Hides Folding Marks in the left border. Note that code folding (see below) can be used even if the marks are not shown.

View Code Folding

  Code folding is used to easily gain an overview of the code by collapsing blocks so they are shown as just the top line. The commands in this submenu collapse or expand the local or top level.

  &Ctrl;&Shift;- Collapse Toplevel

    Collapses toplevel.

  &Ctrl;&Shift;+ Expand Toplevel

    Expands toplevel.

  &Ctrl;- Collapse One Local Level

    Collapses innermost local level.

  &Ctrl;+ Expand One Local Level

    Expands innermost local level.

View Set Encoding

  In former KDevelop versions the Set Encoding function now in the Tools menu used to be here.

### The Project Menu

Project New Project...

  This starts KDevelop's application wizard. It helps you to generate a skeleton for your application from a set of templates.

Project Open Project...

  Opens a Kdevelop2 or KDevelop3 project.

Project Open Recent Project

  Opens recently edited project. A submenu of recently edited projects is displayed to choose from.

Project Import existing Project...

  Creates a KDevelop project file for a given directory, where already existing code files of a non-KDevelop project are stored.

Project New Class...

  Calls the New Class wizard.

Project Class Inheritance Diagram

  Displays inheritance relationship between classes in the project.

  This does not display classes outside inheritance hierarchy.

Project Add Translation...

  Prompts the user for a language and creates .po file for the selected language.

Project Build Configuration

  ???TODO

Project Distribution & Publishing

  Opens the Project Distribution & Publishing dialog which helps users package and publish their software. TODO:link

Project Project Options...

  Opens dialog to set project options.

Project Close Project

  Closes current project.

### The Build Menu

F8 Build Build Project

  Runs make from the project directory.

F7 Build Build Active Target

  Constructs a series of make commands to build an active target. Also builds dependent targets.

Build Compile File

  Runs make filename.o from the directory where filename is the name of the currently opened file. TODO better formulation

Build Run Configure

  Run Configure

Build Run automake & friends

  Executes

  > 1. `make` `-f` Makefile.cvs

  > 2. `./configure`

  commands from the project directory.
Build Install

  Runs `make install` command from the project directory.

Build Install (as root user)

  Asks the user for the root password using kdesu and then runs `make install` as root user.

Build Clean project

  Runs `make clean` command from the project directory.

Build Distclean

  Runs `make distclean` command from the project directory.

&Shift;F9 Build Make Messages & Merge

  Runs `make packages-messages` command from the project directory.

Build Execute Program

  Executes program specified in project settings, Run Options tab. If it is not specified there then the active target is used to determine the application to run.

Build Build API Documentation

  Runs doxygen on a project Doxyfile to generate API documentation. If the search engine is enabled in Doxyfile, this also runs doxytag to create it.

Build Clean API Documentation

  Removes all files generated by doxygen.

Escape Build Stop

  Stop application started with the Execute menuitem above, and all running processes started by KDevelop like building process, grep command etc.

  On the toolbar, this action provides a popup menu to choose a process to stop.

### The Debug Menu

Debug Start

  Start

Debug Stop

  Stop

Debug Interrupt

  Interrupt

Debug Run to Cursor

  Run to Cursor

Debug Step Over

  Step Over

Debug Step over Instruction

  Step over Instruction

Debug Step Into

  Step Into

Debug Step into Instruction

  Step into Instruction

Debug Step Out

  Step Out

Debug Toggle Breakpoint

  Toggle Breakpoint

Debug Viewers

  Viewers

Debug Examine Core File...

  Examine Core File...

Debug Attach to Process

  Attach to Process

Debug Valgrind Memory Leak Check

  Valgrind Memory Leak Check

Debug Profile with KCachegrind

  Profile with KCachegrind

### The Bookmarks Menu

&Ctrl;B Bookmarks Set Bookmark

  Add current selection to your bookmarks.

Bookmarks Clear All Bookmarks

  Clear All Bookmarks.

### The Window Menu

&Alt;W Window Close Selected Windows...

  Close Selected Windows...

&Ctrl;F4 Window Close

  Close

Window Close All

  Close All

Window Close All Others

  Close All Others

### The Tools Menu

Tools Read Only Mode

  Read Only Mode

Tools Filetype Mode

  Filetype Mode

Tools Highlight Mode

  Highlight Mode

Tools Set Encoding

  Set Encoding (former View menu?))

Tools End of Line

  End of Line

Tools Spelling

  Spelling

&Ctrl;I Tools Indent

  Indent

&Ctrl;&Shift;I Tools unindent

  unindent

Tools Clean Indentation

  Clean Indentation

&Ctrl;Tab Tools Align

  Align

&Ctrl;D Tools Comment

  Comment

&Ctrl;&Shift;D Tools Uncomment

  Uncomment

&Ctrl;U Tools Uppercase

  Uppercase

&Ctrl;&Shift;U Tools Lowercase

  Lowercase

&Alt;&Ctrl;U Tools Capitalize

  Capitalize

&Ctrl;J Tools Join Lines

  Join Lines

Tools Word Wrap Document

  Word Wrap Document

Tools Difference Viewer...

  Difference Viewer...

Tools Execute Command...

  Execute Command...

Tools Filter Selection Through Command...

  Filters selection through external command using the Filter plugin.

Tools Debug Regular Expression...

  Debug Regular Expression...

Tools Part Explorer

  Part Explorer

&Alt;&Ctrl;C Tools Quick Open Class...

  Quick Open Class...

&Alt;&Ctrl;M Tools Quick Open Method...

  Quick Open Method...

&Alt;&Ctrl;P Tools Preview Doxygen Output

  Preview Doxygen Output

&Ctrl;&Shift;S Tools Document Current Function

  Document Current Function

### The Settings Menu

&Ctrl;M Settings Show/Hide Menubar

  Show/Hide the menubar.

Settings Toolbars

  Opens a sub menu where you can choose to show or hide the various Toolbars.

Settings Show Statusbar

  Show the Statusbar.

Settings Configure Shortcuts...

  Configure Shortcuts...

Settings Configure Toolbar...

  Configure Toolbar...

Settings Configure Notifications...

  Configure Notifications...

Settings Configure Editor...

  Configure Editor...

Settings Configure KDevelop...

  Configure KDevelop...

### The Help Menu

Help KDevelop Handbook

  View this document.

&Shift;F1 Help What's This?

  Draws a question mark (?) beside the mouse pointer, clicking on a window item such as the Stop button will then display a brief explanation.

Help Tip of the Day

  Tip of the Day

&Alt;&Ctrl;I Help Look in Documentation Index...

  Look in Documentation Index...

&Alt;&Ctrl;S Help Search in Documentation...

  Search in Documentation...

Help Man Page...

  Man Page...

Help Info Page...

  Info Page...

Help Report Bug...

  Report bug.

Help About KDevelop...

  Display some brief information about KDevelop's version number, authors and license agreement.

Help About KDE...

  Show some information about the version of &kde; that you are running.