@ -184,7 +184,7 @@ Compiler plugins must implement KDevCompilerOptions interface.
In the end you should add the language you implemented to the doc/api/LangSupportStatus.dox file and
In the end you should add the language you implemented to the doc/api/LangSupportStatus.dox file and
document your language support part in the way described at \ref howToDocument (doc/api/HowToDocument.dox file).
document your language support part in the way described at \ref howToDocument (doc/api/HowToDocument.dox file).
See also \ref howToAddPlugins (doc/api/HowToAddPlugins.dox file) for an information on how to create a generic KDevelop plugin and how to manage project and global configuration information.
See also \ref howToAddPlugins (doc/api/HowToAddPlugins.dox file) for an information on how to create a generic TDevelop plugin and how to manage project and global configuration information.
@ -22,34 +22,34 @@ This document is targeted at all those that want to build their own IDE or impro
If you are instead looking for a user manual, just go to the help menu of your KDevelop and select KDevelop handbook.
If you are instead looking for a user manual, just go to the help menu of your KDevelop and select KDevelop handbook.
This documentation contains the KDevelop Platform online class reference for the current
This documentation contains the KDevelop Platform online class reference for the current
development version of KDevelop. Additionally, you
development version of KDevelop. Additionally, you
can subscribe or read the <a href="http://www.tdevelop.org/index.html?filename=mailinglist.html">mailing list</a> for any additions and/or
can subscribe or read the <a href="http://www.kdevelop.org/index.html?filename=mailinglist.html">mailing list</a> for any additions and/or
modifications to the Platform %API.
modifications to the Platform %API.
An on-line, updated every 24H, html version of this documentation can be found at: http://www.tdevelop.org/HEAD/doc/platform/html/index.html
An on-line, updated every 24H, html version of this documentation can be found at: http://www.kdevelop.org/HEAD/doc/platform/html/index.html
You can also download a local browseable copy form http://www.tdevelop.org/HEAD/doc/platform/kdevplatformdoc.tar.bz2 . It gets updated every single day too.
You can also download a local browseable copy form http://www.kdevelop.org/HEAD/doc/platform/kdevplatformdoc.tar.bz2 . It gets updated every single day too.
More information about the KDevelop Platform architecture in form of tutorials, Wikis, HOWTOs,
More information about the KDevelop Platform architecture in form of tutorials, Wikis, HOWTOs,
and FAQs can be found at
and FAQs can be found at
the <a href="http://www.tdevelop.org">KDevelop website</a>.
the <a href="http://www.kdevelop.org">KDevelop website</a>.
Quick overviews of the architecture can also be found in the issues of <a href="http://www.tdevelop.org/doc/tehcnotes">
Quick overviews of the architecture can also be found in the issues of <a href="http://www.kdevelop.org/doc/tehcnotes">
@ -126,7 +126,7 @@ One of these four alternatives must be chosen when you create a project and <emp
There are several tutorials available on the &GNU; Build System (<command>Autoconf</command>, <command>Automake</command> and <command>Libtool</command>) of which the &automanag; makes use.
There are several tutorials available on the &GNU; Build System (<command>Autoconf</command>, <command>Automake</command> and <command>Libtool</command>) of which the &automanag; makes use.
</para>
</para>
<itemizedlist>
<itemizedlist>
<listitem><para>A short <ulink url="http://www.tdevelop.org/index.html?filename=tutorial_autoconf.html">autoconf tutorial</ulink> written by Christopher W. Curtis available on the &tdevelop; home page. It concentrates on some basic steps to modify a <filename>Makefile</filename>.
<listitem><para>A short <ulink url="http://www.kdevelop.org/index.html?filename=tutorial_autoconf.html">autoconf tutorial</ulink> written by Christopher W. Curtis available on the &tdevelop; home page. It concentrates on some basic steps to modify a <filename>Makefile</filename>.
</para></listitem>
</para></listitem>
<listitem><para>
<listitem><para>
A more detailed tutorial can be found in a greater set of tutorials on <ulink url="http://www.amath.washington.edu/~lf/tutorials/autoconf/toolsmanual_toc.html"><quote>Developing software with GNU</quote></ulink>.
A more detailed tutorial can be found in a greater set of tutorials on <ulink url="http://www.amath.washington.edu/~lf/tutorials/autoconf/toolsmanual_toc.html"><quote>Developing software with GNU</quote></ulink>.
@ -45,7 +45,7 @@ In this chapter we will discuss the steps necessary to compile and install the &
&tdevelop; is available in binary form from many different &Linux; distributions such as <!--&SuSE;, &RedHat;//--> SuSE, RedHat and others. These binaries are packed in some convenient format, mostly RPM, for easy installation. To install, follow the standard instructions given in your distribution.
&tdevelop; is available in binary form from many different &Linux; distributions such as <!--&SuSE;, &RedHat;//--> SuSE, RedHat and others. These binaries are packed in some convenient format, mostly RPM, for easy installation. To install, follow the standard instructions given in your distribution.
</para>
</para>
<para>
<para>
You may as well obtain the &tdevelop; sources, compile and install them by yourself. These sources can be found via the project home page at <ulink url="http://www.tdevelop.org"> http://www.tdevelop.org</ulink> or via the <ulink url="http://download.kde.org">&kde; ftp site</ulink>.
You may as well obtain the &tdevelop; sources, compile and install them by yourself. These sources can be found via the project home page at <ulink url="http://www.kdevelop.org"> http://www.kdevelop.org</ulink> or via the <ulink url="http://download.kde.org">&kde; ftp site</ulink>.
</para>
</para>
<sect2 id="howto-svn">
<sect2 id="howto-svn">
@ -699,7 +699,7 @@ The <command>kbuildsycoca</command> command does not run from within the root. Y
API is the short form of <quote>Application Program Interface</quote>. Actually such an API cotains a series of descriptions (&ie; calling conventions) by which an application program can access the operating system and other services. In our context, however, a broader definition was adopted. The API of a &kde; or &Qt; application is an abstract of the classes and methods interfaces, a synopsis to be used like a dictionary to navigate the sources.
API is the short form of <quote>Application Program Interface</quote>. Actually such an API cotains a series of descriptions (&ie; calling conventions) by which an application program can access the operating system and other services. In our context, however, a broader definition was adopted. The API of a &kde; or &Qt; application is an abstract of the classes and methods interfaces, a synopsis to be used like a dictionary to navigate the sources.
</para>
</para>
<para>
<para>
There is a version of the most current API available at the <ulink url="http://www.tdevelop.org/HEAD/doc/api/html/index.html">KDevelop-Home website</ulink>. It will be automatically updated every 24 hours so you can keep up.
There is a version of the most current API available at the <ulink url="http://www.kdevelop.org/HEAD/doc/api/html/index.html">KDevelop-Home website</ulink>. It will be automatically updated every 24 hours so you can keep up.
</para>
</para>
<para>
<para>
Alas, this version is best used read-only over the internet. If you do not always have internet access you may as well build your own API documentation from the &tdevelop; sources. To do so, you must tell the automake system where to find the KDELIBS API in your system. This is accomplished by the special option <option>--with-tdelibsdoxy-dir</option> in the <command>configure</command> command when you prepare to compile the &tdevelop; sources:
Alas, this version is best used read-only over the internet. If you do not always have internet access you may as well build your own API documentation from the &tdevelop; sources. To do so, you must tell the automake system where to find the KDELIBS API in your system. This is accomplished by the special option <option>--with-tdelibsdoxy-dir</option> in the <command>configure</command> command when you prepare to compile the &tdevelop; sources:
KDevelop version >= 3.1 comes with a customized version (fork ;)) of %Qt Designer. It is called KDevelop Designer (KDevDesigner, kdevdesigner from the command line). KDevDesigner has some important differences:
KDevelop version >= 3.1 comes with a customized version (fork ;)) of %Qt Designer. It is called KDevelop Designer (KDevDesigner, kdevdesigner from the command line). KDevDesigner has some important differences:
- KDevDesigner provides a read/write KPart which can be embedded into any application which wants to edit .ui files. KDevelop IDE embeds KDevDesigner this way.
- KDevDesigner provides a read/write KPart which can be embedded into any application which wants to edit .ui files. TDevelop IDE embeds KDevDesigner this way.
- KDevDesigner uses %KDE icons and dialogs and thus provides better integration with a system.
- KDevDesigner uses %KDE icons and dialogs and thus provides better integration with a system.
<string><b>Constraints</b>Refine your query by writing additional constraints such as <i>([X-KDevelop-Scope]='Global')</i>).</string>
<string><b>Constraints</b>Refine your query by writing additional constraints such as <i>([X-TDevelop-Scope]='Global')</i>).</string>
<p>If you want to specify additional command-line options to your make program, you can set them in the <b>Project Options</b> dialog, <b>Make Options</b> tab.
<p>If you want to specify additional command-line options to your make program, you can set them in the <b>Project Options</b> dialog, <b>Make Options</b> tab.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>If you use functions of other libraries than the target is currently linked with, you can specify them in the <b>Target Options</b> dialog.
<p>If you use functions of other libraries than the target is currently linked with, you can specify them in the <b>Target Options</b> dialog.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>If you want to change your application's version number, you can change it in the <b>Project Options</b> dialog, <b>General</b> tab, automatically updating your project.
<p>If you want to change your application's version number, you can change it in the <b>Project Options</b> dialog, <b>General</b> tab, automatically updating your project.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>If you want to create a new project, choose "Project"->"New Project" from the menu.
<p>If you want to create a new project, choose "Project"->"New Project" from the menu.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>If you changed your applications' classes, you should update your API documentation by selecting "Build API Documentation" from the Build menu.
<p>If you changed your applications' classes, you should update your API documentation by selecting "Build API Documentation" from the Build menu.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>You can save time if you select "Compile File" from the Build menu or the toolbar, to only compile your current implementation file.
<p>You can save time if you select "Compile File" from the Build menu or the toolbar, to only compile your current implementation file.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>If you're searching for information on classes or classmembers, select "Search for Help on..." from the Help menu or use "Index" tab of the documentation tree.
<p>If you're searching for information on classes or classmembers, select "Search for Help on..." from the Help menu or use "Index" tab of the documentation tree.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>If you want to have info about something in the KDevelop window, select the "What's this?" button in the toolbar and click on the item you don't know about.
<p>If you want to have info about something in the TDevelop window, select the "What's this?" button in the toolbar and click on the item you don't know about.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>Hint: You can search the documentation for a keyword by marking the word and select "Search in Documentation" in the right button popup menu.
<p>Hint: You can search the documentation for a keyword by marking the word and select "Search in Documentation" in the right button popup menu.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>The KDevelop Team wishes you a nice day !
<p>The TDevelop Team wishes you a nice day !
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>If you have found a bug in KDevelop, please let us know. Use KDE Bugzilla at http://bugs.kde.org/ or select "Help"->"Report Bug" from the menu.
<p>If you have found a bug in TDevelop, please let us know. Use KDE Bugzilla at http://bugs.kde.org/ or select "Help"->"Report Bug" from the menu.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>If you want to add your own documentation to the documentation tree use <b>Documentation Tree</b> tab in the <b>Configure KDevelop</b> dialog.
<p>If you want to add your own documentation to the documentation tree use <b>Documentation Tree</b> tab in the <b>Configure TDevelop</b> dialog.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can create a new class with "New Class" from the "Project" menu?
<p>...that you can create a new class with "New Class" from the "Project" menu?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>To open a project, select "Open Project" from the "Project" menu.
<p>To open a project, select "Open Project" from the "Project" menu.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>If you compile your project and get an error, you can click on the error message to switch to the file and line where the error occurred.
<p>If you compile your project and get an error, you can click on the error message to switch to the file and line where the error occurred.
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can debug your programs within KDevelop by selecting "Debug"->"Start" in the menu?
<p>...that you can debug your programs within TDevelop by selecting "Debug"->"Start" in the menu?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can switch between classes or namespaces by selecting the class or namespace combo in the toolbar?
<p>...that you can switch between classes or namespaces by selecting the class or namespace combo in the toolbar?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can preview images and icons by selecting them in the file viewer's trees?
<p>...that you can preview images and icons by selecting them in the file viewer's trees?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can set the compiler options in the <b>Project Options</b> dialog, <b>Configure Options</b> tab?
<p>...that you can set the compiler options in the <b>Project Options</b> dialog, <b>Configure Options</b> tab?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can copy text from the documentation browser to the clipboard and insert it into your sources?
<p>...that you can copy text from the documentation browser to the clipboard and insert it into your sources?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you should keep your library documentation up to date after installing new libraries?
<p>...that you should keep your library documentation up to date after installing new libraries?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can configure the syntax-highlighting of the editor?
<p>...that you can configure the syntax-highlighting of the editor?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can access more internal debug functions selecting "Debug"->"Viewers"?
<p>...that you can access more internal debug functions selecting "Debug"->"Viewers"?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can move the cursor by words with Ctrl and left or right arrow?
<p>...that you can move the cursor by words with Ctrl and left or right arrow?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that your source bookmarks are stored in the project?
<p>...that your source bookmarks are stored in the project?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that your documentation bookmarks are stored globally in KDevelop configuration?
<p>...that your documentation bookmarks are stored globally in TDevelop configuration?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can start grep search from inside editor with context menu?
<p>...that you can start grep search from inside editor with context menu?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can set the installation path in "Project"->"Project Options" "Configure Options" with just adding "--prefix=/install/path/" to the "Configure arguments"-list?
<p>...that you can set the installation path in "Project"->"Project Options" "Configure Options" with just adding "--prefix=/install/path/" to the "Configure arguments"-list?
</html>
</html>
</tip>
</tip>
<tip category="KDevelop|General">
<tip category="TDevelop|General">
<html>
<html>
<p>...that you can compilie your project in "debug-mode" and "optimized-mode"?
<p>...that you can compilie your project in "debug-mode" and "optimized-mode"?
I18N_NOOP("(c) 1999-2007, The KDevelop developers"),"","http://www.tdevelop.org");
I18N_NOOP("(c) 1999-2007, The KDevelop developers"),"","http://www.kdevelop.org");
aboutData.addAuthor("Alexander Dymo",I18N_NOOP("Release coordinator, Overall improvements, Pascal support, C++ support, New File and Documentation parts"),"adymo@tdevelop.org");
aboutData.addAuthor("Alexander Dymo",I18N_NOOP("Release coordinator, Overall improvements, Pascal support, C++ support, New File and Documentation parts"),"adymo@tdevelop.org");
aboutData.addAuthor("Amilcar do Carmo Lucas",I18N_NOOP("Release coordinator, API documentation, Doxygen and autoproject patches"),"amilcar@ida.ing.tu-bs.de");
aboutData.addAuthor("Amilcar do Carmo Lucas",I18N_NOOP("Release coordinator, API documentation, Doxygen and autoproject patches"),"amilcar@ida.ing.tu-bs.de");
aboutData.addAuthor("David Nolden",I18N_NOOP("Advanced C++ code completion, C++ support, overall improvements"),"david.nolden.tdevelop@art-master.de");
aboutData.addAuthor("David Nolden",I18N_NOOP("Advanced C++ code completion, C++ support, overall improvements"),"david.nolden.tdevelop@art-master.de");
I18N_NOOP("(c) 1999-2007, The KDevelop developers"),"","http://www.tdevelop.org");
I18N_NOOP("(c) 1999-2007, The KDevelop developers"),"","http://www.kdevelop.org");
aboutData.addAuthor("Alexander Dymo",I18N_NOOP("Release coordinator, Overall improvements, Pascal support, C++ support, New File and Documentation parts"),"adymo@tdevelop.org");
aboutData.addAuthor("Alexander Dymo",I18N_NOOP("Release coordinator, Overall improvements, Pascal support, C++ support, New File and Documentation parts"),"adymo@tdevelop.org");
aboutData.addAuthor("Amilcar do Carmo Lucas",I18N_NOOP("Release coordinator, API documentation, Doxygen and autoproject patches"),"amilcar@ida.ing.tu-bs.de");
aboutData.addAuthor("Amilcar do Carmo Lucas",I18N_NOOP("Release coordinator, API documentation, Doxygen and autoproject patches"),"amilcar@ida.ing.tu-bs.de");
aboutData.addAuthor("Bernd Gehrmann",I18N_NOOP("Initial idea, basic architecture, much initial source code"),"bernd@tdevelop.org");
aboutData.addAuthor("Bernd Gehrmann",I18N_NOOP("Initial idea, basic architecture, much initial source code"),"bernd@tdevelop.org");