diff options
| author | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-03-15 17:32:48 +0000 |
|---|---|---|
| committer | tpearson <tpearson@283d02a7-25f6-0310-bc7c-ecb5cbfe19da> | 2010-03-15 17:32:48 +0000 |
| commit | e2f541c98dfa4081fa3ab3d28f08ea2309281884 (patch) | |
| tree | cb721a55bc88753ddeb9754dc98ef45e2850ce30 /doc | |
| download | tdesvn-e2f541c98dfa4081fa3ab3d28f08ea2309281884.tar.gz tdesvn-e2f541c98dfa4081fa3ab3d28f08ea2309281884.zip | |
Added KDE3 version of kdesvn
git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/kdesvn@1103685 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'doc')
22 files changed, 4907 insertions, 0 deletions
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt new file mode 100644 index 0000000..f018059 --- /dev/null +++ b/doc/CMakeLists.txt @@ -0,0 +1,54 @@ +#first straigth forward until we have a doc translation + +MACRO (GENBOOK _language_code) + FILE(GLOB docimages RELATIVE ${CMAKE_CURRENT_SOURCE_DIR}/${_language_code} ${_language_code}/hi128-filesys-*.png) + ADD_CUSTOM_COMMAND( + OUTPUT ${CMAKE_CURRENT_SOURCE_DIR}/${_language_code}_index.cache.bz2 + COMMAND + ${KDE3_MEINPROC_EXECUTABLE} + ARGS "--check" "--cache" "${CMAKE_CURRENT_SOURCE_DIR}/${_language_code}_index.cache.bz2" + ${CMAKE_CURRENT_SOURCE_DIR}/${_language_code}/index.docbook + DEPENDS + ${CMAKE_CURRENT_SOURCE_DIR}/${_language_code}/index.docbook + ) + INSTALL(FILES + ${CMAKE_CURRENT_SOURCE_DIR}/${_language_code}_index.cache.bz2 + DESTINATION ${HTML_INSTALL_DIR}/${_language_code}/kdesvn + RENAME + index.cache.bz2 + ) + INSTALL(FILES + ${CMAKE_CURRENT_SOURCE_DIR}/${_language_code}/index.docbook + DESTINATION ${HTML_INSTALL_DIR}/${_language_code}/kdesvn + ) + + FOREACH(_img ${docimages}) + CONFIGURE_FILE(${CMAKE_CURRENT_SOURCE_DIR}/${_language_code}/${_img} + ${CMAKE_CURRENT_BINARY_DIR}/${_language_code}/${_img} + COPYONLY + ) + INSTALL(FILES ${CMAKE_CURRENT_BINARY_DIR}/${_language_code}/${_img} + DESTINATION ${HTML_INSTALL_DIR}/${_language_code}/kdesvn + ) + ENDFOREACH(_img) + + ADD_CUSTOM_TARGET(${_language_code}_doc + DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/${_language_code}_index.cache.bz2 + ) + ADD_DEPENDENCIES(doc ${_language_code}_doc) + +ENDMACRO (GENBOOK) + +IF (KDE3_MEINPROC_EXECUTABLE) + ADD_CUSTOM_TARGET(doc ALL) + GENBOOK(en) + GENBOOK(nl) + # creates the link to the common-section during install + INSTALL(SCRIPT ${CMAKE_CURRENT_SOURCE_DIR}/makelink.cmake) + +#${CMAKE_CURRENT_BINARY_DIR}/common) + +ENDIF (KDE3_MEINPROC_EXECUTABLE) + +ADD_SUBDIRECTORY(man) + diff --git a/doc/en/hi128-filesys-kdesvnadded.png b/doc/en/hi128-filesys-kdesvnadded.png Binary files differnew file mode 100644 index 0000000..e01579d --- /dev/null +++ b/doc/en/hi128-filesys-kdesvnadded.png diff --git a/doc/en/hi128-filesys-kdesvnconflicted.png b/doc/en/hi128-filesys-kdesvnconflicted.png Binary files differnew file mode 100644 index 0000000..61f9db7 --- /dev/null +++ b/doc/en/hi128-filesys-kdesvnconflicted.png diff --git a/doc/en/hi128-filesys-kdesvndeleted.png b/doc/en/hi128-filesys-kdesvndeleted.png Binary files differnew file mode 100644 index 0000000..ca3b090 --- /dev/null +++ b/doc/en/hi128-filesys-kdesvndeleted.png diff --git a/doc/en/hi128-filesys-kdesvnlocked.png b/doc/en/hi128-filesys-kdesvnlocked.png Binary files differnew file mode 100644 index 0000000..ee0bc7c --- /dev/null +++ b/doc/en/hi128-filesys-kdesvnlocked.png diff --git a/doc/en/hi128-filesys-kdesvnmodified.png b/doc/en/hi128-filesys-kdesvnmodified.png Binary files differnew file mode 100644 index 0000000..3042eb4 --- /dev/null +++ b/doc/en/hi128-filesys-kdesvnmodified.png diff --git a/doc/en/hi128-filesys-kdesvnneedlock.png b/doc/en/hi128-filesys-kdesvnneedlock.png Binary files differnew file mode 100644 index 0000000..d057ea2 --- /dev/null +++ b/doc/en/hi128-filesys-kdesvnneedlock.png diff --git a/doc/en/hi128-filesys-kdesvnupdates.png b/doc/en/hi128-filesys-kdesvnupdates.png Binary files differnew file mode 100644 index 0000000..3902655 --- /dev/null +++ b/doc/en/hi128-filesys-kdesvnupdates.png diff --git a/doc/en/index.docbook b/doc/en/index.docbook new file mode 100644 index 0000000..38be189 --- /dev/null +++ b/doc/en/index.docbook @@ -0,0 +1,2324 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kdesvn "<application>kdesvn</application>"> + <!ENTITY kappname "&kdesvn;"><!-- Do *not* replace kappname--> + <!ENTITY package "kde-module"><!-- kdebase, kdeadmin, etc --> + <!ENTITY % addindex "IGNORE"> + <!ENTITY konqi "<application>konqueror</application>"> + <!ENTITY krus "<application>krusader</application>"> + <!ENTITY % English "INCLUDE"><!-- change language only here --> + + + <!-- Do not define any other entities; instead, use the entities + from kde-genent.entities and $LANG/user.entities. --> +]> +<!-- ................................................................ --> + +<!-- The language must NOT be changed here. --> + +<book lang="&language;"> + +<!-- This header contains all of the meta-information for the document such +as Authors, publish date, the abstract, and Keywords --> + +<bookinfo> +<title>The &kdesvn; Handbook</title> + +<authorgroup> +<author> +<firstname>Rajko</firstname> +<othername></othername> +<surname>Albrecht</surname> +<affiliation> +<address><email>[email protected]</email></address> +</affiliation> +</author> +</authorgroup> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> + +<copyright> +<year>2005</year> +<year>2008</year> +<holder>Rajko Albrecht</holder> +</copyright> +<!-- Translators: put here the copyright notice of the translation --> +<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook + and in the FDL itself on how to use it. --> +<legalnotice>&FDLNotice;</legalnotice> + +<!-- Date and version information of the documentation +Don't forget to include this last date and this last revision number, we +need them for translation coordination ! +Please respect the format of the date (YYYY-MM-DD) and of the version +(V.MM.LL), it could be used by automation scripts. +Do NOT change these in the translation. --> + +<date>$Date: 2008-08-03 21:04:39 +0200 (So, 03 Aug 2008) $</date> +<releaseinfo>0.4</releaseinfo> + +<!-- Abstract about this handbook --> + +<abstract> +<para> +&kdesvn; - a subversion client for &kde;. +</para> +</abstract> + +<!-- This is a set of Keywords for indexing by search engines. +Please at least include KDE, the KDE package it is in, the name + of your application, and a few relevant keywords. --> + +<keywordset> +<keyword>KDE</keyword> +<keyword>kdesvn</keyword> +<keyword>subversion</keyword> +<keyword>version control system</keyword> +</keywordset> + +</bookinfo> + +<!-- The contents of the documentation begin here. Label +each chapter so with the id attribute. This is necessary for two reasons: it +allows you to easily reference the chapter from other chapters of your +document, and if there is no ID, the name of the generated HTML files will vary +from time to time making it hard to manage for maintainers and for the CVS +system. Any chapter labelled (OPTIONAL) may be left out at the author's +discretion. Other chapters should not be left out in order to maintain a +consistent documentation style across all KDE apps. --> + +<chapter id="introduction"> +<title>Introduction</title> + +<!-- The introduction chapter contains a brief introduction for the +application that explains what it does and where to report +problems. Basically a long version of the abstract. Don't include a +revision history. (see installation appendix comment) --> + +<para> +&kdesvn; is a <ulink url="http://subversion.tigris.org/">subversion client</ulink> for &kde;. +</para> +<para>You should have some knowledge about subversion itself, but hopefully most items are self explanatory. +</para> +<para> +You may send bugreports and feature wishes via <ulink url="http://kdesvn.alwins-world.de/"> +http://kdesvn.alwins-world.de/. +</ulink> +</para> + +<sect1 id="kdesvn-terms"> +<title>Terms</title> +<para> +If you're familiar with revision control systems you may skip that - or read and correct the author ;) +</para> +<para> +<variablelist> +<varlistentry> +<term>Repository</term> +<listitem><para> +Central store of data. That may be a database or a flat filesystem. Without special clients you're not able to read +data in it. For Subversion repositories &kdesvn; is such a client. +</para></listitem> +</varlistentry> +<varlistentry> +<term>Working copy</term> +<listitem><para> +A flat copy of a repository on local filesystem. This is used like any normal filemanager, editing files and so forth. +RCS-information you can read with clients like &kdesvn;. +</para> +<para> +Remember that subversion doesn't know something about KIO, so a working copy must reside in an area where it may reached without any specific protocol, eg "fish://" or such isn't possible. +</para> +</listitem> +</varlistentry> +<varlistentry> +<term>WebDav</term> +<listitem><para> +WebDav is a protocol which let you modify files on a remote webserver. Subversion is a special kind of WebDAV when repositories are accessed +via webserver. In normal use this is read-only. With special configurations you may get a read-write enabled WebDAV which you may access via +specialized browser. &kdesvn; is NOT a webdav-client, but Konqueror is via the "webdav://" protocol. But with &kdesvn; you +may browse through the version tree of a repository (via "http://") +</para></listitem> +</varlistentry> +</variablelist> +</para> +</sect1> +</chapter> + +<chapter id="using-kdesvn"> +<title>Using &kdesvn;</title> +<sect1 id="kdesvn-features"> +<title>&kdesvn; features</title> +<para> +&kdesvn; understands following protocols for browsing repositories: +<variablelist> + +<varlistentry> +<term>http</term> +<listitem><para> +Standard web browser protocol. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>https</term> +<listitem><para> +Standard encrypted web browser protocol +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn+http</term> +<listitem><para> +Standard web browser protocol. May be used to let konqueror automatic call &kdesvn;. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn+https</term> +<listitem><para> +Standard encrypted web browser protocol. May be used to let konqueror automatic call &kdesvn;. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn+file</term> +<listitem><para> +Local repository protocol. May used to let konqueror automatic call &kdesvn;. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn</term> +<listitem><para> +Subversions own server protocol. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn+ssh</term> +<listitem><para> +Subversion over ssh. See <link linkend="faq">FAQ</link> for details about some specials with that protocol. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>file</term> +<listitem><para> +Direct repository accesss. &kdesvn; checks if a given path is a repository or a working copy and opens it in the right mode. For subversion +<prompt>file:///dir</prompt> and <prompt>/dir</prompt> is not the same! +</para></listitem> +</varlistentry> +</variablelist> +</para> +<para> +This list may used for urls given for <link linkend="kdesvn-commandline">commandline</link>, too. +</para> +</sect1> +<sect1 id="first_steps"> +<title>Beginning with subversion and kdesvn</title> +<para> +This section is mostly for beginners not familiar with subversion and explains how subversions and/or RCS works. +</para> + +<sect2> +<title>Creating a working copy</title> +<caution> +<para> +Working copies MUST be accessible via local paths. Subversion doesn't know something about pseudo filesystems like +<prompt>smb://</prompt> or <prompt>fish://</prompt>. &kdesvn; translates some of them if possible (like <prompt>system:/home</prompt>) but it isn't possible over a network. +</para> +</caution> +<para> +First of all you must create a working copy of your repository. For that select + +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Checkout a repository</guimenuitem> +</menuchoice>. Inside the following dialog you must select the URL of the repository you want to use, e.g., something like +<prompt>http://localhost/repos/myproject</prompt>. Subfolders of a repository are possible, too, e.g., +<prompt>http://localhost/repos/myproject/trunk</prompt> or similiar. +</para> +<para> +Select and/or create a local folder, where the working copy should reside. +</para> +<para> +Last but not least, the revision to checkout. Mostly that should be "HEAD". This ensures that the last stored version +is the referenced version. +</para> +<para> +After clicking on "[OK]" &kdesvn; will create your new working copy and (if the box was checked) opens it. +</para> +<para> +When you have opened a repository for browsing you may mark a folder and than select +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Repository</guisubmenu> +<guimenuitem>Checkout current repository path</guimenuitem> +</menuchoice>. +and fill out the dialogs as described above. Then only the marked path will checked out. +</para> +</sect2> +<sect2> +<title>Commiting local changes</title> +<para> +Mark the entry or entries you want to send and select +<menuchoice> +<shortcut> +<keycombo action="simul"><keycap>#</keycap></keycombo> +</shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Commit</guimenuitem> +</menuchoice> +</para> +<para> +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. +</para> +<para> +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. +</para> +<para> +Enter a log message what you're sending and hit "OK" and the transfer starts. +</para> +</sect2> +<sect2> +<title>Update working copy</title> +<para> +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 +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Check for updates</guimenuitem> +</menuchoice>. +</para> +<para> +When this is finished, items with newer versions or folders with items where newer items are below are marked. +</para> +<para> +To retrieve the changes, select +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Update to head</guimenuitem> +</menuchoice>. This will update to the most latest version. If you want to get a specific revision select +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Update to revision</guimenuitem> +</menuchoice> and select the revision you want in the following box. +</para> +<para> +If no item is selected, the update will done on whole opened working copy, otherwise only recursive on the selected items. +</para> +</sect2> +<sect2> +<title>Adding and Deleting from working copy</title> +<para> +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. +</para> +<sect3> +<title>Add items</title> +<para> +Adding items into a working copy may be done due three ways: +<variablelist> +<varlistentry> +<term>Select not versioned items and add them</term> +<listitem><para> +Copy with konqueror or any other tool into working copy area. Go trough list, mark them and select +<menuchoice> +<shortcut><keycombo action="simul"><keycap>Insert</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Add selected files/dirs</guimenuitem> +</menuchoice>. + When you want adding new folders with all subitems select +<menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>Insert</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Add selected files/dirs recursive</guimenuitem> +</menuchoice>. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Check and add recursive</term> +<listitem><para> +You may check if there are somewhere in working copy unversioned items. After selecting +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Check for unversioned items</guimenuitem> +</menuchoice> 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. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Drag and drop</term> +<listitem><para> +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. +</para></listitem> +</varlistentry> +</variablelist> +</para></sect3> +<sect3> +<title>Deleting items from working copy and unversion</title> +<para> +Deleting items is always recursive. Eg., when you delete a folder all subitems will deleted, too. Mark what you want and select "Delete selected items" from general menu. Items will unversioned and removed from disk. +</para> +</sect3> +</sect2> +</sect1> + +<sect1 id="working-with-repositories"> +<title>Working on repositories</title> +<para> +Simple repository browsing may done within &konqi; &krus; or similar filebrowsers: Open a URL with protocol described in <xref linkend="kdesvn-features" xreflabel="Features" /> (the variants starting with "k") and them will display the content. So simple operations like copy, move and delete may work. When appending a query "?rev=<xxx>" the listing comes from a specific revision. Format of revision-query is described in <xref linkend="revision-syntax" />, some more information about KIO::ksvn are in <xref linkend="kdesvn-kio" /> +</para> +<para> +All work except "Copy" may only done when browsing at revision HEAD. +</para> +<sect2> +<title>Restoring deleted items</title> +<para> +In subversion restoring deleted items is a copy operation of item at specific revision. So when you plan restoring view repository at revision before item was deleted. Select +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Repository</guisubmenu> +<guimenuitem>Select browse revision</guimenuitem> +</menuchoice> +and enter the wanted revision. Now kdesvn displays the content at this term. Mark the entry you want to restore, select +<menuchoice> +<shortcut> +<keycombo action="simul"><keycap>C</keycap></keycombo> +</shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Copy</guimenuitem> +</menuchoice>. Inside the following dialog the target is always at HEAD revision, the source is at revision you selected for browsing. Fill out the path click "OK" and copy starts. After successfull copy switch browsing back to HEAD revision and the restored item should appear. +</para> +</sect2> +<sect2> +<title>Importing folders</title> +<para> +Due restrictions of subversion itself only folders, not single files, may imported. +</para> +<sect3> +<title>With drag and drop</title> +<para> +Mark in any compatible filemanager the folder you want to import and drag it to the folder entry in &kdesvn; where you want to import it. +</para> +</sect3> +<sect3> +<title>Select folder to import with directory-browser</title> +<para> +Mark the folder where you want to import a new folder. Then select +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Import folders into current</guimenuitem> +</menuchoice> and select your wanted folder. +</para> +</sect3> +</sect2> +</sect1> +<sect1 id="operations"> +<title>Other Operations</title> +<sect2 id="merging-items"> +<title>Merge</title> +<para> +Open repository or working copy, mark item you want to merge and select +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guisubmenu>Merge</guisubmenu> +</menuchoice>. +Enter in the following dialog the values wanted. If opend from repository, source 1 and source 2 are filled, when open from within working copy, target is filled with current selected item. The handling of this parameter is a little bit different between using the internal diff of subversion or an external merge-programm like kdiff3. The target must ALWAYS a local folder or file. You may switch between external or internal merge with the checkbox "Use external merge". +</para> +<sect3> +<title>Internal merge</title> +<para> +The meaning is exactly like from within subversions own commandline tool. When source1 and source2 are equal, start and endrevision must different. If sources aren't equal, start-revision is assigned to source1 and end-revision to source2. The target MUST be a working copy otherwise subversion will send an error message. +</para> +<para> +The checkboxes have following meanings: +<variablelist> + +<varlistentry> +<term>Recoursive</term> +<listitem><para> +Do all operations recoursive when working with folders. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Handle unrelated as related items</term> +<listitem><para> +If set, unrelated items will be diffed as if they were related. Otherwise subversion will remove one side and add it on other side again. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Force delete on modified/unversioned</term> +<listitem><para> +If not set and merge would require deletion of an modified or unversioned item the subversion merge fails. Otherwise this items will deleted. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Just dry run without modifications.</term> +<listitem><para> +If set, subversions sends only notifications what it would do but doesn't modify the working copy. +</para></listitem> +</varlistentry> +</variablelist> + +</para> +</sect3> +<sect3> +<title>Using external program for merge</title> +<para> +See <xref linkend="diffmerge-settings"/> for details how to setup the external merge tool. &kappname; generates the commandline as described there. Before it does following: +</para> +<para> +<orderedlist> + +<listitem><para> +Assign start-revision as revision to source 1 and end-revision to source 2. Then checks if them are different (path and/or revision). If yes, its a three-way merge otherwise a simple merge from source to target. If source 2 is left empty it is a simple merge, too. +</para></listitem> + +<listitem><para> +Make an export into temporary folder. If a simple merge only source1 at start-revision, otherwise both sources with there revisions. If item is a file and not a folder than get the content at a specific revision. +</para></listitem> + +<listitem> +<para> +Generate the call to your external merge program as you setup in Settings. The error output will displayed in log window so you may see whats going wrong (if something is gone wrong). +</para> +</listitem> +</orderedlist> + +In difference to internal merge target may a flat folder/file not under sourcecontrol 'cause external tools doesn't care about it. +</para> +<para> +If recoursive isn't set, the export is done as a flat export. Be care: when doing this with working copies externals will NOT exported. +</para> +</sect3> +</sect2> + +<sect2 id="op-resolve"> +<title>Resolving conflicts</title> +<para> +&kappname; itself hasn't a module for resolving conflicts but you may use external software from within &kappname;. In <xref linkend="extern-resolve-setup"/> is a description how to setup up this application. +</para> +<para> +When marking an item with status set to "conflicted" (you'll see a red cross in listview on such items) you may select +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guisubmenu>Resolve conflict</guisubmenu> +</menuchoice>. +or from within context menu <menuchoice><guisubmenu>Resolve conflict</guisubmenu></menuchoice> (only on conflicted items) +&kappname; now starts the program you setup (or the default one). After finish this job you should mark item as resolved +(<menuchoice><guimenu>Subversion</guimenu><guisubmenu>Working copy</guisubmenu><guisubmenu>Mark resolved</guisubmenu></menuchoice>) otherwise you will not able to commit your changes. +</para> +</sect2> + +</sect1> + +<sect1 id="used-properties"> +<title>Properties used by &kappname; for configuration</title> +<sect2> +<title>Bugtracker integration</title> +<para>The <ulink url="http://tortoisesvn.tigris.org/">TortoiseSVN project</ulink> designed a nice property system +<ulink url="http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-bugtracker.html"> for integrating bugtracker</ulink> into +subversion GUI. This moment &kappname; doesn't support extra fields in commit box (will follow later) and doesn't understand all but following properties: +</para> +<para> +<table id="bugtracker-properties"> +<title>Bugtracker Integration Properties</title> +<tgroup cols="3"> + +<thead> +<row> +<entry>Property</entry> +<entry>Description</entry> +<entry>Example</entry> +</row> +</thead> +<tbody> +<row> +<entry><prompt>bugtraq:url</prompt></entry> +<entry>Holds the url to bugtracker. It has to contain the <prompt>%BUGID%</prompt> marker.</entry> +<entry>http://kdesvn.alwins-world.de/ticket/%BUGID%</entry> +</row> + +<row> +<entry><prompt>bugtraq:logregex</prompt></entry> +<entry> +<para>Contains one or two regular expressions, separated by a newline.</para> +<para>If only one expression is set, then the bare bug ID's must be matched in the groups of the regex string. If two expressions are set, then the first expression is used to find a string which relates to the bug ID but may contain more than just the bug ID (e.g. "Issue #123" or "resolves issue 123"). The second expression is then used to extract the bare bug ID from the string extracted with the first expression.</para> +<para>Please keep care about not wanted spaces after the regular expression and don't forget the brackets around the number description.</para> +</entry> +<entry> +<para>Single (useable with TRAC): +<programlisting> +#(\d+) +</programlisting> +Now all numbers like <prompt>#190</prompt> will parsed and translated to an url in logoutput.</para> +<para> +Two expressions: +<programlisting> +[Ii]ssue #?(\d+)(,? ?#(\d+))* +(\d+) +</programlisting> +Remember: Keep care of white spaces after the <prompt>(\d+)</prompt>! This is one of the most errors while this expressions doesn't match! +</para> +</entry> +</row> +</tbody> +</tgroup> +</table> +</para> +<para> +On local opened repositories (eg., <prompt>file://</prompt>-Protocoll) and on working copies this properties will searched upward from opened folder until found or the subversion-toplevel is reached. On repositories opened via network (all except <prompt>file://</prompt> protocoll) it is only searched on opened folder itself. +</para> +<para> +Support for multiple sets of this properties may follow later, (eg., in subfolder extra values for other tracker etc.) but in most cases evaluatin single tracker links should be enough. +</para> +</sect2> +</sect1> + +<sect1 id="revision-tree"> +<title>The revision tree</title> +<para> +The revision tree try display the whole history of an item so user may get a bette feeling about the history of an item. It has to scan the complete log of the repository 'cause it requires some information subversion does not (and I think will not) give. 'Cause this produces a lot of traffic the revisiontree uses always the internal <link linkend="logcache-descr">logcache</link>. +</para> +<sect2> +<title>Requirements</title> +<para> +The revisiontree is generated via <prompt>dot</prompt>. So for a working revisiontree the <prompt>graphviz</prompt> package must installed. +</para> +</sect2> +</sect1> + +<sect1 id="logcache-descr"> +<title>Internal log cache</title> +<para>&kappname; may use an internal logcache for some operations. Mostly it is used for <link linkend="revision-tree">the revisiontree</link> but when viewing simplified log in offline modus, too. The caches are oranized as sqlite databases stored in <prompt>$HOME/.sqvnqt/logcache</prompt>. Every numbered file is a storage for a different repository.<warning><para>The databases may get large! So you may disable automatic update of logcache in settings.</para></warning>You may simply remove a database, than no cached log will given back for that repository (and no revisiontree!) but when you don't disable automatic filling the cache on next open this repository or an associated working copy of it the cache will refilled again. +</para> +<sect2> +<title>Offline mode</title> +<para>Kdesvn may work without network access, eg., you may switch that no network access is allowed. This may usefull when working without network like on notebooks. In such cases &kappname; always get the logs from the internal cache. At this time (2008-06-23) this log is reduced to base functions due technical reasons, so the cached log may (but not must) differ from real log. Differ means that it will not display all copy operations even <prompt>"Log follows nodechanges"</prompt> is set.</para> +</sect2> +<sect2> +<title>Logcache and revisiontree</title> +<para> +The revisiontree will only use the logcache 'cause otherwise it must get always the logs again. It will NOT refresh the logcache (but this may changed in later releases). +</para> +</sect2> +</sect1> + +<sect1 id="overlay-meaning"> +<title>Meaning of icon overlays</title> +<para> +Entries may be marked with overlayed icons when not in "normal" state. +<variablelist> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnlocked.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Locked</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +This entry is locked. In last column the owner of lock is listed. You may setup if kdesvn should check for locked items in repository, too. But be carefull: depending of the kind of the server this may take a long time! +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnneedlock.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Needs locked</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +This entry must be locked before edit and commit. Until you'll not set a lock subversion keeps it read-only. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnupdates.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Updates</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +This entry or - if a folder - an entry below has newer version in repository. Works only with subversion =>1.2 on local and remote. +</para></listitem> +</varlistentry> + + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnmodified.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Modified</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +This entry or - if a folder - an entry below was changed on local disc. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnadded.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>overlay added</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +This entry is locally added to subversion but not yet committed. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvndeleted.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>overlay deleted</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +This entry is locally deleted from subversion but hasn't yet been committed. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnconflicted.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>overlay deleted</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +This entry (or entry below if folder) got conflicts to resolve with last update. +</para></listitem> +</varlistentry> + +</variablelist> + +</para> +</sect1> + +<sect1 id="kdesvn-passwords"> +<title>&kappname; and passwords</title> +<para> +&kappname;/subversion is able to save passwords. Saving passwords is always a security risk, but may let a graphical frontend more useable. +</para> +<sect2> +<title>Not saving passwords</title> +<para> +Most secure way, but sometimes unhandy with GUIs like &kappname;. In particular the background processes of &kappname; would always ask for a password in case the repository has restricted access for reading operations like update and status. The same for "commit" and so on. So if you not saving passwords you should disable "Check for updates on open working copy" and so on. +</para> +</sect2> +<sect2> +<title>Saving passwords in kdewallet</title> +<para> +Secured password storage used by a lot of kde programs like kmail and konqueror. If you'saving passwords and mostly using kdesvn you should use this. Keep care that the encrypted storage isn't a high-secure storage. Details see kdewallet documentation. +</para> +</sect2> +<sect2> +<title>Saving to subversions own password storage</title> +<para> +This is not recommended 'cause the passwords are stored as cleartext! Not believing? Take a look into the files in <prompt>~/.subversion/auth/svn.simple</prompt>. You should only use this if you're using frequently other clients than &kappname; like rapidsvn or esvn or the original svn commandline client. If you're using the commandline client mostly for checkouts or updates which doesn't require a password and kdesvn for commit/move/copy you should use kdewallet instead. +</para> +</sect2> +<sect2> +<title>Internal password cache</title> +<para> +You may activate an internal password cache which will hold passwords as long &kappname; is running in memory. So you must not enter a password twice even if you didn't save it in wallet. +</para> +</sect2> +<sect2> +<title>Specialcase svn+ssh</title> +<para> +When using subversion via svn+ssh password storage may done via ssh and ssh-agent. For this you must have ssh access to the remote mashine and repository. When want to store you must using the public key authentication of ssh, not the password authentication. (In fact ssh prefer the public key authentication). For this you must put your pulic ssh-key on the target, eg., the repository system. SSH passwords will never handled by subversion passwords storage or kde-wallet or internal password cache. +</para> +<para> +If you don't want asked for the password of you ssh-key you may use the <prompt>ssh-agent</prompt>, with selecting the menu +<menuchoice><guimenu> +Subversion +</guimenu> +<guimenuitem>Add ssh identities to ssh-agent</guimenuitem></menuchoice> +you may store you ssh-key-password for your current session so no further entering of your password is needed. +</para> +</sect2> +</sect1> +</chapter> + +<chapter id="kdesvn-kio"> +<title>Konqueror, KIO, &kappname;</title> +<sect1 id="kdesvn-kio-desc"> +<title>Description</title> +<para> +As of version 0.7.0 of &kappname; it comes with some modules integrating some commands directly into konqueror menus. +<variablelist> +<varlistentry> +<term>KIO protocols</term> +<listitem><para>Implements handlers for following protocols: +<itemizedlist> +<listitem><para>ksvn+http</para></listitem> +<listitem><para>ksvn+https</para></listitem> +<listitem><para>ksvn+file</para></listitem> +<listitem><para>ksvn+ssh</para></listitem> +<listitem><para>ksvn</para></listitem> +</itemizedlist> +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. +</para> +<para> +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. +</para> +<para> +For browsing at a specific revision you may append the query <link linkend="revision-syntax">"?rev=<revision>"</link> to the url. +</para> +</listitem> +</varlistentry> +<varlistentry> +<term>Context menus</term> +<listitem><para> +&kappname; 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 <link linkend="kdesvn-commandline">commandline variant of &kappname;</link>. +</para> +<para> +This menu is static up to kde 3.5, so you should care about what you're selecting. Otherwise &kappname; prints an error box. +</para> +</listitem> +</varlistentry> +</variablelist> +</para> +<sect2> +<title>Usage of KIO outside konqueror - an example</title> +<para> +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. +</para> +<para> +<example> +<title>Retrieving differences between revions using KDiff3 and KIO::ksvn</title> +<programlisting> +kdiff3 \ + ksvn://anonsvn.kde.org/home/kde/trunk/KDE/arts?rev=423127 \ + ksvn://anonsvn.kde.org/home/kde/trunk/KDE/arts?rev=455064 +</programlisting> +<para> +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. +</para> +</example> +</para> +</sect2> +</sect1> +<sect1 id="kio-svn-special"> +<title>Programmers information about KIO::ksvn</title> +<para> +<note><para>You may skip this if not interested in KIO programming.</para></note> +KIO::ksvn::special knows the following operations, these are made almost equal in call to the current existing in KIO from kdesdk +so, for instance, kdevelop may use it if kdesdk isn't installed but uses kdesvn::KIO::svn. +</para> +<sect2> +<title>Commandlist</title> +<para> +<table id="kio-svn-special-commands"> +<title>Command overview for KIO::ksvn::special</title> +<tgroup cols="4"> + +<thead> +<row> +<entry>Name/command</entry> +<entry>Numeric id</entry> +<entry>Parameter list</entry> +<entry>Implemented in 0.11.x?</entry> +</row> +</thead> + +<tbody> + +<row> +<entry>Checkout</entry> +<entry>1</entry> +<entry> +<para> +KURL repository, KURL target, int revnumber, QString revkind +</para> +<para> +The target will NOT be modified, e.g., but the content will be checked out without creating a subfolder! e.g., the source may be +http://server/repos/project/trunk, target /home/user/proj/ then the contents of trunk will copied into /home/user/proj/ not +/home/user/proj/trunk/! +</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Update</entry> +<entry>2</entry> +<entry><para>KURL url,int revnum, QString revstring</para> +<para> +If revnum < 0 the revstring is parsed. +Format of revstring is described in <link linkend="revision-syntax">Appendix</link>. +</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Commit</entry> +<entry>3</entry> +<entry><para>KURL::List urls</para> +<para>urls a list of local urls to commit. Will ask for log.</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Log</entry> +<entry>4</entry> +<entry> +<para> +int startrevnumber,QString startrevstring,int endrevnumber,QString endrevstring,KURL::List +</para> +<para> +Use this with care - this may produce a lot of data. +</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Import</entry> +<entry>5</entry> +<entry>KURL targetrepository, KURL sourcepath</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Add</entry> +<entry>6</entry> +<entry>KURL</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Del</entry> +<entry>7</entry> +<entry>KURL::List</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Revert</entry> +<entry>8</entry> +<entry><para>KURL::List</para> +<para>Revert in KIO is always non-recursive, no questions (calling app must do it itself)</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Status</entry> +<entry>9</entry> +<entry><para>KURL item,bool checkRepos, bool recurse</para> +<para>item - the item check info about, checkRepos - check if there are newer versions in repository, recurse - check recursive or not.</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Mkdir</entry> +<entry>10</entry> +<entry>KURL::List</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Resolve</entry> +<entry>11</entry> +<entry>KURL, bool recursive</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Switch</entry> +<entry>12</entry> +<entry>KURL working_copy_path,KURL new_repository_url,bool recursive,int revnumber, QString revkind</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Diff</entry> +<entry>13</entry> +<entry> +<para>URL uri1, KURL uri2, int r1, QString rstring1, int r2, QString rstring 2, bool recursive</para> +<para>For difference between repository file:/// and working copy setup working copy urls without a protocol!</para> +</entry> +<entry>Yes</entry> +</row> +</tbody> + +</tgroup> +</table> + +</para> +</sect2> +<sect2> +<title>Return values</title> +<para> +Return values may given via metadata, see apidoc for details. +</para> +<para> +<table id="kio-ksvn-metadata"> +<title>Content of metadata</title> +<tgroup cols="2"> + +<thead> +<row> +<entry>Key</entry> +<entry>Possible value</entry> +</row> +</thead> + +<tbody> + +<row> +<entry>path</entry> +<entry>Path of the item action was made on, eg. given url</entry> +</row> + +<row> +<entry>action</entry> +<entry>Numeric action type</entry> +</row> + +<row> +<entry>kind</entry> +<entry>kind of item (mostly dir or file)</entry> +</row> + +<row> +<entry>mime_t</entry> +<entry>Subversion mimetype of item</entry> +</row> + +<row> +<entry>content</entry> +<entry>State of content (subversion value)</entry> +</row> + +<row> +<entry>prop</entry> +<entry>State of properties (subversion value)</entry> +</row> + +<row> +<entry>rev</entry> +<entry>Resulting revision or revision worked on</entry> +</row> + +<row> +<entry>string</entry> +<entry>Internal defined human readable message.</entry> +</row> + +<row> +<entry>loggedaction</entry> +<entry>Subversion defined action string on item (A,M,D)</entry> +</row> +<row> +<entry>loggedcopyfrompath</entry> +<entry>If copied from which path? (may empty)</entry> +</row> +<row> +<entry>loggedcopyfromrevision</entry> +<entry>If copied at which revision? (may < 0)</entry> +</row> +<row> +<entry>loggedpath</entry> +<entry>On which single path the entries logged action and so on are set. (path is set to the calling url)</entry> +</row> +<row> +<entry>diffresult</entry> +<entry>a line of difference output</entry> +</row> +</tbody> + +</tgroup> +</table> + +</para> +</sect2> +</sect1> +</chapter> + +<chapter id="kdesvn-commandline"> +<title>Using kdesvn via commandline</title> +<sect1 id="kdesvn-commandline-overview"> +<title>Overview</title> +<para> +Some subversion operations may used via the commandline, eg., like a standard commandline client but user interaction is made via KDE-UI. The standard syntax is <prompt>kdesvn exec <command> [parameter] <url></prompt>. +</para> +<para> +If a single revision on a single url is wanted it may be set as a parameter of the url +<programlisting>svn://your-server/path-to-repository/item?rev=<your-rev></programlisting> This will overwrite the option <prompt>-r <rev></prompt>. +</para> +<para> +A revision may given as +a number or one of <prompt>HEAD</prompt> or <prompt>BASE</prompt> or as date format like {YYYY-MM-DD}. +</para> +</sect1> +<sect1 id="kdesvn-command-list"> +<title>Commandlist</title> +<para> +If in following overview as possible parameter <prompt>-r revision</prompt> is given, this revision may set as <prompt><url>?rev=the-revision</prompt>. +<table id="svn-commands-table"> +<title>Subversion commands</title> +<tgroup cols="3"> + +<thead> +<row> +<entry>Command</entry> +<entry>Meaning</entry> +<entry>Accepted options</entry> +</row> +</thead> + +<tbody> +<row> +<entry>commit (or ci)</entry> +<entry>commit changes of item to repository</entry> +<entry></entry> +</row> +<row> +<entry>log</entry> +<entry>Print log of item</entry> +<entry>-r startrevision:endrevision -l limit_display</entry> +</row> +<row> +<entry>cat</entry> +<entry>Display content of item</entry> +<entry>-r revision </entry> +</row> +<row> +<entry>copy (or cp)</entry> +<entry>Copy item inside working copy or repository. If target isn't given, &kappname; will prompt.</entry> +<entry></entry> +</row> +<row> +<entry>move (or mv, rename)</entry> +<entry>Move/Rename item inside working copy or repository. If target isn't given, &kappname; will prompt.</entry> +<entry></entry> +</row> +<row> +<entry>get</entry> +<entry>Get content of item and save it</entry> +<entry>-r revision -o <outputfile> (output is required!)</entry> +</row> +<row> +<entry>blame (or annotate)</entry> +<entry>annotate file</entry> +<entry>-r startrevision:endrevision</entry> +</row> +<row> +<entry>update</entry> +<entry>Update item in working copy</entry> +<entry>-r revision</entry> +</row> +<row> +<entry>diff</entry> +<entry>Diff two revisions of item or diff two items at specific revision</entry> +<entry>-r startrev:endrev</entry> +</row> +<row> +<entry>info</entry> +<entry>Detailed information about the item</entry> +<entry>-r revision</entry> +</row> +<row> +<entry>checkout (or co)</entry> +<entry>Checkout repository-path into a new working copy path. Target path and source revision will be asked for.</entry> +<entry></entry> +</row> +<row> +<entry>checkoutto (or coto)</entry> +<entry>Checkout repository-path into a new working copy path. The difference of the source path and source revision will be asked for.</entry> +<entry></entry> +</row> +<row> +<entry>export</entry> +<entry>Export repository- or working copy-path into directory. Target path and source revision will be asked for.</entry> +<entry></entry> +</row> +<row> +<entry>exportto</entry> +<entry>Export repository- or working copy-path into directory. Source path and source revision will be asked for.</entry> +<entry></entry> +</row> +<row> +<entry>delete (del, remove, rm)</entry> +<entry>delete url(s) from repository or working copy.</entry> +<entry></entry> +</row> +<row> +<entry>add</entry> +<entry>add url to working copy. url must belong to a working copy (its not an import!)</entry> +<entry></entry> +</row> +<row> +<entry>revert (or undo)</entry> +<entry>undone current changes to working copy. May only used on working copy urls!</entry> +<entry></entry> +</row> +<row> +<entry>checknew (or addnew)</entry> +<entry>check in given url for new, unversioned items and add them to working copy if wanted.</entry> +<entry></entry> +</row> +<row> +<entry>tree</entry> +<entry>displays revision tree of item (only first argument), if url with "?rev=xxx" given, this revision is the peg-revision.</entry> +<entry>-r startrev:endrev</entry> +</row> +<row> +<entry>lock</entry> +<entry>lock url(s), if "-f" is given then existing locks are brocken.</entry> +<entry>-f</entry> +</row> +<row> +<entry>unlock</entry> +<entry>unlock url(s), if "-f" is given then not owned locks are brocken or non + existing locks are ignored.</entry> +<entry>-f</entry> +</row> +<row> +<entry>help</entry> +<entry>displays this page</entry> +<entry></entry> +</row> +</tbody> +</tgroup> + +</table> + +<table id="parameter-list"> +<title>Parameter for subversion commands</title> +<tgroup cols="3"> +<thead> +<row> +<entry>Parameter</entry> +<entry>Possible values</entry> +<entry>allowed for</entry> +</row> +</thead> +<tbody> +<row> +<entry>-r</entry> +<entry><prompt>revision</prompt> or <prompt>startrev:endrev</prompt></entry> +<entry>all except commit</entry> +</row> +<row> +<entry>-R</entry> +<entry>(none)</entry> +<entry>all except commit</entry> +</row> +<row> +<entry><prompt>-o</prompt></entry> +<entry><prompt><filename></prompt></entry> +<entry>get</entry> +</row> +<row> +<entry><prompt>-l</prompt></entry> +<entry><prompt><number></prompt></entry> +<entry>log</entry> +</row> +<row> +<entry><prompt>-f</prompt></entry> +<entry><prompt></prompt></entry> +<entry>(un-)lock</entry> +</row> + +</tbody> +</tgroup> +</table> + +</para> +<sect2> +<title>The "log" command</title> +<para> +Log command displays a dialog containing the log of the given url. With subversion 1.2 or above it accepts a limit e.g. how many entries it has to display. +</para> +<para> +Inside that dialog you may select log entries and get the differences between them. +<example> +<title>Display the last 20 commit logs</title> +<programlisting> +kdesvn exec log -l 20 -r HEAD:1 myfile.c +</programlisting> +<para>Beware of order of revision: You want go from HEAD to START for the LAST one. So you must giverevision HEAD as starting point, otherwise you would get +the first 20 entries.</para> +</example> +</para> +</sect2> +<sect2> +<title>The "diff" command</title> +<para> +You get differences between revisions of an item or between to items inside same working copy or repository. When diff'ing revisions of an item that revisions +may gived as <prompt>-r STARTREV:ENDREV</prompt>. When diffing an item inside a working copy without any revisions it prints the diff against repository. +<example> +<title>Print difference against repository, eg. local changes</title> +<programlisting> +kdesvn exec diff myfile.c +</programlisting> +</example> +<example> +<title>print difference between revisions</title> +<programlisting> +kdesvn exec diff -r 21:20 myfile.c +</programlisting> +</example> +</para> +<para> +When diffing two items revisions may be appended to url of items. e.g.: +<programlisting>http://server/path/item?rev=HEAD</programlisting> +<example> +<title>Diffing two tagged versions</title> +<programlisting> +kdesvn exec diff http://www.alwins-world.de/repos/kdesvn/tags/rel_0_6_2 http://www.alwins-world.de/repos/kdesvn/tags/rel_0_6_3 +</programlisting> +</example> +</para> +</sect2> +</sect1> +</chapter> + +<chapter id="setup"> +<title>Settings</title> +<para> +Setting may changed from the setup dialog. Them are seperated into some subdialogs. +</para> +<sect1 id="general-settings"> +<title>General</title> +<para> +<informaltable id="General-setup-items"> +<tgroup cols="2"> +<tbody> +<row> +<entry>Size of listviewicons</entry> +<entry>How big (square) the icons in main list view should be</entry> +</row> +<row> +<entry>Show fileinfos</entry> +<entry>If a small tool-tip should appear when moving mouse over an item</entry> +</row> +<row> +<entry>Show preview in fileinfo</entry> +<entry>If kdesvn should show a preview in fileinfo tooltip (local access only, not on networked repositories)</entry> +</row> +<row> +<entry>Mark item status with iconoverlay</entry> +<entry>When an item isn't in normal subversion state it may get an overlay. (See <xref linkend="overlay-meaning" />)</entry> +</row> +<row> +<entry>Items sortorder is casesensitive</entry> +<entry>If the sortorder in mainwindow is case sensitivie or not, eg., if "a" not equal to "A".</entry> +</row> +<row> +<entry>External display</entry> +<entry>Default view on double-click. If set to <prompt>default</prompt> &kappname; uses standard action assigned with entry.</entry> +</row> +<row> +<entry>Maximum logmessages in history</entry> +<entry>How many logmessages &kappname; should remember.</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</para> +</sect1> + +<sect1 id="subversion-settings"> +<title>Subversion settings</title> +<para> +<informaltable id="subversion-settings-table"> +<tgroup cols="2"> + +<tbody> + +<row> +<entry>Start check for updates when open a working copy</entry> +<entry>When open a working copy start a check for updates in background</entry> +</row> +<row> +<entry>Start fill log cache on open</entry> +<entry>If set &kappname; start (re-)filling the logcache when open a repository or working copy if repository url is not assigned local (<programlisting>file://</programlisting>)</entry> +</row> +<row> +<entry>Check if items has svn:needs-lock set</entry> +<entry>Check on working copies if an item has this property set and if yes, displays a special overlayed icon. Setting this may let listings get real slow.</entry> +</row> +<row> +<entry>Get file details while remote listing</entry> +<entry>When checked, kdesvn get more detailed info about file items when making a listing to remote repositories. So you may see remote locks in overview. Be careful: This may let listings REAL slow!</entry> +</row> + +<row> +<entry>Gain item info recursive</entry> +<entry>When activated, "info" on folders will gain information about all items below, may be real slow.</entry> +</row> + +<row> +<entry>Display ignored files</entry> +<entry>Show items marked in subversion for ignore or not.</entry> +</row> + +<row> +<entry>Store passwords for remote connections</entry> +<entry>Storing passwords is often a security problem. Subversion stores its passwords into a flat file, eg., passwords in cleartext! So be carefull setting this flag and see next entry, too. This item only says if saving passwords is the default, you may change it for specific realms inside login dialog.</entry> +</row> + +<row> +<entry>Store passwords into KDE wallet</entry> +<entry>When saving passwords, the cleartext file from subversion is a security hole. &kappname; is able saving them into encrypted kde wallet instead there (starting with version 0.12.0) and use them. On other hand other subversion clients aren't able reading them so you must enter them if using tools like svn-cmdline or rapidsvn, too. As long as subversion don't encrypt password storage you should think twice about it.</entry> +</row> + +<row> +<entry>Use internal password cache</entry> +<entry>When a password isn't stored persistent &kappname; may hold is until &kappname; ends so you may not need enter it again on each operation. This cache is never persistent, eg., it will not saved anywhere.</entry> +</row> + +<row> +<entry>Log follows node changes</entry> +<entry>If checked log follows copy operations.</entry> +</row> + +<row> +<entry>Logs always reads list of changed files</entry> +<entry>The logcommand may read list of changed files in commit. This is usefull and in most cases it cost not real more traffic.</entry> +</row> + +<row> +<entry>Review items before commit</entry> +<entry>When doing a commit &kdesvn; may make a check what to do. Eg., if unversioned items are below which may added, list items changed and current operation will commit. This cost a depending on tree more or less time.</entry> +</row> +<row> +<entry>Maximum displayed logs when full log</entry> +<entry>Doing a "Full log" may cost a much, depending on start-revision. You may limit it to a default maximum value. If set to "0" it is unlimited.</entry> +</row> + +</tbody> + +</tgroup> +</informaltable> + +</para> +</sect1> + +<sect1 id="diffmerge-settings"> +<title>Diff & merge</title> +<para> +<variablelist> + +<varlistentry> +<term>Diff ignore contenttype</term> +<listitem><para> +Only interesting when diff are made with subversion itself. When set, than subversions diff ignores the content type of entries. Otherwise it will not output +diffs from binaries. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Diff in revisiontree is recursive</term> +<listitem><para> +When set, diffs made from within revisiontree view are made recursive like in all other cases, too. Otherwise only changes belonging to that folderitems are shown. How that is made depends on how you let diffs generate (from subversion itself or from external viewers). +</para></listitem> +</varlistentry> +<varlistentry> +<term>Diff ignores white space changes</term> +<listitem> +<para> +Ignore changes in the amount of white space (option "-b" to diff) +</para> +</listitem> +</varlistentry> +<varlistentry> +<term>Diff ignores all white spaces</term> +<listitem> +<para>Ignore all white space (option "-w" to diff)</para> +</listitem> +</varlistentry> +</variablelist> + +</para> +<sect2> +<title>Diff display</title> +<para> +Selects which kind of display for diff-content should use. Default is "kompare" If set to "External display" +you must enter a valid program in "External diff display". Only if internal display is used you may see differences in properties. +</para> +</sect2> +<sect2> +<title>External diff display</title> +<para> +Defines what &kdesvn; is using for external display and how it will called. There are three ways: +</para> +<para> +<variablelist> +<varlistentry> +<term><program> <parameter></term> +<listitem><para> +The difference will generated with subversion and put direct into standard input of the external program (eg., no temporary files needed) +</para></listitem> +</varlistentry> + +<varlistentry> +<term><program> <parameter> %f</term> +<listitem><para> +The difference will generated with subversion, saved into a temporary file and the parameter "%f" will replaced with that filename. +This may used with for instance with a simple call to less or textviewer. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><program> <parameter> %1 %2</term> +<listitem><para> +&kappname; let the external program make the difference. %1 and %2 will replaced with required values (filenames or foldernames). &kappname; +stores content to compare in a temporary environment (when folders do a "export", when single file, does a "cat") when needed and +cleans up after closing external program or closing itself. +</para></listitem> +</varlistentry> +<varlistentry> +<term>Prefer external merge program</term> +<listitem><para>Select if in merge dialog "Use external program" should be checked or not as default.</para></listitem> +</varlistentry> +</variablelist> +</para> +</sect2> +<sect2> +<title>External merge program</title> +<para> +Setup the program and options for using when subversions builtin merge isn't wanted. The default is <prompt>kdiff3 %s1 %s2 %t</prompt>. The order of substitution variables isn't important, and them may there more than once, eg. like <prompt>kdiff3 -o %t %s1 %s2 %t</prompt>. This stuff is only tested with "meld" + and "kdiff3". Think about that external programs mostly doesn't know any about subversion ignore-parameter so them may show lot more than expected. +</para> +<sect3> +<title>Variable substitutions for external merge program</title> +<para> +<variablelist> + +<varlistentry> +<term>%s1</term> +<listitem><para> +Substituted with source number one. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>%s2</term> +<listitem><para> +Substituted with source number two. If this is empty or this is equal to source one and start and end revision is same, this variable +will skipped. So be carefull setting up commandlines like <prompt>xxdiff --title1 %s1 --title2 %s2 %s1 %s2 %t</prompt>. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>%t</term> +<listitem><para> +Substituted with target. +</para></listitem> +</varlistentry> + +</variablelist> + +</para> +</sect3> +</sect2> +<sect2 id="extern-resolve-setup"> +<title>Conflict resolver program</title> +<para> +You may use an external program like <command>kdiff3</command> for resolving conflicts, the default is +<prompt>kdiff3 %o %m %n -o %t</prompt>. +</para> +<sect3> +<title>Variable substitution for externel conflict resolver</title> +<para> +In paranthesis after each description an example how subversion would call the files. This options meaning are designed for kdiff3, 'cause this moment (2008-02-07) this is the only one I know supporting all parameters required for a good conflict resolving. +<variablelist> +<varlistentry> +<term>%o or %l</term> +<listitem><para> +Old (local,left) version. This means the lower revsion number, eg., the start point of conflicted changes. (<prompt>foo.cc.r2</prompt>) +</para></listitem> +</varlistentry> +<varlistentry> +<term>%m or %w</term> +<listitem><para> +Mine (working) version of file, eg., what you had changed against old version. (<prompt>foo.cc.mine</prompt>) +</para></listitem> +</varlistentry> +<varlistentry> +<term>%n or %r</term> +<listitem><para> +New (remote, right) version of file. Eg, version someone other had made. (<prompt>foo.cc.r3</prompt>) +</para></listitem> +</varlistentry> +<varlistentry> +<term>%t</term> +<listitem><para> +Target name, eg., the origin name. For kdiff3 (as an example) this would be name after the <prompt>"-o"</prompt> parameter (= output file). (<prompt>foo.cc</prompt>) +</para></listitem> +</varlistentry> +</variablelist> +</para> +</sect3> +</sect2> +</sect1> +<sect1 id="kio-cmdline-settings"> +<title>KIO / commandline</title> +<para> +<variablelist> + +<varlistentry> +<term>Show log after executing a command</term> +<listitem><para> +Should a dialog open with the log of last made subversion command when it where done via commandline or konqueror action menu. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Minimum loglines to show</term> +<listitem><para> +If "Show log..." is set, what is the minimum of lines before such a dialog will shown. So you may set that such window will +only shown when interesting output was generated (commitlog and so on) +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Don't display contextmenu in konqueror</term> +<listitem><para> +If set, no action menu entry for kdesvn is made in konqueror. Works only with KDE 3.5. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>KIO operations use standard logmessage.</term> +<listitem><para> +When making operations on a repository via the kdesvn KIO protocol from within konqueror (eg., "ksvn+..." protocols) on large operations like moving or copy folders kdesvn would ask for a logmessage for each item. This is a behavior of konqueror. +When this option is set, the KIO implementation from kdesvn will not ask for a logmessage but set a standard logmessage. This flags not the operations from +kdesvn action menu for konqueror but only copy/move/mkdir/delete made with konqueror or other filemanagers on a KIO-url. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Standard message</term> +<listitem><para> +The message kdesvn-kio should set on operations from within konqueror when the flag above is set. Default is "Revision made with kdesvn KIO." +</para></listitem> +</varlistentry> + +</variablelist> + +</para> +</sect1> +</chapter> + +<chapter id="commands"> +<title>Command Reference</title> + +<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the +application windows and their menubar and toolbar commands for easy reference. +Also include any keys that have a special function but have no equivalent in the +menus or toolbars. This may not be necessary for small apps or apps with no tool +or menu bars. --> + +<sect1 id="kdesvn-mainwindow"> +<title>The main &kdesvn; window</title> + +<sect2> +<title>The File Menu</title> +<para> +<variablelist> +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> +</shortcut> +<guimenu>File</guimenu> +<guimenuitem>Open</guimenuitem> +</menuchoice></term> +<listitem><para><action>Open a local working copy or a repository previously checked out</action></para></listitem> +</varlistentry> +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo> +</shortcut> +<guimenu>File</guimenu> +<guimenuitem>Close</guimenuitem> +</menuchoice> +</term> +<listitem><para><action>Close</action> current opened repository or working copy</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> +</shortcut> +<guimenu>File</guimenu> +<guimenuitem>Quit</guimenuitem> +</menuchoice></term> +<listitem><para><action>Quits</action> &kdesvn;</para></listitem> +</varlistentry> +</variablelist> +</para> +</sect2> +<sect2> +<title>The <guimenu>Bookmark</guimenu> Menu</title> +<para> +see konqueror help +</para> +</sect2> +<sect2 id="kdesvn-subversion-menu"> +<title>The <guimenu>Subversion</guimenu> Menu</title> +<variablelist> + +<varlistentry> +<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guimenuitem>Refresh view</guimenuitem> +</menuchoice></term> +<listitem><para><action>Refresh</action> the current status of all displayed items. This will list each item asked for to be displayed at current status. +</para></listitem> + +</varlistentry> +</variablelist> +<sect3> +<title>General subversion actions</title> +<variablelist> +<varlistentry> +<term> +<menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Full log</guimenuitem> +</menuchoice></term> +<listitem> +<para><action>Display</action> lifetime log of the the currently selected item. +Be careful, this list may be really big!</para> +</listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl; &Shift;<keycap>L</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Log...</guimenuitem> +</menuchoice></term> +<listitem><para>Displays a log where a revision/date range may selected before.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>I</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Details</guimenuitem> +</menuchoice></term> +<listitem><para>Displays detailed information about selected item(s)</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Blame</guimenuitem> +</menuchoice></term> +<listitem><para>Makes an annotated list over all checkins. That may consume time!</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Blame range</guimenuitem> +</menuchoice></term> +<listitem><para>Annotate a range of commits for a file.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Cat head</guimenuitem> +</menuchoice></term> +<listitem><para>Shows the content of the last commited version of that entry. (May be different to working copy version if working on a WC!)</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>F2</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Move</guimenuitem> +</menuchoice></term> +<listitem><para>Move or rename item inside working copy or in repository</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>F5</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Copy</guimenuitem> +</menuchoice></term> +<listitem><para>Copy item inside working copy or in repository</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>Del</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Delete selected files/dirs</guimenuitem> +</menuchoice></term> +<listitem><para>Delete selected entries. If working in a working copy you must commit your deletions afterwards.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Make (sub-)directory</guimenuitem> +</menuchoice></term> +<listitem><para>Create a new directory</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Import directories into current</guimenuitem> +</menuchoice></term> +<listitem><para>Select directories you want to import into the current selected directory</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Checkout a repository</guimenuitem> +</menuchoice></term> +<listitem><para>Creates a new working copy of a repository</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Export a repository</guimenuitem> +</menuchoice></term> +<listitem><para>Exports a repository to filesystem, eg. creates a clean directory tree without +subversion information. +</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Lock current items</guimenuitem> +</menuchoice></term> +<listitem><para>Mark current items as locked. Read the subversion handbook before using this! +</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>General</guisubmenu> +<guimenuitem>Unlock current items</guimenuitem> +</menuchoice></term> +<listitem><para>Remove locks on current items. Read the subversion handbook before using this! +</para></listitem> +</varlistentry> +</variablelist> +</sect3> +<sect3> +<title>Working copy</title> +<variablelist> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>u</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Update to head</guimenuitem> +</menuchoice></term> +<listitem><para>Update working copy to HEAD of repository</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Update to revision...</guimenuitem> +</menuchoice></term> +<listitem><para>Update working copy to a specific revision of repository</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>#</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Commit</guimenuitem> +</menuchoice></term> +<listitem><para>Commit changes inside working copy for selected items to repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Diff local changes</guimenuitem> +</menuchoice></term> +<listitem><para>Display local changes as diff-output (without network access). This is the difference only to +last state the working copy was updated to, not against the version in repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Diff against head</guimenuitem> +</menuchoice></term> +<listitem><para>Diff's current working copy against head of repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>P</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Properties</guimenuitem> +</menuchoice></term> +<listitem><para>View/Edit properties assigned with current entry.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>Insert</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Add selected files/dirs</guimenuitem> +</menuchoice></term> +<listitem><para>Add selected files and/or directories to version control.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Revert current changes</guimenuitem> +</menuchoice></term> +<listitem><para>Revert changes made in working copy and updates to last updated state.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Resolve recursive</guimenuitem> +</menuchoice></term> +<listitem><para>Mark conflicted items as not conflicted and removes associated files.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Merge two revisions</guimenuitem> +</menuchoice></term> +<listitem><para>Merge two revisions of entries into working copy.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Ignore/Unignore current item</guimenuitem> +</menuchoice></term> +<listitem><para>Edit property of parent directory of current item so that selected item will marked as ignored if not set, otherwise remove it from ignorelist.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Cleanup</guimenuitem> +</menuchoice></term> +<listitem><para>Clean up the working copy and removes (commit-)locks if any</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Switch repository</guimenuitem> +</menuchoice></term> +<listitem><para>Switch the root of the current working copy. "relocate" This is not supported at this moment.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Working copy</guisubmenu> +<guimenuitem>Switch to repository</guimenuitem> +</menuchoice></term> +<listitem><para>Opens the repository tree of another working copy.</para></listitem> +</varlistentry> +</variablelist> +</sect3> +<sect3> +<title>Repository</title> +<variablelist> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Repository</guisubmenu> +<guimenuitem>Checkout current repository path</guimenuitem> +</menuchoice></term> +<listitem><para>Create a working copy from the current selected entry if a directory.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Repository</guisubmenu> +<guimenuitem>Export current repository path</guimenuitem> +</menuchoice></term> +<listitem><para>Create a clean copy on local filesystem from the current selected entry if a directory.</para></listitem> +</varlistentry> +</variablelist> +</sect3> +</sect2> +<sect2> +<title>The <guimenu>Help</guimenu> Menu</title> + +<!-- Assuming you have a standard help menu (help, what's this, about --> +<!-- &kdesvn;, about KDE) then the documentation is already written. --> +<!-- The following entity is valid anywhere that a variablelist is --> +<!-- valid. --> + +&help.menu.documentation; + +</sect2> + +<sect2 id="kdesvn-svntoolbar"> +<title>The subversion toolbar</title> +<variablelist> +<varlistentry> +<term> +<guibutton>Open</guibutton> +</term> +<listitem><para>Open a working copy</para></listitem> +</varlistentry> +</variablelist> +</sect2> + +</sect1> +</chapter> + +<chapter id="faq"> +<title>Questions and Answers</title> + +<!-- (OPTIONAL but recommended) This chapter should include all of the silly +(and not-so-silly) newbie questions that fill up your mailbox. This chapter +should be reserved for BRIEF questions and answers! If one question uses more +than a page or so then it should probably be part of the +"Using this Application" chapter instead. You should use links to +cross-reference questions to the parts of your documentation that answer them. +This is also a great place to provide pointers to other FAQ's if your users +must do some complicated configuration on other programs in order for your +application work. --> + +<!-- +&reporting.bugs; +&updating.documentation; +--> + +<qandaset id="faqlist"> +<qandaentry> +<question> +<para>When using the (k)svn+ssh protocol it asks all the time for password again. Why?</para> +</question> +<answer> +<para> +The "problem" is ssh itself. Subversion creates for each command sending a tunnel +to the repository. And on each tunnel it is a new ssh connection. And for every connection ssh must +authenticate. This may you fix when you store your local public identity to the host containing the +repository. If your public identity has a password, ssh-agent will asked (when ssh-agent is installed). +</para> +<para> +When you're running a ssh-agent before starting &kdesvn;, you should add your identity to its cache, &kdesvn; will not +modifiy it due security reasons, so it would ask for your password again and again. (see <ulink url="man:ssh-add">Manpage of ssh-add</ulink>) +</para> +</answer> +</qandaentry> +<qandaentry> +<question> +<para>The password prompt for (k)svn+ssh comes on terminal when kdesvn started from there, how do I switch off this?</para> +</question> +<answer> +<para> +It may not switched off. This is a feature of ssh-agent itself, when it see it has a terminal it asks for password in terminal not +in a X-Dialog like kdesvnaskpass. (see <ulink url="man:ssh-add">Manpage of ssh-add</ulink>). +</para> +</answer> +</qandaentry> +<qandaentry> +<question> +<para>When checking for updates kdesvn doesn't display something but I know there are newer items!</para> +</question> +<answer> +<para> +Updates may only displayed when the remote server is subversion 1.2, too. Eg., seems that repository runs with +subversion <1.2. It is not planned that &kdesvn; do that check recursive itself - this makes no sense. Ask for upgrading +repository to newer subversion. +</para> +</answer> +</qandaentry> +<qandaentry> +<question> +<para>When starting kdesvn it sends a dialog "Could not find our part" and shows an empty window, why?</para> +</question> +<answer> +<para> +There are many reasons why the program couldn't load. This mostly happens when you building subversion-libs yourself. In that case you may +check out <ulink url="http://kdesvn.alwins-world.de/ticket/128">issue entry</ulink>. +</para> +<para> +The next big thing could that you forgot to give a libsuffix on 64-Bit systems at compile-time. So the part will installed in <prompt>$PREFIX/lib</prompt> instead of <prompt>$PREFIX/lib64</prompt>. So give <prompt>-DLIB_SUFFIX=64</prompt> as paramter to cmake. +</para> +<para>If this does not solve your problem, you may try out on a console: +<programlisting> + export LD_PRELOAD=/usr/lib/kde3/libkdesvnpart.so + kdesvn + unset LD_PRELOAD +</programlisting> +(/usr/lib/kde3 depends of course on your system, please check where it is installed) +</para> +<para> +You should see a lot of output why loading of libkdesvnpart.so isn't possible, that may help solving your problem. +</para> +</answer> +</qandaentry> +</qandaset> +</chapter> + +<appendix id="revision-syntax"> +<title>Syntax for revisions</title> +<para> +Revisions may given in same form like to the standard svn - client. That means: number, keyword or date. +</para> +<para> +<variablelist> + +<varlistentry> +<term>Number</term> +<listitem><para> +A number greater or equal -1. -1 means "unspecified revision", 0 is the beginning. Normaly these numbers shouldn't used (most operations will fail with that). +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Keyword</term> +<listitem><para> +One of +<itemizedlist> + +<listitem><para> +HEAD +</para></listitem> + +<listitem><para> +BASE +</para></listitem> + +<listitem><para> +COMMITED +</para></listitem> + +<listitem><para> +PREV +</para></listitem> + +<listitem><para> +START +</para></listitem> + +<listitem><para> +WORKING +</para></listitem> + +</itemizedlist> + +</para> +<para> +The keywords are case sensitive! eg, head is not the same like HEAD. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>Date</term> +<listitem><para> +Date in form {YYYY-MM-DD}. It must real MM or DD - eg. 2005-1-1 must written as {2005-01-01}. +</para></listitem> +</varlistentry> + +</variablelist> + +</para> +<para> +Appending a specific revision to an url will always made via "?rev=<revision>. +</para> +</appendix> + +<appendix id="further"> +<title>Further information</title> +<sect1> +<title>Reporting bugs / Feedback</title> +<para> +Bugreports and wishes may send to <email>[email protected]</email>, questions about usage or any other feedback to <email>[email protected]</email>. +</para> +<para> +An overview for the mailinglists for &kappname; you may get in the <ulink url="http://lists.alwins-world.de/mailman/listinfo">mailinglist overview</ulink>. +</para> +</sect1> +<sect1 id="credits-and-license"> +<!-- Include credits for the programmers, documentation writers, and +contributors here. The license for your software should then be included below +the credits with a reference to the appropriate license file included in the KDE +distribution. --> +<title>Credits and License and Thanks</title> +<para> +Program copyright 2005-2006 Rajko Albrecht <email>[email protected]</email> +</para> +<para> +Many tnx to contributors: +<itemizedlist> +<listitem><para>Andreas Richter <email>[email protected]</email> - for qt4 port of svnqt</para> +</listitem> +<listitem><para>Michael Biebl <email>[email protected]</email> - for a lot of help, ideas, implementation and hints.</para> +</listitem> +<listitem><para>Bram Schoenmakers <email>[email protected]</email> - for kde-specific hints, dutch translation, cleaning up my code.</para> +</listitem> +</itemizedlist> +And tnx to all other translators (I never thought that I get that fast such a lot of translations!) and for all of your positive and negative feedback. It helped a lot. +</para> +<para> +If you want your own translation for &kappname; and may want help please read on the homepage of &kappname; or ask on <ulink url="mailto:[email protected]"><email>[email protected]</email> mailinglist</ulink>. +</para> +<para> +Documentation copyright 2005-2006 Rajko Albrecht <email>[email protected]</email> +</para> +<!-- TRANS:CREDIT_FOR_TRANSLATORS --> + +&underFDL; <!-- FDL: do not remove --> +<!-- Determine which license your application is licensed under, + and delete all the remaining licenses below: + + (NOTE: All documentation are licensed under the FDL, + regardless of what license the application uses) --> + +&underGPL; <!-- GPL License --> +<!-- &underBSDLicense; --><!-- BSD License --> +<!-- &underArtisticLicense; --><!-- BSD Artistic License --> +<!-- &underX11License; --><!-- X11 License --> +</sect1> + +</appendix> + +<appendix id="installation"> +<title>Installation</title> + +<sect1 id="getting-kdesvn"> +<title>How to obtain &kdesvn;</title> + +<!-- This first entity contains boiler plate for applications that are +part of KDE CVS. You should remove it if you are releasing your +application --> +<para> +&kdesvn; itself can be found +at <ulink url="http://kdesvn.alwins-world.de/trac.fcgi/downloads/"> +the &kdesvn; download area</ulink>. +</para> +<para> +You may get <ulink url="http://kdesvn.alwins-world.de/trac.fcgi/browser/trunk">latest repository version</ulink> when looking whats going on. +</para> +<para> +The homepage of that project is <ulink url="http://kdesvn.alwins-world.de/">http://kdesvn.alwins-world.de/</ulink> +</para> +</sect1> + +<sect1 id="requirements"> +<title>Requirements</title> + +<!-- +List any special requirements for your application here. This should include: +.Libraries or other software that is not included in kdesupport, +kdelibs, or kdebase. +.Hardware requirements like amount of RAM, disk space, graphics card +capabilities, screen resolution, special expansion cards, etc. +.Operating systems the app will run on. If your app is designed only for a +specific OS, (you wrote a graphical LILO configurator for example) put this +information here. +--> + +<para> +You need installed subversion 1.3 or above and &kde; 3.4.x +or above. Subversion prior 1.3 is NOT supported! +</para> +<para> +Subversion may found on <ulink url="http://subversion.tigris.org">its homepage</ulink> but your +distributor should have packages for your system and/or distribution. +</para> +<!-- For a list of updates, you may refer to the application web site +or the ChangeLog file, or ... --> +<para> +You can find a list of changes at <ulink +url="http://kdesvn.alwins-world.de/trac.fcgi/browser/trunk/ChangeLog">http://kdesvn.alwins-world.de/browser/trunk/ChangeLog</ulink>. +</para> +</sect1> + +<sect1 id="compilation"> +<title>Compilation and Installation</title> +<para> +&kappname; requires at least cmake 2.4 for building, automake isn't supported. The following steps works with both distribution tarball or tarball from repository. Unpack the archive +or checkout / export a copy from repository and change to the resulting sourcedirectory. +</para> +<para> +<screen> +<prompt>%</prompt> <userinput><command>mkdir</command> build</userinput> +<prompt>%</prompt> <userinput><command>cd</command> build</userinput> +<prompt>%</prompt> <userinput><command>cmake</command> ../ -DCMAKE_INSTALL_PREFIX=`kde-config --prefix` -DCMAKE_BUILD_TYPE=Release</userinput> +<prompt>%</prompt> <userinput><command>make</command></userinput> +<prompt>%</prompt> <userinput><command>make</command> install</userinput> +</screen> +</para> +</sect1> + +</appendix> + +&documentation.index; +</book> diff --git a/doc/makecommon.sh b/doc/makecommon.sh new file mode 100755 index 0000000..f38eabd --- /dev/null +++ b/doc/makecommon.sh @@ -0,0 +1,16 @@ +#!/bin/sh + +if [ "x$1" = "x" ]; then + echo "No source" + exit 0 +fi +if [ "x$2" = "x" ]; then + echo "No target" + exit 0 +fi + +if [ ! -h $1 ]; then + echo "linking $2 -> $1" + ln -fs "$2" "$1" +fi + diff --git a/doc/makelink.cmake b/doc/makelink.cmake new file mode 100644 index 0000000..3c64ed4 --- /dev/null +++ b/doc/makelink.cmake @@ -0,0 +1,18 @@ +IF($ENV{DESTDIR} MATCHES ".+") + SET(DESTDIR $ENV{DESTDIR}) +ELSE($ENV{DESTDIR} MATCHES ".+") + SET(DESTDIR "") +ENDIF($ENV{DESTDIR} MATCHES ".+") + +SET(COMMONLINK "${DESTDIR}${CMAKE_INSTALL_PREFIX}/share/doc/HTML/en/kdesvn/common") + +MESSAGE(STATUS "Generating ${COMMONLINK}") + +EXECUTE_PROCESS( + COMMAND "rm" "-f" "common" + COMMAND ln "-s" "../common" "common" + WORKING_DIRECTORY "${DESTDIR}/${CMAKE_INSTALL_PREFIX}/share/doc/HTML/en/kdesvn" + ) + +SET(CMAKE_INSTALL_MANIFEST_FILES ${CMAKE_INSTALL_MANIFEST_FILES} "${CMAKE_INSTALL_PREFIX}/share/doc/HTML/en/kdesvn/common") + diff --git a/doc/man/CMakeLists.txt b/doc/man/CMakeLists.txt new file mode 100644 index 0000000..941a995 --- /dev/null +++ b/doc/man/CMakeLists.txt @@ -0,0 +1,8 @@ +SET(MANFILES + kdesvn.1 + kdesvnaskpass.1) + +INSTALL(FILES + ${MANFILES} + DESTINATION share/man/man1) + diff --git a/doc/man/kdesvn.1 b/doc/man/kdesvn.1 new file mode 100644 index 0000000..2c69012 --- /dev/null +++ b/doc/man/kdesvn.1 @@ -0,0 +1,166 @@ +.\" This file was generated by kdemangen.pl +.TH KDESVN 1 "Aug 2006" "K Desktop Environment" "A Subversion Client for KDE (standalone application)" +.SH NAME +kdesvn +\- A Subversion Client for KDE (standalone application) +.SH SYNOPSIS +kdesvn [Qt\-options] [KDE\-options] [options] exec <command> [URL] +.SH DESCRIPTION +A Subversion Client for KDE (standalone application) +.SH OPTIONS +.SS +.SS Arguments: +.TP +.B exec +<command> Execute subversion command ("exec help" for more information) +.TP +.B URL +Document to open +.SS Options: +.TP +.B \-r startrev +[:endrev] Execute single subversion command on specific revision(-range) +.TP +.B \-R +Ask for revision when executing single command +.TP +.B \-o <file> +Save output of subversion command (eg "cat") into file <file> +.TP +.B \-l <number> +Limit log output to <number> +.SS +.SS Generic options: +.TP +.B \-\-help +Show help about options +.TP +.B \-\-help\-qt +Show Qt specific options +.TP +.B \-\-help\-kde +Show KDE specific options +.TP +.B \-\-help\-all +Show all options +.TP +.B \-\-author +Show author information +.TP +.B \-v, \-\-version +Show version information +.TP +.B \-\-license +Show license information +.TP +.B \-\- +End of options +.SS +.SS KDE options: +.TP +.B \-\-caption <caption> +Use 'caption' as name in the titlebar +.TP +.B \-\-icon <icon> +Use 'icon' as the application icon +.TP +.B \-\-miniicon <icon> +Use 'icon' as the icon in the titlebar +.TP +.B \-\-config <filename> +Use alternative configuration file +.TP +.B \-\-dcopserver <server> +Use the DCOP Server specified by 'server' +.TP +.B \-\-nocrashhandler +Disable crash handler, to get core dumps +.TP +.B \-\-waitforwm +Waits for a WM_NET compatible windowmanager +.TP +.B \-\-style <style> +sets the application GUI style +.TP +.B \-\-geometry <geometry> +sets the client geometry of the main widget - see man X for the argument format +.SS +.SS Qt options: +.TP +.B \-\-display <displayname> +Use the X-server display 'displayname' +.TP +.B \-\-session <sessionId> +Restore the application for the given 'sessionId' +.TP +.B \-\-cmap +Causes the application to install a private color +map on an 8-bit display +.TP +.B \-\-ncols <count> +Limits the number of colors allocated in the color +cube on an 8-bit display, if the application is +using the QApplication::ManyColor color +specification +.TP +.B \-\-nograb +tells Qt to never grab the mouse or the keyboard +.TP +.B \-\-dograb +running under a debugger can cause an implicit +-nograb, use -dograb to override +.TP +.B \-\-sync +switches to synchronous mode for debugging +.TP +.B \-\-fn, \-\-font <fontname> +defines the application font +.TP +.B \-\-bg, \-\-background <color> +sets the default background color and an +application palette (light and dark shades are +calculated) +.TP +.B \-\-fg, \-\-foreground <color> +sets the default foreground color +.TP +.B \-\-btn, \-\-button <color> +sets the default button color +.TP +.B \-\-name <name> +sets the application name +.TP +.B \-\-title <title> +sets the application title (caption) +.TP +.B \-\-visual TrueColor +forces the application to use a TrueColor visual on +an 8-bit display +.TP +.B \-\-inputstyle <inputstyle> +sets XIM (X Input Method) input style. Possible +values are onthespot, overthespot, offthespot and +root +.TP +.B \-\-im <XIM server> +set XIM server +.TP +.B \-\-noxim +disable XIM +.TP +.B \-\-reverse +mirrors the whole layout of widgets +.SS + +.SH SEE ALSO +Full user documentation is available through the KDE Help Center. You can also enter the URL +.BR help:/kdesvn/ +directly into konqueror or you can run +.BR "`khelpcenter help:/kdesvn/'" +from the command-line. +.br +.SH AUTHORS +.nf +Rajko Albrecht <[email protected]> +.br + diff --git a/doc/man/kdesvnaskpass.1 b/doc/man/kdesvnaskpass.1 new file mode 100644 index 0000000..13a22b7 --- /dev/null +++ b/doc/man/kdesvnaskpass.1 @@ -0,0 +1,147 @@ +.\" This file was generated by kdemangen.pl +.TH KDESVNASKPASS 1 "Aug 2006" "K Desktop Environment" "ssh-askpass for kdesvn" +.SH NAME +kdesvnaskpass +\- ssh-askpass for kdesvn +.SH SYNOPSIS +kdesvnaskpass [Qt\-options] [KDE\-options] [prompt] +.SH DESCRIPTION +ssh-askpass for kdesvn +.SH OPTIONS +.SS +.SS Arguments: +.TP +.B prompt +prompt +.SS Generic options: +.TP +.B \-\-help +Show help about options +.TP +.B \-\-help\-qt +Show Qt specific options +.TP +.B \-\-help\-kde +Show KDE specific options +.TP +.B \-\-help\-all +Show all options +.TP +.B \-\-author +Show author information +.TP +.B \-v, \-\-version +Show version information +.TP +.B \-\-license +Show license information +.TP +.B \-\- +End of options +.SS +.SS KDE options: +.TP +.B \-\-caption <caption> +Use 'caption' as name in the titlebar +.TP +.B \-\-icon <icon> +Use 'icon' as the application icon +.TP +.B \-\-miniicon <icon> +Use 'icon' as the icon in the titlebar +.TP +.B \-\-config <filename> +Use alternative configuration file +.TP +.B \-\-dcopserver <server> +Use the DCOP Server specified by 'server' +.TP +.B \-\-nocrashhandler +Disable crash handler, to get core dumps +.TP +.B \-\-waitforwm +Waits for a WM_NET compatible windowmanager +.TP +.B \-\-style <style> +sets the application GUI style +.TP +.B \-\-geometry <geometry> +sets the client geometry of the main widget - see man X for the argument format +.SS +.SS Qt options: +.TP +.B \-\-display <displayname> +Use the X-server display 'displayname' +.TP +.B \-\-session <sessionId> +Restore the application for the given 'sessionId' +.TP +.B \-\-cmap +Causes the application to install a private color +map on an 8-bit display +.TP +.B \-\-ncols <count> +Limits the number of colors allocated in the color +cube on an 8-bit display, if the application is +using the QApplication::ManyColor color +specification +.TP +.B \-\-nograb +tells Qt to never grab the mouse or the keyboard +.TP +.B \-\-dograb +running under a debugger can cause an implicit +-nograb, use -dograb to override +.TP +.B \-\-sync +switches to synchronous mode for debugging +.TP +.B \-\-fn, \-\-font <fontname> +defines the application font +.TP +.B \-\-bg, \-\-background <color> +sets the default background color and an +application palette (light and dark shades are +calculated) +.TP +.B \-\-fg, \-\-foreground <color> +sets the default foreground color +.TP +.B \-\-btn, \-\-button <color> +sets the default button color +.TP +.B \-\-name <name> +sets the application name +.TP +.B \-\-title <title> +sets the application title (caption) +.TP +.B \-\-visual TrueColor +forces the application to use a TrueColor visual on +an 8-bit display +.TP +.B \-\-inputstyle <inputstyle> +sets XIM (X Input Method) input style. Possible +values are onthespot, overthespot, offthespot and +root +.TP +.B \-\-im <XIM server> +set XIM server +.TP +.B \-\-noxim +disable XIM +.TP +.B \-\-reverse +mirrors the whole layout of widgets +.SS + +.SH SEE ALSO +Full user documentation is available through the KDE Help Center. You can also enter the URL +.BR help:/kdesvnaskpass/ +directly into konqueror or you can run +.BR "`khelpcenter help:/kdesvnaskpass/'" +from the command-line. +.br +.SH AUTHORS +.nf + diff --git a/doc/nl/hi128-filesys-kdesvnadded.png b/doc/nl/hi128-filesys-kdesvnadded.png Binary files differnew file mode 100644 index 0000000..e01579d --- /dev/null +++ b/doc/nl/hi128-filesys-kdesvnadded.png diff --git a/doc/nl/hi128-filesys-kdesvnconflicted.png b/doc/nl/hi128-filesys-kdesvnconflicted.png Binary files differnew file mode 100644 index 0000000..61f9db7 --- /dev/null +++ b/doc/nl/hi128-filesys-kdesvnconflicted.png diff --git a/doc/nl/hi128-filesys-kdesvndeleted.png b/doc/nl/hi128-filesys-kdesvndeleted.png Binary files differnew file mode 100644 index 0000000..ca3b090 --- /dev/null +++ b/doc/nl/hi128-filesys-kdesvndeleted.png diff --git a/doc/nl/hi128-filesys-kdesvnlocked.png b/doc/nl/hi128-filesys-kdesvnlocked.png Binary files differnew file mode 100644 index 0000000..ee0bc7c --- /dev/null +++ b/doc/nl/hi128-filesys-kdesvnlocked.png diff --git a/doc/nl/hi128-filesys-kdesvnmodified.png b/doc/nl/hi128-filesys-kdesvnmodified.png Binary files differnew file mode 100644 index 0000000..3042eb4 --- /dev/null +++ b/doc/nl/hi128-filesys-kdesvnmodified.png diff --git a/doc/nl/hi128-filesys-kdesvnneedlock.png b/doc/nl/hi128-filesys-kdesvnneedlock.png Binary files differnew file mode 100644 index 0000000..d057ea2 --- /dev/null +++ b/doc/nl/hi128-filesys-kdesvnneedlock.png diff --git a/doc/nl/hi128-filesys-kdesvnupdates.png b/doc/nl/hi128-filesys-kdesvnupdates.png Binary files differnew file mode 100644 index 0000000..3902655 --- /dev/null +++ b/doc/nl/hi128-filesys-kdesvnupdates.png diff --git a/doc/nl/index.docbook b/doc/nl/index.docbook new file mode 100644 index 0000000..8747869 --- /dev/null +++ b/doc/nl/index.docbook @@ -0,0 +1,2174 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kdesvn "<application>kdesvn</application>"> + <!ENTITY kappname "&kdesvn;"><!-- Do *not* replace kappname--> + <!ENTITY package "kde-module"><!-- kdebase, kdeadmin, etc --> + <!ENTITY % addindex "IGNORE"> + <!ENTITY konqi "<application>konqueror</application>"> + <!ENTITY krus "<application>krusader</application>"> + <!ENTITY % English "INCLUDE"><!-- change language only here --> + + + <!-- Do not define any other entities; instead, use the entities + from kde-genent.entities and $LANG/user.entities. --> +]> +<!-- ................................................................ --> + +<!-- The language must NOT be changed here. --> + +<book lang="&language;"> + +<!-- This header contains all of the meta-information for the document such +as Authors, publish date, the abstract, and Keywords --> + +<bookinfo> +<title>Het &kappname; handboek</title> + +<authorgroup> +<author> +<firstname>Rajko</firstname> +<othername></othername> +<surname>Albrecht</surname> +<affiliation> +<address><email>[email protected]</email></address> +</affiliation> +</author> +</authorgroup> + +<!-- TRANS:ROLES_OF_TRANSLATORS --> + +<copyright> +<year>2005</year> +<year>2006</year> +<holder>Rajko Albrecht</holder> +</copyright> + + +<!-- Translators: put here the copyright notice of the translation --> +<!-- Put here the FDL notice. Read the explanation in fdl-notice.docbook + and in the FDL itself on how to use it. --> +<legalnotice>&FDLNotice;</legalnotice> + +<!-- Date and version information of the documentation +Don't forget to include this last date and this last revision number, we +need them for translation coordination ! +Please respect the format of the date (YYYY-MM-DD) and of the version +(V.MM.LL), it could be used by automation scripts. +Do NOT change these in the translation. --> + +<date>$Date: 2007-10-16 12:53:18 +0200 (Di, 16 Okt 2007) $</date> +<releaseinfo>0.3</releaseinfo> + +<!-- Abstract about this handbook --> + +<abstract> +<para> +&kappname; - een subversion cliënt voor &kde;. +</para> +</abstract> + +<!-- This is a set of Keywords for indexing by search engines. +Please at least include KDE, the KDE package it is in, the name + of your application, and a few relevant keywords. --> + +<keywordset> +<keyword>KDE</keyword> +<keyword>kdesvn</keyword> +<keyword>subversion</keyword> +<keyword>version control system</keyword> +</keywordset> + +</bookinfo> + +<!-- The contents of the documentation begin here. Label +each chapter so with the id attribute. This is necessary for two reasons: it +allows you to easily reference the chapter from other chapters of your +document, and if there is no ID, the name of the generated HTML files will vary +from time to time making it hard to manage for maintainers and for the CVS +system. Any chapter labelled (OPTIONAL) may be left out at the author's +discretion. Other chapters should not be left out in order to maintain a +consistent documentation style across all KDE apps. --> + +<chapter id="introduction"> +<title>Overzicht</title> + +<!-- The introduction chapter contains a brief introduction for the +application that explains what it does and where to report +problems. Basically a long version of the abstract. Don't include a +revision history. (see installation appendix comment) --> + +<para> +&kappname; is een <ulink url="http://subversion.tigris.org/">subversion client</ulink> voor &kde;. +</para> +<para>Subsversion wordt bekend geacht, maar hopelijk leggen de meeste items zichzelf uit. +</para> +<para> +Gebruik <ulink url="http://kdesvn.alwins-world.de/">kdesvn.alwins-world.de/ om bugs (programmafouten) en wensen te rapporteren. +</ulink> +</para> + +<sect1 id="kdesvn-terms"> +<title>Termen</title> +<para> +Indien revisie controle systemen bekend zijn, dan kan dit overgeslagen worden - of lees en korrigeer de auteur ;) +</para> +<para> +<variablelist> +<varlistentry> +<term>Repository</term> +<listitem><para> +Centrale opslag van data. Dit kan een database of een plat bestandsysteem zijn. Zonder een speciale cliënt kan de data hierin niet bekeken worden. Voor Subversion repositories is &kappname; een dergelijke cliënt. +</para></listitem> +</varlistentry> +<varlistentry> +<term>werkkopie</term> +<listitem><para> +Een platte kopie van een repository in een lokaal bestandsysteem. Dit wordt gebruikt met een normale bestandsbeheerder, bestanden bewerken enzovoort. +RCS-informatie kan bekeken worden met cliënten zoals &kappname;. +</para> +<para> +Vergeet niet dat subversion niets weet over KIO, een werkkopie moet daarom op een plek staan waar het bereikt kan worden zonder een speciaal protocool, b.v. "fish://" of vergelijkbare zijn niet mogelijk. +</para> +</listitem> +</varlistentry> +<varlistentry> +<term>WebDav</term> +<listitem><para> +WebDav is een protocool waarmee op afstand bestanden op een webserver veranderd kunnen worden. Subversion is een speciaal soort WebDAV wanneer toegang tot repositories via een webserver. Normaal is dit alleen lezen. Met speciale instellingen is een lees- en schrijfbare WebDAV mogelijk zodat toegang via een speciale browser mogelijk is. &kappname; is geen webdav-client, Maar Konqueror kan wel met "webdav://" protocool werken. Met &kappname; kan er gebladerd worden door de revisieboom van een repository (via "http://") +</para></listitem> +</varlistentry> +</variablelist> +</para> +</sect1> +</chapter> + +<chapter id="using-kdesvn"> +<title>&kappname; gebruiken</title> +<sect1 id="kdesvn-features"> +<title>De mogelijkheden van &kappname;.</title> +<para> +&kappname; kan de volgende protocolen gebruiken om door repositories te bladeren: +<variablelist> + +<varlistentry> +<term>http</term> +<listitem><para> +Standaard web browser protocool. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>https</term> +<listitem><para> +Standaard versleutelde web browser protocool +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn+http</term> +<listitem><para> +Standaard web browser protocool. kan gebruikt worden om konqueror automatisch &kappname; te laten starten. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn+https</term> +<listitem><para> +Standaard versleutelde web browser protocool. kan gebruikt worden om konqueror automatisch &kappname; te laten starten. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn+file</term> +<listitem><para> +Lokale repository protocool. kan gebruikt worden om konqueror automatisch &kappname; te laten starten. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn</term> +<listitem><para> +Subversions eigen server protocool. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>(k)svn+ssh</term> +<listitem><para> +Subversion over ssh. Lees <link linkend="faq">FAQ</link> voor speciale details van dit protocol. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>file</term> +<listitem><para> +Direct repository toegang. &kappname; controleert of het opgegeven pad een repository of een werkkopie is en opent het daarna in de juiste modus. voor subversion zijn +<prompt>file:///dir</prompt> en <prompt>/dir</prompt> niet hetzelfde! +</para></listitem> +</varlistentry> +</variablelist> +</para> +<para> +Deze lijst kan ook gebruikt worden voor de <link linkend="kdesvn-commandline">comandoregel</link>. +</para> +</sect1> +<sect1 id="first_steps"> +<title>De eerste stappen met subversion en &kappname;</title> +<para> +Dit hoofdstuk is voornamelijk voor beginners die nog niet erg bekend zijn met subversion en legt uit hoe subversion en/of RCS werken. +</para> + +<sect2> +<title>Een werkkopie maken</title> +<caution> +<para> +Werkkopiën MOETEN lokaal bereikbaar zijn. Subversion weet niets van pseudo filesystems zoals +<prompt>smb://</prompt> of <prompt>fish://</prompt>. &kappname; vertaalt sommige van deze systemen als dat mogelijk is (zoals <prompt>system:/home</prompt>) Maar dat is niet mogelijk over een netwerk. +</para> +</caution> +<para> +Als eerste moet een werkkopie gemaakt worden van de repository. ga naar het volgende menu + +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Repository uitchecken</guimenuitem> +</menuchoice>. In de volgende dialoog moet de URL van de gekozen repository ingevuld worden, bijvoorbeeld: +<prompt>http://localhost/repos/myproject</prompt>. Submappen van een repository zijn ook mogelijk, b.v., +<prompt>http://localhost/repos/myproject/trunk</prompt> of vergelijkbaar. +</para> +<para> +Kies en/of maak een lokale map, waar de werkkopie moet komen. +</para> +<para> +En tenslotte, de revisie die uitgecheckt moet worden. Meestal is dat "HEAD". Dit zorgt ervoor dat naar de laatst opgeslagen versie wordt gewezen. +</para> +<para> +Klik op "[OK]" en &kappname; maakt een nieuwe werkkopie en (als dat is aangevinkt) opent deze. +</para> +<para> +Wanneer een repository is geopend om te bekijken, kan een map gemarkeerd worden en ga dan naar het volgende menu +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Repository</guisubmenu> +<guimenuitem>Huidige repositorypad uitchecken</guimenuitem> +</menuchoice>. +En vul de dialoog in zoals boven beschreven. Alleen de gemarkeerde map zal worden uitgecheckt. +</para> +</sect2> +<sect2> +<title>Vastleggen van lokale veranderingen</title> +<para> +Markeer de items die vastgelegd (commit) moet worden en ga naar dan het volgende menu +<menuchoice> +<shortcut> +<keycombo action="simul"><keycap>#</keycap></keycombo> +</shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Vastleggen</guimenuitem> +</menuchoice> +</para> +<para> +Indien geprobeerd wordt om te vastleggen (commit) terwijl geen item is geselecteerd, zal &kappname; de bovenste item van de geopende werkkopie gebruiken, b.v. het werkkopie-pad. +</para> +<para> +Deze opdracht is altijd recursief, dit betekent dat als een map wordt geselecteerd, &kappname; alle veranderde items in deze map zal versturen. Wanneer ingesteld wordt dat alle items eerst nagekeken moeten worden voordat ze verstuurd worden, dan zijn in het volgende dialoog alle te versturen items te zien. Daar kunt U items die U niet wil versturen deselecteren. In dat geval verstuurt &kappname; alle items apart. Of U kunt items selecteren zonder revisie selecteren en deze toevoegen en vastleggen (commit) (als ze niet gemarkeerd zijn om genegeerd te worden). Op deze manier is te zien of er nieuwere items zijn die U vergeten bent. +</para> +<para> +Voer een logbericht in en druk op "OK" en het verzenden start. +</para> +</sect2> +<sect2> +<title>Werkkopie bijwerken</title> +<para> +Dit brengt de lokale werkkopie in sync met de repository. U kunt &kappname; zo instellen dat &kappname; bij het openen van een werkkopie controleert op nieuwere/veranderde items in de repository. Dit wordt in de achtergrond uitgevoerd terwijl er gewoon gewerkt kan worden met &kappname;. Of start de controle met +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Controleren voor updates</guimenuitem> +</menuchoice>. +</para> +<para> +Wanneer dit is uitgevoerd, zijn items met een nieuwere versie of mappen met items die een nieuwere versie hebben gemarkeerd. +</para> +<para> +Om de wijzigingen op te halen, ga naar het volgende +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Bijwerken naar HEAD</guimenuitem> +</menuchoice>. Nu wordt de werkkopie bijgewerkt naar de laatste revisie. Indien een speciale revisie gewenst is, selecteer dan +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Bijwerken naar revisie...</guimenuitem> +</menuchoice> en kies de gewenste revisie in de volgende dialoog. +</para> +<para> +Indien geen item is geselecteerd, zal de hele werkkopie worden bijgewerkt, anders alleen recursief op de geselecteerde items. +</para> +</sect2> +<sect2> +<title>Toevoegen aan en verwijderen van een werkkopie</title> +<para> +Beide handelingen moet in twee stappen gedaan worden: voeg eerst toe of verwijder en leg dan vast (commit) naar repository. Voor het vastleggen (commit) kan het toevoegen of verwijderen nog ongedaan worden. +</para> +<sect3> +<title>Items toevoegen</title> +<para> +Een item toevoegen aan een werkkopie kan op drie verschillende manieren gedaan worden: +<variablelist> +<varlistentry> +<term>Selecteer de items zonder revisie en voeg deze toe</term> +<listitem><para> +Kopieer met konqueror of een ander programma naar de map met de werkkopie. Ga door de lijst, markeer het bestand en selecteer hem. +<menuchoice> +<shortcut><keycombo action="simul"><keycap>Insert</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Geselecteerde bestanden/mappen toevoegen</guimenuitem> +</menuchoice>. + Wanneer nieuwe mappen met alle subitems toegevoegd moet worden, ga naar +<menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>Insert</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Gemarkeerde bestanden/mappen recursief toevoegen</guimenuitem> +</menuchoice>. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Recursief controleren en toevoegen</term> +<listitem><para> +Er kan in de werkkopie gecontroleerd worden op onbeheerde items. Ga naar +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Controleren voor onbeheerde items</guimenuitem> +</menuchoice> Een dialoog verschijnt met alle onbeheerde items in een overzicht. Door op OK te klikken worden alle gemarkeerde items aan de werkkopie toegevoegd, ongewenste items moeten eerst ongemarkeerd worden. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Slepen en loslaten</term> +<listitem><para> +Markeer in konqueror of een andere vergelijkbare bestandsbeheerder de gewenste items die toegevoegd moeten worden en versleep ze naar &kappname;. Laat ze los op de mappen in de geopende werkkopie en &kappname; kopieert deze items daar naar toe en voegt ze toe. +</para></listitem> +</varlistentry> +</variablelist> +</para></sect3> +<sect3> +<title>Items met revisie uit de werkkopie verwijderen</title> +<para> +Items verwijderen is altijd recursief. B.V.,wanneer een map verwijderd wordt, dan worden ook alle subitems verwijderd. Markeer de de gewenste items en kies "Gemarkeerde bestanden/mappen verwijderen" van het algemene menu. De revisiecontrole wordt van de items verwijderd en daarna worden de items van de harde schijf verwijderd. +</para> +</sect3> +</sect2> +</sect1> + +<sect1 id="working-with-repositories"> +<title>Werken met repositories</title> +<para> +Eenvoudig bladeren door de repository kan gedaan worden met &konqi; &krus; of vergelijkbare bestandsbeheerders: Open een URL met een protocool zoals beschreven in <xref linkend="kdesvn-features" xreflabel="Features" /> (Alle varianten die starten met "k") en zij zullen de inhoud tonen. Hierdoor kunnen eenvoudige opdrachten zoals kopieren, verplaatsen en verwijderen uitgevoerd worden. Wanneer het volgende filter "?rev=<xxx>" wordt ingesteld, zijn alleen de gegevens van een specifiek revisie te zien. De syntax van een revisie-filter wordt beschreven in <xref linkend="revision-syntax" />, lees meer over KIO::ksvn in <xref linkend="kdesvn-kio" /> +</para> +<para> +Alle opdrachten behalve "Kopieren" kunnen alleen uitgevoerd worden in de revisie HEAD. +</para> +<sect2> +<title>Terugplaatsen van verwijderde items</title> +<para> +Het terugplaatsen van verwijderde items in subversion is het kopieeren van items uit een gekozen revisie. Wanneer U dus van plan bent om items terug te plaatsen, kijk naar de revisie voordat het item werdt verwijderd. Ga naar +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Repository</guisubmenu> +<guimenuitem>Selecteer revisie om te bladeren</guimenuitem> +</menuchoice> +en kies de gewenste revisie. &kappname; toont nu inhoud hiervan. Markeer het de items die teruggezet moeten worden en ga naar +<menuchoice> +<shortcut> +<keycombo action="simul"><keycap>C</keycap></keycombo> +</shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Kopieren</guimenuitem> +</menuchoice>. In de volgende dialoog is het doel altijd de revisie HEAD, de bron is de revisie waarin men aan het bladeren was. Vul het pad in en klik "OK" en het kopieren start. Ga na het succesvol kopieeren terug naar de HEAD revisie en het teruggeplaatste item zou tezien moeten zijn. +</para> +</sect2> +<sect2> +<title>Importeren van mappen</title> +<para> +Vanwege beperkingen van subversion zelf, kunnen alleen mappen en geen losse bestanden geïmporteerd worden. +</para> +<sect3> +<title>Slepen en loslaten</title> +<para> +Markeer in een bestandsbeheerder de map die geïmporteerd moet worden en sleep het naar de map in &kappname; waar U het wilt importeren. +</para> +</sect3> +<sect3> +<title>Markeer een map die geïmporteerd moet worden in de bestandsbeheerder</title> +<para> +Markeer de map waar naar toe een nieuwe map geïmporteerd moet worden. En ga naar +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Mappen importeren in huidige map</guimenuitem> +</menuchoice> En selecteer de gewenste map. +</para> +</sect3> +</sect2> +</sect1> +<sect1 id="operations"> +<title>Overige handelingen</title> +<sect2 id="merging-items"> +<title>Samenvoegen</title> +<para> +Open repository of werkkopie, markeer het item dat samengevoegd (merge) moet worden en ga naar +<menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guisubmenu>Samenvoegen</guisubmenu> +</menuchoice>. +Vul in de volgende dialoog de gewenste waarden. Wanneer de repository is geopend, worden bron1 en bron2 gevuld, wanneer de werkkopie is geopend, dan wordt het doel gevuld met het huidige geselecteerde item. Het afhandelen van deze parameter is afhankelijk of de interne diff, subversion danwel een extern samenvoeg-programma zoals kdiff3 gebruikt wordt. Het doel moet ALTIJD een lokaal bestand of map zijn. Er mag gewisseld worden tussen extern en intern samenvoegen (merge) via het keuzevakje "Externe samenvoeging gebruiken". +</para> +<sect3> +<title>Intern samenvoegen</title> +<para> +Het doel is hetzelfde als bij subversions eigen commandoregel. Wanneer bron1 en bron2 aan elkaar gelijk zijn, moeten start- en eind-revisie verschillend zijn. Als de bronnen niet gelijk zijn, dan is start-revisie toegewezen aan bron1 en de eind-revisie aan bron2. Het doel MOET een werkkopie zijn, anders stuurt subversion een foutmelding. +</para> +<para> +De keuzevakjes hebben de volgende betekenissen: +<variablelist> + +<varlistentry> +<term>Recursief</term> +<listitem><para> +Voer alle opdrachten op mappen recursief uit. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Ongerelateerde items behandelen als gerelateerde items</term> +<listitem><para> +Indien ingeschakeld, zullen items zonder relatie worden vergeleken (diff) alsof zij wel een relatie hebben. Anders zal subversion de ene zijde verwijderen en het aan de andere zijde toevoegen. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Forceer verwijderen bij gewijzigd/niet in versiebeheer</term> +<listitem><para> +Indien niet ingeschakeld en samenvoegen (merge) verlangt het verwijderen van een veranderde item of een item zonder rivisiecontrole, zal het samenvoegen (merge) mislukken. Anders zal het item worden verwijderd. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Uitvoeren als test zonder wijzigingen</term> +<listitem><para> +Indien ingeschakeld, verstuurt subversion alleen meldingen over wat het zou doen, maar verandert de werkkopie niet. +</para></listitem> +</varlistentry> +</variablelist> + +</para> +</sect3> +<sect3> +<title>Extern samenvoegprogramma:</title> +<para> +Lees <xref linkend="diffmerge-settings"/> voor de details hoe een externe (merge) samenvoegprogramma ingesteld moet worden. &kappname; geeft via de commandoregel opdrachten. Eerst wordt het volgende uitgevoerd: +</para> +<para> +<orderedlist> + +<listitem><para> +Wijs een start-revisie toe als bron1 en een eind-revisie als bron2. Controleer dan of er verschillen zijn (pad en/of revisie). Als dat ja is, dan is het een drievoudig samenvoegen, anders is het een eenvoudig samenvoegen van bron naar doel. Als bron2 leeggelaten is, is het ook een eenvoudig samenvoegen (merge). +</para></listitem> + +<listitem><para> +Maak een export naar een tijdelijke map. Alleen de start-revisie als bron1 als het simpel samenvoegen (merge) is, anders beide bronnen met hun revisies. Neem de inhoud van een Als het item geen map is maar een bestand, neem dan de inhoud van een aangewezen revisie. +</para></listitem> + +<listitem> +<para> +Maakt de aanroep naar het gewenste externe (merge) samenvoeg-programma zoals ingesteld in de Instellingen. De foutmeldingen worden getoond in een log-venster zodat te zien is wat fout is gegaan (als iets fout is gegaan). +</para> +</listitem> +</orderedlist> + +In afwijking met het interne (merge) samenvoeg-programma, mag het doel een gewone map/bestand (zonder revisie controle) zijn, omdat externe programma's dit niet belangrijk vinden. +</para> +<para> +Indien recursief niet is ingeschakeld, wordt de export uitgevoerd als een platte export. Wees voorzichtig: wanneer dit wordt gedaan met werkkopiën, worden externals NIET geëxporteerd. +</para> +</sect3> + +</sect2> +</sect1> + +<sect1 id="used-properties"> +<title>Eigenschappen van &kappname; instellen</title> +<sect2> +<title>Bugtracker integratie</title> +<para>Het <ulink url="http://tortoisesvn.tigris.org/">TortoiseSVN project</ulink> ontwierp een mooi systeem +<ulink url="http://tortoisesvn.net/docs/release/TortoiseSVN_en/tsvn-dug-bugtracker.html"> om bugtracker te integreren</ulink> in het subversion GUI. Op dit moment ondersteund &kappname; geen extra velden in het vastleg vak (dit zal later volgen) en begrijpt alleen de volgende eigenschappen: +</para> +<para> +<table id="bugtracker-properties"> +<title>Bugtracker Integratie Eigenschappen</title> +<tgroup cols="3"> + +<thead> +<row> +<entry>Eigenschap</entry> +<entry>Omschrijving</entry> +<entry>Voorbeeld</entry> +</row> +</thead> +<tbody> +<row> +<entry><prompt>bugtraq:url</prompt></entry> +<entry>Dit is het url naar de bugtracker. Het moet het woord <prompt>%BUGID%</prompt> bevatten.</entry> +<entry>http://kdesvn.alwins-world.de/ticket/%BUGID%</entry> +</row> + +<row> +<entry><prompt>bugtraq:logregex</prompt></entry> +<entry> +<para>Bevat een of twee uitdrukkingen, gescheiden door een regeleinde.</para> +<para>Indien alleen een enkele uitdrukking is ingesteld, dan moet de kale bug ID overeenkomen met een groepje van de regex-regel. Indien twee uitdrukkingen zijn ingesteld, wordt de eerste uitdrukking gebruikt om de regel met het bug ID te vinden (b.v "Issue #123" of "resolve issue 123"). De tweede uitdrukking wordt vervolgens gebruikt om de kale bug ID te krijgen uit de regel verkregen met de eerste uitdrukking.</para> +<para>Let op ongewenste spaties aan het eind van de uitdrukking en vergeet niet de haakjes om het nummer-omschrijving.</para> +</entry> +<entry> +<para>Enkele uitdrukking (bruikbaar met TRAC): +<programlisting> +#(\d+) +</programlisting> +Niet alle nummers zoals <prompt>#190</prompt> zullen overgenomen en vertaald worden naar een url in de logoutput.</para> +<para> +Twee uitdrukkingen: +<programlisting> +[Ii]ssue #?(\d+)(,? ?#(\d+))* +(\d+) +</programlisting> +Vergeet niet: let op de spaties na de <prompt>(\d+)</prompt>! Dit is een van de meest voorkomende fouten waarom deze expressie niet werkt! +</para> +</entry> +</row> +</tbody> +</tgroup> +</table> +</para> +<para> +Bij lokaal geopende repositories (b.v., <prompt>file://</prompt>-Protocool) en bij werkkopiën worden deze eigenschappen vanaf de geopende map omhoog gezocht totdat het gevonden is of het bovenste nivo van subversion is bereikt. In repositories die via een netwerk geopend zijn (alles behalve <prompt>file://</prompt> protocool) wordt alleen de geopende map doorzocht. +</para> +<para> +Ondersteuning voor meervoudige sets van deze eigenschappen volgen mischien later, (b.v. in een submap een andere waarde voor een ander item) maar meestal is het opzoeken van van een enkele item genoeg. +</para> +</sect2> +</sect1> + +<sect1 id="overlay-meaning"> +<title>Betekenissen van de iconen</title> +<para> +Items die niet in een "normale" staat zijn, kunnen gemarkeerd worden met een icoon. +<variablelist> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnlocked.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Vergrendeld</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +Dit item is vergrendeld. In de laatste kolum wordt de eigenaar van het slot genoemd. &kappname; kan zo ingesteld worden dat het ook naar vergrendelde items zoekt. Wees voorzichtig: afhankelijk van het type server, kan dit een lange tijd in beslag nemen! +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnneedlock.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Vergrendelen vereist</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +Dit item moet vergrendeld worden voordat het bewerkt en weer samengevoegd kan worden. Totdat het vergrendeld is, houdt subversion het als "alleen lezen". +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnupdates.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Updates</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +Dit item of - als het een map is - een item daarin heeft een nieuwere versie in repository. Dit werkt alleen met subversion => lokaal of op afstand. +</para></listitem> +</varlistentry> + + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnmodified.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Veranderd</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +Dit item - als het een map is - een item daarin is veranderd op de lokale schijf. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnadded.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Toegevoegd</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +Dit item is lokaal toegevoegd aan subversion maar nog niet vastgelegd (commit). +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvndeleted.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Verwijderd</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +Dit item is lokaal verwijderd van subversion maar nog niet vastgelegd (commit). +</para></listitem> +</varlistentry> + +<varlistentry> +<term><inlinemediaobject> +<imageobject> +<imagedata fileref="hi128-filesys-kdesvnconflicted.png" format="PNG" /> +</imageobject> +<textobject> +<phrase>Conflict</phrase> +</textobject> +</inlinemediaobject> +</term> +<listitem><para> +Dit item - als het een map is - een item daarin heeft conflicten met (die opgelost moeten worden) gekregen met de laatste update. +</para></listitem> +</varlistentry> + +</variablelist> + +</para> +</sect1> + +<!-- +<sect1> +<title>Wat &kdesvn; niet is</title> +<para> +&kappname; heeft NIET de capaciteit om direct subversion repositories te wijzigen. Dit is niet omdat het niet is erin geprogrammeerd, dit is omdat behalve bij speciaal daarvoor ingestelde op webserver gebaseerde repositories, deze voorziening geen onderdeel van subversion zelf. Subversion is GEEN transferprotocool zoals FTP of SFTP. De data moet daarom eerst veranderd worden in een werkkopie. Het importeren van nieuwe bestanden of mappen via verslepen en loslaten is een ander idee. +</para> +</sect1> +--> +</chapter> + +<chapter id="kdesvn-kio"> +<title>Konqueror, KIO, &kappname;</title> +<sect1 id="kdesvn-kio-desc"> +<title>Omschrijving</title> +<para> +Vanaf versie 0.7.0 van &kappname; , zijn er enkele modules die enkele commando's direct in de menu's van konqueror integreren. +<variablelist> +<varlistentry> +<term>KIO protocools</term> +<listitem><para>Zorgt voor het verwerken van de volgende protocools: +<itemizedlist> +<listitem><para>ksvn+http</para></listitem> +<listitem><para>ksvn+https</para></listitem> +<listitem><para>ksvn+file</para></listitem> +<listitem><para>ksvn+ssh</para></listitem> +<listitem><para>ksvn</para></listitem> +</itemizedlist> +Dit geldt mischien ook voor "svn+..." maar vanaf kde 3.4, heeft kdesdk zijn eigen kleine svn-kio genaamd "svn+http"enz. Deze pakketten zijn zo georganiseerd - of zouden dat moeten zijn - dat "svn+..." als een extra pakket komt zodat het geïnstalleerd kan worden als kdesk het niet geïnstalleerd heeft. +</para> +<para> +Deze protocools zijn alleen ontworpen voor repositories, niet voor werkkopieën. B.v. "ksvn+file:///<pad>" moet naar een ander startpunt wijzen dan het programma zelf of Kpart. Werkkopieën kunnen bekeken worden met konqueror. +</para> +<para> +Om door een aangewezen revisie te kunnen bladeren, moet de volgende zoekopdracht gegeven worden <link linkend="revision-syntax">"?rev=<revision>"</link> naar het url. +</para> +</listitem> +</varlistentry> +<varlistentry> +<term>Context menus</term> +<listitem><para> +&kappname; installeert context menu's voor konqueror. Deze zijn zichtbaar na een rechter muisklik in het het venster (alleen in het standaard venster, niet in KPart) , het is daarom mogelijk om de meeste akties direkt in konqueror uit te voeren ( of elke andere bestandsbeheerder dat konquerors context menu's kan gebruiken zoals krusader). Dit wordt gedaan via een call naar de <link linkend="kdesvn-commandline">commandoregel variant van &kappname;</link>. +</para> +<para> +Dit menu is altijd ingeschakeld in kde 3.5, Let daarom op wanneer U iets selecteerd. Anders geeft &kappname; een foutmelding. +</para> +</listitem> +</varlistentry> +</variablelist> +</para> +<sect2> +<title>Gebruik van KIO buiten konqueror - een voorbeeld</title> +<para> +Elke op &kde; gebaseerde programma kan deze protocools gebruiken. Het is daarom mogelijk om alle verschilen tussen twee revisies te verkrijgen met kDiff3 zonder veel kennis. +</para> +<para> +<example> +<title>Het verschil verkrijgen tussen twee revisies door gebruik van kDiff3 en KIO::ksvn</title> +<programlisting> +kdiff3 \ + ksvn://anonsvn.kde.org/home/kde/trunk/KDE/arts?rev=423127 \ + ksvn://anonsvn.kde.org/home/kde/trunk/KDE/arts?rev=455064 +</programlisting> +<para> +Laat kdiff3 alle verschillen tussen twee revisie's tonen. Letop! Gebruik hiervan in &kappname;(diffen tussen twee revisie's) is VEEL sneller omdat het interne mechanisme van subversion wordt gebruikt. +</para> +</example> +</para> +</sect2> +</sect1> +<sect1 id="kio-svn-special"> +<title>Informatie over KIO::ksvn voor programmeurs</title> +<para> +<note><para>U kunt dit gedeelte overslaan indien U niet geïnterreseerd bent in KIO-programmeren.</para></note> +KIO::ksvn::special kent de volgende opdrachten, ze zijn in aanroep bijna gelijk gemaakt aan de huidige bestaande in KIO van kdesk +dus, bijvoorbeeld, kdevelop kan het gebruiken als kdesk niet is geïnstalleerd in de vorm van kdesvn::KIO::svn. +</para> +<sect2> +<title>Overzicht met commando's</title> +<para> +<table id="kio-svn-special-commands"> +<title>Commando overzicht voor KIO::ksvn::special</title> +<tgroup cols="4"> + +<thead> +<row> +<entry>Naam/commando</entry> +<entry>Numerieke id</entry> +<entry>Parameter lijst</entry> +<entry>Ingevoerd in 0.11.x?</entry> +</row> +</thead> + +<tbody> + +<row> +<entry>Checkout</entry> +<entry>1</entry> +<entry> +<para> +KURL repository, KURL target, int revnumber, QString revkind +</para> +<para> +Het doel wordt NIET veranderd, b.v., maar de inhoud wordt uitgecheckt zonder een submap te maken! b.v. de bron is http://server/repos/project/trunk, en als het doel is /home/user/proj/ , dan zal de inhoud van trunk gekopieërd worden naar /home/user/proj/ en niet naar +/home/user/proj/trunk/! +</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Update</entry> +<entry>2</entry> +<entry><para>KURL url,int revnum, QString revstring</para> +<para> +Indien revnum < 0 de revstring is ingevoegt. +De opbouw van revstring is omschreven in <link linkend="revision-syntax">Appendix</link>. +</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Commit</entry> +<entry>3</entry> +<entry><para>KURL::List urls</para> +<para>Geeft een overzicht met lokale URL's om vast te leggen. Vraagt naar een log.</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Log</entry> +<entry>4</entry> +<entry> +<para> +int startrevnumber,QString startrevstring,int endrevnumber,QString endrevstring,KURL::List +</para> +<para> +Gebruik dit voorzichtig - dit kan veel data produceren. +</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Import</entry> +<entry>5</entry> +<entry>KURL targetrepository, KURL sourcepath</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Add</entry> +<entry>6</entry> +<entry>KURL</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Del</entry> +<entry>7</entry> +<entry>KURL::List</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Revert</entry> +<entry>8</entry> +<entry><para>KURL::List</para> +<para>Terugdraaien in KIO is altijd niet-recursief, geen vragen (aanroepend programma moet dat zelf doen)</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Status</entry> +<entry>9</entry> +<entry><para>KURL item,bool checkRepos, bool recurse</para> +<para>item - het item waarover informatie opgevraagd moet worden, checkRepos - controleert of er nieuwere versies zijn in de repository, recurse - controleert recursief of niet.</para> +</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Mkdir</entry> +<entry>10</entry> +<entry>KURL::List</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Resolve</entry> +<entry>11</entry> +<entry>KURL, bool recursive</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Switch</entry> +<entry>12</entry> +<entry>KURL working_copy_path,KURL new_repository_url,bool recursive,int revnumber, QString revkind</entry> +<entry>Yes</entry> +</row> + +<row> +<entry>Diff</entry> +<entry>13</entry> +<entry> +<para>URL uri1, KURL uri2, int r1, QString rstring1, int r2, QString rstring 2, bool recursive</para> +<para>Voor verschillen tussen het repository bestand:/// en de werkkopie, de URL van de werkkopie kan zonder protocool ingesteld worden!</para> +</entry> +<entry>Yes</entry> +</row> +</tbody> + +</tgroup> +</table> + +</para> +</sect2> +<sect2> +<title>Return waarden</title> +<para> +Return waarden mogen gegeven worden via metadata, lees apidoc voor de details. +</para> +<para> +<table id="kio-ksvn-metadata"> +<title>Inhoud van metadata</title> +<tgroup cols="2"> + +<thead> +<row> +<entry>Key</entry> +<entry>mogelijke waarde</entry> +</row> +</thead> + +<tbody> + +<row> +<entry>path</entry> +<entry>Het pad van het item waarop een aktie is uitgevoerd, b.v. een gegeven url.</entry> +</row> + +<row> +<entry>action</entry> +<entry>Numeric action type</entry> +</row> + +<row> +<entry>kind</entry> +<entry>Soort item (meestal een map of een bestand)</entry> +</row> + +<row> +<entry>mime_t</entry> +<entry>Subversion mimetype van item</entry> +</row> + +<row> +<entry>content</entry> +<entry>De inhoud (subversion waarde)</entry> +</row> + +<row> +<entry>prop</entry> +<entry>Eigenschappen (subversion waarde)</entry> +</row> + +<row> +<entry>rev</entry> +<entry>De resulterende revisie of de revisie waarmee is gewerkt</entry> +</row> + +<row> +<entry>string</entry> +<entry>Intern leesbare bericht.</entry> +</row> + +<row> +<entry>loggedaction</entry> +<entry>Door subversion gedefineerde actie string voor item (A,M,D)</entry> +</row> +<row> +<entry>loggedcopyfrompath</entry> +<entry>Via welk pad gekopieerd? (mag leeg zijn)</entry> +</row> +<row> +<entry>loggedcopyfromrevision</entry> +<entry>Van welke revisie gekopieerd? (mag < 0)</entry> +</row> +<row> +<entry>loggedpath</entry> +<entry>Via welk enkel pad de logged actie worden weggeschreven. (pad is ingesteld naar het opgeroepen url)</entry> +</row> +<row> +<entry>diffresult</entry> +<entry>Een regel van een verschil output</entry> +</row> +</tbody> + +</tgroup> +</table> + +</para> +</sect2> +</sect1> +</chapter> + +<chapter id="kdesvn-commandline"> +<title>&kappname; via de commandoregel gebruiken</title> +<sect1 id="kdesvn-commandline-overview"> +<title>Overzicht</title> +<para> +Sommige subversion opdrachten kunnen via de commandoregel worden uitgevoerd, b.v. zoals een standaard commandoregel cliënt maar interactie met een gebruiker gebeurt via de KDE-UI. De standaard syntax is <prompt>kdesvn exec <command> [parameter] <url></prompt>. +</para> +<para> +Als een enkele revisie van een enkele url is gewenst, dan kan dit als parameter ingesteld worden via <programlisting>svn://your-server/path-to-repository/item?rev=<your-rev></programlisting> Dit overschrijft de optie <prompt>-r <rev></prompt>. +</para> +<para> +Een revisie kan opgegeven worden als + een nummer of als <prompt>HEAD</prompt> of <prompt>BASE</prompt> of als een datum zoals {YYYY-MM-DD}. +</para> +</sect1> +<sect1 id="kdesvn-command-list"> +<title>Overzicht van opdrachten</title> +<para> +Indien in de volgende overzicht de parameter <prompt>-r revision</prompt> is gegeven, dan mag deze revisie worden ingesteld met <prompt><url>?rev=the-revision</prompt>. +<table id="svn-commands-table"> +<title>Subversion commando's</title> +<tgroup cols="3"> + +<thead> +<row> +<entry>Commando</entry> +<entry>Betekenis</entry> +<entry>Geaccepteerde opties</entry> +</row> +</thead> + +<tbody> +<row> +<entry>commit (or ci)</entry> +<entry>Legt veranderingen van een item vast (commit) naar de repository.</entry> +<entry></entry> +</row> +<row> +<entry>log</entry> +<entry>Geeft de log van een item</entry> +<entry>-r startrevision:endrevision -l limit_display</entry> +</row> +<row> +<entry>cat</entry> +<entry>Toont de inhoud van een item.</entry> +<entry>-r revisie </entry> +</row> +<row> +<entry>copy (or cp)</entry> +<entry>Kopieert een item binnen een werkkopie of een repository. Als er geen doel is opgegeven, dan vraagt &kappname; ernaar.</entry> +<entry></entry> +</row> +<row> +<entry>move (of mv, rename)</entry> +<entry>Verplaats/Herbenoem een item binnen een werkkopie of een repository. Als er geen doel is opgegeven, dan vraagt &kappname; ernaar.</entry> +<entry></entry> +</row> +<row> +<entry>get</entry> +<entry>Verkrijg de inhoud van een item en slaat het op.</entry> +<entry>-r revisie -o <outputfile> (output is verplicht!)</entry> +</row> +<row> +<entry>blame (of annotate)</entry> +<entry>Aantekeningen bij bestand</entry> +<entry>-r startrevisie:eindrevisie</entry> +</row> +<row> +<entry>update</entry> +<entry>Een item in de werkkopie updaten</entry> +<entry>-r revisie</entry> +</row> +<row> +<entry>diff</entry> +<entry>Vergelijk (diff) twee revisie's van een item of vergelijk (diff) twee items bij bepaalde revisie's.</entry> +<entry>-r startrev:endrev</entry> +</row> +<row> +<entry>info</entry> +<entry>Gedetaileerde informatie over een item.</entry> +<entry>-r revisie</entry> +</row> +<row> +<entry>checkout (or co)</entry> +<entry>Checkout repository-pad naar een nieuw werkkopie-pad. Er wordt gevraagd naar het doelpad en de bron-revisie.</entry> +<entry></entry> +</row> +<row> +<entry>checkoutto (or coto)</entry> +<entry>Checkout repository-pad naar een nieuw werkkopie-pad. Er wordt gevraagd naar het verschil van de bronpad en bron-revisie.</entry> +<entry></entry> +</row> +<row> +<entry>export</entry> +<entry>Exporteerd de repository- of werkkopie-pad naar een map. Er wordt gevraagd naar het doelpad en de bron-revisie.</entry> +<entry></entry> +</row> +<row> +<entry>exportto</entry> +<entry>Exporteerd repository- of werkkopie-path naar een map. Er wordt gevraagd naar het doelpad en de bron-revisie.</entry> +<entry></entry> +</row> +<row> +<entry>delete (del, remove, rm)</entry> +<entry>verwijder de url(s) van de repository of de werkkopie.</entry> +<entry></entry> +</row> +<row> +<entry>add</entry> +<entry>Voegt een url toe aan een werkkopie. De url moet aan een werkkopie toebehoren (het is niet een import!)</entry> +<entry></entry> +</row> +<row> +<entry>revert (of undo)</entry> +<entry>Maakt de huidige veranderingen aan de werkkopie weer ongedaan. Mag alleen gebruikt worden bij werkkopieën!</entry> +<entry></entry> +</row> +<row> +<entry>checknew (of addnew)</entry> +<entry>Controleert in een opgegeven url voor nieuwe, items zonder revisie en voegt ze dan (indien gewenst) toe aan de werkkopie.</entry> +<entry></entry> +</row> +<row> +<entry>tree</entry> +<entry>Toont de revisie-boom van een item (alleen het eerste argument), Als de url met de parameter "?rev=xxx" wordt gegeven, dan start de revisie-boom vanaf hier.</entry> +<entry>-r startrev:endrev</entry> +</row> +<row> +<entry>lock</entry> +<entry>Vergrendel url(s), als de parameter "-f" wordt meegegeven worden bestaande vergrendelingen verwijderd.</entry> +<entry>-f</entry> +</row> +<row> +<entry>unlock</entry> +<entry>Ontgrendeld een url(s), Als de parameter "-f" wordt meegegeven worden ook vergrendelingen die niet in eigendom zijn ontgrendeld en niet bestaande vergrendelingen overgeslagen.</entry> +<entry>-f</entry> +</row> +<row> +<entry>help</entry> +<entry>Toon deze pagina</entry> +<entry></entry> +</row> +</tbody> +</tgroup> + +</table> + +<table id="parameter-list"> +<title>Parameters voor subversion commando's</title> +<tgroup cols="3"> +<thead> +<row> +<entry>Parameter</entry> +<entry>Mogelijke waardes</entry> +<entry>toegestaan bij</entry> +</row> +</thead> +<tbody> +<row> +<entry>-r</entry> +<entry><prompt>revisie</prompt> of <prompt>startrev:endrev</prompt></entry> +<entry>alle behalve commit</entry> +</row> +<row> +<entry>-R</entry> +<entry>(geen)</entry> +<entry>alle behalve commit</entry> +</row> +<row> +<entry><prompt>-o</prompt></entry> +<entry><prompt><bestandsnaam></prompt></entry> +<entry>get</entry> +</row> +<row> +<entry><prompt>-l</prompt></entry> +<entry><prompt><nummer></prompt></entry> +<entry>log</entry> +</row> +<row> +<entry><prompt>-f</prompt></entry> +<entry><prompt></prompt></entry> +<entry>(un-)lock</entry> +</row> + +</tbody> +</tgroup> +</table> + +</para> +<sect2> +<title>Het "log" commando</title> +<para> +Het log commando geeft een venster met de log van het gegeven url. Met subversion 1.2 of hoger accepteert het filters b.v. hoeveel items het moet vertonen. +</para> +<para> +In het venster kan men log-entries selecteren en de verschillen daartussen zien. +<example> +<title>Toon de laatste 20 toevoeg (commit) logs</title> +<programlisting> +kdesvn exec log -l 20 -r HEAD:1 myfile.c +</programlisting> +<para>Let op de volgorde van de revisie's: Men gaat van HEAD naar START voor de LAATSTE. Geef daarom revisie HEAD als startpunt, anders krijgt men de eerste 20 entries te zien.</para> +</example> +</para> +</sect2> +<sect2> +<title>Het "diff" commando</title> +<para> +Men ziet de verschillen tussen revisie's van een item of tussen items in een dezelfde werkkopie of repository. Wanneer revisie's van een item worden vergeleken (diff) , dan mogen deze revisie's worden gegeven als <prompt>-r STARTREV:ENDREV</prompt>. Wanneer een item in een werkkopie zonder een revisie wordt vergeleken (gediff't), dan wordt het verschil met de repository getoond. +<example> +<title>Toon het verschil tegen de repository, b.v. lokale veranderingen</title> +<programlisting> +kdesvn exec diff myfile.c +</programlisting> +</example> +<example> +<title>Toont de verschillen tussen revisie's</title> +<programlisting> +kdesvn exec diff -r 21:20 myfile.c +</programlisting> +</example> +</para> +<para> +Wanneer twee items worden vergeleken (gediff't), dan mogen revisie's worden toegevoegd aan de url van de items. b.v.: +<programlisting>http://server/path/item?rev=HEAD</programlisting> +<example> +<title>Vergelijken (diffing) van twee gemarkeerde versie's</title> +<programlisting> +kdesvn exec diff http://www.alwins-world.de/repos/kdesvn/tags/rel_0_6_2 http://www.alwins-world.de/repos/kdesvn/tags/rel_0_6_3 +</programlisting> +</example> +</para> +</sect2> +</sect1> +</chapter> + +<chapter id="setup"> +<title>Instellingen</title> +<para> +Via het instellingenscherm kunnen de instellingen veranderd worden. Ze zijn ingedeeld in verschillende deelschermen. +</para> +<sect1 id="general-settings"> +<title>Algemeen</title> +<para> +<informaltable id="General-setup-items"> +<tgroup cols="2"> +<tbody> +<row> +<entry>Formaat van de pictogrammen</entry> +<entry>Hoe groot (vierkant) moeten de iconen in de hoofdlijst zijn.</entry> +</row> +<row> +<entry>Bestandsinformatie tonen</entry> +<entry>Schakel deze optie in als u tekstballonnen wilt zien als u uw muis op een pictogram laat rusten.</entry> +</row> +<row> +<entry>Afbeeldingsweergave tonen</entry> +<entry>&kappname; toont een voorbeeld in de tekstballon als de muis op een pictogram rust (alleen bij lokale bestanden, niet bij repositories via een netwerk).</entry> +</row> +<row> +<entry>Items gemarkeerd met iconen</entry> +<entry>Items die niet in een "normale" staat zijn, kunnen gemarkeerd worden met een icoon. (lees ook <xref linkend="overlay-meaning" />)</entry> +</row> +<row> +<entry>Itemvolgorde is hoofdlettergevoelig</entry> +<entry>De volgorde in het hoofdvenster is wel of niet hoofdlettergevoelig, b.v., een "a" is niet gelijk aan "A".</entry> +</row> +<row> +<entry>Externe weergave</entry> +<entry>De standaard weergave wordt gebruikt bij dubbelklikken. Indien <prompt>standaard</prompt> ingesteld, gebruikt &kappname; het als de standaard aktie die is ingesteld voor de entry.</entry> +</row> +<row> +<entry>Maximum aantal logberichten in de history</entry> +<entry>Het aantal logberichten dat &kappname; moet onthouden.</entry> +</row> +</tbody> +</tgroup> +</informaltable> + +</para> +</sect1> + +<sect1 id="subversion-settings"> +<title>Instellingen van Subversion</title> +<para> +<informaltable id="subversion-settings-table"> +<tgroup cols="2"> + +<tbody> + +<row> +<entry>Controleren voor updates wanneer een werkkopie geopend wordt</entry> +<entry>Wanneer een werkkopie wordt geopend, start onmiddelijk een controle voor updates in de achtergrond.</entry> +</row> +<row> +<entry>Controleer of items de eigenschap \"svn:needs-lock\" hebben</entry> +<entry>Controleer bij werkkopie's of een item deze eigenschap heeft en toont in dat geval een speciaal icoontje ernaast. Dit inschakelen maakt het overzicht erg langzaam.</entry> +</row> +<row> +<entry>Bestandsdetails laden wanneer bestanden op afstand getoond worden</entry> +<entry>Indien ingeschakeld, haalt &kappname; meer gedetailleerde informatie over bestanden in de overzicht van de repositorie . Men kan dan vergrendelingen van anderen in het overzicht zien. Wees voorzichtig: dit inschakelen maakt de lijst ERG langzaam!</entry> +</row> + +<row> +<entry>Iteminformatie recursief opvragen</entry> +<entry>Wanneer "info" bij een map is ingeschakeld, zal informatie over alle items in deze map verzameld worden, kan erg langzaam zijn.</entry> +</row> + +<row> +<entry>Genegeerde bestanden tonen</entry> +<entry>Toon items in subversion gemarkeerd om wel of niet genegeerd te worden.</entry> +</row> + +<row> +<entry>Wachtwoorden opslaan voor verbindingen op afstand</entry> +<entry>Het opslaan van wachtwoorden is vaak een veiligheidsprobleem. Subversion bewaart zijn wachtwoorden in een plat bestand, dat wil zeggen wachtwoorden in leesbare tekst! Wees daarom voorzichtig met het inschakelen hiervan en lees daarom ook het volgende item. In dit item wordt alleen verteld dat wachtwoorden opslaan de standaard is, dit kan voor speciale doelen veranderd worden in het login venster.</entry> +</row> + +<row> +<entry>Wachtwoord opslaan in de KDE-portefeuille</entry> +<entry>Bij het bewaren van wachtwoorden is het bestand met leesbare tekst een gat in de veiligheid. &kappname; kan de wachtwoorden opslaan en ook weer gebruiken in de versleutelde KDE-portefeuille in plaats van de normale plek (vanaf versie 0.12.0). Aan de andere kant kunnen andere subversion-cliënt's dit niet inlezen, dus moet bij het gebruik van programma's zoal svn-cmdline of rapidsvn ze toch opnieuw ingevoerd worden. Zolang subversion de opslag van wachtwoorden niet versleuteld is het mischien verstandiger om ze helemaal niet op te slaan.</entry> +</row> + +<row> +<entry>Logbestanden houden node-veranderingen bij</entry> +<entry>Indien ingeschakeld, komen kopieerakties ook in de log.</entry> +</row> + +<row> +<entry>Logs altijd een overzicht van gewijzigde bestanden laten inlezen</entry> +<entry>Het logcommando kan een overzcht van gewijzigde bestanden in de vastlegging (commit) opnemen. Dit is erg handig en meestal kost dit niet meer verkeer.</entry> +</row> + +<row> +<entry>Items nakijken voor vastlegging</entry> +<entry>Wanneer toevoeging wordt uitgevoerd, kan &kappname; controleren wat te doen. B.V. zijn er items zonder revisie toegevoegd, toon veranderde items en legt daarna vast (commit). Dit kost afhankelijk van de boom meer of minder tijd.</entry> +</row> +<row> +<entry>Maximale hoeveelheid loggegevens wanneer de log vol is</entry> +<entry>Een "Volledige log" uitvoeren kan veel kosten, afhankelijk van de start-revisie. Dit kan begrenst worden tot een standaard maximum waarde. Indien "0", is het onbegrenst.</entry> +</row> + +</tbody> + +</tgroup> +</informaltable> + +</para> +</sect1> + +<sect1 id="diffmerge-settings"> +<title>DiffMerge instellingen</title> +<para> +<variablelist> + +<varlistentry> +<term>Vergelijking (diff) negeert inhoudstype</term> +<listitem><para> +Alleen interresant wanneer de diff is gemaakt met subversion zelf. Indien ingeschakelt, negeert subversions diff de inhoudstype van de items. Anders geeft het geen diffs van binaries. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Vergelijking (diff) in revisieboom is recursief</term> +<listitem><para> +Indien ingeschakelt, zijn vergelijkingen (diffs) in een revisieboom recursief zoals in alle andere gevallen. Anders worden alleen worden alleen de veranderde items in die map getoond. Hoe dat wordt gedaan is afhankelijk van hoe de vergelijkingen (diff) worden gemaakt (door subversion zelf of door een extern programma). +</para></listitem> +</varlistentry> +<varlistentry> +<term>Verschil negeert spatie-wijzigingen</term> +<listitem> +<para> +Negeert veranderingen in de hoeveelheid spatie's (optie "-b" naar diff) +</para> +</listitem> +</varlistentry> +<varlistentry> +<term>Diff negeert alle spatie's</term> +<listitem> +<para>Negeer alle spatie's (optie "-w" naar diff)</para> +</listitem> +</varlistentry> +</variablelist> + +</para> +<sect2> +<title>Verschilweergave</title> +<para> +Bepaalt op welke manier de inhoud van een diff word getoond. De standaard is "kompare" Indien "Externe weergave" is ingeschakeld, +moet een geldig programma in "Externe verschilweergave:" worden ingevuld. Alleen als de interne weergave wordt gebruikt, zijn er verschillen in eigenschappen te zijn. +</para> +</sect2> +<sect2> +<title>Externe diff-weergave gebruiken</title> +<para> +Bepaalt wat &kappname; gebruikt voor de externe weergave en hoe het wordt aangeroepen. Dit kan op drie manieren: +</para> +<para> +<variablelist> +<varlistentry> +<term><program> <parameter></term> +<listitem><para> +De vergelijking wordt gemaakt door subversion en direct aan de standaard input van het externe programma doorgegeven (voordeel: geen tijdelijke bestanden nodig) +</para></listitem> +</varlistentry> + +<varlistentry> +<term><program> <parameter> %f</term> +<listitem><para> +De vergelijking wordt gemaakt door subversion, bewaart in een tijdelijk bestand, waarbij de parameter "%f" wordt vervangen door het bestandsnaam. +Dit kan worden gebruikt bij een eenvoudige aanroep naar less of een textviewer. +</para></listitem> +</varlistentry> + +<varlistentry> +<term><program> <parameter> %1 %2</term> +<listitem><para> +&kappname; laat een extern programma de vergelijking uitvoeren. %1 en %2 worden vervangen door de verlangde waarden (bestandsnamen of mappen). &kappname; +bewaart de inhoud die vergeleken moet worden in een tijdelijke omgeving (indien mappen een "export" uitvoeren, indien een enkel bestand een "cat" uitvoeren) wanneer nodig en ruimt op na het sluiten van het externe programma of het zichzelf sluiten. +</para></listitem> +</varlistentry> +<varlistentry> +<term>Extern samenvoegprogramma gebruiken</term> +<listitem><para>Indien in het (merge) samenvoeg dialoog "Externe samenvoeging gebruiken, niet die van Subversion" is wel of niet aangevinkt.</para></listitem> +</varlistentry> +</variablelist> +</para> +</sect2> +<sect2> +<title>Externe samenvoeg programma</title> +<para> +Stelt het programma en de mogelijkheden daarvan in voor gebruik wanneer de ingebouwde mogelijkheden van subversion ongewenst zijn. De standaard is <prompt>kdiff3 %s1 %s2 %t</prompt>. De volgorde van de vervangende variabelen is niet belangrijk, en kunnen meer keren voorkomen, b.v. zoals <prompt>kdiff3 -o %t %s1 %s2 %t</prompt>. Dit is alleen getest met "meld" + en "kdiff3". Bedenk dat externe programma's meestal geen weet hebben van subversion ignore-parameters en dat daarom veel meer te zien is dan verwacht. +</para> +<sect3> +<title>Vervangings-variabelen voor het externe (merge) samenvoeg programma</title> +<para> +<variablelist> + +<varlistentry> +<term>%s1</term> +<listitem><para> +Vervang door bron nummer een. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>%s2</term> +<listitem><para> +Vervang door bron nummer twee. Als deze leeg is of gelijk is aan de bron een en de start en eind revisie zijn dezelfde, dan wordt deze variabele overgeslagen. Wees daarom voorzichtig met het opstellen van commandoregel zoals <prompt>xxdiff --title1 %s1 --title2 %s2 %s1 %s2 %t</prompt>. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>%t</term> +<listitem><para> +Vervang door doel. +</para></listitem> +</varlistentry> + +</variablelist> + +</para> +</sect3> +</sect2> +</sect1> +<sect1 id="kio-cmdline-settings"> +<title>KIO / commandoregel</title> +<para> +<variablelist> + +<varlistentry> +<term>Log tonen na het uitvoeren van een commando</term> +<listitem><para> +Moet een dialoog geopend worden met de log van de laatste via de commandoregel of via konqueror gegeven subversion-commando. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Minimaal aantal logregels tonen:</term> +<listitem><para> +Indien "Toon log..." is ingeschakeld, wat is het minimum aantal regels dat dit dialoog moet tonen. Zodat dit zo ingesteld kan worden dat alleen interresante output te zien is (toevoeglog enzovoorts). +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Contextmenu niet weergeven in Konqueror</term> +<listitem><para> +Indien ingeschakelt, wordt er geen menu-item voor &kappname; aangemaakt in konqueror. Werkt alleen in KDE 3.5. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>KIO-handelingen met het gebruik van standaard logberichten</term> +<listitem><para> +Wanneer een repository bewerkt wordt via het &kappname; KIO protocool vanuit konqueror (b.v. het "ksvn+..." protocool) met grote operaties zoals het verplaatsen of kopieren van mappen, moet &kappname; dan vragen naar een logbericht voor elk item. Dit is normaal gedrag van konqueror. +Wanneer dit is ingeschakeld, zal de KIO-implementatie van &kappname; niet vragen naar een logbericht maar een standaard logbericht meegeven. Dit gebeurt niet bij akties vanuit het &kappname;-menu voor konqueror maar alleen bij het kopieren/ verplaatsen en het aanmaken of weer verwijderen van mappen in konqueror of een andere bestandsmanager met een KIO-url. +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Standaard berichten</term> +<listitem><para> +Het bericht dat kdesvn-kio zou moeten geven bij bewerkingen vanuit konqueror wanneer bovenstaande vlag is gezet. Standaard is "Revision made with kdesvn KIO." +</para></listitem> +</varlistentry> + +</variablelist> + +</para> +</sect1> +</chapter> + +<chapter id="commands"> +<title>De inhoud van de menu's</title> + +<!-- (OPTIONEEL, MAAR AANBEVOLEN) Dit hoofdstuk zou een lijst moeten geven van alle vensters van het programma, de menu's en werkbalk commando's om makkelijk op te kunnen zoeken. +Ook toetsaanslagen die een speciale functie hebben en geen equivalent in de menu's of werkbalken hebben. Dit is niet noodzakelijk voor kleine programma's of programma's zonder menu's en werkbalken. --> + +<sect1 id="kdesvn-mainwindow"> +<title>Het &kappname; hoofdvenster</title> + +<sect2> +<title>Het menu Bestand</title> +<para> +<variablelist> +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo> +</shortcut> +<guimenu>Bestand</guimenu> +<guimenuitem>Openen</guimenuitem> +</menuchoice></term> +<listitem><para><action>Opent een lokale werkkopie of een repository die al is uitgecheckt.</action></para></listitem> +</varlistentry> +<varlistentry> +<term> +<menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo> +</shortcut> +<guimenu>Bestand</guimenu> +<guimenuitem>Sluiten</guimenuitem> +</menuchoice> +</term> +<listitem><para><action>Sluit</action> de huidige geopende repository of werkkopie.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut> +<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> +</shortcut> +<guimenu>Bestand</guimenu> +<guimenuitem>Afsluiten</guimenuitem> +</menuchoice></term> +<listitem><para><action>Afsluiten</action> van &kappname;</para></listitem> +</varlistentry> +</variablelist> +</para> +</sect2> +<sect2> +<title>Het menu <guimenu>Bladwijzers</guimenu></title> +<para> +Lees de helppagina's van konqueror. +</para> +</sect2> +<sect2 id="kdesvn-subversion-menu"> +<title>Het menu <guimenu>Subversion</guimenu></title> +<variablelist> + +<varlistentry> +<term><menuchoice><shortcut><keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guimenuitem>Weergave vernieuwen</guimenuitem> +</menuchoice></term> +<listitem><para><action>Vernieuw</action> de huidige weergave van alle getoonde items. Dit toont de huidige status van alle gevraagde items. +</para></listitem> + +</varlistentry> +</variablelist> +<sect3> +<title>Algemene subversion aktie's</title> +<variablelist> +<varlistentry> +<term> +<menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Volledige log</guimenuitem> +</menuchoice></term> +<listitem> +<para><action>Toont </action> de levenslange log van het geselecteerde item. +Wees voorzichtig, deze lijst kan erg lang zijn!</para> +</listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl; &Shift;<keycap>L</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Log...</guimenuitem> +</menuchoice></term> +<listitem><para>Toont een log, waarbij een revisie/datum bereik ingesteld kan worden.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>I</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Details</guimenuitem> +</menuchoice></term> +<listitem><para>Toont gedetaileerde informatie over het geselecteerde item(s)</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Blame</guimenuitem> +</menuchoice></term> +<listitem><para>Maakt een lijst met aantekeningen (annotatie's) over alle vastleggingen (commit). Dit kan veel tijd kosten!</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Blame bereik</guimenuitem> +</menuchoice></term> +<listitem><para>Stelt het bereik in voor de vastleggingen (commit) van een bestand.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Cat HEAD</guimenuitem> +</menuchoice></term> +<listitem><para>Toont de inhoud van de laatste vastgelegde (commit) versie van het item. (Dit kan verschillen met de werkkopie indien er gewerkt is aan de werkkopie!)</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>F2</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Verplaatsen</guimenuitem> +</menuchoice></term> +<listitem><para>Verplaats of hernoem een item in een werkkopie of in de repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>F5</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Kopiëren</guimenuitem> +</menuchoice></term> +<listitem><para>Kopieer een item in werkkopie of in een repository</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>Del</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Gemarkeerde bestanden/mappen verwijderen</guimenuitem> +</menuchoice></term> +<listitem><para>Verwijdert de geselecteerde items. Indien men in een werkkopie werkt, moeten de verwijderingen daarna vastgelegd worden.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Nieuwe map</guimenuitem> +</menuchoice></term> +<listitem><para>Maakt een nieuwe map.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Mappen importeren in huidige map</guimenuitem> +</menuchoice></term> +<listitem><para>Selecteer de mappen die U wilt importeren naar de huidige geselecteerde map.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Repository uitchecken</guimenuitem> +</menuchoice></term> +<listitem><para>Maakt een nieuwe werkkopie van een repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Repository exporteren</guimenuitem> +</menuchoice></term> +<listitem><para>Exporteert een repository naar een bestands-systeem, maakt b.v. een schone boom van mappen zonder de subversion-informatie. +</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Huidige items vergrendelen</guimenuitem> +</menuchoice></term> +<listitem><para>Markeer de huidige items als vergrendeld. Lees voor het gebruik het subversion handboek! +</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Algemeen</guisubmenu> +<guimenuitem>Huidige items ontgrendelen</guimenuitem> +</menuchoice></term> +<listitem><para>Ontgrendel de huidige items. Lees voor het gebruik het subversion handboek! +</para></listitem> +</varlistentry> +</variablelist> +</sect3> +<sect3> +<title>Werkkopie</title> +<variablelist> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>u</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Bijwerken naar HEAD</guimenuitem> +</menuchoice></term> +<listitem><para>De werkkopie bijwerken naar de HEAD van de repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Bijwerken naar revisie...</guimenuitem> +</menuchoice></term> +<listitem><para>De werkkopie bijwerken naar een bepaalde revisie van de repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>#</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Vastleggen</guimenuitem> +</menuchoice></term> +<listitem><para>Legt de veranderingen van de gemarkeerde items in de werkkopie vast (commit) naar de repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>D</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Verschil bepalen lokale wijzigingen</guimenuitem> +</menuchoice></term> +<listitem><para>Toont de lokale verschillen als een diff-output (zonder toegang tot een netwerk). Dit is alleen het verschil tegen de laatste bijgewerkte stand van de werkkopie, niet tegen de versie in de repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul">&Ctrl;<keycap>H</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Verschil bepalen ten opzichte van HEAD</guimenuitem> +</menuchoice></term> +<listitem><para>Diff's de huidige werkkopie tegen HEAD van de repository.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>P</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Eigenschappen</guimenuitem> +</menuchoice></term> +<listitem><para>Tonen/Bewerken van eigenschappen van het huidige item.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<shortcut><keycombo action="simul"><keycap>Insert</keycap></keycombo></shortcut> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Gemarkeerde bestanden/mappen toevoegen</guimenuitem> +</menuchoice></term> +<listitem><para>Leg de gemarkeerde bestanden/mappen vast (commit) aan revisie controle.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Huidige veranderingen terugdraaien</guimenuitem> +</menuchoice></term> +<listitem><para>Maak de veranderingen in de werkkopie ongedaan naar de laatste bijgewerkte toestand.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Recursief oplossen</guimenuitem> +</menuchoice></term> +<listitem><para>Markeer de in conflict zijnde items als "niet in conflict" en verwijder de daarbijhorende bestanden.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Twee revisies samenvoegen</guimenuitem> +</menuchoice></term> +<listitem><para>Voeg twee revisies van een item samen (merge )in de werkkopie.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Huidige item negeren/negeren opheffen</guimenuitem> +</menuchoice></term> +<listitem><para>Bewerk de eigenschap van de bovenliggende map van dit item zo dat dit item gemarkeerd wordt als negeren of juist weer van de negeer-lijst afhalen.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Opruimen</guimenuitem> +</menuchoice></term> +<listitem><para>Ruim de werkkopie op en verwijder de aanwezig zijnde (commit-)vergrendelingen.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Repository switchen</guimenuitem> +</menuchoice></term> +<listitem><para>Verandert de hoofdmap van de huidige werkkopie. "relocate" Dit wordt op dit moment niet ondersteund.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Werkkopie</guisubmenu> +<guimenuitem>Repository switchen</guimenuitem> +</menuchoice></term> +<listitem><para>Opent de repositoryboom van een andere werkkopie.</para></listitem> +</varlistentry> +</variablelist> +</sect3> +<sect3> +<title>Repository</title> +<variablelist> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Repository</guisubmenu> +<guimenuitem>Huidige repositorypad uitchecken</guimenuitem> +</menuchoice></term> +<listitem><para>Maakt een werkkopie van de huidige geselecteerde item als het een map is.</para></listitem> +</varlistentry> +<varlistentry> +<term><menuchoice> +<guimenu>Subversion</guimenu> +<guisubmenu>Repository</guisubmenu> +<guimenuitem>Huidige repositorypad exporteren</guimenuitem> +</menuchoice></term> +<listitem><para>Maakt een schone kopie op het lokale bestandsysteem van de geselecteerde item als het een map is.</para></listitem> +</varlistentry> +</variablelist> +</sect3> +</sect2> +<sect2> +<title>Het <guimenu>Help</guimenu> Menu</title> + +<!-- Assuming you have a standard help menu (help, what's this, about --> +<!-- &kappname;, about KDE) then the documentation is already written. --> +<!-- The following entity is valid anywhere that a variablelist is --> +<!-- valid. --> + +&help.menu.documentation; + +</sect2> + +<sect2 id="kdesvn-svntoolbar"> +<title>De subversion werkbalk</title> +<variablelist> +<varlistentry> +<term> +<guibutton>Openen</guibutton> +</term> +<listitem><para>Open een werkkopie</para></listitem> +</varlistentry> +</variablelist> +</sect2> + +</sect1> +</chapter> + +<chapter id="faq"> +<title>Vraag en antwoord</title> + +<!-- (OPTIONAL but recommended) This chapter should include all of the silly +(and not-so-silly) newbie questions that fill up your mailbox. This chapter +should be reserved for BRIEF questions and answers! If one question uses more +than a page or so then it should probably be part of the +"Using this Application" chapter instead. You should use links to +cross-reference questions to the parts of your documentation that answer them. +This is also a great place to provide pointers to other FAQ's if your users +must do some complicated configuration on other programs in order for your +application work. --> + +<!-- +&reporting.bugs; +&updating.documentation; +--> + +<qandaset id="faqlist"> +<qandaentry> +<question> +<para>Wanneer het (k)svn+ssh protocol gebruikt wordt, wordt telkens opnieuw naar het wachtwoord gevraagt, waarom ?</para> +</question> +<answer> +<para> +Het "probleem" is ssh zelf. Subversion maakt voor elk verzonden commando een tunnel naar de repository. En elke tunnel is een nieuw ssh- verbinding. En elke ssh moet geïndentificeerd worden. Dit kan verbeteren wanneer Uw lokale publieke identiteit naar de host de repository bevat. Indien Uw publieke indentiteit een wachtwoord heeft, zal het aan ssh-agent worden gevraagd (wanneer ssh-agent is geïnstalleerd). +</para> +<para> +Wanneer een ssh-agent wordt gestart voordat &kappname; is gestart, voeg dan Uw indentiteit toe aan de cache van deze ssh-agent, &kappname; zal dit niet veranderen vanwege de veiligheid, en vraagt daarom steeds opnieuw naar Uw wachtwoord. (Lees ook <ulink url="man:ssh-add">Manpage van ssh-add</ulink>) +</para> +<para> +<ulink url="http://steamedpenguin.com/kdesvn-and-private-keys/">Steamedpenguin heeft een mooie beschrijving</ulink> hoe &kappname; te gebruiken met ssh en keychain. +</para> +</answer> +</qandaentry> +<qandaentry> +<question> +<para>Het wachtwoord prompt voor (k)svn+ssh komt in de terminal wanneer &kappname; vanuit de terminal wordt gestart, hoe kan ik dit uitschakelen?</para> +</question> +<answer> +<para> +Het mag niet uitgeschakeld worden. Dit is een eigenschap van ssh-agent zelf, wanneer het merkt dat het in een terminal is gestart, dan vraagt het voor een wachtwoord in een terminal en niet in een X-dialoog zoals kdesvnaskpass. (Lees ook <ulink url="man:ssh-add">Manpage van ssh-add</ulink>). +</para> +</answer> +</qandaentry> +<qandaentry> +<question> +<para>Bij controles voor nieuwere versies, toont &kappname; iets niet terwijl ik weet dat er nieuwere items zijn!</para> +</question> +<answer> +<para> +Updates worden alleen getoond wanneer de bestandserver ook subversion 1.2 is. B.v. wanneer het lijkt dat repository subversion <1.2 is. Er zijn geen plannen dat &kappname; zelf recursief de controle uitvoert - dit is niet zinvol. Vraag of de repository een modernere versie van subversion kan krijgen. +</para> +</answer> +</qandaentry> +<qandaentry> +<question> +<para>Wanneer &kappname; wordt gestart, toont het de dialoog "Kon de KPart niet vinden" en toont vervolgens een leeg venster, waarom?</para> +</question> +<answer> +<para> +Er kunnen vele redenen zijn waarom het programma niet geladen kon worden. Dit gebeurt meestal wanneer men de subversion-bibiotheken zelf compileert. +Lees in dat geval de beschrijving van de <ulink url="http://kdesvn.alwins-world.de/ticket/128">issue entry</ulink>. +</para> +<para> +Het volgende probleem kan zijn dat bij het compileren de libsuffix voor 64-Bit systemen niet is meegegeven. De onderdelen worden dan geïnstalleerd in <prompt>$PREFIX/lib</prompt> inplaats van <prompt>$PREFIX/lib64</prompt>. Geef daarom <prompt>-DLIB_SUFFIX=64</prompt> als paramter naar cmake. +</para> +<para>Als het probleem nog niet is opgelost, probeer dan het volgende in een terminal: +<programlisting> + export LD_PRELOAD=/usr/lib/kde3/libkdesvnpart.so + kdesvn + unset LD_PRELOAD +</programlisting> +(/usr/lib/kde3 kan op Uw systeem anders zijn, controleer daarom de plaats waar het is geïnstalleerd) +</para> +<para> +Met behulp van veel output is te zien waarom libkdesvnpart.so niet geladen kan worden, dit kan helpen om het probleem op te lossen. +</para> +</answer> +</qandaentry> +</qandaset> +</chapter> + +<appendix id="revision-syntax"> +<title>Opbouw voor revisies</title> +<para> +Revisies kunnen in dezelfde vorm gegeven worden als bij de standaard svn - cliënt. Dit betekent: een nummer, trefwoord of een datum. +</para> +<para> +<variablelist> + +<varlistentry> +<term>Nummers</term> +<listitem><para> +Een nummer gelijk of groter dan -1. -1 betekend "unspecified revision", 0 is het begin. Normaal is het beter als deze nummers niet gebruikt worden (de meeste opdrachten zullen hiermee mislukken). +</para></listitem> +</varlistentry> + +<varlistentry> +<term>Trefwoord</term> +<listitem><para> +Een van +<itemizedlist> + +<listitem><para> +HEAD +</para></listitem> + +<listitem><para> +BASE +</para></listitem> + +<listitem><para> +COMMITED +</para></listitem> + +<listitem><para> +PREV +</para></listitem> + +<listitem><para> +START +</para></listitem> + +<listitem><para> +WORKING +</para></listitem> + +</itemizedlist> + +</para> +<para> +De trefwoorden zijn hoofdlettergevoelig! b.v. head is niet hetzelfde als HEAD. +</para> +</listitem> +</varlistentry> + +<varlistentry> +<term>Datum</term> +<listitem><para> +De datum moet in volgorde {YYYY-MM-DD}. Het moet echt MM of DD - b.v. 2005-1-1 moet worden geschreven als {2005-01-01}. +</para></listitem> +</varlistentry> + +</variablelist> + +</para> +<para> +Een gewenst revisie toevoegen naar url moet altijd gedaan worden via "?rev=<revision>. +</para> +</appendix> + +<appendix id="further"> +<title>Meer informatie</title> +<sect1> +<title>Bugs melden / terugkoppeling</title> +<para> +Bugmeldingen en wensen (in het Engels)kunnen gezonden worden naar <email>[email protected]</email>, vragen over het gebruik of andere terugkoppelingen naar <email>[email protected]</email>. +</para> +<para> +Een overzicht van de mailinglijsten voor &kappname; zijn te verkrijgen op <ulink url="http://lists.alwins-world.de/mailman/listinfo">mailinglijsten overzicht</ulink>. +</para> +</sect1> +<sect1 id="credits-and-license"> +<!-- Include credits for the programmers, documentation writers, and +contributors here. The license for your software should then be included below +the credits with a reference to the appropriate license file included in the KDE +distribution. --> +<title>Dankbetuigingen en licenties</title> +<para> +Programma copyright 2005-2006 Rajko Albrecht <email>[email protected]</email> +</para> +<para> +Hartelijk dank aan de volgende personen: +<itemizedlist> +<listitem><para>Andreas Richter <email>[email protected]</email> - voor de overzetting naar qt4 van svnqt</para> +</listitem> +<listitem><para>Michael Biebl <email>[email protected]</email> - voor de vele hulp, ideeën en aanwijzingen.</para> +</listitem> +<listitem><para>Bram Schoenmakers <email>[email protected]</email> - voor de kde-specific aanwijzingen, Nederlandse vertaling van de menu's, opschonen van mijn code.</para> +</listitem> +<listitem><para>Ronald Stroethoff <email>[email protected]</email> - voor de Nederlandse vertaling van deze help-pagina's.</para> +</listitem> +</itemizedlist> +Hartelijk dank aan alle andere vertalers (Ik had nooit gedacht dat ik zo snel zoveel vertalingen zou krijgen!) en voor alle positieve en negatieve terugkoppelingen. Dat heeft veel geholpen. +</para> +<para> +Indien U Uw eigen vertaling van &kappname; wilt en hulp wenst, lees meer op de homepage van &kappname; of vraag op <ulink url="mailto:[email protected]"><email>[email protected]</email> mailinglist</ulink>. +</para> +<para> +Documentatie copyright 2005-2006 Rajko Albrecht <email>[email protected]</email> +</para> +<!-- TRANS:CREDIT_FOR_TRANSLATORS --> + +&underFDL; <!-- FDL: do not remove --> +<!-- Determine which license your application is licensed under, + and delete all the remaining licenses below: + + (NOTE: All documentation are licensed under the FDL, + regardless of what license the application uses) --> + +&underGPL; <!-- GPL License --> +<!-- &underBSDLicense; --><!-- BSD License --> +<!-- &underArtisticLicense; --><!-- BSD Artistic License --> +<!-- &underX11License; --><!-- X11 License --> +</sect1> + +</appendix> + +<appendix id="installation"> +<title>Installatie</title> + +<sect1 id="getting-kdesvn"> +<title>Hoe U &kappname; kunt verkrijgen</title> + +<!-- Deze eerste item bevat een voorbeel (boiler plate) voor programma's die een onderdeel zijn van KDE CVS. Deze moet verwijderd worden wanneer U Uw programma releast. --> +<para> +&kappname; kan worden gevonden op + <ulink url="http://kdesvn.alwins-world.de/downloads/"> +de &kappname; download area</ulink>. +</para> +<para> +Op de <ulink url="http://kdesvn.alwins-world.de/browser/trunk">laatste repository versie</ulink> is te zien wat de laatste ontwikkelingen zijn. +</para> +<para> +De homepage van het project is <ulink url="http://kdesvn.alwins-world.de/">http://kdesvn.alwins-world.de/</ulink> +</para> +</sect1> + +<sect1 id="requirements"> +<title>Benodigde bibliotheken</title> + +<!-- +Vermeldt alle speciale benodigheden voor Uw programma hier. This should include: +.bibiotheken of andere software dat niet is meegeleverd met kdesupport, +kdelibs, of kdebase. +.Hardware benodigheden zoals de hoeveelheid geheugen (RAM), harde schijf ruimte, grafische kaart, scherm resolutie, andere speciale kaarten enz. +.Operating systemen waarop het programma loopt. Indien Uw programma is ontworpen om alleen op een specifiek OS te werken, (U schreef een bijvoorbeeld een grafische LILO configurator) , meldt deze informatie hier. +--> + +<para> +Subversion 1.2 of moderner en &kde; 3.4.x +of moderner. Subversion ouder dan 1.2 wordt NIET ondersteund! +</para> +<para> +Subversion kan worden gevonden op <ulink url="http://subversion.tigris.org">its homepage</ulink> , maar Uw distributeur heeft waarschijnlijk pakketten voor Uw systeem en/of ditributie. +</para> +<!-- Voor een lijst van updates, kunt U verwijzen naar de webpage van het Changelog- bestand, of ... --> +<para> +Een lijst met wijzigingen kan gevonden worden op <ulink +url="http://kdesvn.alwins-world.de/browser/trunk/ChangeLog">http://kdesvn.alwins-world.de/browser/trunk/ChangeLog</ulink>. +</para> +</sect1> + +<sect1 id="compilation"> +<title>Compileren en installeren</title> +<para> +&kappname; heeft voor compilatie cmake 2.4 of moderner nodig, automake wordt niet ondersteund. Voer de volgende stappen uit met naar naar keuze een tar-archief van een distributie of een tar-archief vanuit het repository . Pak het archief uit of checkout / exporteer een kopie van repository en ga naar de resulterende bron-map. +</para> +<para> +<screen> +<prompt>%</prompt> <userinput><command>mkdir</command> build</userinput> +<prompt>%</prompt> <userinput><command>cd</command> build</userinput> +<prompt>%</prompt> <userinput><command>cmake</command> ../ -DCMAKE_INSTALL_PREFIX=`kde-config --prefix` -DCMAKE_BUILD_TYPE=Release</userinput> +<prompt>%</prompt> <userinput><command>make</command></userinput> +<prompt>%</prompt> <userinput><command>make</command> install</userinput> +</screen> +</para> +</sect1> + +</appendix> + +&documentation.index; +</book> + +<!-- +Local Variables: +mode: sgml +sgml-minimize-attributes:nil +sgml-general-insert-case:lower +sgml-indent-step:0 +sgml-indent-data:nil +End: + +vim:tabstop=2:shiftwidth=2:expandtab +--> + |
