Chapter 3. Konqueror, KIO, kdesvn

Table of Contents

Description
Usage of KIO outside konqueror - an example
Programmers information about KIO::ksvn
Commandlist
Return values

Description

As of version 0.7.0 of kdesvn it comes with some modules integrating some commands directly into konqueror menus.

KIO protocols

Implements handlers for following protocols:

  • ksvn+http

  • ksvn+https

  • ksvn+file

  • ksvn+ssh

  • ksvn

The same maybe for "svn+..." but as from kde 3.4, kdesdk has it own small svn-kio called "svn+http"etc. So packages are organized that way - or should that "svn+..." comes as an extra package so it may installed if kdesdk hasn't installed it.

These protocols are designed only for repositories, not for working copies. E.g. "ksvn+file:///<path>" must point to the beginning of a repository different to the application itself or KPart. Working copies may browsed with konqueror.

For browsing at a specific revision you may append the query "?rev=<revision>" to the url.

Context menus

kdesvn installs context menues for konqueror. Them may be seen with right mouse click in the browser window (only in standard view, not any KPart) so it is possible to do most used actions direct from within konqueror (or any other filemanagers that read konquerors context menues like krusader). This is done via a call to the commandline variant of kdesvn.

This menu is static up to kde 3.5, so you should care about what you're selecting. Otherwise kdesvn prints an error box.

Usage of KIO outside konqueror - an example

Every KDE based application may use these protocols. So it would be possible to retrieve all differences between two revisions with kdiff3 without any deep knowledge.

Example 3.1. Retrieving differences between revions using KDiff3 and KIO::ksvn

kdiff3 \
  ksvn://anonsvn.kde.org/home/kde/trunk/KDE/arts?rev=423127 \
  ksvn://anonsvn.kde.org/home/kde/trunk/KDE/arts?rev=455064

Let kdiff3 print all differences between two revisions. Note! Using this within kdesvn (diff'ing two revisions) is MUCH faster because the internal mechanisms of subversion are used.