Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 65 insertions, 0 deletions

diff --git a/kdewidgets/README b/kdewidgets/README
new file mode 100644
index 000000000..eaa3de347
--- /dev/null
+++ b/kdewidgets/README
@@ -0,0 +1,65 @@
+KDE Custom Widgets for Qt Designer 2
+====================================
+
+
+Summary:
+========
+
+This directory contains KDE custom widgets for designer 2 which comes with
+Qt 3. Just make sure your plugin path in qtconfig includes
+$KDEDIR/lib/kde3/plugins . With the KDE build system nothing special 
+(i.e. editing the plugin path) is needed, as uic will automatically be
+called with -L <path to the kdewidgets plugin> .
+
+This plugin uses the QWidget plugin API of Qt >= 3.0
+Don't expect it to work with any other versions of Qt.
+
+
+Known Bugs:
+===========
+
+Designer crashes when using widgets that use the kapp pointer.
+
+HOWTO Add Widgets:
+==================
+Just add new widgets to kde.widgets like this:
+[ClassName]
+IncludeFile=myheader.h
+IconSet=mycoolwidget.png
+ToolTip=My Cool Widget
+WhatsThis=Long description of my cool widget
+ConstructorArgs=(parent, name, otherNeccessaryArg)
+IsContainer=true
+Group=MyWidgetCollection
+
+Everything but [ClassName] is optional.
+IncludeFile defaults to classname.h (all lowercase)
+IconSet defaults to classname.png (all lowercase)
+ToolTip defaults to ClassName
+WhatsThis defaults to ClassName
+ConstructorArgs=(parent, name)
+IsContainer defaults to false - note, any value except an empty one is
+                                interpreted as true, even if the value
+                                is "false" :) So, if the widget is not a
+                                container, just omit this line.
+Group defaults to "KDE"
+
+Don't forget to add an icon to the pics directory.  Try to make it look similar to the other icons and be the same size.
+
+There are some global options that you can have.
+
+[Global]
+Init=new InitCode();
+Destroy= delete object;
+PluginName=MyPlugin
+
+PluginName overrides the passed in value at the command line and is optional.
+Init and Destroy are both optional arguments that can be used for custom build
+up and tear down code.
+
+Have fun!
+
+
+Ian Reinhart Geiser <geiseri@kde.org>
+Daniel Molkentin <molkentin@kde.org>
+Malte Starostik <malte@kde.org>