kdevelop

introduction

kdevelop is an integrated C/C++ development environment. Once one reaches the stage of writing multifile C++ projects, kdevelop has much to offer in the way of support and simplification.

The following notes are incomplete and sketchy because I had already installed a previous version of kdevelop and all of its helping applications on my machine, so most of the pieces were already in place -- which will surely NOT be the case on a fresh Linux installation.

software name and current version

installation notes

First download the latest version of kdevelop:

As root, type

rpm -i kdevelop-1.2-1.i386.rpm

This will install kdevelop into /usr/bin, where it will live alongside hoards of its KDE friends.

Now, from a command prompt (as a user, not as root), type kdevelop

You should see the multipanel kdevelop display. Go to the Help menu to start your exploration.


Appended below are fragmentary notes from my first round with kdevelop. It was one of the first software packages I ever installed, so some better choices may have been available.

kdevelop documentation

Left to its own devices, kdevelop will install its User Manual documentation in /usr/doc/kde/HTML/en and then search for it in /usr/share/doc/HTML/default. I successfully connected the software to its User Manual with the following

cd /usr/doc/kde/HTML/en 
su root
cp -R kdevelop /usr/share/doc/HTML/default 
exit

This made a copy of everything (as a safety precaution). Moving the documentation or making a link to it might be a smarter solution.

That was "Phase One" of linking kdevelop to its User Manual, Programming Manual, etc.

"Phase two" of linking kdevelop to its documentation involves generating documentation for four sets of KDE Libraries.

First download kdelibs-1.1.2.tar.gz from some linux mirror (I chose the "generic" set rather than the Red-Hat sets). Then, in your home directory, do

tar zxvf kdelibs-1.1.2.tar.gz

creating a directory $HOME/kdelibs-1.1.2

For me this was /home/parrish/kdelibs-1.1.2

Now launch kdevelop, select Options:KDevelop Setup:Documentation, and press Update KDE-Documentation, type in the "new KDE Libs sources path:" as, for instance,

/home/parrish/kdelibs-1.1.2

press OK, and kdevelop will use the sources in /home/parrish/kdelibs-1.1.2 to generate loads of gritty documentation and put the new docs in

/home/parrish/.kde/share/apps/kdevelop/KDE-Documentation/

Now go to the kdevelop Help menu and click on any one of the four KDE-xxxx-Library menu items and you can read loads of nifty technical docs.

Actually, the proper way to do this would be for root to install the documentation in something like /usr/share/apps/kdevelop/KDE-Documentation, so all users could share one set of docs.

using kdevelop

Launch kdevelop in your home directory.

kdevelop &

Select "Project:New.." to open the KDE Application Wizard. Choose the "Terminal:C++" project type, from near the bottom of the list of project types. Click "Next." Give your project a name and click away all the check marks in the lower panels, since we want to start with a plain vanilla C++ project. Click "Next," "Next," "Next," "Next" and "Create." You will see the list of commands that are executed in order to create your project. The last entry in that list is "READY." Click "Exit" to exit the wizard. Select "Project:Add existing Files..." and find a simple C++ program, such as "Hello-World!" to add to your project. kdevelop makes a copy of the selected file, places the copy into your project, and displays it in the main kdevelop window. Click on LFV in the left panel of kdevelop to see a view of the files in your project. The file you just added should be under "Sources." Click on the little wheel in the control panel to build your project and execute the resulting object code (or choose "Build" and then choose "Execute" or "Execute with Arguments" in the "Project" menu. If your program generates output, it will automatically appear in a kdevelop window. There is extensive help available under the "Help" menu. If you are new to C/C++ programming, try browsing the "C/C++-Reference" available from the "Help" menu.

In kdevelop's left panel, click on "CV" to see the functions and variables of your program and go to the corresponding code with one click. Click on "LFV" to display your various code, header, and data files. Click on "DOC" to peruse quite a library of associated documentation.

Note that you can add multiple files to a kdevelop project via kdevelop's "Project: Add existing File ..." dialog box. Navigate to the desired directory, hold down the Control key and click on the desired files to add several selections at a time to the current project.

To print a code file, choose "Print" from the "File" menu. kdevelop lets you choose a program (a2ps, enscript, or lpr) to create the image of the page, and will let you preview the result before printing. Nice!

using glimpse within kdevelop

Glimpse is a marvelous indexing utility which will work well with kdevelop. As a test, open some document and select a fairly generic word, such as "kdevelop" and then choose "Search Selected Word" from the kdevelop Help menu. You should get a list of all the places in whiich that word occurs in all of your documentation - then you can click on an entry in that list and go to that reference. Neat!


cparrish@sewanee.edu