diff options
Diffstat (limited to 'README')
| -rw-r--r-- | README | 124 |
1 files changed, 0 insertions, 124 deletions
@@ -1,124 +0,0 @@ -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 - TDE_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 TDEDIR to be empty. - e.g. - TDEDIR= 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 - |