[kde-doc-english] [kdesvn] doc: kdesvn handbook update
Burkhard Lück
lueck at hube-lueck.de
Tue Jul 19 18:50:36 UTC 2016
Git commit c6173331b93aab0a045492331d07b793b70d46e6 by Burkhard Lück.
Committed on 19/07/2016 at 18:50.
Pushed by lueck into branch 'master'.
kdesvn handbook update
proofread + update
remove comments
bump date+releaseinfo
from kde, not for kde
add some missing items
remove appendix
remove faq
Ship It by Christian Ehrlicher via PM
REVIEW:127991
M +320 -338 doc/index.docbook
http://commits.kde.org/kdesvn/c6173331b93aab0a045492331d07b793b70d46e6
diff --git a/doc/index.docbook b/doc/index.docbook
index 3594b5c..57308c5 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -1,28 +1,14 @@
<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
<!ENTITY kdesvn "<application>kdesvn</application>">
- <!ENTITY kwallet "<application>KWallet</application>">
- <!ENTITY kdiff3 "<application>KDiff3</application>">
- <!ENTITY kappname "&kdesvn;"><!-- Do *not* replace kappname-->
- <!ENTITY package "kde-module"><!-- kdebase, kdeadmin, etc -->
<!ENTITY % addindex "IGNORE">
<!ENTITY Rajko.Albrecht '<personname><firstname>Rajko</firstname><surname>Albrecht</surname></personname>'>
<!ENTITY Rajko.Albrecht.mail '<email>ral at alwins-world.de</email>'>
<!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>
@@ -42,33 +28,17 @@ as Authors, publish date, the abstract, and Keywords -->
<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>2013-07-05</date>
-<releaseinfo>0.4</releaseinfo>
-
-<!-- Abstract about this handbook -->
+<date>2016-05-22</date>
+<releaseinfo>kdesvn 2.0</releaseinfo>
<abstract>
<para>
-&kdesvn; - a subversion client for &kde;.
+&kdesvn; - a subversion client by &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>
@@ -78,25 +48,11 @@ Please at least include KDE, the KDE package it is in, the name
</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 labeled (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;.
+&kdesvn; is a <ulink url="http://subversion.apache.org/">subversion client</ulink> by &kde;.
</para>
<para>You should have some knowledge about subversion itself, but hopefully most items are self explanatory.
</para>
@@ -196,7 +152,7 @@ Subversion's own server protocol.
<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.
+Subversion over ssh.
</para></listitem>
</varlistentry>
@@ -385,8 +341,8 @@ With the buttons above you may select another range of logs to display.
</para>
<para>
-The buttons below displays always work on item selected for log, not on item selected in list of changed files. So when you select
-<guibutton>Diff previous</guibutton> there it makes the diff over all changed items in this revision if them are equivalent or below the subversion
+The buttons below displays always work on item selected for log, not on item selected in list of changed files. So when you select
+<guibutton>Diff previous</guibutton> there it makes the diff over all changed items in this revision if them are equivalent or below the subversion
entry selected for retrieving logs before. Same for <guibutton>Diff revisions</guibutton>.
</para>
<para>
@@ -397,7 +353,7 @@ entry selected for retrieving logs before. Same for <guibutton>Diff revisions</g
</para>
</sect3>
</sect2>
-</sect1>
+</sect1>
<sect1 id="working-with-repositories">
<title>Working on repositories</title>
@@ -541,14 +497,14 @@ If recursive is not set, the export is done as a flat export. Be care: when doin
&kdesvn; itself hasn't a module for resolving conflicts but you may use external software from within &kdesvn;. 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 <quote>conflicted</quote> (you'll see a red cross in listview on such items) you may select
+ When marking an item with status set to <quote>conflicted</quote> (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 <guimenuitem>Resolve conflict</guimenuitem> (only on conflicted items)
-&kdesvn; now starts the program you setup (or the default one). After finish this job you should mark item as resolved
+&kdesvn; 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>
@@ -640,7 +596,7 @@ The revision tree is generated via <application>dot</application>. So for a work
</sect2>
</sect1>
-<sect1 id="logcache-descr">
+<sect1 id="logcache-descr">
<title>Internal log cache</title>
<para>
&kdesvn; may use an internal log cache for some operations. Mostly it is used for <link linkend="revision-tree">the revision tree</link> but when viewing simplified log in offline mode, too. The caches are organized as <application>SQLite</application> databases stored in <filename class="directory">$HOME/.sqvnqt/logcache</filename>. Every numbered file is a storage for a different repository.
@@ -651,11 +607,11 @@ The revision tree is generated via <application>dot</application>. So for a work
</para>
</warning>
<para>
- You may simply remove a database, than no cached log will given back for that repository (and no revision tree!) but when you do not disable automatic filling the cache on next open this repository or an associated working copy of it the cache will refilled again.
+ You may simply remove a database, than no cached log will be given back for that repository (and no revision tree!) but when you do not disable automatic filling the cache on next open this repository or an associated working copy of it the cache will be refilled again.
</para>
<sect2>
<title>Offline mode</title>
-<para>&kdesvn; may work without network access, &ie; you can switch off the network access for &kdesvn;. This may useful when working without network like on notebooks. In such cases &kdesvn; always gets 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 <guilabel>Log follows node changes</guilabel> is set.</para>
+<para>&kdesvn; may work without network access, &ie; you can switch off the network access for &kdesvn;. This may be useful when working without network like on notebooks. In such cases &kdesvn; always gets the logs from the internal cache. This log is reduced to base functions due to 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 <guilabel>Log follows node changes</guilabel> is set.</para>
</sect2>
<sect2>
<title>Log cache and revision tree</title>
@@ -794,15 +750,15 @@ This entry (or entry below if folder) got conflicts to resolve with last update.
</para>
</sect2>
<sect2>
-<title>Saving passwords in &kwallet;</title>
+<title>Saving passwords in &kwallet5;</title>
<para>
- Secured password storage used by a lot of &kde; programs like &kmail; and &konqueror;. If you are saving passwords and mostly using &kdesvn; you should use this. Keep care that the encrypted storage isn't a high-secure storage. Details see <ulink url="help:/kwallet">&kwallet; documentation</ulink>.
+ Secured password storage used by a lot of &kde; programs like &kmail; and &konqueror;. If you are saving passwords and mostly using &kdesvn; you should use this. Keep care that the encrypted storage isn't a high-secure storage. Details see <ulink url="help:/kwallet5">&kwallet5; documentation</ulink>.
</para>
</sect2>
<sect2>
<title>Saving to subversion's own password storage</title>
<para>
- This is not recommended 'cause the passwords are stored as clear text! Not believing? Take a look into the files in <filename class="directory">~/.subversion/auth/svn.simple</filename>. You should only use this if you are frequently using other clients than &kdesvn; like <application>rapidsvn</application> or <application>esvn</application> or the original <application>svn</application> command line client. If you're using the command line client mostly for checkouts or updates which do not require a password and &kdesvn; for commit/move/copy you should use &kwallet; instead.
+ This is not recommended 'cause the passwords are stored as clear text! Not believing? Take a look into the files in <filename class="directory">~/.subversion/auth/svn.simple</filename>. You should only use this if you are frequently using other clients than &kdesvn; like <application>rapidsvn</application> or <application>esvn</application> or the original <application>svn</application> command line client. If you're using the command line client mostly for checkouts or updates which do not require a password and &kdesvn; for commit/move/copy you should use &kwallet5; instead.
</para>
</sect2>
<sect2>
@@ -814,7 +770,7 @@ You may activate an internal password cache which will hold passwords as long &k
<sect2>
<title>Special case 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 machine and repository. When want to store something you should use the public key authentication of ssh, not the password authentication. (In fact ssh prefer the public key authentication). For this you must put your public ssh-key on the target, ⪚, the repository system. SSH passwords will never be handled by subversion passwords storage or &kwallet; or internal password cache.
+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 machine and repository. When want to store something you should use the public key authentication of ssh, not the password authentication. (In fact ssh prefer the public key authentication). For this you must put your public ssh-key on the target, ⪚, the repository system. SSH passwords will never be handled by subversion passwords storage or &kwallet5; or internal password cache.
</para>
<para>
If you don't want asked for the password of your SSH key you can use the <application>ssh-agent</application>, with selecting the menu
@@ -845,8 +801,7 @@ As of version 0.7.0 of &kdesvn; it comes with some modules integrating some comm
<listitem><para>ksvn+ssh</para></listitem>
<listitem><para>ksvn</para></listitem>
</itemizedlist>
-<para>The same may be said for <quote>svn+...</quote>. But as from &kde; 3.4, kdesdk has it own small svn-kio called <quote>svn+http</quote> &etc; So packages are organized that way - or should that <quote>svn+...</quote> 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. For example, <filename class="directory">ksvn+file:///<replaceable>path</replaceable></filename> must point to the beginning of a repository different to the application itself or KPart.
Working copies may browsed with &konqueror;.
@@ -897,8 +852,8 @@ kdiff3 \
<title>Programmers information about KIO::ksvn</title>
<note><para>You may skip this if not interested in KIO programming.</para></note>
<para>
-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, <application>KDevelop</application> may use it if kdesdk isn't installed but uses &kdesvn;::KIO::svn.
+KIO::ksvn::special knows the following operations, these are made almost equal in call to the current existing in KIO from kdesdk-kioslaves
+so, for instance, &kdevelop; may use it if kdesdk-kioslaves isn't installed but uses &kdesvn;::KIO::svn.
</para>
<sect2>
<title>Command list</title>
@@ -926,9 +881,9 @@ KIO::ksvn::special knows the following operations, these are made almost equal i
KURL repository, KURL target, int revnumber, QString revkind
</para>
<para>
-The target will NOT be modified, ⪚, but the content will be checked out without creating a subfolder! For example, 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/!
+The target will <emphasis>not</emphasis> be modified, ⪚, but the content will be checked out without creating a subfolder! For example, the source may be
+<filename>http://server/repos/project/trunk</filename>, target <filename>/home/user/proj/</filename> then the contents of trunk will copied into <filename>/home/user/proj/</filename> not
+<filename>/home/user/proj/trunk/</filename>!
</para>
</entry>
<entry>Yes</entry>
@@ -1408,6 +1363,14 @@ Settings can be changed from the setup dialog. They are separated into some subd
<entry>Maximum log messages in history</entry>
<entry>How many log messages &kdesvn; should remember.</entry>
</row>
+<row>
+<entry>Display colored annotate</entry>
+<entry>Use colors defined in the settings dialog for annotations.</entry>
+</row>
+<row>
+<entry>Use navigation panel</entry>
+<entry>Toggle the display of the repository tree view.</entry>
+</row>
</tbody>
</tgroup>
</informaltable>
@@ -1415,10 +1378,11 @@ Settings can be changed from the setup dialog. They are separated into some subd
</para>
</sect1>
-<sect1 id="subversion-settings">
-<title>Subversion settings</title>
-<para>
-<informaltable id="subversion-settings-table">
+<sect1 id="subversion-timedjobs-settings">
+<title>Subversion and timed jobs settings</title>
+
+<table id="subversion-settings">
+<title>Subversion</title>
<tgroup cols="2">
<tbody>
@@ -1475,12 +1439,41 @@ Settings can be changed from the setup dialog. They are separated into some subd
<entry>When doing a commit &kdesvn; may make a check what to do. For example, if unversioned items are below which may be added, list items changed and current operation will commit. This cost a depending on tree more or less time.</entry>
</row>
+<row>
+<entry>Hide new items in commit box</entry>
+<entry>Should unversioned items displayed in commit dialog or not.</entry>
+</row>
+
+<row>
+<entry>Update modifies instead of conflicts</entry>
+<entry>If set, a local addition at the same path as an
+incoming addition of the same node kind results in a normal node with a
+possible local modification, instead of a tree conflict.</entry>
+</row>
+
+<row>
+<entry>Update makes missing parents</entry>
+<entry>If set, create any non-existent parent directories
+also by checking them out at depth=empty</entry>
+</row>
+
</tbody>
</tgroup>
-</informaltable>
+</table>
+
+<table id="timejobs-settings">
+<title>Timed jobs</title>
+<tgroup cols="2">
+<tbody>
+<row>
+<entry><para>Check modified items every N seconds</para> <para>Check for updated items every N seconds</para></entry>
+<entry>If set check for updates or modified items in working copy when network is enabled on regular base</entry>
+</row>
+</tbody>
+</tgroup>
+</table>
-</para>
</sect1>
<sect1 id="diffmerge-settings">
@@ -1489,7 +1482,7 @@ Settings can be changed from the setup dialog. They are separated into some subd
<variablelist>
<varlistentry>
-<term>Diff ignore content type</term>
+<term>Diff ignores content type</term>
<listitem><para>
Only interesting when diff are made with subversion itself. When set, than subversion diff ignores the content type of entries. Otherwise it will not output
diffs from binaries.
@@ -1516,6 +1509,24 @@ When set, diffs made from within revision tree view are made recursive like in a
<para>Ignore all white space (option <option>-w</option> to diff)</para>
</listitem>
</varlistentry>
+<varlistentry>
+<term>Prefer external merge program</term>
+<listitem>
+<para>Set if merge with external program is preferred and not Subversion's merge</para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Use Git diff format</term>
+<listitem>
+<para></para>
+</listitem>
+</varlistentry>
+<varlistentry>
+<term>Show copies as add</term>
+<listitem>
+<para></para>
+</listitem>
+</varlistentry>
</variablelist>
</para>
@@ -1602,7 +1613,7 @@ Substituted with target.
<sect2 id="extern-resolve-setup">
<title>Conflict resolver program</title>
<para>
-You may use an external program like &kdiff3; for resolving conflicts, the default is
+You may use an external program like &kdiff3; for resolving conflicts, the default is
<command>kdiff3 %o %m %n -o %t</command>.
</para>
<sect3>
@@ -1639,6 +1650,11 @@ Target name, ⪚ the origin name. For &kdiff3; (as an example) this would be na
</sect3>
</sect2>
</sect1>
+<!--FIXME
+Colors
+
+Revisions tree
+-->
<sect1 id="kio-cmdline-settings">
<title>KIO / command line</title>
<para>
@@ -1666,6 +1682,12 @@ If set, no action menu entry for &kdesvn; is made in &konqueror;.</para></listit
</varlistentry>
<varlistentry>
+<term>Do not display entries in toplevel action menu</term>
+<listitem><para>
+If set, kdesvn will not show some extra actions inside <guimenuitem>Action</guimenuitem> menu of &konqueror; or &dolphin;.</para></listitem>
+</varlistentry>
+
+<varlistentry>
<term>KIO operations use standard log message</term>
<listitem><para>
When making operations on a repository via the &kdesvn; KIO protocol from within &konqueror; (&ie;, <quote>ksvn+...</quote> protocols) on large operations like moving or copy folders &kdesvn; would ask for a log message for each item. This is a behavior of &konqueror;.
@@ -1681,6 +1703,24 @@ When this option is set, the KIO implementation from &kdesvn; will not ask for a
</para></listitem>
</varlistentry>
+<varlistentry>
+<term>KIO can overwrite</term>
+<listitem><para>
+If this flag is set, you will have a simple write support for existing
+items. ⪚ you can open files in your editor and save them direct without
+checking out them before (&kdesvn; will do it in background).</para>
+<para>Use this only if you are sure what you are doing.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term>KIO shows progress messages</term>
+<listitem><para>
+If set KIO shows in KDE's Plasma detailed information about current operation.
+Error messages of KIO will always displayed and can <emphasis>not</emphasis> be switched off.
+</para></listitem>
+</varlistentry>
+
</variablelist>
</para>
@@ -1690,12 +1730,6 @@ When this option is set, the KIO implementation from &kdesvn; will not ask for a
<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>
@@ -1713,6 +1747,47 @@ or menu bars. -->
</menuchoice></term>
<listitem><para><action>Open a local working copy or a repository previously checked out</action></para></listitem>
</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Recent opened urls</guimenuitem>
+</menuchoice></term>
+<listitem><para>This is a shortcut to open recently opened repositories. Clicking on this item opens
+a list to the side of the menu with several of the most
+recently opened local working copies or a repositories.
+Clicking on a specific item will open it in &kdesvn;
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<shortcut>
+<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
+</shortcut>
+<guimenu>File</guimenu>
+<guimenuitem>New</guimenuitem>
+</menuchoice></term>
+<listitem><para><action>Open a window with a new instance of &kdesvn;</action></para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>File</guimenu>
+<guimenuitem>Subversion Admin</guimenuitem>
+</menuchoice></term>
+<listitem><para>Menu items with administration tasks for subversion repositories like:
+<simplelist>
+<member>Create and open new repository</member>
+<member>Dump repository to file</member>
+<member>Hotcopy a repository</member>
+<member>Load dump into repository</member>
+</simplelist>
+For more information please read the output of <command>svnadmin --help</command>
+</para>
+</listitem>
+</varlistentry>
+
<varlistentry>
<term>
<menuchoice>
@@ -1744,24 +1819,12 @@ or menu bars. -->
See <ulink url="help:/konqueror/bookmarks.html">&konqueror; help</ulink>.
</para>
</sect2>
+
<sect2 id="kdesvn-subversion-menu">
<title>The Subversion Menu</title>
-<variablelist>
-<varlistentry>
-<term><menuchoice><shortcut><keycombo action="simul"><keycap>F5</keycap></keycombo></shortcut>
-<guimenu>Subversion</guimenu>
-<guisubmenu>View</guisubmenu>
-<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>
+<variablelist id="subversion-general">
<title>General subversion actions</title>
-<variablelist>
<varlistentry>
<term>
<menuchoice>
@@ -1897,10 +1960,9 @@ subversion information.
</para></listitem>
</varlistentry>
</variablelist>
-</sect3>
-<sect3>
+
+<variablelist id="subversion-workingcopy">
<title>Working copy</title>
-<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Subversion</guimenu>
@@ -2012,10 +2074,9 @@ last state the working copy was updated to, not against the version in repositor
<listitem><para>Switch the root of the current working copy.</para></listitem>
</varlistentry>
</variablelist>
-</sect3>
-<sect3>
+
+<variablelist id="subversion-repository">
<title>Repository</title>
-<variablelist>
<varlistentry>
<term><menuchoice>
<guimenu>Subversion</guimenu>
@@ -2033,131 +2094,179 @@ last state the working copy was updated to, not against the version in repositor
<listitem><para>Create a clean copy on local file system from the current selected entry if a directory.</para></listitem>
</varlistentry>
</variablelist>
-</sect3>
-</sect2>
-<sect2>
-<title>The Help 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. -->
+<variablelist id="subversion-view">
+<title>View actions</title>
+<varlistentry>
+<term><menuchoice><shortcut><keycombo action="simul"><keycap>F5</keycap></keycombo></shortcut>
+<guimenu>Subversion</guimenu>
+<guisubmenu>View</guisubmenu>
+<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>
-&help.menu.documentation;
+<varlistentry>
+<term><menuchoice>
+<guimenu>Subversion</guimenu>
+<guisubmenu>View</guisubmenu>
+<guimenuitem>Unfold File Tree / Fold File Tree</guimenuitem>
+</menuchoice></term>
+<listitem><para>Expand or collapse the repository tree view.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Subversion</guimenu>
+<guisubmenu>Log Cache</guisubmenu>
+<guimenuitem>Stop updating the log cache</guimenuitem>
+</menuchoice></term>
+<listitem><para>The log is cached and used to display the revision tree of a repository. Depending on the Internet connection, size of the subversion repository and history length this may take much time,
+Therefore you can stop updating the cache using this action.
+</para></listitem>
+</varlistentry>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Subversion</guimenu>
+<guimenuitem>Add ssh identities to ssh-agent</guimenuitem>
+</menuchoice></term>
+<listitem><para>Store your SSH-key password for your current session so no further entering of your password is needed.
+</para></listitem>
+</varlistentry>
+</variablelist>
+</sect2>
+<sect2 id="kdesvn-database-menu">
+<title>The Database Menu</title>
+<variablelist>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Database</guimenu>
+<guimenuitem>Show database content</guimenuitem>
+</menuchoice></term>
+<listitem><para>Displays an overview about the cache database content for known repositories and
+allows to delete the cache or repository and access to repository settings.
+</para></listitem>
+</varlistentry>
+<varlistentry>
+<term><menuchoice>
+<guimenu>Database</guimenu>
+<guimenuitem>Settings for current repository</guimenuitem>
+</menuchoice></term>
+<listitem><para>Display a dialog to adapt the settings for the cache, logs and statistics.
+</para></listitem>
+</varlistentry>
+</variablelist>
</sect2>
-<sect2 id="kdesvn-svntoolbar">
-<title>The subversion toolbar</title>
+<sect2>
+<title>The Settings and Help Menu</title>
+<para>Apart from the common &kde; <guimenu>Settings</guimenu> and <guimenu>Help</guimenu>
+menu items described in the the <ulink url="help:/fundamentals/ui.html#menus-settings"
+>Settings Menu</ulink> and <ulink url="help:/fundamentals/ui.html#menus-help">Help Menu</ulink>
+of the &kde; Fundamentals &kwordquiz; this additional menu entry:</para>
+<variablelist>
+
+<varlistentry>
+<term><menuchoice>
+<guimenu>Settings</guimenu>
+<guimenuitem>Quick settings</guimenuitem>
+</menuchoice></term>
+<listitem>
+
<variablelist>
+
<varlistentry>
<term>
-<guibutton>Open</guibutton>
-</term>
-<listitem><para>Open a working copy</para></listitem>
+<guimenuitem>Load last opened URL on start</guimenuitem>
+</term><listitem>
+<para>Reload last opened URL if no one is given on command line.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<guimenuitem>Logs follow node changes</guimenuitem>
+</term><listitem>
+<para><!--FIXME What does this option do? --></para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<guimenuitem>Display ignored files</guimenuitem>
+</term><listitem>
+<para>Show items marked in subversion for ignore or not.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<guimenuitem>Display unknown files</guimenuitem>
+</term><listitem>
+<para>Show files not added to the subversion repository.</para>
+</listitem>
</varlistentry>
+
+<varlistentry>
+<term>
+<guimenuitem>Hide unchanged files</guimenuitem>
+</term><listitem>
+<para>Use this action to show only changed files and provide a clear and concise overview.</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>
+<guimenuitem>Work online</guimenuitem>
+</term><listitem>
+<para>Working offline the log cache will not be updated, therefore the cached log may differ from real log.</para>
+</listitem>
+</varlistentry>
+
</variablelist>
+
+</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 <quote>problem</quote> 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 can be fixed if you store your local public identity to the host containing the
-repository. If your public identity has a password, <application>ssh-agent</application> will be 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
-modify 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>How can I give a different port or username to svn+ssh protocol?</para>
-</question>
-<answer>
-<para>
-You may use an entry in <filename class="directory">$HOME/.ssh/config</filename>, see <ulink url="man:ssh_config">Ssh config manpage</ulink> for exact syntax.
-</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. For example, 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 <quote>Could not find our part</quote> 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 lib suffix on 64-bit systems at compile-time. So the part was installed in <filename class="directory">$PREFIX/lib</filename> instead of <filename class="directory">$PREFIX/lib64</filename>. So give <option>-DLIB_SUFFIX=64</option> as parameter to <command>cmake</command>.
-</para>
-<para>If this does not solve your problem, you may try out on a console:</para>
-<programlisting>
- export LD_PRELOAD=/usr/lib/kde4/libkdesvnpart.so
- kdesvn
- unset LD_PRELOAD
-</programlisting>
+<chapter id="credits-and-license">
+<title>Credits and License and Thanks</title>
+<para>
+Program copyright 2005-2006 &Rajko.Albrecht; &Rajko.Albrecht.mail;
+</para>
+<para>
+Many thanks to contributors:
+</para>
+<itemizedlist>
+<listitem><para>Andreas Richter <email>ar at oszine.de</email> - for qt4 port of svnqt</para>
+</listitem>
+<listitem><para>Michael Biebl <email>biebl at teco.edu</email> - for a lot of help, ideas, implementation and hints.</para>
+</listitem>
+<listitem><para>Bram Schoenmakers <email>bramschoenmakers at kde.nl</email> - for &kde;-specific hints, dutch translation, cleaning up my code.</para>
+</listitem>
+</itemizedlist>
<para>
- (<filename class="directory">/usr/lib/kde4</filename> depends of course on your system, please check where it is installed)
+And thanks 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>
- You should see a lot of output why loading of <filename>libkdesvnpart.so</filename> is not possible, that may help solving your problem.
+ If you want your own translation for &kdesvn; and may want help please read on the <ulink url="http://l10n.kde.org/">&kde; Localization page</ulink> or ask on <ulink url="mailto:kde-i18n-doc at kde.org"><email>kde-i18n-doc at kde.org</email> mailing list</ulink>.
+</para>
+<para>
+Documentation copyright 2005-2006 &Rajko.Albrecht; &Rajko.Albrecht.mail;
</para>
-</answer>
-</qandaentry>
-</qandaset>
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;
+&underGPL;
</chapter>
<appendix id="revision-syntax">
@@ -2171,7 +2280,7 @@ check out <ulink url="http://kdesvn.alwins-world.de/ticket/128">issue entry</uli
<varlistentry>
<term>Number</term>
<listitem><para>
- A number greater or equal -1. -1 means <quote>unspecified revision</quote>, 0 is the beginning. Normally, these numbers shouldn't used (most operations will fail with that).
+ A number greater or equal -1. -1 means <quote>unspecified revision</quote>, 0 is the beginning. Normally, these numbers should not be used (most operations will fail with that).
</para></listitem>
</varlistentry>
@@ -2217,7 +2326,7 @@ The keywords are case sensitive! For example, head is not the same as HEAD.
<varlistentry>
<term>Date</term>
<listitem><para>
-Date in form {YYYY-MM-DD}. It must real MM or DD - ⪚ 2005-1-1 must written as {2005-01-01}.
+Date in form {YYYY-MM-DD}. It must real MM or DD - ⪚ 2005-1-1 must be written as {2005-01-01}.
</para></listitem>
</varlistentry>
@@ -2229,132 +2338,5 @@ Date in form {YYYY-MM-DD}. It must real MM or DD - ⪚ 2005-1-1 must written as
</para>
</appendix>
-<appendix id="further">
-<title>Further information</title>
-<sect1>
-<title>Reporting bugs / Feedback</title>
-<para>
- Bug reports and wishes may be filed on <ulink url="https://bugs.kde.org/">&kde; Bugtracking System</ulink>.<!-- questions about usage or any other feedback to <email>kdesvn at alwins-world.de</email>-->
-</para>
-<!--
-<para>
-An overview for the mailing lists for &kdesvn; 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; &Rajko.Albrecht.mail;
-</para>
-<para>
-Many thanks to contributors:
-</para>
-<itemizedlist>
-<listitem><para>Andreas Richter <email>ar at oszine.de</email> - for qt4 port of svnqt</para>
-</listitem>
-<listitem><para>Michael Biebl <email>biebl at teco.edu</email> - for a lot of help, ideas, implementation and hints.</para>
-</listitem>
-<listitem><para>Bram Schoenmakers <email>bramschoenmakers at kde.nl</email> - for &kde;-specific hints, dutch translation, cleaning up my code.</para>
-</listitem>
-</itemizedlist>
-<para>
-And thanks 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 &kdesvn; and may want help please read on the <ulink url="http://l10n.kde.org/">&kde; Localization page</ulink> or ask on <ulink url="mailto:kde-i18n-doc at kde.org"><email>kde-i18n-doc at kde.org</email> mailing list</ulink>.
-</para>
-<para>
-Documentation copyright 2005-2006 &Rajko.Albrecht; &Rajko.Albrecht.mail;
-</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>
-
-<para>
-&kdesvn; itself can be found
-at <ulink url="https://projects.kde.org/kdesvn/downloads/">
-the &kdesvn; download area</ulink>.
-</para>
-<para>
-You may get <ulink url="https://projects.kde.org/kdesvn/repository/">latest repository version</ulink> when looking whats going on.
-</para>
-<para>
-The homepage of that project is <ulink url="https://projects.kde.org/kdesvn">here</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.5 or above and &kde; 4.9.x
-or above. Subversion prior 1.5 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="https://projects.kde.org/kdesvn/activity/">this page</ulink>.
-</para>
-</sect1>
-
-<sect1 id="compilation">
-<title>Compilation and Installation</title>
-<para>
-&kdesvn; requires at least cmake 2.8 for building, automake isn't supported. The following steps works with both distribution tarball or tarball from repository. Unpack the archive
-or clone the repository and change to the resulting source directory.
-</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>
More information about the kde-doc-english
mailing list