1
<chapter id="survey-manual">
2
<title>What This Manual Contains</title>
5
This user manual is intended to describe the contents and use of the &kdevelop; &kdevrelease; Integrated Development Environment (IDE) from a user's point of view. It is not a programming manual, nor does it describe the development process in detail. Its only aim is to guide you in the handling of the IDE.
8
Here you will find information on the following topics:
12
<term><link linkend="getting-started">Getting Started with &kdevelop; — a Guided Tour</link> </term>
14
<para>Gives you a quick start on the use of this &IDE;, introducing the basic steps of how to work on a project.</para></listitem>
18
<term><link linkend="kdevelop-survey">Overview of the Features of
19
&kdevelop;</link></term>
21
<para>Extends the guided tour in the previous chapter, giving an overall
22
view of what is built-in within &kdevelop; and gets you acquainted with the
23
look and feel of this &IDE;.</para>
28
<term><link linkend="setup">Configuring &kdevelop;</link></term>
30
<para>Shows how you can tailor the &IDE; to suit your needs.</para>
35
<term><link linkend="applicationwizard">Getting started: the
36
&appwizard;</link></term>
38
<para>Describes the basics of how to set up a new project in &kdevelop;
39
using the built-in &appwizard;.</para>
44
<term><link linkend="editing">Editing tools</link></term>
46
<para>All you need to write your source files: using the editor, searching
47
for text both locally and project-wide, up to integrating new files and
48
classes into the project.</para>
53
<term><link linkend="file-browsers">The File Browsers</link></term>
55
<para>Demonstrates various tools to look at the structure of your project
56
and how to access the files you want to work with.</para>
61
<term><link linkend="class-browsers">The Class Browsers</link></term>
63
<para>Describes one of the most powerful tools of &kdevelop; which lets you
64
navigate through class dependencies and allows you to easily create and
65
access the classes and methods you need.
71
<term><link linkend="documentation">Documentation</link></term>
73
<para>Shows how to access the rich built-in documentation &kdevelop;
74
provides and tells you how to create documentation of your project, concise
75
and powerful &API; documentation providing you an overall view of all your
76
project sources as well as docbook-based user documentation.</para>
81
<term><link linkend="project-management">Building and Project
82
Management</link></term>
84
<para>Deals with the creation and management of your project; describing the
85
basics of autoconf and automake as well as how to set up custom make files
86
and how to use compiler or make options to tailor your application to suit
92
<term><link linkend="adv-build-management">Advanced Build
93
Management</link></term>
95
<para>Looks at ways to keep multiple build configurations, to cross-compile
96
for diverse platforms, or to make an embedded system using the
97
<application>Qt/embedded</application> library.</para>
102
<term><link linkend="debugger">The Debugger Interface</link></term>
104
<para>Describes how to use the integrated <application>gdb</application>
105
debugger interface so you can hunt down bugs without leaving
110
<!-- ### Currently disabled. Probably too specialized programming stuff. Check later again.
112
<link linkend="python">Python</link> — an overview of how to create Python-based applications in &kdevelop;.
115
<link linkend="php">PHP</link> — an overview of how to create PHP-based HTML applications in &kdevelop;.
116
</para></listitem>//-->
119
<term><link linkend="cvs">Using CVS</link></term>
121
<para>Tells you how you can maintain your project using the CVS versioning
122
system; a must, especially if many developers work on the same
130
<link linkend="kdevelop-scripting">Scripting &kdevelop;</link> — describes how to add scripts to automate &kdevelop;.
135
Some commonly used information has been put into the <emphasis>appendix</emphasis>. Amongst others this consists of:
138
Some commonly used information has been put into the <emphasis>appendix</emphasis>. Amongst others this consists of:
143
<term><link linkend="kdevelop-install">Installing &kdevelop;</link></term>
145
<para>Tells you where to obtain &kdevelop; and how to get it up and
153
<term><link linkend="nutshell">In a Nutshell — Tips and
156
<para>A quick reference to commonly used commands and actions. And a short
157
guide to solve common problems when working with
163
<term><link linkend="unixdev">Development on &UNIX;</link></term>
165
<para>A historical overview of &UNIX; program development, the main tools
166
necessary and why you need an &IDE;.</para>
172
<link linkend="app-menus">Menus and Toolbars Overview</link> — provides you with a short overall view of the menu and toolbar selections available.
176
<link linkend="app-shortcuts">Shortcut Keys</link> — the keys you can use to work with &kdevelop; without resorting to the mouse.
181
<term><link linkend="app-files">Configuration Files Used by
182
&kdevelop;</link></term>
183
<listitem><para>Lists the files &kdevelop; uses to save its internal
184
information. This is particularly useful in case something went wrong with
190
<link linkend="plugin-tools">Plugin Tools</link>
191
</term><listitem><para>Lists the pluggable tools you can use to taylor the capabilities of
192
&kdevelop; to your needs.
193
</para></listitem></varlistentry>
197
<link linkend="plugin-tools">Plugin tools</link> — provides you with an overview of the parts which make up &kdevelop; and how you can tailor it to suit your needs by only loading the parts that are necessary, both IDE and project-wide.
201
<link linkend="app-uimodes-examples">KDevelop User Interface Mode Examples </link>
202
</term><listitem><para>Shows user interface modes.
203
</para></listitem></varlistentry>
206
<link linkend="app-misc-info">Further Information </link> </term><listitem><para>
207
Getting Information, reporting Bugs etc.
208
</para></listitem></varlistentry>
211
<link linkend="app-changelog">Changelog </link>
212
</term><listitem><para>Shows the history of this documentation.
213
</para></listitem></varlistentry>
216
<link linkend="app-bibliography">Bibliography </link>
217
</term><listitem><para>Bibliography
218
</para></listitem></varlistentry>
223
<link linkend="documentation-index">Index </link> —