docs.kde.org
Command Reference
Prev
Next

Appendix G. Command Reference

Volker Paul

Table of Contents

The Menubar
The File Menu
The Edit Menu
The View Menu
The Project Menu
The Build Menu
The Debug Menu
The Bookmarks Menu
The Window Menu
The Tools Menu
The Settings Menu
The Help Menu

Note

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

File->New (Ctrl+N)

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.

File->Open (Ctrl+O)

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.

File->Quick Open File (Alt+Ctrl+O)

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.

File->Save (Ctrl+S)

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.

File->Reload (F5)

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.

File->Print... (Ctrl+P)

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.

File->Close (Ctrl+F4)

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.

File->Quit (Ctrl+Q)

Quits KDevelop.

The Edit Menu

Note

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

Edit->Undo (Ctrl+Z)

Reverses the last action you performed.

Edit->Redo (Ctrl+Shift+Z)

Reverses the last Undo performed.

Edit->Cut (Ctrl+X)

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

Edit->Copy (Ctrl+C)

Places a copy of the selected text in the clipboard.

Edit->Paste (Ctrl+V)

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.

Edit->Select All (Ctrl+A)

Immediately selects all text of the current file.

Edit->Deselect (Ctrl+Shift+A)

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.

Edit->Block Selection Mode (Ctrl+Shift+B)

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)

Edit->Overwrite Mode (Insert)

Toggles Insert/Overwrite Mode.

Edit->Find (Ctrl+F)

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

Edit->Find Next (F3)

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

Edit->Find Previous (Shift+F3)

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

Edit->Replace (Ctrl+R)

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.

Edit->Go to Line (Ctrl+G)

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

Edit->Find in Files (Alt+Ctrl+F)

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

Edit->Find-Select-Replace (Ctrl+Shift+R)

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.

Edit->Expand Text (Ctrl+J)

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

Edit->Expand Abbreviation (Ctrl+L)

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

Edit->Complete Text (Ctrl+Space)

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

Edit->Make Member (F2)

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.

View->Switch to... (Ctrl+/)

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

View->Raise Editor (Alt+C)

Places the focus on the editor.

View->Next Error (F4)

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

View->Previous Error (Shift+F4)

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

View->Full Screen Mode (Shift+F)

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.

View->Switch Header/Implementation (Ctrl+F12)

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.

View->Switch to Command Line (F7)

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 ???

View->Dynamic Word Wrap (F10)

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)

View->Show/Hide Icon Border (F6)

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

View->Show/Hide Line Numbers (F11)

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?

View->Show/Hide Folding Marks (F9)

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.

Collapse Toplevel (Ctrl+Shift+-)

Collapses toplevel.

Expand Toplevel (Ctrl+Shift++)

Expands toplevel.

Collapse One Local Level (Ctrl+-)

Collapses innermost local level.

Expand One Local Level (Ctrl++)

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 projectj 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.

Note

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

Build->Build Project (F8)

Runs make from the project directory.

Build->Build Active Target (F7)

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.

Build->Make Messages & Merge (Shift+F9)

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.

Build->Stop (Escape)

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

Bookmarks->Set Bookmark (Ctrl+B)

Add current selection to your bookmarks.

Bookmarks->Clear All Bookmarks

Clear All Bookmarks.

The Window Menu

Window->Close Selected Windows... (Alt+W)

Close Selected Windows...

Window->Close (Ctrl+F4)

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

Tools->Indent (Ctrl+I)

Indent

Tools->unindent (Ctrl+Shift+I)

unindent

Tools->Clean Indentation

Clean Indentation

Tools->Align (Ctrl+Tab)

Align

Tools->Comment (Ctrl+D)

Comment

Tools->Uncomment (Ctrl+Shift+D)

Uncomment

Tools->Uppercase (Ctrl+U)

Uppercase

Tools->Lowercase (Ctrl+Shift+U)

Lowercase

Tools->Capitalize (Alt+Ctrl+U)

Capitalize

Tools->Join Lines (Ctrl+J)

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

Tools->Quick Open Class... (Alt+Ctrl+C)

Quick Open Class...

Tools->Quick Open Method... (Alt+Ctrl+M)

Quick Open Method...

Tools->Preview Doxygen Output (Alt+Ctrl+P)

Preview Doxygen Output

Tools->Document Current Function (Ctrl+Shift+S)

Document Current Function

The Settings Menu

Settings->Show/Hide Menubar (Ctrl+M)

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.

Help->What's This? (Shift+F1)

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

Help->Look in Documentation Index... (Alt+Ctrl+I)

Look in Documentation Index...

Help->Search in Documentation... (Alt+Ctrl+S)

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.

Prev
Next
Home


docs.kde.org