|
18 | 18 | /** |
19 | 19 | * Apache Commons CSV Format Support. |
20 | 20 | * |
21 | | - * <p>CSV are widely used as interfaces to legacy systems or manual data-imports. |
| 21 | + * <p>CSV are widely used as interfaces to legacy systems or manual data imports. |
22 | 22 | * CSV stands for "Comma Separated Values" (or sometimes "Character Separated |
23 | 23 | * Values"). The CSV data format is defined in |
24 | 24 | * <a href="http://tools.ietf.org/html/rfc4180" target="_blank">RFC 4180</a> |
25 | 25 | * but many dialects exist.</p> |
26 | 26 | * |
27 | 27 | * <p>Common to all file dialects is its basic structure: The CSV data-format |
28 | | - * is record oriented, whereas each record starts on a new textual line. A |
| 28 | + * is record-oriented, whereas each record starts on a new textual line. A |
29 | 29 | * record is build of a list of values. Keep in mind that not all records |
30 | 30 | * must have an equal number of values:</p> |
31 | 31 | * <pre> |
|
36 | 36 | * <p>The following list contains the CSV aspects the Commons CSV parser supports:</p> |
37 | 37 | * <dl> |
38 | 38 | * <dt>Separators (for lines)</dt> |
39 | | - * <dd>The record separators are hardcoded and cannot be changed. The must be '\r', '\n' or '\r\n'.</dd> |
| 39 | + * <dd>The record separators are hardcoded and cannot be changed. The must be '\r', '\n', or '\r\n'.</dd> |
40 | 40 | * |
41 | 41 | * <dt>Delimiter (for values)</dt> |
42 | 42 | * <dd>The delimiter for values is freely configurable (default ',').</dd> |
43 | 43 | * |
44 | 44 | * <dt>Comments</dt> |
45 | | - * <dd>Some CSV-dialects support a simple comment syntax. A comment is a record |
| 45 | + * <dd>Some CSV dialects support a simple comment syntax. A comment is a record |
46 | 46 | * which must start with a designated character (the commentStarter). A record |
47 | | - * of this kind is treated as comment and gets removed from the input (default none)</dd> |
| 47 | + * of this kind is treated as a comment and gets removed from the input (default none)</dd> |
48 | 48 | * |
49 | 49 | * <dt>Encapsulator</dt> |
50 | 50 | * <dd>Two encapsulator characters (default '"') are used to enclose -> complex values.</dd> |
51 | 51 | * |
52 | 52 | * <dt>Simple values</dt> |
53 | | - * <dd>A simple value consist of all characters (except the delimiter) until |
54 | | - * (but not including) the next delimiter or a record-terminator. Optionally |
| 53 | + * <dd>A simple value consists of all characters (except the delimiter) until |
| 54 | + * (but not including) the next delimiter or a record terminator. Optionally |
55 | 55 | * all surrounding whitespaces of a simple value can be ignored (default: true).</dd> |
56 | 56 | * |
57 | 57 | * <dt>Complex values</dt> |
58 | 58 | * <dd>Complex values are encapsulated within a pair of the defined encapsulator characters. |
59 | 59 | * The encapsulator itself must be escaped or doubled when used inside complex values. |
60 | | - * Complex values preserve all kind of formatting (including newlines -> multiline-values)</dd> |
| 60 | + * Complex values preserve all kinds of formatting (including newlines -> multiline-values)</dd> |
61 | 61 | * |
62 | 62 | * <dt>Empty line skipping</dt> |
63 | 63 | * <dd>Optionally empty lines in CSV files can be skipped. |
|
0 commit comments