Beginning with subversion and kdesvn
This section is mostly for beginners not familiar with subversion and explains how subversions and/or RCS works.
Working copies MUST be accessible via local paths. Subversion doesn't know something about pseudo filesystems like
fish://. kdesvn translates some of them if possible (like
system:/home) but it isn't possible over a network.
First of all you must create a working copy of your repository. For that select
->->. Inside the following dialog you must select the URL of the repository you want to use, e.g., something like
http://localhost/repos/myproject. Subfolders of a repository are possible, too, e.g.,
http://localhost/repos/myproject/trunk or similiar.
Select and/or create a local folder, where the working copy should reside.
Last but not least, the revision to checkout. Mostly that should be "HEAD". This ensures that the last stored version is the referenced version.
After clicking on "[OK]" kdesvn will create your new working copy and (if the box was checked) opens it.
When you have opened a repository for browsing you may mark a folder and than select ->->. and fill out the dialogs as described above. Then only the marked path will checked out.
Mark the entry or entries you want to send and select ->-> (#)
If you try to commit if no item is selected, kdesvn uses the top-most element of opened working copy, eg, the working copy path itself.
This operation is always recursive, means, if selecting a folder kdesvn always send all changed items below it. When you setup that you want to review all items before commit inside the following dialog all items kdesvn would send are listed. There you may unmark items you don't want to send. In that case kdesvn sends all items alone, eg, not recursive. Or you may select items not versioned for add and commit (if them are not marked to be ignored). So you may see if there are newer items you forgot.
Enter a log message what you're sending and hit "OK" and the transfer starts.
This brings you local working copy in sync with the repository. You may setup that kdesvn checks on opening a working copy for newer/modified items in repository. This runs in background and you may work meanwhile with kdesvn. Or start check with ->->.
When this is finished, items with newer versions or folders with items where newer items are below are marked.
To retrieve the changes, select ->->. This will update to the most latest version. If you want to get a specific revision select ->-> and select the revision you want in the following box.
If no item is selected, the update will done on whole opened working copy, otherwise only recursive on the selected items.
Both operations requires two steps: First add or delete and then commiting that changes to repository. Before you commit you may undone add or delete.
Adding items into a working copy may be done due three ways:
Copy with konqueror or any other tool into working copy area. Go trough list, mark them and select ->-> (Insert). When you want adding new folders with all subitems select ->-> (Ctrl+Insert).
You may check if there are somewhere in working copy unversioned items. After selecting ->-> a dialog appears where all not versioned items are listed. Hitting ok adds all marked items to working copy, items you don't want versioned you should unmark before.
Mark in konqueror or any other compatible filebrowser items you want to add and drag them to kdesvn. You may drop them on folders inside the opened working copy and than kdesvn copy the dropped items to it and add the items.
The log display may start with Ctrl+L when one or none item is marked in overview. Depending on your settings (see the section called “Subversion settings”) kdesvn retrieves some log entries beginning on head and displays them.
On left side you see the list of logentries kdesvn retrieved. The logmessage is stripped-down to one line to fit. The full logmessage appears in right upper window when marking an entry. In the right lower window you'll the list of changed files. This windows ONLY appears if this list ist fetched depending on your settings.
With the buttons above you may select another range of logs to display.
This range is called without any pre-limit so you have to think about yourself on large repositories.
The buttons below displays always work on item selected for log, not on item selected in list of changed files. So when you select
Diff previous" there it makes the diff over all changed items in this revision if them are equivalent or below the subversion
entry selected for retrievung logs before. Same for "
Annotate" of course works only if item to log is a file.
On all listentries (both lists) you have context menu enabled for some extra operations. In left list this is "Set version as left side of diff" (eg, beginning revision) and "Set version as right side of diff" (eg., end or target of diff, in unified the part marked with a "
+++"). If you selected these revisions them are marked with some small arrows.
|Using kdesvn||Up||Working on repositories|