Updated some of the TDevelop documentation toc files. This relates to bug 1859.

Also some KDE to TDE renaming.
pull/1/head
Michele Calgaro 10 years ago
parent 75724494fb
commit 9ea861095e

@ -46,8 +46,8 @@ the &tdevelop; IDE</para>
</abstract> </abstract>
<keywordset> <keywordset>
<keyword>KDE</keyword> <keyword>TDE</keyword>
<keyword>KDevelop</keyword> <keyword>TDevelop</keyword>
<keyword>IDE</keyword> <keyword>IDE</keyword>
<keyword>development</keyword> <keyword>development</keyword>
<keyword>programming</keyword> <keyword>programming</keyword>
@ -60,9 +60,9 @@ the &tdevelop; IDE</para>
<para> <para>
As Unix Systems are becoming more and more popular to even beginners working with computer machines As Unix Systems are becoming more and more popular to even beginners working with computer machines
due to its advantages in regards of stability and functionality, most are somehow disappointed, because due to its advantages in regards of stability and functionality, most are somehow disappointed, because
those applications don't have a consistent look and each one behaves different from another. With KDE, those applications don't have a consistent look and each one behaves different from another. With TDE,
developers have an almost perfect way to create first-class applications for Unix desktop systems to get developers have an almost perfect way to create first-class applications for Unix desktop systems to get
a wider user community by the mere quality their applications have to offer. Therefore, KDE becomes more a wider user community by the mere quality their applications have to offer. Therefore, TDE becomes more
and more popular as a base for programming design, and developers want to take advantage of the and more popular as a base for programming design, and developers want to take advantage of the
possibilities that the system has to offer. possibilities that the system has to offer.
</para> </para>
@ -74,8 +74,8 @@ For making the best use of this programming handbook, we assume that you already
C++ programming language; if not, you should make yourself familiar with that first. Information about C++ programming language; if not, you should make yourself familiar with that first. Information about
C++ is available through various sources either in printed form at your local bookstore or by tutorials C++ is available through various sources either in printed form at your local bookstore or by tutorials
found on the Internet. Knowledge about the design of Graphical User Interfaces is not required, as this found on the Internet. Knowledge about the design of Graphical User Interfaces is not required, as this
handbook tries to cover the application design for KDE programs, which also includes an introduction into handbook tries to cover the application design for TDE programs, which also includes an introduction into
the Qt toolkit as well as the KDE libraries and the design of User Interfaces. Also, you should have made the Qt toolkit as well as the TDE libraries and the design of User Interfaces. Also, you should have made
yourself comfortable with &tdevelop; by reading The User Manual to &tdevelop;, which contains a descriptive yourself comfortable with &tdevelop; by reading The User Manual to &tdevelop;, which contains a descriptive
review of the functionality provided by the IDE. review of the functionality provided by the IDE.
</para> </para>
@ -84,7 +84,7 @@ review of the functionality provided by the IDE.
<sect1 id="c1s2"> <sect1 id="c1s2">
<title>About this Handbook</title> <title>About this Handbook</title>
<para> <para>
This handbook has been written to give developers an introduction into KDE application development by This handbook has been written to give developers an introduction into TDE application development by
using the KDevelop Integrated Development Environment. using the KDevelop Integrated Development Environment.
</para> </para>
<para> <para>
@ -104,7 +104,7 @@ online-manuals.
<sect2 id="c1s2s1"> <sect2 id="c1s2s1">
<title>In the next chapter</title> <title>In the next chapter</title>
<para> <para>
We'll take a look at the Qt and KDE libraries, showing basic concepts and why things are the way they are. We'll take a look at the Qt and TDE libraries, showing basic concepts and why things are the way they are.
Also, we will discuss how to create the tutorial applications provided with the Qt toolkit by using Also, we will discuss how to create the tutorial applications provided with the Qt toolkit by using
tdevelop;, so beginners can already see first results with a few steps, and thereby will learn how to make tdevelop;, so beginners can already see first results with a few steps, and thereby will learn how to make
use of some of &tdevelop;'s best features. use of some of &tdevelop;'s best features.
@ -132,17 +132,17 @@ You will learn how to:
<sect1 id="c1s3"> <sect1 id="c1s3">
<title>Additional Information</title> <title>Additional Information</title>
<para> <para>
Additional information about Qt/KDE programming is available by various sources: Additional information about Qt/TDE programming is available by various sources:
<itemizedlist> <itemizedlist>
<listitem><para>Programming with Qt by Matthias Kalle Dalheimer</para></listitem> <listitem><para>Programming with Qt by Matthias Kalle Dalheimer</para></listitem>
<listitem><para><ulink url="www.kdevelop.org">The User Manual to KDevelop, provided with the TDevelop IDE</ulink></para></listitem> <listitem><para><ulink url="www.kdevelop.org">The User Manual to KDevelop, provided with the TDevelop IDE</ulink></para></listitem>
<listitem><para><ulink url="doc.trolltech.com">The Online Reference to the Qt library</ulink></para></listitem> <listitem><para><ulink url="doc.trolltech.com">The Online Reference to the Qt library</ulink></para></listitem>
<listitem><para><ulink url="developer.kde.org">The KDE Developer web site</ulink></para></listitem> <listitem><para><ulink url="developer.kde.org">The TDE Developer web site</ulink></para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
<para> <para>
Additionally, you should look for help by subscribing to the various mailing lists, whose addresses Additionally, you should look for help by subscribing to the various mailing lists, whose addresses
are available on the mentioned web sites, and on the Usenet newsgroups dedicated to users of KDE and are available on the mentioned web sites, and on the Usenet newsgroups dedicated to users of TDE and
Unix Systems as well as about the C and C++ programming language. Unix Systems as well as about the C and C++ programming language.
</para> </para>
<para> <para>
@ -159,7 +159,7 @@ functionality of the development environment.
</chapter> </chapter>
<chapter id="chapter2"> <chapter id="chapter2">
<title>The KDE and Qt Libraries</title> <title>The TDE and Qt Libraries</title>
<para> <para>
The Norwegian company TrollTech (<ulink url="http://www.trolltech.com">http://www.trolltech.com</ulink>) The Norwegian company TrollTech (<ulink url="http://www.trolltech.com">http://www.trolltech.com</ulink>)
provides a so-called GUI toolkit, named Qt. GUI means "Graphical User Interface", and therefore, Qt-based provides a so-called GUI toolkit, named Qt. GUI means "Graphical User Interface", and therefore, Qt-based
@ -171,25 +171,20 @@ application design very easy. Additionally, the Qt toolkit is also available for
which allows developers to provide their applications for both platforms. which allows developers to provide their applications for both platforms.
</para> </para>
<para> <para>
The KDE Team (<ulink url="http://www.kde.org">http://www.kde.org</ulink>) joined together with the goal The TDE libraries, which rely on the Qt toolkit, provide essential methods and classes that make all TDE
to make using Unix Systems more friendly, and decided to use the Qt toolkit for the development of a window applications designed with them look similar and consistent, so the user has the great advantage that he
manager on X-Windows, plus a variety of tools included with the KDE packages. The K Desktop Environment only has to get accustomed with an application's specific usage, not with handling dialogs or buttons.
therefore contains the window manager kwm, the file manager kfm and the launch panel kpanel as the main Also, TDE programs integrate themselves into the desktop and are able to interact with the file manager
components plus a variety of first-class utilities and applications. After KDE was out, a lot of developers via drag'n drop, offer session management and many more, if all features offered by the TDE libraries are used.
turned their eyes towards the new environment and what it has to offer them. The KDE libraries are providing Both, the Qt toolkit and the TDE libraries, are implemented in the C++ programming language; therefore
essential methods and classes that make all applications designed with them look similar and consistent, applications that make use of these libraries are also mostly written in C++. In the following chapter,
so the user has the great advantage that he only has to get accustomed with an application's specific we'll make a short trip through the libraries to see what already
usage, not with handling dialogs or buttons. Also, KDE programs integrate themselves into the desktop and
are able to interact with the file manager via drag'n drop, offer session management and many more, if all
features offered by the KDE libraries are used. Both, the Qt toolkit and the KDE libraries, are implemented
in the C++ programming language; therefore applications that make use of these libraries are also mostly
written in C++. In the following chapter, we'll make a short trip through the libraries to see what already
is provided and how Qt and TDE applications are created in general. is provided and how Qt and TDE applications are created in general.
</para> </para>
<para> <para>
Both, the Qt toolkit and the KDE libraries, are implemented in the C++ programming language; Both, the Qt toolkit and the TDE libraries, are implemented in the C++ programming language;
therefore applications that make use of these libraries are also mostly written in C++. In the following therefore applications that make use of these libraries are also mostly written in C++. In the following
chapter, we'll make a short trip through the libraries to see what already is provided and how Qt and KDE chapter, we'll make a short trip through the libraries to see what already is provided and how Qt and TDE
applications are created in general. applications are created in general.
</para> </para>
@ -206,9 +201,9 @@ applications and are needed for X-Window programming. Additionally, the toolkit
</itemizedlist> </itemizedlist>
</para> </para>
<para> <para>
Therefore knowing the Qt classes is very essential, even if you only want to program KDE-applications. Therefore knowing the Qt classes is very essential, even if you only want to program TDE-applications.
To have an impression on the basic concept how GUI-applications are constructed and compiled, we'll first To have an impression on the basic concept how GUI-applications are constructed and compiled, we'll first
have a look at a sample Qt-only program; then we'll extend it to a KDE program. have a look at a sample Qt-only program; then we'll extend it to a TDE program.
</para> </para>
<sect2 id="c2s1s1"> <sect2 id="c2s1s1">
@ -273,7 +268,7 @@ Alternatively, you can use the online documentation from Trolltech's <ulink url=
For <classname>QApplication</classname>, you will see the constructor and all other methods that this For <classname>QApplication</classname>, you will see the constructor and all other methods that this
class provides. If you follow a link, you will get more information about the usage and meaning of the class provides. If you follow a link, you will get more information about the usage and meaning of the
methods, which is very useful when you sometimes can't detect the correct use or want to have an example. methods, which is very useful when you sometimes can't detect the correct use or want to have an example.
This also counts for the KDE library documentation, which uses a similar documentation type; therefore This also counts for the TDE library documentation, which uses a similar documentation type; therefore
this is almost all you have to know about using the class-references with the documentation browser. this is almost all you have to know about using the class-references with the documentation browser.
</para> </para>
<sect3 id="c2s1s2s1"> <sect3 id="c2s1s2s1">
@ -332,7 +327,7 @@ user events.
<note><para> <note><para>
For already advanced users: The button has no parent declared in the constructor, therefore it For already advanced users: The button has no parent declared in the constructor, therefore it
is a top-level widget alone and runs in a local event loop which doesn't need to wait for the main is a top-level widget alone and runs in a local event loop which doesn't need to wait for the main
event loop. See the QWidget class documentation and The KDE Library Reference Guide</para> event loop. See the QWidget class documentation and The TDE Library Reference Guide</para>
</note> </note>
</sect3> </sect3>
@ -510,7 +505,7 @@ by the member function which actually is the slot that will be executed on signa
By using signals and slots, your program's objects can interact with each other easily without explicitly By using signals and slots, your program's objects can interact with each other easily without explicitly
depending on the type of the receiver object. You will learn more about using this mechanism for productive depending on the type of the receiver object. You will learn more about using this mechanism for productive
usage later in this handbook. More information about the Signals/Slot mechanism can also be found in usage later in this handbook. More information about the Signals/Slot mechanism can also be found in
<ulink url="developer.kde.org/documentation/library/libraryref.html">The KDE Library Reference Guide</ulink> <ulink url="developer.kde.org/documentation/library/libraryref.html">The TDE Library Reference Guide</ulink>
and the <ulink url="doc.trolltech.com">Qt online reference</ulink>. and the <ulink url="doc.trolltech.com">Qt online reference</ulink>.
</para> </para>
</sect3> </sect3>
@ -518,11 +513,11 @@ and the <ulink url="doc.trolltech.com">Qt online reference</ulink>.
</sect1> </sect1>
<sect1 id="c2s3"> <sect1 id="c2s3">
<title>What KDE provides</title> <title>What TDE provides</title>
<sect2 id="c2s3s1"> <sect2 id="c2s3s1">
<title>The KDE 3.x libraries</title> <title>The TDE libraries</title>
<para> <para>
The main KDE libraries you'll be using for creating your own TDE applications are: The main TDE libraries you'll be using for creating your own TDE applications are:
<itemizedlist> <itemizedlist>
<listitem><para> <listitem><para>
the tdecore library, containing all classes that are non-visible elements to provide application functionality the tdecore library, containing all classes that are non-visible elements to provide application functionality
@ -536,16 +531,16 @@ the tdefile library, containing the file selection dialogs
</itemizedlist> </itemizedlist>
</para> </para>
<para> <para>
Additionally, for specific solutions KDE offers the following libraries: Additionally, for specific solutions TDE offers the following libraries:
<itemizedlist> <itemizedlist>
<listitem><para> <listitem><para>
the tdefx library, containing pixmaps, image effects the TDEStyle extension to QStyle the tdefx library, containing pixmaps, image effects the TDEStyle extension to QStyle
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
the tdehtml library, containing KDE's html component the tdehtml library, containing TDE's html component
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
the kjs library, containing KDE's Javascript support the kjs library, containing TDE's Javascript support
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
the tdeio library, containing low level access to network files the tdeio library, containing low level access to network files
@ -556,14 +551,14 @@ the tdeparts library, containing support for re-usable embeddable extendable app
</itemizedlist> </itemizedlist>
</para> </para>
<para> <para>
Next we'll have a look at what is needed to turn out first Qt Application into a KDE one. Next we'll have a look at what is needed to turn out first Qt Application into a TDE one.
</para> </para>
</sect2> </sect2>
<sect2 id="c2s3s2"> <sect2 id="c2s3s2">
<title>Example KDE Application</title> <title>Example TDE Application</title>
<para> <para>
In the following, you will see that writing a KDE application is not much more difficult than a In the following, you will see that writing a TDE application is not much more difficult than a
Qt application. For the use of KDE's features, you just have to use some other classes, and you're almost Qt application. For the use of TDE's features, you just have to use some other classes, and you're almost
done. As an example, we'll discuss the changed version of the Qt example from above: done. As an example, we'll discuss the changed version of the Qt example from above:
<programlisting> <programlisting>
#include &lt;tdeapplication.h> #include &lt;tdeapplication.h>
@ -589,7 +584,7 @@ return a.exec();
You see that first we have changed from <classname>QApplication</classname> to <classname>TDEApplication You see that first we have changed from <classname>QApplication</classname> to <classname>TDEApplication
</classname>. Further, we had to change the previously used <methodname>setMainWidget()</methodname> method </classname>. Further, we had to change the previously used <methodname>setMainWidget()</methodname> method
to <methodname>setTopWidget</methodname>, which <classname>TDEApplication</classname> uses to set the main to <methodname>setTopWidget</methodname>, which <classname>TDEApplication</classname> uses to set the main
widget. That's it! Your first KDE application is ready - you only have to tell the compiler the KDE widget. That's it! Your first TDE application is ready - you only have to tell the compiler the TDE
include path and the linker to link in the tdecore library with -ltdecore. include path and the linker to link in the tdecore library with -ltdecore.
</para> </para>
<para> <para>
@ -602,7 +597,7 @@ mentioned before and see the effects.
What you should have looked into additionally until now is the reference documentation for Qt, What you should have looked into additionally until now is the reference documentation for Qt,
especially the <classname>QApplication</classname>, <classname>QWidget</classname> and <classname>QObject especially the <classname>QApplication</classname>, <classname>QWidget</classname> and <classname>QObject
</classname> class and the tdecore library documentation for the <classname>TDEApplication</classname> class. </classname> class and the tdecore library documentation for the <classname>TDEApplication</classname> class.
The <ulink url="developer.kde.org/documentation/library/libraryref.html">KDE Library Reference handbook</ulink> The <ulink url="developer.kde.org/documentation/library/libraryref.html">TDE Library Reference handbook</ulink>
also covers a complete description about the invocation of the <classname>QApplication</classname> and also covers a complete description about the invocation of the <classname>QApplication</classname> and
<classname>TDEApplication</classname> constructors including command-line argument processing. <classname>TDEApplication</classname> constructors including command-line argument processing.
</para> </para>
@ -622,7 +617,7 @@ all of your projects are first created by the wizard, and then you can start bui
already provided by the source skeleton. You can choose from several project types according to your project goals: already provided by the source skeleton. You can choose from several project types according to your project goals:
<itemizedlist> <itemizedlist>
<listitem><para> <listitem><para>
KDE Application Framework: includes source code for a complete frame structre of a standard KDE application TDE Application Framework: includes source code for a complete frame structre of a standard TDE application
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
QMake Project: Creates an application framework based around Trolltech's qmake configuration system QMake Project: Creates an application framework based around Trolltech's qmake configuration system
@ -637,7 +632,7 @@ A multitude of other program skeletons
</para> </para>
<para> <para>
In this chapter we'll see how the Application Wizard can be invoked and what has to be done to generate In this chapter we'll see how the Application Wizard can be invoked and what has to be done to generate
a KDE application project. This will also be the initial step of our coverage, where we will create the a TDE application project. This will also be the initial step of our coverage, where we will create the
initial version of a sample project. For all other project types the steps are usualyl the same, but you initial version of a sample project. For all other project types the steps are usualyl the same, but you
may not have as many options available. may not have as many options available.
</para> </para>
@ -648,9 +643,9 @@ may not have as many options available.
<sect2 id="c3s2s1"> <sect2 id="c3s2s1">
<title>Starting the Application Wizard and the First Page</title> <title>Starting the Application Wizard and the First Page</title>
<para> <para>
To start with your KDE application, open &tdevelop;. From the Project menu, selection New Project. The To start with your TDE application, open &tdevelop;. From the Project menu, selection New Project. The
Application Wizard starts, and you'll see the selection tree on the first page containing available project Application Wizard starts, and you'll see the selection tree on the first page containing available project
types that can be created. Choose the C++ subtree, then KDE, then Application Framework. types that can be created. Choose the C++ subtree, then TDE, then Application Framework.
</para> </para>
<para> <para>
For our sample project, we are going to create the application KScribble. Enter this as the application For our sample project, we are going to create the application KScribble. Enter this as the application
@ -835,13 +830,13 @@ used by kscribble.cpp via an #include statement inside of the file.
<sect1 id="c3s4"> <sect1 id="c3s4">
<title>The source skeleton</title> <title>The source skeleton</title>
<para> <para>
To conceptualize how a KDE application works, we'll first have a very close look at the source To conceptualize how a TDE application works, we'll first have a very close look at the source
skeleton already provided by the Application Wizard. As we already saw, we're having a set of source skeleton already provided by the Application Wizard. As we already saw, we're having a set of source
and header files that build the initial code for the application and make it ready-to-run. Therefore, and header files that build the initial code for the application and make it ready-to-run. Therefore,
the easiest way to explain the code is to follow the implementation line by line as it is processed the easiest way to explain the code is to follow the implementation line by line as it is processed
during executing the program until it enters the main event loop and is ready to accept user input. during executing the program until it enters the main event loop and is ready to accept user input.
Then, we'll have a look at the functionality that enables user interaction and how certain things work. Then, we'll have a look at the functionality that enables user interaction and how certain things work.
This is probably the best way to explain the framework and, as it is similar to almost all KDE This is probably the best way to explain the framework and, as it is similar to almost all TDE
applications, will enable you to read source codes from other projects as well; additionally, you will applications, will enable you to read source codes from other projects as well; additionally, you will
know where to change what part of the code to make your applications behave the way they are designed for. know where to change what part of the code to make your applications behave the way they are designed for.
</para> </para>
@ -897,7 +892,7 @@ by selecting the "Global Functions" folder.
</para> </para>
<para> <para>
Now, what happens first is the usual creation of a <classname>TDEApplication</classname> object, but we've Now, what happens first is the usual creation of a <classname>TDEApplication</classname> object, but we've
added some KDE methods that set program and author information for this application. added some TDE methods that set program and author information for this application.
</para> </para>
</sect2> </sect2>
<sect2> <sect2>
@ -989,7 +984,7 @@ design would match best to allow any user to work with the application with a mi
learning how to handle the user interface. learning how to handle the user interface.
</para> </para>
<para> <para>
For some purposes like text editing and displaying HTML files, views are provided by the Qt and KDE For some purposes like text editing and displaying HTML files, views are provided by the Qt and TDE
libraries; we will discuss certain aspects of these high-level widgets in the next section. libraries; we will discuss certain aspects of these high-level widgets in the next section.
But for most applications new widgets have to be designed and implemented. It is that what makes a But for most applications new widgets have to be designed and implemented. It is that what makes a
programmer also a designer and where his abilities on creativity are asked. Nevertheless, you should programmer also a designer and where his abilities on creativity are asked. Nevertheless, you should
@ -1016,13 +1011,13 @@ a joy if you know how to exploit it's capabilities- inheritance, information hid
already existing code. already existing code.
</para> </para>
<para> <para>
When creating a KDE or Qt project, you always have to have a view that inherits QWidget, either by When creating a TDE or Qt project, you always have to have a view that inherits QWidget, either by
direct inheritance or because the library widget you want to use inherits QWidget. Therefore, the direct inheritance or because the library widget you want to use inherits QWidget. Therefore, the
Application Wizard already constructed a view that is an instance of a class yourappView, which Application Wizard already constructed a view that is an instance of a class yourappView, which
inherits QWidget already. inherits QWidget already.
</para> </para>
<para> <para>
This chapter therefore describes how to use library widgets for creating views of KDE or This chapter therefore describes how to use library widgets for creating views of TDE or
Qt applications that are generated with &tdevelop;, then we look at the libraries and what kind of Qt applications that are generated with &tdevelop;, then we look at the libraries and what kind of
views are already offered. views are already offered.
</para> </para>
@ -1032,7 +1027,7 @@ views are already offered.
<para> <para>
When your application design has been set up, you first should look for already existing code that When your application design has been set up, you first should look for already existing code that
will make your life a lot easier. A part of this search is to look for a widget that can be used as will make your life a lot easier. A part of this search is to look for a widget that can be used as
a view or at least as a part of it; either directly or by inheritance. The KDE and Qt libraries already a view or at least as a part of it; either directly or by inheritance. The TDE and Qt libraries already
contain a set of widgets that can be used for this purpose. To use them, you have two options: contain a set of widgets that can be used for this purpose. To use them, you have two options:
<orderedlist> <orderedlist>
<listitem><para> <listitem><para>
@ -1071,7 +1066,7 @@ Looking at the first page of the Qt online documentation, you will find a link t
"Widget Screenshots" where you can have a look at how the widgets Qt contains look like. "Widget Screenshots" where you can have a look at how the widgets Qt contains look like.
These are ready to use and can be combined together to form complex widgets to create application These are ready to use and can be combined together to form complex widgets to create application
views or dialogs. In the following, we'll discuss some of these which are very usable for creating views or dialogs. In the following, we'll discuss some of these which are very usable for creating
application views, but keep in mind that the KDE libraries sometimes contain other widgets for the application views, but keep in mind that the TDE libraries sometimes contain other widgets for the
same purpose; those will be reviewed in the next section. same purpose; those will be reviewed in the next section.
</para> </para>
<para> <para>
@ -1087,7 +1082,7 @@ document's view widget.
<listitem><para> <listitem><para>
to create a ScrollView yourself, inherit the View widget from <classname>QWidget</classname> to create a ScrollView yourself, inherit the View widget from <classname>QWidget</classname>
and add vertical and horizontal <classname>QScrollBars </classname>. and add vertical and horizontal <classname>QScrollBars </classname>.
(This is done by KDE`s TDEHTMLView widget.) (This is done by TDE`s TDEHTMLView widget.)
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
For text processing, use <classname>QTextEdit</classname>. This class provides a complete For text processing, use <classname>QTextEdit</classname>. This class provides a complete
@ -1117,9 +1112,9 @@ know how to handle them and only have to concentrate on the displayed data.
</para> </para>
</sect2> </sect2>
<sect2 id="c4s3s2"> <sect2 id="c4s3s2">
<title>KDE Views</title> <title>TDE Views</title>
<para> <para>
The KDE libraries were invented to make designing applications for the K Desktop Environment easier The TDE libraries were invented to make designing applications for the K Desktop Environment easier
and capable of more functionality than what Qt alone is offering. The tdeui library offers: and capable of more functionality than what Qt alone is offering. The tdeui library offers:
<orderedlist> <orderedlist>
<listitem><para> <listitem><para>
@ -1201,7 +1196,7 @@ toolBar()</methodname> will also provide you with applicable widgets.
<para> <para>
A very professional thing you should always add to your application are keyboard accelerators. A very professional thing you should always add to your application are keyboard accelerators.
Those are mainly used by experienced users that want to work fast with their applications and Those are mainly used by experienced users that want to work fast with their applications and
are willing to learn shortcuts. For this, the KDE libraries provide the class <classname> are willing to learn shortcuts. For this, the TDE libraries provide the class <classname>
TDEAction</classname>, which provides the keyboard accelerator keys and access to global configured TDEAction</classname>, which provides the keyboard accelerator keys and access to global configured
standard keyboard accelerators. standard keyboard accelerators.
</para> </para>
@ -1212,7 +1207,7 @@ such as F1 for accessing online-help, Ctrl+N for New File etc.
<para> <para>
If your application contains a lot of accelerators, you should make them configurable If your application contains a lot of accelerators, you should make them configurable
by an Options-menu; either it could be combined with other application configuration in a QWidget by an Options-menu; either it could be combined with other application configuration in a QWidget
or stand alone. The KDE library already provides a <classname>KKeyChooser</classname> or stand alone. The TDE library already provides a <classname>KKeyChooser</classname>
for use in tab dialogs, whereas <classname>KKeyDialog</classname> provides a ready-to use for use in tab dialogs, whereas <classname>KKeyDialog</classname> provides a ready-to use
key-configuration dialog. key-configuration dialog.
</para> </para>
@ -1238,7 +1233,7 @@ A very important part of the development process is to provide help functionalit
wherever possible. Most developers tend to delay this, but you should remember that a normal user wherever possible. Most developers tend to delay this, but you should remember that a normal user
isn't necessarily a Unix expert. He may come from the the dark side of computer software usage offering isn't necessarily a Unix expert. He may come from the the dark side of computer software usage offering
all sweets that a user may need to work himself into using an application even without ever touching the all sweets that a user may need to work himself into using an application even without ever touching the
manuals. Therefore, the KDE and Qt library provide all means usually considered making an application manuals. Therefore, the TDE and Qt library provide all means usually considered making an application
professional in the eyes of the normal user by help functions that are ready to use. professional in the eyes of the normal user by help functions that are ready to use.
Within the application, those are:</para> Within the application, those are:</para>
<itemizedlist> <itemizedlist>
@ -1252,7 +1247,7 @@ using the standard help key F1. This context based help system is provided auto
<classname>TDEMainWindow</classname> class, though as the author you must provide the content. <classname>TDEMainWindow</classname> class, though as the author you must provide the content.
</para> </para>
<para> <para>
As &tdevelop; also offers all types of help as well as the KDE framework generated by the As &tdevelop; also offers all types of help as well as the TDE framework generated by the
application wizard already contains support for this, this chapter will help you find out where application wizard already contains support for this, this chapter will help you find out where
and how to add your help functionality. </para> and how to add your help functionality. </para>
<para> <para>
@ -1322,7 +1317,7 @@ To add the What's This...? help to one of your widgets, use the static method
<para> <para>
Due to the fact that projects often lack a complete set of user documentation, Due to the fact that projects often lack a complete set of user documentation,
all &tdevelop; projects contain a pre-build handbook that can be easily adapted; all &tdevelop; projects contain a pre-build handbook that can be easily adapted;
therefore fulfiling another goal of KDE: providing enough online-help to support users that therefore fulfiling another goal of TDE: providing enough online-help to support users that
are not familiar with an application. This chapter therefore introduces you on how to extend are not familiar with an application. This chapter therefore introduces you on how to extend
the provided documentation template and what you have to do to make it available to the user. the provided documentation template and what you have to do to make it available to the user.
</para> </para>
@ -1333,7 +1328,7 @@ the provided documentation template and what you have to do to make it available
The documentation for your project lies in projectdir/doc/en, or perhaps another directory if English The documentation for your project lies in projectdir/doc/en, or perhaps another directory if English
isn't your native language. Therein lies a file, index.docbook, in which the documentation is stored. isn't your native language. Therein lies a file, index.docbook, in which the documentation is stored.
The format for editing this file is explained on The format for editing this file is explained on
<ulink url="http://i18n.kde.org/doc/markup/">KDE's documentation website</ulink>. <ulink url="http://i18n.kde.org/doc/markup/">TDE's documentation website</ulink>.
</para> </para>
</sect1> </sect1>
<sect1 id="c9s3"> <sect1 id="c9s3">
@ -1342,7 +1337,7 @@ The format for editing this file is explained on
Another important part of the documentation is including a descriptive help for your class interfaces. Another important part of the documentation is including a descriptive help for your class interfaces.
This will allow you and other programmers to use your classes by reading the HTML class documentation This will allow you and other programmers to use your classes by reading the HTML class documentation
that can be created with KDoc. &tdevelop; supports the use of KDoc completely by creating the that can be created with KDoc. &tdevelop; supports the use of KDoc completely by creating the
KDE-library documentation, also your application frameworks are already documented. To work yourself TDE-library documentation, also your application frameworks are already documented. To work yourself
into the provided code, it would be a good start to read the included documentation online. into the provided code, it would be a good start to read the included documentation online.
The following describes what to do to get the API documentation, where &tdevelop; helps you add it The following describes what to do to get the API documentation, where &tdevelop; helps you add it
and what kind of special tags KDoc provides. and what kind of special tags KDoc provides.
@ -1365,7 +1360,7 @@ use of the provided functionality and feel more comfortable.
</sect1> </sect1>
<!-- <!--
<sect1 id="c10s2"> <sect1 id="c10s2">
<title>How KDE support Internationalization</title> <title>How TDE support Internationalization</title>
<para> <para>
</para> </para>
</sect1> --> </sect1> -->

@ -1,6 +1,6 @@
<!DOCTYPE tdeveloptoc> <!DOCTYPE tdeveloptoc>
<tdeveloptoc> <tdeveloptoc>
<title>Ada</title> <title>Ada 95 Reference Manual</title>
<base href="http://www.adahome.com/rm95"/> <base href="http://www.adahome.com/rm95"/>
<tocsect1 name="General" url="rm9x-01.html"> <tocsect1 name="General" url="rm9x-01.html">
<tocsect2 name="Scope" url="rm9x-01-01.html"></tocsect2> <tocsect2 name="Scope" url="rm9x-01-01.html"></tocsect2>

@ -2,6 +2,6 @@
<tdeveloptoc> <tdeveloptoc>
<title>Ada bugs (GCC)</title> <title>Ada bugs (GCC)</title>
<base href="http://gcc.gnu.org/bugzilla/"/> <base href="http://gcc.gnu.org/bugzilla/"/>
<tocsect1 name="Query" url="query.cgi"> <tocsect1 name="Query" url="query.cgi?format=advanced&amp;component=ada&amp;bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=SUSPENDED&amp;bug_status=WAITING&amp;bug_status=REOPENED">
</tocsect1> </tocsect1>
</tdeveloptoc> </tdeveloptoc>

@ -10,8 +10,18 @@
################################################# #################################################
install( FILES install( FILES
libc.toc libstdc++.toc kdetemplates.toc stl.toc c++_bugs_gcc.toc
qt-kdev3.toc kde2book.toc gnustep.toc gnome1.toc clanlib.toc
clanlib.toc c++_bugs_gcc.toc gtk_bugs.toc cppannotations.toc
wxwidgets_bugs.toc cppannotations.toc gnome1.toc
gnustep.toc
gtk_bugs.toc
kde2book.toc
kdetemplates.toc
libc.toc
libstdc++.toc
objc++_bugs_gcc.toc
qt-kdev3.toc
stl.toc
wxwidgets_bugs.toc
DESTINATION ${DATA_INSTALL_DIR}/kdevdocumentation/tocs ) DESTINATION ${DATA_INSTALL_DIR}/kdevdocumentation/tocs )

@ -1,7 +1,19 @@
tocdir = ${kde_datadir}/kdevdocumentation/tocs tocdir = ${kde_datadir}/kdevdocumentation/tocs
toc_DATA = libc.toc libstdc++.toc kdetemplates.toc stl.toc qt-kdev3.toc kde2book.toc \ toc_DATA = \
gnustep.toc gnome1.toc clanlib.toc c++_bugs_gcc.toc gtk_bugs.toc wxwidgets_bugs.toc \ c++_bugs_gcc.toc \
cppannotations.toc clanlib.toc \
cppannotations.toc \
gnome1.toc \
gnustep.toc \
gtk_bugs.toc \
kde2book.toc \
kdetemplates.toc \
libc.toc \
libstdc++.toc \
objc++_bugs_gcc.toc \
qt-kdev3.toc \
stl.toc \
wxwidgets_bugs.toc
#indexdir = ${kde_datadir}/devdoctreeview/indices #indexdir = ${kde_datadir}/devdoctreeview/indices
#index_DATA = libc.index libstdc++.index stl.index kde2book.index #index_DATA = libc.index libstdc++.index stl.index kde2book.index

@ -2,6 +2,6 @@
<tdeveloptoc> <tdeveloptoc>
<title>C++ bugs (GCC)</title> <title>C++ bugs (GCC)</title>
<base href="http://gcc.gnu.org/bugzilla/"/> <base href="http://gcc.gnu.org/bugzilla/"/>
<tocsect1 name="Query" url="query.cgi"> <tocsect1 name="Query" url="query.cgi?format=advanced&amp;component=c&amp;component=c%2B%2B&amp;bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=SUSPENDED&amp;bug_status=WAITING&amp;bug_status=REOPENED">
</tocsect1> </tocsect1>
</tdeveloptoc> </tdeveloptoc>

@ -0,0 +1,7 @@
<!DOCTYPE tdeveloptoc>
<tdeveloptoc>
<title>Objective-C bugs (GCC)</title>
<base href="http://gcc.gnu.org/bugzilla/"/>
<tocsect1 name="Query" url="query.cgi?format=advanced&amp;component=objc&amp;component=objc%2B%2B&amp;bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=SUSPENDED&amp;bug_status=WAITING&amp;bug_status=REOPENED">
</tocsect1>
</tdeveloptoc>

@ -2,6 +2,6 @@
<tdeveloptoc> <tdeveloptoc>
<title>Fortran bugs (GCC)</title> <title>Fortran bugs (GCC)</title>
<base href="http://gcc.gnu.org/bugzilla/"/> <base href="http://gcc.gnu.org/bugzilla/"/>
<tocsect1 name="Query" url="query.cgi"> <tocsect1 name="Query" url="query.cgi?format=advanced&amp;component=fortran&amp;bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=SUSPENDED&amp;bug_status=WAITING&amp;bug_status=REOPENED">
</tocsect1> </tocsect1>
</tdeveloptoc> </tdeveloptoc>

@ -2,6 +2,6 @@
<tdeveloptoc> <tdeveloptoc>
<title>Java bugs (GCC)</title> <title>Java bugs (GCC)</title>
<base href="http://gcc.gnu.org/bugzilla/"/> <base href="http://gcc.gnu.org/bugzilla/"/>
<tocsect1 name="Query" url="query.cgi"> <tocsect1 name="Query" url="query.cgi?format=advanced&amp;component=java&amp;bug_status=UNCONFIRMED&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=SUSPENDED&amp;bug_status=WAITING&amp;bug_status=REOPENED">
</tocsect1> </tocsect1>
</tdeveloptoc> </tdeveloptoc>

Loading…
Cancel
Save