<!-- 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
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.
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>. 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>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.
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!
Dit item moet vergrendeld worden voordat het bewerkt en weer samengevoegd kan worden. Totdat het vergrendeld is, houdt subversion het als "alleen lezen".
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.
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>
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
<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>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>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>
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.:
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>
<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>
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.
&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. -->
<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>
<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.
<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>
<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>
<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:
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>kdesvn-bugs@alwins-world.de</email>, vragen over het gebruik of andere terugkoppelingen naar <email>kdesvn@alwins-world.de</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>kdesvn@alwins-world.de</email>
</para>
<para>
Hartelijk dank aan de volgende personen:
<itemizedlist>
<listitem><para>Andreas Richter <email>ar@oszine.de</email> - voor de overzetting naar qt4 van svnqt</para>
</listitem>
<listitem><para>Michael Biebl <email>biebl@teco.edu</email> - voor de vele hulp, ideeën en aanwijzingen.</para>
</listitem>
<listitem><para>Bram Schoenmakers <email>bramschoenmakers@kde.nl</email> - voor de kde-specific aanwijzingen, Nederlandse vertaling van de menu's, opschonen van mijn code.</para>
</listitem>
<listitem><para>Ronald Stroethoff <email>stroet43@zonnet.nl</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:kdesvn-i10n@alwins-world.de"><email>kdesvn-i10n@alwins-world.de</email> mailinglist</ulink>.
</para>
<para>
Documentatie copyright 2005-2006 Rajko Albrecht <email>kdesvn@alwins-world.de</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) -->
<!-- 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. -->
.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
&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.
