KIO-Giobridge
=============

The purpose of KIO-Giobridge is to let all desktop applications and file-managers
share the same network transparency layer for working with network file systems
like FTP, SFTP, SMB, WEBDAV,... Therefore KDE4, Gtk and 3rd party applications
can access the same file-server resources without logging in twice or facing
other inconsistencies. At the moment we have two incompatible network
transparency systems, running in the same desktop session for different groups
of applications. Also, with the existence of two frameworks, a lot of 3rd party
applications were locked out, as they didn't want to decide for one of them.

KIO-Giobridge is an optional adapter for KIO to use the new GIO/GVFS (the
successor of Gnome-VFS) to handle the protocols mentioned above.  GIO/GVFS has
been chosen, because it's pretty independent from desktop specific libraries, daemons
and toolkits and only depends on D-Bus and GLib. Another advantage of GIO/GVFS
is its "stateful" mount daemons: All the communication to a certain share is
handled by a single mount daemon process. The life-cycle of those mount daemons
is user-controllable (mount/unmount), similar to kernel or FUSE mounts.

KIO-Giobridge can be enabled/disabled with the kio-giobridge-mgr utility. 
Additionally it's required to compile Qt4 with GLib-Main-Loop support (which 
is default on many distros already).

Along with KIO-Giobridge it would be advantageous to implement the "Desktop
Bookmarks Storage Specification" in Gnome, to fix another file-management
interoperability bug.


Howto Install
=============

Just like any other cmake project:

check out the sources, lets say in kio-giobridge-sources 

cd ..
mkdir my-build-dir
cd my-build-dir
cmake ../kio-giobridge-sources
make install


Enabling KIO-GioBridge:
=======================

To enable KIO-GioBridge you type

kio-giobridge-mgr enable

which will copy the required *.protocol files to your local kde4 services 
directory.

 + + +
 
KFilePlacesModelGnome
=====================

This module aligns the model in KFilePlaces (the left side panel in Dolphin and
the KDE Filechooser) with the style in Nautilus/Gtk File-Chooser:

* [username] -> home dir
* Desktop
* File System
* Network

<List of Volumes> (including GVFS network mounts)

* Trash

<Bookmarks> (from ./~gtk-bookmarks)


To build this module you have to enable

cmake -D ENABLE_KFILEPLACESMODEL_GNOME=1 <path to sources>

when running cmake. The module is optional, because it requires the following
patches for kdelibs and kdebase:

http://reviewboard.kde.org/r/1880/
http://reviewboard.kde.org/r/1951/ (see the screenshot)


