slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

;doc:csv: clarify CSV means DSV, and link to that instead

Browse Source
This commit is contained in:
Simon Michael 2025-04-20 09:26:06 -10:00
parent 29bca306ee
commit 72f1a14bbd
1 changed files with 9 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
hledger/hledger.m4.md
View File

@ -129,7 +129,7 @@ Usually the data file is in hledger's journal format, but it can be in any of th
| [`journal`](#journal) | hledger journal files and some Ledger journals, for transactions | `.journal` `.j` `.hledger` `.ledger` | | [`journal`](#journal) | hledger journal files and some Ledger journals, for transactions | `.journal` `.j` `.hledger` `.ledger` |
| [`timeclock`](#timeclock) | timeclock files, for precise time logging | `.timeclock` | | [`timeclock`](#timeclock) | timeclock files, for precise time logging | `.timeclock` |
| [`timedot`](#timedot) | timedot files, for approximate time logging | `.timedot` | | [`timedot`](#timedot) | timedot files, for approximate time logging | `.timedot` |
| [`csv`](#csv) | Comma or other character separated values, for data import | `.csv` | | [`csv`](#csv) | Comma- or other delimiter-separated values, for data import | `.csv` |
| [`ssv`](#csv) | Semicolon separated values | `.ssv` | | [`ssv`](#csv) | Semicolon separated values | `.ssv` |
| [`tsv`](#csv) | Tab separated values | `.tsv` | | [`tsv`](#csv) | Tab separated values | `.tsv` |
| [`rules`](#csv) | CSV/SSV/TSV/other separated values, alternate way | `.rules` | | [`rules`](#csv) | CSV/SSV/TSV/other separated values, alternate way | `.rules` |
@ -3159,15 +3159,14 @@ Currently, hledger
# CSV # CSV
hledger can read [CSV](http://en.wikipedia.org/wiki/Comma-separated_values) files hledger can read transactions from CSV (comma-separated values) files.
(Character Separated Value - usually comma, semicolon, or tab) containing dated records, More precisely, it can read [DSV](https://en.wikipedia.org/wiki/Delimiter-separated_values) (delimiter-separated values),
automatically converting each record into a transaction. from a file or standard input.
Comma-separated, semicolon-separated and tab-separated are the most common variants,
and hledger will recognise these three automatically based on a `.csv`, `.ssv` or `.tsv`
file name extension or a `csv:`, `ssv:` or `tsv:` file path prefix.
(To learn about *writing* CSV, see [CSV output](#csv-output).) (To learn about producing CSV or TSV *output*, see [CSV output](#csv-output).)
For best error messages when reading CSV/TSV/SSV files,
make sure they have a corresponding `.csv`, `.tsv` or `.ssv` file extension
or use a hledger file prefix (see [File Extension](#file-extension) below).
Each CSV file must be described by a corresponding *rules file*. Each CSV file must be described by a corresponding *rules file*.
This contains rules describing the CSV data (header line, fields This contains rules describing the CSV data (header line, fields