.\" Generated by manscript from nl/dwdiff.1.txt
.TH "DWDIFF" "1" "2018/12/03" "Versie $VERSION$" "dwdiff afgebakend woord verschil programma"
.hw /usr/share/doc/dwdiff-$VERSION$ http://os.ghalkes.nl/dwdiff.html
.SH NAAM
dwdiff \- afgebakend woord verschil programma
.SH OVERZICHT
\fBdwdiff\fR [\fIOPTIES\fR] \fIOUD BESTAND\fR \fINIEUW BESTAND\fR
.br
\fBdwdiff\fR [\fIOPTIES\fR] \fB\-\-diff\-input\fR [\fIDIFF BESTAND\fR]
.SH BESCHRIJVING
\fBdwdiff\fR is een programma dat het verschil tussen twee bestanden bepaalt in
woorden, in plaats van in regels. Het verschilt van \fBwdiff\fR in dat het de
gebruiker toestaat om te specificeren wat witruimte is, en in dat het een
optionele lijst van afbakeningskarakters kan gebruiken. Afbakeningskarakters
worden behandeld als of ze afzonderlijke woorden zijn, zelfs als er geen
witruimte is gelaten tussen het karakter en het voorafgaande of volgende woord.
\fBdwdiff\fR is grotendeels commando-regel compatibel met \fBwdiff\fR. Slechts the
\-\-autopager, \-\-terminal en \-\-avoid\-wraps opties worden niet ondersteund.
.PP
De standaard uitvoer van \fBdwdiff\fR is de nieuwe tekst, met daarin
gemarkeerde verwijderde en ingevoegde stukken. Er zijn commando-regel opties
beschikbaar om de uitvoer te veranderen.
.SH OPTIES
\fBdwdiff\fR accepteert de volgende opties (In alle karaktersequenties worden
eerst de \\-escapecodes verwerkt. Alle standaard codes worden ondersteund,
evenals de \\u en \\U Unicode escapecodes):
.PP
.TP
\fB\-h\fR, \fB\-\-help\fR
Toon een kort help bericht.
.TP
\fB\-v\fR, \fB\-\-version\fR
Toon versie en auteursrecht informatie.
.TP
\fB\-d\fR \fIdelimiters\fR, \fB\-\-delimiters\fR=\fIdelimiters\fR
Specificeer de lijst van afbakeningskarakters. De standaard waarde is leeg.
.TP
\fB\-P\fR, \fB\-\-punctuation\fR
Gebruik alle leestekens als afbakeningskarakters. De set van leestekens is
locale-afhankelijk.
.TP
\fB\-W\fR \fIwhitespace\fR, \fB\-\-white\-space\fR=\fIwhitespace\fR
Specificeer de lijst van witruimte karakters. De standaard set van witruimte
is locale-afhankelijk.
.TP
\fB\-u\fR, \fB\-\-diff\-input\fR
Interpreteer de invoer als de uitvoer van \fBdiff\fR in het Unified Diff
formaat (meestal geproduceerd door \fBdiff \-u\fR). In dit geval is er maar één
invoerbestand toegestaan. Deze optie maakt het mogelijk om de diff uitvoer
te herformateren met \fBdwdiff\fR, en is bijvoorbeeld nuttig om de uitvoer van
\fBsvn diff\fR na te bewerken.
.TP
\fB\-1\fR, \fB\-\-no\-deleted\fR
Toon de woorden die verwijderd zijn uit het eerste bestand niet.
.TP
\fB\-2\fR, \fB\-\-no\-inserted\fR
Toon de woorden die ingevoegd zijn in het tweede bestand niet.
.TP
\fB\-3\fR, \fB\-\-no\-common\fR
Toon de woorden die in beide bestanden voorkomen niet.
.TP
\fB\-L\fR[\fIwidth\fR], \fB\-\-line\-numbers\fR[=\fIwidth\fR]
Toon regelnummers aan het begin van iedere regel. De getoonde regelnummers
zijn respectievelijk het regelnummer in het oude bestand en het regelnummer
in het nieuwe bestand. Het optionele \fIwidth\fR argument is het minimum
aantal posities per regelnummer.
.TP
\fB\-C\fR\fInum\fR, \fB\-\-context\fR=\fInum\fR
Toon \fInum\fR regels context voor en na veranderingen. Voegt een regel met
alleen \-\- toe tussen ieder blok veranderingen.
.TP
\fB\-s\fR, \fB\-\-statistics\fR
Toon statistieken bij het afsluiten van het programma. De getoonde getallen
zijn de aantallen woorden in beide bestanden, het aantal verwijderde woorden,
het aantal ingevoegde woorden, en het aantal veranderde woorden. Het aantal
veranderde woorden wordt geteld als het aantal woorden dat is verwijderd in het
eerste bestand, en als het aantal vervangende woorden uit het tweede bestand.
Al deze getallen worden ook uitgedrukt als een percentage van het totaal aantal
woorden van het bestand waaruit ze afkomstig waren.
.TP
\fB\-i\fR, \fB\-\-ignore\-case\fR
Negeer het verschil tussen hoofdletters en kleine letters bij het vergelijken
van woorden. Deze optie is alleen beschikbaar als het onderliggende \fBdiff\fR
programma deze optie biedt.
.TP
\fB\-I\fR, \fB\-\-ignore\-formatting\fR
Negeer verschillen in opmaak van karakters. Deze optie schakelt naar het
gebruik van de Unicode compatibiliteitsdecompositie van karakters in plaats
van de canonieke decompositie. De compatibiliteitsdecompositie gooit opmaak
informatie weg. Bijvoorbeeld, de ligatuur fi wordt vertaald naar twee losse
letters voor de vergelijking. Echter, ook super- en subscript worden ook als
gelijk gezien, evenals verschillende rotaties van hetzelfde karakter.
.TP
\fB\-c\fR[\fIspec\fR], \fB\-\-color\fR[=\fIspec\fR]
Kleurenmodus. De optionele specificatie \fIspec\fR kan gebruikt worden om
de gebruikte kleuren aan te passen. \fIspec\fR bestaat uit
[\fIverwijderd\fR],[\fItoegevoegd\fR]. Als een van beide ontbreekt wordt
zijn standaard kleur gebruikt (respectievelijk helder rood en helder groen).
Beide delen van \fIspec\fR bestaan uit [\fIvoorgrond\fR][:\fIachtergrond\fR]. Een lijst
met toelaatbare kleurnamen kan worden verkregen door het woord ``list'' te
gebruiken op de plaats van \fIspec\fR. Alternatief kan een willekeurige
escapecode om attributen te zetten worden gebruikt als kleur door er \fIe:\fR
voor te zetten.
.IP
De standaard markeringen voor het begin en het einde van verwijderde en
toegevoegde tekst worden onderdrukt, maar markeringen die op de commando-regel
zijn gespecificeerd zullen worden afgedrukt.
.TP
\fB\-l\fR, \fB\-\-less\-mode\fR
Als \-p, maar voer het doorhalen ook uit op verwijderde witruimte karakters.
.TP
\fB\-p\fR, \fB\-\-printer\fR
Gebruik doorhalen met een liggend streepje en dik gedrukte tekst om
veranderingen te benadrukken. Dit is geïmplementeerd door eerst een liggend
streepje of een duplicaat van het karakter af te drukken, gevolgd door een
backspace karakter, gevolgd door het karakter zelf. Op de meeste terminals
heeft dit geen effect. Het \fBless\fR(1) programma zal echter doorgehaalde en
dik gedrukte tekst laten zien.
.IP
De standaard markeringen voor het begin en het einde van verwijderde en
toegevoegde tekst worden onderdrukt, maar markeringen die op de commando-regel
zijn gespecificeerd zullen worden afgedrukt.
.TP
\fB\-m\fR[\fInum\fR], \fB\-\-match\-context\fR[=\fInum\fR]
Gebruik \fInum\fR woorden context voor en na ieder woord voor vergelijking.
Woorden in de oude tekst komen dan alleen overeen met woorden in de nieuwe
tekst als de woorden er omheen eveneens overeenkomen. Dit verbeterd de uitvoer
van \fBdwdiff\fR voor grote aanpassingen met veel voorkomende woorden. Echter,
het gebruik van context vergroot de benodigde schijfruimte en vergt meer
rekentijd. De standaard waarde voor deze optie is 1. Zet deze optie op 0 om het
gedrag van versies voor 1.5 te gebruiken.
.TP
\fB\-\-aggregate\-changes\fR
Laat nabije veranderingen versmelten tot één verandering, als context woorden
gebruikt worden (zie \fB\-\-match\-context\fR). Deze optie verminderd de
benodigde rekentijd door de veranderingen die het \fBdiff\fR programma
rapporteerd niet nader te verfijnen.
.TP
\fB\-A\fR \fIalgorithm\fR, \fB\-\-algorithm\fR=\fIalgorithm\fR
Kies het algoritme dat gebruikt wordt om de verschillen te bepalen. Er zijn
drie mogelijke waarden voor \fIalgorithm\fR: \fIbest\fR, welke een minimaal
aantal verschillen probeert te vinden, \fInormal\fR, welke enige optimaliteit
uitruilt voor snelheid, en \fIfast\fR, welke er van uit gaat dat er slechts
enkele wijzigingen zijn op een lange tekst. Standaard wordt het \fInormal\fR
algoritme gebruikt.
.TP
\fB\-S\fR[\fImarker\fR], \fB\-\-paragraph\-separator\fR[=\fImarker\fR]
Toon toegevoegde of verwijderde blokken van regels met alleen maar witruimte
karakters. Een speciale markering wordt aan de uitvoer toegevoegd om deze
blokken aan te geven. De standaard markering is \-\-.
.TP
\fB\-\-wdiff\-output\fR
Maak uitvoer die overeenkomt met die van het \fBwdiff\fR programma. \fBdwdiff\fR
maakt gebruik van een ander uitvoer algoritme, welke een meer intuïtieve
uitvoer produceert.
.TP
\fB\-w\fR \fIstring\fR, \fB\-\-start\-delete\fR=\fIstring\fR
Tekenreeks om het begin van verwijderde tekst te markeren. De standaard waarde
is [\-.
.TP
\fB\-x\fR \fIstring\fR, \fB\-\-stop\-delete\fR=\fIstring\fR
Tekenreeks om het einde van verwijderde tekst te markeren. De standaard waarde
is \-].
.TP
\fB\-y\fR \fIstring\fR, \fB\-\-start\-insert\fR=\fIstring\fR
Tekenreeks om het begin van toegevoegde tekst te markeren. De standaard waarde
is {+.
.TP
\fB\-z\fR \fIstring\fR, \fB\-\-stop\-insert\fR=\fIstring\fR
Tekenreeks om het einde van toegevoegde tekst te markeren. De standaard waarde
is +}.
.TP
\fB\-R\fR, \fB\-\-repeat\-markers\fR
Herhaal de begin en eind markeringen aan het begin en het eind van een regel
als de verandering over een regeleinde loopt.
.TP
\fB\-\-profile\fR=\fIname\fR
Laad het profiel met de naam \fIname\fR uit het \fB.dwdiffrc\fR bestand in de home
directory van de gebruiker. Alleen het laatst genoemde profiel wordt
daadwerkelijk gelezen, tenzij het gevolgd wordt door een \fB\-\-no\-profile\fR optie.
Standaard wordt het profiel genaamd \fIdefault\fR gelezen.
.TP
\fB\-\-no\-profile\fR
Schakel het lezen van profielen uit, tenzij gevolgd door nog een \fB\-\-profile\fR
optie. Dit verhindert ook het lezen van het \fIdefault\fR profiel.
.PP
Een enkel minteken (\-) als bestandsnaam kan worden gebruikt om aan te geven dat
de tekst van de standaard invoer moet worden gelezen. Slechts één bestand kan
van standaard invoer worden gelezen. Om te voorkomen dat \fBdwdiff\fR een
bestandsnaam die begint met een minteken interpreteert als een optie kan een
dubbel minteken (\-\-) opgegeven worden, waarna \fBdwdiff\fR alle volgende argumenten
als bestandsnamen zal interpreteren.
.PP
De stopstatus van \fBdwdiff\fR geeft het resultaat van de vergelijking aan: 0 als de
bestanden gelijk zijn, 1 als er verschillen zijn. In geval er een fout optreedt,
zal \fBdwdiff\fR stoppen met status 2.
.SH PROFIELEN
Sinds versie 2.1.0 biedt \fBdwdiff\fR de gebruiker de mogelijkheid profielen te
creëren. Een profiel is een set opties die geladen kan worden middels de
\fB\-\-profile\fR optie. Profielen worden vastgelegd in het \fB.dwdiffrc\fR bestand in de
home directory van de gebruiker. De inhoud van het \fB.dwdiffrc\fR bestand dient er
als volgt uit te zien:
.PP
Een regel bevat ofwel een profiel kop (tekst tussen []), of een lange optie naam
zonder de voorloop streepjes, optioneel gevolgd door het bijbehorende argument.
Het argument wordt van witruimtekarakters ontdaan. Als het argument
corresponderende dubbele of enkele aanhalingstekens bevat, dan worden deze ook
verwijderd. Commentaar kan toegevoegd worden door een regel met een hekje (#) te
beginnen.
.PP
Als er geen profiel naam is gespecificeerd, dan wordt het profiel met de naam
\fIdefault\fR geladen, tenzij de optie \fB\-\-no\-profile\fR gespecificeerd is. Hier is
een voorbeeld \fB.dwdiffrc\fR:
.PP
.po 5
[default]
.br
color red,blue
.br
punctuation
.PP
[html]
.br
start-delete
.br
stop-delete
.br
start-insert
.br
stop-insert
.PP
[space-only]
.br
# Use only a space as whitespace.
.br
white-space " "
.br
.po
.SH BUGS
Als u denkt een bug gevonden te hebben, controleer dan dat u de nieuwste versie
van \fBdwdiff\fR gebruikt. Als u een bug wil
rapporteren, voeg dan een minimaal voorbeeld dat het probleem demonstreert toe
aan uw melding.
.SH AUTEUR
G.P. Halkes
.SH COPYRIGHT
Copyright \(co 2006\-2011 G.P. Halkes and others
.br
\fBdwdiff\fR is gelicenseerd onder de GNU General Public License version 3.
.br
Voor meer informatie over de licentie, zie het bestand COPYING in de
documentatie map. Op Un*x systemen is dit meestal
/usr/share/doc/dwdiff-$VERSION$.
.SH ZIE\ OOK
\fBdwfilter\fR(1), \fBwdiff\fR(1), \fBdiff\fR(1)