Skip to content

Commit

Permalink
Update the German user manual.
Browse files Browse the repository at this point in the history
  • Loading branch information
@j6t
j6t committed Nov 15, 2017
1 parent e796660 commit 989c100
Show file tree
Hide file tree
Showing 15 changed files with 186 additions and 196 deletions.
41 changes: 19 additions & 22 deletions kdbg/doc/de/argspwdenv.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,36 +2,38 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="GENERATOR" content="Mozilla/4.74 [en] (X11; U; Linux 2.2.16-SMP i686) [Netscape]">
<meta name="Author" content="Johannes Sixt">
<title>KDbg - Benutzerhandbuch - Argumente, Arbeitsverzeichnis, Umgebungsvariablen</title>
</head>
<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000">
<a href="index.html">Inhalt</a>
<body text="#000000" bgcolor="#FFFFFF">
<p><a href="index.html">Inhalt</a></p>
<h3>
<a NAME="Environment"></a>Programmargumente, Arbeitsverzeichnis, Umgebungsvariablen
Programmargumente, Arbeitsverzeichnis, Umgebungsvariablen
setzen</h3>
Mit <i>Ausführen|Argumente</i> öffnen Sie einen Dialog, in dem
<p>Mit <i>Ausführen|Argumente</i> öffnen Sie einen Dialog, in dem
Sie Programmargumente, das Arbeitsverzeichnis sowie Umgebungsvariablen
setzen können.
setzen können.</p>
<h3>
Programmargumente</h3>
In der obersten Eingabezeile können Sie die Programmargumente eingeben,
die an das Programm übergeben werden sollen. Diese werden beim nächsten
Programmstart verwendet.
Register Argumente</h3>
<p>In dem Eingabefeld können Sie die Programmargumente eingeben,
die an das Programm übergeben werden sollen.
Mittels <i>Dateinamen einfügen</i> können Sie nach einer Datei suchen und an
der aktuellen Position <i>einfügen</i>. Analog können Sie mit
<i>Verzeichnis einfügen</i> nach einem Verzeichnis suchen.</p>
<p>Diese geänderten Argumente werden beim nächsten Programmstart verwendet.</p>
<h3>
Arbeitsverzeichnis</h3>
Im Eingabefeld darunter können Sie das Arbeitsverzeichnis angeben.
<a name="WorkingDir"></a>Register Arbeitsverzeichnis</h3>
<p>Im dem Eingabefeld können Sie das Arbeitsverzeichnis angeben.
Dieses wird sofort an gdb übergeben, sobald Sie <i>OK</i> drücken.
Das Programm verwendet das neue Arbeitsverzeichnis allerdings erst beim
nächsten Start.
nächsten Start.</p>
<p>Das Arbeitsverzeichnis gilt auch für gdb selbst! Das angegebene
Arbeitsverzeichnis wird sofort an gdb weitergegeben, d.h. gdb wird die
neue Einstellung verwenden, sobald Sie <i>OK</i> drücken. Das kann
einen Einfluss darauf haben, ob gdb Quellcodedateien findet.
einen Einfluss darauf haben, ob gdb Quellcodedateien findet.</p>
<h3>
Umgebungsvariablen</h3>
Im Bereich für Umgebungsvariablen können Sie einen Ausdruck in
<a name="Environment"></a>Register Umgebungsvariablen</h3>
<p>Im Register Umgebungsvariablen können Sie einen Ausdruck in
der Form
<tt>VARIABLE=Wert</tt> eingeben und dann <i>Ändern</i> klicken,
um der Umgebungsvariablen <tt>VARIABLE</tt> einen <tt>Wert</tt> zuzuweisen.
Expand All @@ -40,11 +42,6 @@ <h3>
geben Sie einfach den neuen Wert ein und klicken <i>Ändern</i>. Wenn
Sie den Namen der Variable ändern und <i>Ändern</i> clicken,
erzeugen Sie eine neue Variable! Die neuen Umgebungsvariablen werden erst
beim nächsten Programmstart verwendet.
<p>Wenn Sie glibc2 unter Linux verwenden, ist es sehr wichtig, dass Sie
der Umgebungsvariablen <tt>LD_BIND_NOW</tt> den Wert <tt>1</tt> zuweisen.
Wenn diese Variable nicht gesetzt ist, können solche Funktionen nicht
betreten werden, die von der Bibliothek <tt>libc</tt> und anderen Shared
Libraries importiert werden.
beim nächsten Programmstart verwendet.</p>
</body>
</html>
35 changes: 17 additions & 18 deletions kdbg/doc/de/breakptlist.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,17 +2,16 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="GENERATOR" content="Mozilla/4.74 [en] (X11; U; Linux 2.2.16-SMP i686) [Netscape]">
<meta name="Author" content="Johannes Sixt">
<title>KDbg - Benutzerhandbuch - Haltepunkte</title>
</head>
<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000">
<a href="index.html">Inhalt</a>
<body text="#000000" bgcolor="#FFFFFF">
<p><a href="index.html">Inhalt</a></p>
<h1>
Die Liste der Haltepunkte</h1>
Die Liste der Haltepunkte zeigt alle gesetzten Haltepunkte und Watchpoints
<p>Die Liste der Haltepunkte zeigt alle gesetzten Haltepunkte und Watchpoints
und ermöglicht, diese zu manipulieren. Die Liste der Haltepunkte können
Sie mit dem Menüpunkt <i>Ansicht|Haltepunkte</i> anzeigen.
Sie mit dem Menüpunkt <i>Ansicht|Haltepunkte</i> anzeigen.</p>
<h2>
Die Übersicht</h2>
Für jeden Haltepunkt wird folgendes angezeigt:
Expand All @@ -29,54 +28,54 @@ <h2>
<li>
die Haltebedingung (falls gesetzt).</li>
</ul>
Das Piktogramm links zeigt an, ob der Haltepunkt aktiviert (tiefroter Punkt)
<p>Das Piktogramm links zeigt an, ob der Haltepunkt aktiviert (tiefroter Punkt)
oder deaktiviert (hellroter Punkt) ist, ob es sich um einen temporären
Haltepunkt handelt (eine winzige Uhr ist sichtbar) und ob der Haltepunkt
bedingt ist (ein Fragezeichen ist sichtbar).
<p>Watchpoints werden durch ein Brillensymbol gekennzeichnet.
bedingt ist (ein Fragezeichen ist sichtbar).</p>
<p>Watchpoints werden durch ein Brillensymbol gekennzeichnet.</p>
<h2>
Haltepunkte manipulieren</h2>
<a NAME="StopProg"></a>Beachten Sie bitte, dass Haltepunkte und Watchpoints
<p><a NAME="StopProg"></a>Beachten Sie bitte, dass Haltepunkte und Watchpoints
nicht manipuliert werden können solange das zu debuggende Programm
läuft. Wenn das Programm bereits gestartet wurde, muss es zuerst angehalten
werden - entweder indem es auf einen bereits gesetzten Haltepunkt trifft
oder "gewaltsam" indem Sie <i>Ausführung|Unterbrechen</i> wählen.
Dadurch wird das Programm nicht beendet, sondern nur unterbrochen. Sie
können die Haltepunkte jetzt verändern. Wählen Sie danach
<i>Ausführung|Ausführen</i>,
um das Programm fortzusetzen.
um das Programm fortzusetzen.</p>
<p>Am einfachsten kann ein Haltepunkt im <a href="sourcecode.html">Quellcode-Fenster</a>
gesetzt werden. Wenn Sie den genauen Dateinamen und die Zeilennummer einer
Funktion nicht kennen, können Sie den Funktionsnamen im Feld über
der Liste eingeben und <i>Haltepunkt</i> wählen.
der Liste eingeben und <i>Haltepunkt</i> wählen.</p>
<p>Sie können eine Haltepunkt in der Liste auswählen seine Zustand
mittels <i>Deaktivieren</i> oder <i>Aktivieren</i> ändern. Oder Sie
klicken auf den Haltepunkt mit der mittleren Maustaste - genau so, wie
Sie im Quellcode-Fenster Haltepunkte aktivieren und deaktivieren.
Sie im Quellcode-Fenster Haltepunkte aktivieren und deaktivieren.</p>
<p>Sie können eine Bedingung setzen (sodass das Programm nur stehen
bleibt, wenn die Bedingung erfüllt ist) oder die Anzahl der zu ignorierenden
Stopps setzen (sodass das Programm die nächsten n Male nicht stehen
bleibt, die es über diesen Haltepunkt läuft). Dazu wählen
sie den Schalter <i>Bedingt</i> und geben die Anzahl der zu ignorierenden
Treffer und/oder die Bedingung ein.
Treffer und/oder die Bedingung ein.</p>
<h2>
Watchpoints manipulieren</h2>
Watchpoints sind den Haltepunkten ähnlich, nur dass das Programm angehalten
<p>Watchpoints sind den Haltepunkten ähnlich, nur dass das Programm angehalten
wird, sobald sich der Inhalt einer Speicherstelle ändert. Ebenso wie
Haltepunkte können Watchpoints nicht manipuliert werden, solange das
Programm läuft. Weitere Hinweise dazu <a href="#StopProg">siehe oben</a>.
Programm läuft. Weitere Hinweise dazu <a href="#StopProg">siehe oben</a>.</p>
<p>Einen Watchpoint können Sie setzen, indem Sie einen Ausdruck im
Feld über der Liste eingeben und <i>Watchpoint</i> klicken. Das Programm
wird dann angehalten, sobald sich der Wert des Ausdrucks ändert. Beachten
Sie, dass Sie Watchpoints, die eine lokale Variable benötigen, nur
setzen können, wenn das Programm von einem Haltepunkt (oder mittels
Ausführung|Unterbrechen) angehalten wurde.
Ausführung|Unterbrechen) angehalten wurde.</p>
<p>Zum Entfernen eines Watchpoints wählen Sie diesen in der Liste
aus und klicken <i>Entfernen</i>. Falls der Ausdruck eine lokale Variable
enthält, wird der Watchpoint automatisch entfernt, sobald das Programm
die aktive Funktion verlässt.
die aktive Funktion verlässt.</p>
<p>Wie mit Haltepunkten können Sie eine Bedingung oder eine Anzahl
zu ignorierender Stopps setzen, indem Sie den Watchpoint auswählen
und <i>Bedingt</i> klicken.
und <i>Bedingt</i> klicken.</p>
</body>
</html>
19 changes: 12 additions & 7 deletions kdbg/doc/de/globaloptions.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,15 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="GENERATOR" content="Mozilla/4.74 [en] (X11; U; Linux 2.2.16-SMP i686) [Netscape]">
<meta name="Author" content="Johannes Sixt">
<title>KDbg - Benutzerhandbuch - Globale Einstellungen</title>
</head>
<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000">
<a href="index.html">Inhalt</a>
<body text="#000000" bgcolor="#FFFFFF">
<p><a href="index.html">Inhalt</a></p>
<h1>
Globale Einstellungen</h1>
Mit dem Menüpunkt <i>Datei|Globale Einstellungen</i> können Sie
folgende Optionen einstellen:
<p>Mit dem Menüpunkt <i>Datei|Globale Einstellungen</i> können Sie
folgende Optionen einstellen:</p>
<ul>
<li>
den Befehl, mit dem gdb aufgerufen wird;</li>
Expand Down Expand Up @@ -57,8 +56,7 @@ <h4>

<blockquote>Sie können angeben, ob das KDbg-Fenster in den Vordergrund
gebracht werden soll, sobald das kontrollierte Programm anhält (bei
einem Breakpoint oder wegen eines Signals). Das Fenster wird allerdings
nicht aktiviert (zumindest nicht unter KWM, dem Window Manger von KDE).
einem Breakpoint oder wegen eines Signals).
Manche Benutzer werden dieses Verhalten als störend empfinden, weshalb
diese Option standardmässig ausgeschaltet ist.</blockquote>

Expand All @@ -68,5 +66,12 @@ <h4>
angegeben werden kann. Dadurch wird verhindert, dass das Fenster ständig
nach hinten und vorne blinkt, sobald Sie einen Einzelschritt-Befehl absetzen.</blockquote>

<h4>
Dateifilter</h4>

<blockquote>Sie können Dateifiltermuster für Quellcode-Datein und
Header-Dateien angeben. Diese werden beim Aufruf von <i>Datei|Quellcode
öffnen</i> verwendet.</blockquote>

</body>
</html>
45 changes: 22 additions & 23 deletions kdbg/doc/de/howdoi.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,17 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="GENERATOR" content="Mozilla/4.74 [en] (X11; U; Linux 2.2.16-SMP i686) [Netscape]">
<meta name="Author" content="Johannes Sixt">
<title>KDbg - Benutzerhandbuch - Wie kann ich...?</title>
</head>
<body text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#51188E" alink="#FF0000">
<a href="index.html">Inhalt</a>
<body text="#000000" bgcolor="#FFFFFF">
<p><a href="index.html">Inhalt</a></p>
<h1>
Wie kann ich...?</h1>

<h4>
... eine Haltepunkt setzen?</h4>
Dafür gibt's mehrere Möglichkeiten:
<p>Dafür gibt's mehrere Möglichkeiten:</p>
<ul>
<li>
Sie können im <a href="sourcecode.html">Quellcode-Fenster</a> in den
Expand All @@ -27,57 +26,57 @@ <h4>
Sie können einen Haltepunkt in der <a href="breakptlist.html">Liste
der Haltepunkte</a> setzen.</li>
</ul>
Wenn Sie keinen Haltepunkt setzen können, könnte es sein, dass
<p>Wenn Sie keinen Haltepunkt setzen können, könnte es sein, dass
das Programm gerade läuft. Sie können keine Haltepunkte setzen,
solange das Programm läuft. Halten Sie es zuerst mit <i>Ausführung|Unterbrechen</i>
an. Falls Sie dann noch immer keine Haltepunkte setzen können, versichern
Sie sich, dass Sie das Programm mit Debug-Information übersetzt <i>und
gebunden</i> haben.
gebunden</i> haben.</p>
<h4>
... den Wert einer globalen Variablen oder eines beliebigen Ausdrucks anzeigen?</h4>
Benutzen Sie das <a href="watches.html">Ausdrücke-Fenster</a>.
<p>Benutzen Sie das Fenster <a href="watches.html">Beobachtete Ausdrücke</a>.</p>
<h4>
... Watchpoints setzen?</h4>
Watchpoints können über die <a href="breakptlist.html">Liste
der Haltepunkte</a> bearbeitet werden.
<p>Watchpoints können über die <a href="breakptlist.html">Liste
der Haltepunkte</a> bearbeitet werden.</p>
<h4>
... einen Core-Dump benutzen?</h4>
Laden Sie zuerst das Programm mittels <i>Datei|Programm</i>, dann geben
Sie den Core-Dump mittels <i>Datei|Core dump</i> an.
<p>Laden Sie zuerst das Programm mittels <i>Datei|Programm laden</i>, dann geben
Sie den Core-Dump mittels <i>Datei|Core-Dump</i> an.</p>
<h4>
... ein Programm debuggen, das sich in eine Endlosschleife verlaufen hat?</h4>
Starten Sie das Programm und lassen Sie es laufen, bis es in die Endlosschleife
<p>Starten Sie das Programm und lassen Sie es laufen, bis es in die Endlosschleife
gelangt. Dann schalten Sie um zu KDbg und wählen <i>Ausführung|Unterbrechen</i>.
Hiermit haben Sie das Programm <i>in flagranti</i> erwischt!
Hiermit haben Sie das Programm <i>in flagranti</i> erwischt!</p>
<h4>
... erreichen, dass das Programm einigemale über einen Haltepunkt
drüberläuft, ohne anzuhalten?</h4>
In der <a href="breakptlist.html">Liste der Haltepunkte</a> wählen
<p>In der <a href="breakptlist.html">Liste der Haltepunkte</a> wählen
Sie den Haltepunkt; dann klicken Sie <i>Bedingt</i> und geben die Anzahl
in <i>Ignoriere nächste Treffer</i> an.
in <i>Ignoriere nächste Treffer</i> an.</p>
<h4>
... eine Umgebungsvariable für das Programm setzen?</h4>
Wählen Sie <i>Ausführung|Argumente</i> und geben die Umgebungsvariable
im <a href="argspwdenv.html#Environment">Argumente-Dialog</a> an.
<p>Wählen Sie <i>Ausführung|Argumente</i> und geben die Umgebungsvariable
im <a href="argspwdenv.html#Environment">Argumente-Dialog</a> an.</p>
<h4>
... ein Arbeitsverzeichnis für das Programm wählen?</h4>
Wählen Sie <i>Ausführung|Argumente</i> und geben das Arbeitsverzeichnis
im <a href="argspwdenv.html#Environment">Argumente-Dialog</a> an.
<p>Wählen Sie <i>Ausführung|Argumente</i> und geben das Arbeitsverzeichnis
im <a href="argspwdenv.html#Environment">Argumente-Dialog</a> an.</p>
<h4>
... das Terminal-Fenster los werden?</h4>
Wählen Sie <i>Datei|Einstellungen</i> und schalten auf das Register
<p>Wählen Sie <i>Einstellungen|Dieses Programm</i> und schalten auf das Register
<a href="pgmsettings.html#output">Ausgabe</a>
um. Wählen Sie <i>Nur Ausgabe, einfache Terminalemulation</i> und
klicken Sie <i>OK</i>. Nun müssen Sie das Programm neu laden (am einfachsten
wählen Sie es aus der Liste unter <i>Datei|Zuletzt geöffnete
Programme</i>). Die Programmausgaben werden nun in das eingebaute <a href="pgmoutput.html">Ausgabefenster</a>
geschrieben und stdin ist auf <tt>/dev/null</tt> umgeleitet.
geschrieben und stdin ist auf <tt>/dev/null</tt> umgeleitet.</p>
<p>Sie müssen diese Einstellungen für jedes neue Programm wiederholen,
das Sie debuggen.
das Sie debuggen.</p>
<p><b><i>Wichtig:</i></b> Sie sollten dies nicht tun, falls Ihr Programm
Eingaben vom Terminal (normalerweise stdin) erwartet oder falls mehr als
nur einfache Terminalemultionen benötigt werden (mehr als nur Wagenrücklauf
und Zeilenvorschub). Das eingebaute Ausgabefenster unterstützt keine
Eingaben oder Terminalemulationen.
Eingaben oder Terminalemulationen.</p>
</body>
</html>
Loading

0 comments on commit 989c100

Please sign in to comment.