From 2825a06e8e42d7ef27b45a18ab52b1d30c9dffe7 Mon Sep 17 00:00:00 2001 From: Simon Michael Date: Sat, 14 Dec 2019 13:57:17 -0800 Subject: [PATCH] ;doc: csv: expand help on other separator characters [ci skip] --- hledger-lib/hledger_csv.m4.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/hledger-lib/hledger_csv.m4.md b/hledger-lib/hledger_csv.m4.md index 8667680a6..e765a3c83 100644 --- a/hledger-lib/hledger_csv.m4.md +++ b/hledger-lib/hledger_csv.m4.md @@ -637,13 +637,20 @@ When CSV values are enclosed in quotes, note: ## Other separator characters -With the `--separator 'CHAR'` option (experimental), hledger will expect the -separator to be CHAR instead of a comma. Ie it will read other -"Character Separated Values" formats, such as TSV (Tab Separated Values). -Note: on the command line, use a real tab character in quotes, not \t. Eg: +You can use the `--separator 'CHAR'` command line option +(experimental) to read other kinds of character-separated data. +Eg to read SSV (Semicolon Separated Values), use: +```shell +$ hledger -f foo.tsv --separator ';' print +``` +Note the semicolon is quoted because it's a +[special shell character](hledger.html#special-characters-in-arguments-and-queries). + +To read TSV (Tab Separated Values), use: ```shell $ hledger -f foo.tsv --separator ' ' print ``` +Note, that's a real tab character in quotes, not `\t`. ## Reading multiple CSV files