diff options
| -rw-r--r-- | .gitmodules | 3 | ||||
| -rw-r--r-- | CMakeLists.txt | 2 | ||||
| -rw-r--r-- | INSTALL | 17 | ||||
| -rw-r--r-- | README | 124 | ||||
| -rw-r--r-- | README.md | 49 | ||||
| -rw-r--r-- | TODO | 1 | ||||
| m--------- | admin | 0 |
7 files changed, 67 insertions, 129 deletions
diff --git a/.gitmodules b/.gitmodules deleted file mode 100644 index 934def7..0000000 --- a/.gitmodules +++ /dev/null @@ -1,3 +0,0 @@ -[submodule "admin"] - path = admin - url = https://system@scm.trinitydesktop.org/scm/git/tde-common-admin diff --git a/CMakeLists.txt b/CMakeLists.txt index b5db36a..45284c9 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -19,7 +19,7 @@ project( kgtk ) ##### set up cpack ############################## -set(CPACK_PACKAGE_DESCRIPTION_FILE "${CMAKE_CURRENT_SOURCE_DIR}/README") +set(CPACK_PACKAGE_DESCRIPTION_FILE "${CMAKE_CURRENT_SOURCE_DIR}/README.md") set(CPACK_GENERATOR "TBZ2") set(CPACK_SOURCE_GENERATOR "TBZ2") set(CPACK_PACKAGE_VERSION_MAJOR "0") @@ -0,0 +1,17 @@ +Basic Installation +================== + +kgtk-qt3 relies on cmake to build. + +Here are suggested default options: + + -DCMAKE_EXPORT_COMPILE_COMMANDS="ON" \ + -DCMAKE_INSTALL_PREFIX="/opt/trinity" \ + -DCONFIG_INSTALL_DIR="/etc/trinity" \ + -DSYSCONF_INSTALL_DIR="/etc/trinity" \ + -DXDG_MENU_INSTALL_DIR="/etc/xdg/menus" \ + -DCMAKE_BUILD_TYPE=RelWithDebInfo \ + -DCMAKE_VERBOSE_MAKEFILE="ON" \ + -DCMAKE_SKIP_RPATH="OFF" \ + -DBUILD_ALL="ON" \ + -DWITH_ALL_OPTIONS="ON" @@ -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 - diff --git a/README.md b/README.md new file mode 100644 index 0000000..2bb5e4f --- /dev/null +++ b/README.md @@ -0,0 +1,49 @@ + + ktgk-qt3 - allows to use TDE dialogs in Gtk apps + +This is an LD_PRELOAD hack that allows most GTK +applications to use Trinity's file dialogs when run under TDE. + +It overrides the gtk file chooser functions to communicate +with this TDE module/application. + +kgtk-qt3 is composed of the following pieces: + +1. An application called kdialogd. +2. LD_PRELOAD libraries that are used to override the Gtk2 and TQt3 file dialogs. + +Start an application using the following command to use the functionality: + + kgtk-wrapper <application> + +kgtk-wrapper determines whether it is a Gtk2 or TQt3 application and then sets +the LD_PRELOAD environment variable to point to the approriate kgtk library. +When the application 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 terminates itself 30 seconds after the last Gtk/TQt app has +disconnected. This timeout can be changed by editing kdialogdrc and setting/changing + + [General] + Timeout=10 + +. + +Contributing +-------------- + +If you wish to contribute to kgtk-qt3, you might do so: + +- TDE Gitea Workspace (TGW) collaboration tool. + https://mirror.git.trinitydesktop.org/gitea + +- TDE Weblate Translation Workspace (TWTW) collaboration tool. + https://mirror.git.trinitydesktop.org/weblate + + +Translations status +--------------------- + +### messages +[![Translations status](https://mirror.git.trinitydesktop.org/weblate/widgets/applications/-/kgtk-qt3/multi-auto.svg +"Engage in translating")](https://mirror.git.trinitydesktop.org/weblate/projects/applications/kgtk-qt3/) @@ -1 +0,0 @@ -KDE4: File dialog history diff --git a/admin b/admin deleted file mode 160000 -Subproject a7f75ac0ff587d5b8694a1b78557597161f8104 |