summaryrefslogtreecommitdiffstats
path: root/tdeparts/Mainpage.dox
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-01-26 13:17:21 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2013-01-26 13:17:21 -0600
commitdfe289850f068f19ba4a83ab4e7e22a7e09c13c9 (patch)
treec297348a55df66c571de4525646e0b9762427353 /tdeparts/Mainpage.dox
parentb7658a0d5eca24a9d37c6e04f88298ef02389db0 (diff)
downloadtdelibs-dfe289850f068f19ba4a83ab4e7e22a7e09c13c9.tar.gz
tdelibs-dfe289850f068f19ba4a83ab4e7e22a7e09c13c9.zip
Rename a number of libraries and executables to avoid conflicts with KDE4
Diffstat (limited to 'tdeparts/Mainpage.dox')
-rw-r--r--tdeparts/Mainpage.dox42
1 files changed, 42 insertions, 0 deletions
diff --git a/tdeparts/Mainpage.dox b/tdeparts/Mainpage.dox
new file mode 100644
index 000000000..994503d44
--- /dev/null
+++ b/tdeparts/Mainpage.dox
@@ -0,0 +1,42 @@
+/** @mainpage Framework for Trinity Graphical Components
+
+This library implements the framework for Trinity parts, which are
+elaborate widgets with a user-interface defined in terms of actions
+(menu items, toolbar icons). See KParts::Part.
+
+The library also provides a framework for applications that want to
+use parts. Such applications need to inherit their main window
+from KParts::MainWindow and provide a so-called shell GUI,
+which provides a basic skeleton GUI with part-independent functionality/actions.
+
+Some KParts applications won't be specific to a given part, but expect
+to be able to embed, for instance, all types of viewers out there. For this
+the basic functionality of any viewer has been implemented in
+KParts::ReadOnlyPart, which viewer-like parts should inherit from.
+The same applies to KParts::ReadWritePart, which is for editor-like parts.
+
+You can add actions to an existing KParts app from "outside", defining
+the code for those actions in a shared library. This mechanism is
+obviously called plugins, and implemented by KParts::Plugin.
+
+For a complete, and very simple, example of how to use KParts to display
+any kind of file (i.e. making a generic viewer), see the documentation for
+KParts::ComponentFactory::createPartInstanceFromQuery.
+
+@authors
+Simon Hausmann \<hausmann@kde.org\><br>
+David Faure \<faure@kde.org\><br>
+Kurt Granroth \<granroth@kde.org\><br>
+Michael Koch \<koch@kde.org\>
+
+@maintainers
+[Unknown/None]
+
+@licenses
+@lgpl
+
+*/
+
+// DOXYGEN_REFERENCES = tdecore tdeui kio
+// DOXYGEN_SET_PROJECT_NAME = KParts
+// vim:ts=4:sw=4:expandtab:filetype=doxygen