1 files changed, 41 insertions, 28 deletions

diff --git a/readme.md b/readme.md
index 2b080cf..9de8941 100644
--- a/readme.md
+++ b/readme.md
@@ -41,12 +41,13 @@ for ( size_t nf; (nf = csv_read(&csv, in)) != 0; ) {  /* eine Zeile aus `in` les
 ~~~
 
 Es sind nur zwei Funktionen notwendig, um die Daten des FILE-Streams `in` vollständig zu verarbeiten:
-`csv_read()` liest eine Zeile aus dem Parameter `in` und liefert die Anzahl der erfolgreich geparsten Felder oder **0** bei Dateiende.
-`csv_field()` liefert einen (read only) `const char`-Zeiger für das i-te Feld.
+`csv_read()` liest eine Zeile aus dem Stream `in` und liefert die Anzahl der erfolgreich analysierten Felder oder **0** bei Dateiende.
+`csv_field()` liefert einen (read only) `const char`-Zeiger für das *i*te Feld.
 
 Der Speicher für das CSV-Objekt wird automatisch von `csv_read()` beim ersten Aufruf alloziert und wieder freigeben nachdem der Stream `in` vollständig gelesen wurde.
 
-Mehr Arbeit ist nur noch dann notwendig, wenn eine Fehlerbehandlung zum Projekt hinzugefügt wird. Für die meisten einfachen Fälle reichen diese Schritte wahrscheinlich schon aus.
+Mehr Arbeit ist nur noch dann notwendig, wenn eine Fehlerbehandlung zum Projekt hinzugefügt wird.
+Für die meisten einfachen Fälle reichen diese Schritte wahrscheinlich schon aus.
 
 ## Motivation
 
@@ -58,7 +59,7 @@ Die meisten anderen CSV-Bibliotheken passen nicht:
 - fehlerhafte Verarbeitung von "problematischen" CSV-Dateien (Zeilenumbrüche innerhalb einer Zelle)
 - unvorteilhafte Lizenz (GPL)
 - umständliche API (Callbacks zum Verarbeiten der Inhalte, seltsames Handling am Dateiende)
-- globale Variablen, die den Einsatz in Multi-Threadumgebungen unmöglich machen
+- globale Variablen, die den Einsatz in Multithread-Umgebungen unmöglich machen
 - C++ wenn ich C brauche
 - Java/Python/Rust/Ruby/${YourLanguageHere} wenn ich C brauche
 - Langsam, Aufgebläht
@@ -105,7 +106,9 @@ csv_cleanup(&csv);
 
 Dieser Code erzeugt ein neues `csv_t`-Objekt im Speicher welches anschließend durch `csv_init()` mit Standardwerten initialisiert wird.
 
-Dann wird der Datenstrom `in` zeilenweise in den Speicher eingelesen und innerhalb der Schleife verarbeitet. Die Anzahl der Felder pro Zeile wird mit Hilfe der Funktion `csv_nfields()` ermittelt. Alternativ liefert auch der Returnwert von `csv_read()` die Feldanzahl:
+Dann wird der Datenstrom `in` zeilenweise in den Speicher eingelesen und innerhalb der Schleife verarbeitet.
+Die Anzahl der Felder pro Zeile wird mit Hilfe der Funktion `csv_nfields()` ermittelt.
+Alternativ liefert auch der Rückgabewert von `csv_read()` die Feldanzahl:
 
 ~~~c
 // ...
@@ -120,13 +123,16 @@ while ( (nf = csv_read(&csv, in)) != 0 ) {
 Der Rückgabewert **0** bei einem Aufruf von `csv_read()` kennzeichnet das Ende des Datenstroms.
 
 > **Hinweis:**  
-> Das Ende einer CSV-Datei mit 0-gelesenen Feldern zu kennzeichnen ist vollkommen legitim. Eine "leere" Zeile innerhalb der Datei würde nämlich als genau ein (leeres) Feld interpretiert, so dass der Rückgabewert hier **1** wäre. Anders gesagt: Es gibt in CSV-Dateien keine Zeilen mit 0 Feldern.
+> Das Ende einer CSV-Datei mit 0-gelesenen Feldern zu kennzeichnen ist vollkommen legitim.
+> Eine "leere" Zeile innerhalb der Datei würde nämlich als genau ein (leeres) Feld interpretiert, so dass der Rückgabewert hier **1** wäre.
+> Anders gesagt: Es gibt in CSV-Dateien keine Zeilen mit 0 Feldern.
 
 Der Aufruf von `csv_cleanup()` ist nicht zwingend notwendig, da alle belegten Ressourcen beim letzten `csv_read()` automatisch freigegeben werden, wenn es keinen Fehler bei der Dateiverarbeitung gab.
 
 **2\. Optionen einstellen**
 
-Wenn nichts weiter angegeben ist, gehen wir von einem Komma (`,`) als Feldtrenner sowie doppelten Anführungszeichen (`"`) als Feldbegrenzer aus. Die meisten CSV-Dateien im deutschsprachigen Raum verwenden jedoch ein Semikolon (`;`) zum Trennen der einzelnen Felder.
+Wenn nichts weiter angegeben ist, gehen wir von einem Komma (`,`) als Feldtrenner sowie doppelten Anführungszeichen (`"`) als Feldbegrenzer aus.
+Die meisten CSV-Dateien im deutschsprachigen Raum verwenden jedoch ein Semikolon (`;`) zum Trennen der einzelnen Felder.
 
 Wir berücksichtigen dies bei der Initialisierung eines `csv_options_t`-Objektes.
 
@@ -139,21 +145,24 @@ csv_t csv;
 csv_init_opt(&csv, &csv_options);
 ~~~
 
-Damit wir nicht alle Felder in `csv_options` ändern müssen, initialisieren wir dieses zunächst mit `csv_default_options` und passen dann `field_delimiter` und `field_separator` für unsere Bedürfnisse an. Das `csv`-Objekt wird nun mit der Funktion `csv_init_opt()` initialisiert, die einen zusätzlichen Zeiger auf ein `csv_options_t`-Objekt erwartet. 
+Damit wir nicht alle Felder in `csv_options` ändern müssen, initialisieren wir dieses zunächst mit den Standardwerten aus `csv_default_options` und passen dann `field_delimiter` und `field_separator` für unsere Bedürfnisse an.
+Das `csv`-Objekt wird nun mit der Funktion `csv_init_opt()` initialisiert, die einen zusätzlichen Zeiger auf ein `csv_options_t`-Objekt erwartet.
 
 > **Hinweis:**  
 > `csv_init(&csv);` ist letztlich nur eine kürzere Schreibweise für `csv_init_opt(&csv, &csv_default_options);`.
 
 > **Hinweis:**  
-> Die Standardwerte für Feldtrenner und Feldbegrenzer lassen sich als Übersetzungsoptionen beim Compilieren über die Makros `CSV_DEFAULT_SEPARATOR` und `CSV_DEFAULT_DELIMITER` setzen. 
+> Die Standardwerte für Feldtrenner und Feldbegrenzer lassen sich als Übersetzungsoptionen beim Compilieren über die Makros `CSV_DEFAULT_SEPARATOR` und `CSV_DEFAULT_DELIMITER` setzen.
 
 Der Rest der Schleife bleibt gleich.
 
 **3\. Fehlerbehandlung hinzufügen**
 
-Bei der Verarbeitung können verschiedene Fehler auftreten, die ein robustes Programm selbstverständlich behandelt. Leider stellt die Programmiersprache C keinen Exception-Mechanismus zur Verfügung, so dass sich der Programmierer an dieser Stelle anders behelfen muss.
+Bei der Verarbeitung können verschiedene Fehler auftreten, die ein robustes Programm selbstverständlich behandelt.
+Leider stellt die Programmiersprache C keinen Exception-Mechanismus zur Verfügung, so dass sich der Programmierer an dieser Stelle anders behelfen muss.
 
-Die beste Variante, die dem klassischen Exceptions am nächsten kommt, sind die beiden C-Funktionen `setjmp()` und `longjmp()`, mit deren Hilfe wir nun die Fehlerbehandlung umsetzen. Wir benötigen dafür die beiden Felder `cb_error` und `cb_error_arg` des `csv_options`-Objektes:
+Die beste Variante, die den klassischen Exceptions am nächsten kommt, sind die beiden C-Funktionen `setjmp()` und `longjmp()`, mit deren Hilfe wir nun die Fehlerbehandlung umsetzen.
+Wir benötigen dafür die beiden Felder `cb_error` und `cb_error_arg` des `csv_options`-Objektes:
 
 ~~~c
 jmp_buf env;
@@ -161,18 +170,20 @@ csv_options.cb_error     = csvErrorHandler;
 csv_options.cb_error_arg = &env;
 ~~~
 
-`cb_error` ist ein Zeiger auf eine Callback-Funktion, die im Falle eines Fehlers aus der CSV-Bibliothek heraus aufgerufen wird. Ihr werden ein Fehlerwert vom Typ `csv_err_t` sowie ein Zeiger auf benutzerdefinierte Daten -- in unserem Fall ein Zeiger auf eine `jmp_buf`-Variable -- mit übergeben:
+`cb_error` ist ein Zeiger auf eine Callback-Funktion, die im Falle eines Fehlers aus der CSV-Bibliothek heraus aufgerufen wird.
+Ihr werden ein Fehlerwert vom Typ `csv_err_t` sowie ein Zeiger auf benutzerdefinierte Daten -- in unserem Fall ein Zeiger auf eine `jmp_buf`-Variable -- mit übergeben:
 
 ~~~c
 static void
-csvErrorHandler(csv_err_t err, void *cb_arg)
+csvErrorHandler(csv_err_t err, void *cb_error_arg)
 {
         fprintf(stderr, "error while csv-processing: %s\n", csv_err_str(err));
-        longjmp(*((jmp_buf *) cb_arg), err);
+        longjmp(*((jmp_buf *) cb_error_arg), err);
 }
 ~~~
 
-Mit Hilfe des Parameter `err` wird eine einfache Fehlermeldung protokolliert. Anschließend rufen wir `longjmp()` auf, damit die Fehlerbehandlung auf höherer Ebene fortgesetzt wird.
+Mit Hilfe des Parameter `err` wird eine einfache Fehlermeldung protokolliert.
+Anschließend rufen wir `longjmp()` auf, damit die Fehlerbehandlung auf höherer Ebene fortgesetzt wird.
 
 Die Hauptschleife in unserer Funktion sieht nun so aus:
 
@@ -216,7 +227,7 @@ case CSV_ERR_IO_READ:
 
 ### Typen
 
-**Fehlercodes** für die Callbackhandler:
+**Fehlercodes** für die Callback-Handler:
 
 ~~~c
 typedef enum {
@@ -247,7 +258,7 @@ typedef struct {
 extern const csv_options_t csv_default_options;
 ~~~
 
-**Contextobjekt** zur Aufnahme der aktuell gelesenen Zeile:
+**Context Objekt** zur Aufnahme der aktuell gelesenen Zeile:
 
 ~~~c
 typedef struct {
@@ -284,9 +295,10 @@ void csv_cleanup(csv_t *csv);
 Gibt den belegten Speicher eines `csv_t`-Objektes wieder frei.
 
 Parameter
-: **`csv`** ein Zeiger initialisiertes `csv_t`-Objekt.
+: **`csv`** ein Zeiger auf ein initialisiertes `csv_t`-Objekt.
 
-`csv_cleanup()` gibt den verwendeten Speicher des csv-Objektes wieder frei. Ein direkter Aufruf dieser Funktion ist nur im Fehlerfall notwendig weil dann die automatische Speicherfreigabe der Bibliothek nicht greift.
+`csv_cleanup()` gibt den verwendeten Speicher des csv-Objektes wieder frei.
+Ein direkter Aufruf dieser Funktion ist nur im Fehlerfall notwendig weil dann die automatische Speicherfreigabe der Bibliothek nicht greift.
 
 **Zeilenweises Lesen**
 
@@ -297,7 +309,7 @@ size_t csv_read(csv_t *csv, FILE *in);
 Liest einen Datensatz aus dem FILE-Stream, speichert das Ergebnis in `csv` und liefert die Anzahl der gefundenen Felder zurück.
 
 Parameter
-: **`csv`** ein Zeiger initialisiertes `csv_t`-Objekt.
+: **`csv`** ein Zeiger auf ein initialisiertes `csv_t`-Objekt.
 : **`in`** ein Zeiger auf einen geöffneten C-FILE-Stream.
 
 Rückgabe
@@ -313,7 +325,7 @@ const char *csv_field(const csv_t *const csv, size_t idx);
 Die beiden Funktionen ermöglichen einen Zugriff auf die einzelnen Felder des zuletzt gelesenen Datensatzes.
 
 Parameter
-: **`csv`** ein Zeiger initialisiertes `csv_t`-Objekt.
+: **`csv`** ein Zeiger auf ein initialisiertes `csv_t`-Objekt.
 : **`idx`** Index des zu lesenden Feldes. (0 <= idx < `csv_nfields(&csv)`)
 
 Rückgabe
@@ -342,11 +354,10 @@ Die CSV-Bibliothek kann an verschiedene Bedürfnisse angepasst werden.
 
 Beim Compilieren der Datei `csv.c` können die Standardwerte für Feldbegrenzer und Feldtrenner als Makrodefinitionen `CSV_DEFAULT_DELIMITER` und `CSV_DEFAULT_SEPARATOR` voreingestellt werden.
 
-Option                     Beschreibung   Standardwert
--------------------------- -------------- ---------------------------------
-`CSV_DEFAULT_DELIMITER`    Feldbegrenzer  `"`
-`CSV_DEFAULT_SEPARATOR`    Feldtrenner    `,`
--------------------------- -------------- ---------------------------------
+| Option                     | Beschreibung   | Standardwert |
+| -------------------------- | -------------- | -------------|
+| `CSV_DEFAULT_DELIMITER`    | Feldbegrenzer  | `"`          |
+| `CSV_DEFAULT_SEPARATOR`    | Feldtrenner    | `,`          |
 Table: Makros
 
 Soll beispielsweise das in Deutschland viel häufiger vorkommende Semikolon (`;`) statt einem Komma (`,`) standardmäßig als Trennsymbol zwischen den Feldern einer CSV-Datei benutzt werden sieht der Aufruf zum Compilieren so aus:
@@ -365,9 +376,11 @@ TODO!
 
 ## Lizenz
 
-In den letzten Jahrzehnten habe ich massiv vom Internet und seinen Inhalten profitiert. Ein gutes Stück meiner Kenntnisse und Fähigkeiten verdanke ich den vielen Foren, Webseiten, Newsgroups und Individuen die Informationen und Software kostenfrei und allgemein zugänglich bereitstellen.
+In den letzten Jahrzehnten habe ich massiv vom Internet und seinen Inhalten profitiert.
+Ein gutes Stück meiner Kenntnisse und Fähigkeiten verdanke ich den vielen Foren, Webseiten, Newsgroups und Individuen die Informationen und Software kostenfrei und allgemein zugänglich bereitstellen.
 
-Aus diesem Grund stelle ich meine Software (sofern nicht anders angegeben) unter der freizügigen [Do What the Fuck You Want to Public License](http://www.wtfpl.net) zur Verfügung. Vielleicht findet jemand den Code nützlich oder kann Erkenntnisse daraus gewinnen.
+Aus diesem Grund stelle ich meine Software (sofern nicht anders angegeben) unter der freizügigen [Do What the Fuck You Want to Public License](http://www.wtfpl.net) zur Verfügung.
+Vielleicht findet jemand den Code nützlich oder kann Erkenntnisse daraus gewinnen.
 
 ~~~
 Copyright © 2020 Thomas Schmucker