* Added kgtk-qt3

* Slight kpowersave message cleanup


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/kgtk-qt3@1173604 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 124 insertions, 0 deletions

diff --git a/README b/README
new file mode 100644
index 0000000..b7337f9
--- /dev/null
+++ b/README
@@ -0,0 +1,124 @@
+Introduction
+------------
+
+KGtk is a quick-n-dirty hack to allow some Gtk2, Qt3, and Qt4
+applications to use KDE3 or KDE4 file dialogs.
+
+KGtk is composed of the following pieces:
+
+1. An application called kdialogd. In this archive there are
+   two varieties of this - a KDE3 version, and a KDE4 version.
+2. LD_PRELOAD libraries that are used to override the Gtk2, Qt3,
+   and Qt4 file dialogs.
+
+If you start an application using the following command:
+    kgtk-wrapper gimp
+
+...the the following occurs:
+
+1. kgtk-wrapper determines whether the application is a Gtk2, Qt3,
+   or Qt4 application. It then sets the LD_PRELOAD environment
+   variable to point to the approriate KGtk library.
+2. When the application now starts, it checks for the
+   KDE_SESSION_VERSION environment variable. If this is not set,
+   or is less than 4, then the KDE3 version of kdialogd is started,
+   else the KDE4 version is started.
+3. When 'gimp' now tries to open a file dialog, the KGtk library
+   intercepts this, and asks kdialogd to open a file dialog instead.
+
+There will only ever be one instance of kdialogd, and all apps communicate with the same
+instance - and it termiantes itself 30 seconds after the last Gtk/Qt app has
+disconnected. This timeout can be changed by editing kdialogdrc and setting/changing
+
+    [General]
+    Timeout=10
+
+
+Installation
+------------
+As of v0.9.1, kgtk uses CMake in place of autotools.
+
+Because KGtk includes code for Qt3/KDE3 and Qt4/KDE4, you need
+to specify when building which variants you would like to build.
+This is accomplished as follows:
+
+1. mkdir build
+2. cd build
+3. cmake .. -DCMAKE_INSTALL_PREFIX=/usr
+4. make
+5. sudo make install
+
+* -DKGTK_KDE3=true instructs CMake to create makefiles for the KDE3
+  version of KDialogD. Defaults to "true", use -DKGTK_KDE3=false
+  to turn off. Turning this on, sets -DKGTK_KDE4=false and
+  -DKGTK_QT4=false
+
+* -DKGTK_KDE4=true would instruct CMake to create makefiles for
+  the KDE4 version of KDialogD. Defaults to "false".
+
+* -DKGTK_GTK2=true instructs CMake to create makefiles for the Gtk2
+  version of the LD_PRELOAD library. Defaults to "true", use
+  -DKGTK_GTK2=false to turn off.
+
+* -DKGTK_QT3=true instructs CMake to create makefiles for the Qt3
+  version of the LD_PRELOAD library. Defaults to "true", use
+  -DKGTK_QT3=false to turn off. Turning this on, sets
+  -DKGTK_KDE4=false and -DKGTK_QT4=false
+
+* -DKGTK_QT4=true instructs CMake to create makefiles for the Qt4
+  version of the LD_PRELOAD library. Defaults to "false".
+
+* For 64 bit systems, also append -DLIB_SUFFIX=64
+
+Mixing '-DKGTK_KDE3=true' and '-DKGTK_KDE4=true' wont work, so compile the Qt3/KDE3,
+and Qt4/KDE4 variants separately. Also, the 'build' folder *must* be cleaned before
+switching to/from Qt3/KDE3 from/to Qt4/KDE4
+
+
+So, to compile everything I suggest the following:
+
+ 1. mkdir build3
+ 2. cd build3
+ 3. cmake .. -DCMAKE_INSTALL_PREFIX=/usr
+    [ This will build KDialogD for KDE3, and create the LD_PRELOAD libraries for
+      Qt3 and Gtk2 ]
+ 4. make
+ 5. sudo make install
+
+ 6. set up Qt4/KDE4 env variables
+ 7. clean build folder
+
+ 8. mkdir build4
+ 9. cd build4
+10. cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DKGTK_KDE4=true -DKGTK_QT4=true -DKGTK_GTK2=false
+11. make
+12. sudo make install
+
+NOTE: If you have both KDE3 and KDE4 installed, when calling cmake for KDE3, set KDEDIR to be empty.
+      e.g. 
+        KDEDIR= cmake -DCMAKE_INSTALL_PREFIX=/usr -DKGTK_KDE4=false -DKGTK_QT4=false
+
+Notes
+-----
+
+The library has been tested with the following applications:
+
+Reported to work:
+
+  1. Firefox (1.5.x only, not 1.0.x)
+  2. Inkscape
+  3. GIMP
+  4. Kino
+  5. Eclipse
+  6. Azureus
+  7. Galde-2
+  8. Streamtuner
+  9. Avidemux2
+ 10. Scribus
+ 11. QComcBook
+ 12. Planner 0.14: works, but asks twice for open file
+
+Reported *not* working:
+
+  1. AbiWord
+