Programmers information about KIO::ksvnNote
You may skip this if not interested in KIO programming.
KIO::ksvn::special knows the following operations.
Table 3.1. Command overview for KIO::ksvn::special
| Command name | Numeric id | Parameter list | Implemented in the current version? |
|---|---|---|---|
| Checkout | 1 |
KURL repository, KURL target, int revnumber, QString revkind
The target will not be modified, e.g., but the content will be checked out without creating a subfolder! For example, the source may be
| Yes |
| Update | 2 | KURL url, int revnum, QString revstring If revnum < 0 the revstring is parsed. Format of revstring is described in Appendix. | Yes |
| Commit | 3 | KURL::List urls urls is a list of local urls to commit. Will ask for log message. | Yes |
| Log | 4 |
int startrevnumber, QString startrevstring, int endrevnumber, QString endrevstring, KURL::List Use this with care - this may produce a lot of data. | Yes |
| Import | 5 | KURL targetrepository, KURL sourcepath | Yes |
| Add | 6 | KURL | Yes |
| Del | 7 | KURL::List | Yes |
| Revert | 8 | KURL::List Revert in KIO is always non-recursive, no questions (calling app must do it itself) | Yes |
| Status | 9 | KURL item, bool checkRepos, bool recurse item - the item whos info should be checked, checkRepos - check if there are newer versions in the repository, recurse - whether to check recursive or not. | Yes |
| Mkdir | 10 | KURL::List | Yes |
| Resolve | 11 | KURL, bool recursive | Yes |
| Switch | 12 | KURL working_copy_path, KURL new_repository_url, bool recursive,int revnumber, QString revkind | Yes |
| Diff | 13 |
URL uri1, KURL uri2, int r1, QString rstring1, int r2, QString rstring 2, bool recursive For difference between repository file:/// and working copy setup working copy urls without a protocol! | Yes |
Return values may be given via metadata, see apidoc for details.
Table 3.2. Content of metadata
| Key | Possible value |
|---|---|
| path | Path of the item action was made on, e.g. given url |
| action | Numeric action type |
| kind | kind of item (mostly folder or file) |
| mime_t | Subversion mimetype of item |
| content | State of content (subversion value) |
| prop | State of properties (subversion value) |
| rev | Resulting revision or revision worked on |
| string | Internal defined human readable message. |
| loggedaction | Subversion defined action string on item (A,M,D) |
| loggedcopyfrompath | If copied from which path? (may be empty) |
| loggedcopyfromrevision | If copied at which revision? (may be < 0) |
| loggedpath | On which single path the entries logged action and so on are set. (path is set to the calling url) |
| diffresult | a line of difference output |