fixing formatting

Author: rsdoiel

cmds/csv2xlsx/csv2xlsx.go

@@ -50,7 +50,7 @@ If the Workbook does not exist then it is created.
 
 	examples = `
 
-EXAMPLE
+EXAMPLES
 
 	%s -i data.csv MyWorkbook.xlsx 'My worksheet'
 

cmds/joinstring/joinstring.go

@@ -54,12 +54,15 @@ This should yield
 
 Joining a newline delimited file into a single string
 
-    cat <<EOF > %s -nl -d '||' "one||two||three"
-    one
+    cat myfile.txt | %s -nl -d '||' "one||two||three"
+
+where myfile.txt holds
+
+	one
 	two
 	three
-    EOF
-This should yield
+
+should yield
 
     one||two||three
 

cmds/range/range.go

@@ -56,26 +56,37 @@ down otherwise it counts up.
 
 EXAMPLES
 
-Yields 1 2 3 4 5
-	
+Create a range of integers one through five
+
 	%s 1 5
 
-Yields -2 -1 0 1 2 3 4 5 6
+Yields 1 2 3 4 5
+
+Create a range of integer negative two to six
 
 	%s -- -2 6
 
-Yields 2 4 6 8 10
+Yields -2 -1 0 1 2 3 4 5 6
+
+Create a range of even integers two to ten
 
 	%s -increment=2 2 10
 
-Yields 10 9 8 7 6 5 4 3 2 1
+Yields 2 4 6 8 10
+
+Create a descending range of integers ten down to one
 
 	%s 10 1
 
-Yields a random integer from 0 to 10
+Yields 10 9 8 7 6 5 4 3 2 1
+
+
+Pick a random integer between zero and ten
 
 	%s -r 0 10
 
+Yields a random integer from 0 to 10
+
 `
 
 	// Standard Options

docs/csv2json.md

@@ -12,21 +12,21 @@ per line.
 ## OPTIONS
 
 ```
-	-as-blobs	output as one JSON blob per line
-	-d	set the delimter character
-	-delimiter	set the delimter character
-	-example	display example(s)
-	-h	display help
-	-help	display help
-	-i	input filename
-	-input	input filename
-	-l	display license
-	-license	display license
-	-o	output filename
-	-output	output filename
-	-use-header	treat the first row as field names
-	-v	display version
-	-version	display version
+    -as-blobs    output as one JSON blob per line
+    -d    set the delimter character
+    -delimiter    set the delimter character
+    -example    display example(s)
+    -h    display help
+    -help    display help
+    -i    input filename
+    -input    input filename
+    -l    display license
+    -license    display license
+    -o    output filename
+    -output    output filename
+    -use-header    treat the first row as field names
+    -v    display version
+    -version    display version
 ```
 
 ## EXAMPLES

docs/csv2mdtable.md

@@ -11,19 +11,19 @@ table to stdout.
 ## OPTIONS
 
 ```
-	-d	set delimiter character
-	-delimiter	set delimiter character
-	-example	display example(s)
-	-h	display help
-	-help	display help
-	-i	input filename
-	-input	input filename
-	-l	display license
-	-license	display license
-	-o	output filename
-	-output	output filename
-	-v	display version
-	-version	display version
+    -d    set delimiter character
+    -delimiter    set delimiter character
+    -example    display example(s)
+    -h    display help
+    -help    display help
+    -i    input filename
+    -input    input filename
+    -l    display license
+    -license    display license
+    -o    output filename
+    -output    output filename
+    -v    display version
+    -version    display version
 ```
 
 ## EXAMPLES

docs/csv2xlsx.md

@@ -11,32 +11,32 @@ If the Workbook does not exist then it is created.
 ## OPTIONS
 
 ```
-	-d	set delimiter character (input)
-	-delimiter	set delimiter character (input)
-	-example	display example(s)
-	-h	display help
-	-help	display help
-	-i	input filename (CSV content)
-	-input	input filename (CSV content)
-	-l	display license
-	-license	display license
-	-sheet	Sheet name to create/replace
-	-v	display version
-	-version	display version
-	-workbook	Workbook name
+    -d    set delimiter character (input)
+    -delimiter    set delimiter character (input)
+    -example    display example(s)
+    -h    display help
+    -help    display help
+    -i    input filename (CSV content)
+    -input    input filename (CSV content)
+    -l    display license
+    -license    display license
+    -sheet    Sheet name to create/replace
+    -v    display version
+    -version    display version
+    -workbook    Workbook name
 ```
 
-## EXAMPLE
+## EXAMPLES
 
 ```shell
-	csv2xlsx -i data.csv MyWorkbook.xlsx 'My worksheet'
+    csv2xlsx -i data.csv MyWorkbook.xlsx 'My worksheet'
 ```
 
 This creates a new 'My worksheet' in the Excel Workbook
 called 'MyWorkbook.xlsx' with the contents of data.csv.
 
 ```shell
-	cat data.csv | csv2xlsx MyWorkbook.xlsx 'My worksheet'
+    cat data.csv | csv2xlsx MyWorkbook.xlsx 'My worksheet'
 ```
 
 This does the same but the contents of data.csv are piped into

docs/csvcleaner.md

@@ -17,29 +17,29 @@ minimal memory is used to operate on the file.
 ## OPTIONS
 
 ```
-	-comma	if set use this character in place of a comma for delimiting cells
-	-comment-char	if set, rows starting with this character will be ignored as comments
-	-example	display example(s)
-	-fields-per-row	set the number of columns to output right padding empty cells as needed
-	-h	display help
-	-help	display help
-	-i	input filename
-	-input	input filename
-	-l	display license
-	-left-trim-spaces	If set to true leading white space in a field is ignored.
-	-license	display license
-	-o	output filename
-	-output	output filename
-	-output-comma	if set use this character in place of a comma for delimiting output cells
-	-reuse	if false then a new array is allocated for each row processed, if true the array gets reused
-	-right-trim-spaces	If set to true trailing white space in a field is ignored.
-	-stop-on-error	exit on error, useful if you're trying to debug a problematic CSV file
-	-trim-spaces	If set to true leading and trailing white space in a field is ignored.
-	-use-crlf	if set use a charage return and line feed in output
-	-use-lazy-quoting	If LazyQuotes is true, a quote may appear in an unquoted field and a non-doubled quote may appear in a quoted field.
-	-v	display version
-	-verbose	write verbose output to standard error
-	-version	display version
+    -comma    if set use this character in place of a comma for delimiting cells
+    -comment-char    if set, rows starting with this character will be ignored as comments
+    -example    display example(s)
+    -fields-per-row    set the number of columns to output right padding empty cells as needed
+    -h    display help
+    -help    display help
+    -i    input filename
+    -input    input filename
+    -l    display license
+    -left-trim-spaces    If set to true leading white space in a field is ignored.
+    -license    display license
+    -o    output filename
+    -output    output filename
+    -output-comma    if set use this character in place of a comma for delimiting output cells
+    -reuse    if false then a new array is allocated for each row processed, if true the array gets reused
+    -right-trim-spaces    If set to true trailing white space in a field is ignored.
+    -stop-on-error    exit on error, useful if you're trying to debug a problematic CSV file
+    -trim-spaces    If set to true leading and trailing white space in a field is ignored.
+    -use-crlf    if set use a charage return and line feed in output
+    -use-lazy-quoting    If LazyQuotes is true, a quote may appear in an unquoted field and a non-doubled quote may appear in a quoted field.
+    -v    display version
+    -verbose    write verbose output to standard error
+    -version    display version
 ```
 
 ## EXAMPLES

docs/csvcols.md

@@ -12,23 +12,23 @@ listed on the commandline (first column is 1 not 0).
 ## OPTIONS
 
 ```
-	-col	output specified columns (e.g. -col 1,12:14,2,4))
-	-cols	output specified columns (e.g. -col 1,12:14,2,4))
-	-d	set delimiter character
-	-delimiter	set delimiter character
-	-example	display example
-	-h	display help
-	-help	display help
-	-i	input filename
-	-input	input filename
-	-l	display license
-	-license	display license
-	-o	output filename
-	-output	output filename
-	-skip-header-row	skip the header row
-	-uuid	add a prefix row with generated UUID cell
-	-v	display version
-	-version	display version
+    -col    output specified columns (e.g. -col 1,12:14,2,4))
+    -cols    output specified columns (e.g. -col 1,12:14,2,4))
+    -d    set delimiter character
+    -delimiter    set delimiter character
+    -example    display example
+    -h    display help
+    -help    display help
+    -i    input filename
+    -input    input filename
+    -l    display license
+    -license    display license
+    -o    output filename
+    -output    output filename
+    -skip-header-row    skip the header row
+    -uuid    add a prefix row with generated UUID cell
+    -v    display version
+    -version    display version
 ```
 
 ## EXAMPLES

docs/csvfind.md

@@ -12,32 +12,32 @@ exact match as well as some Levenshtein matching.
 ## OPTIONS
 
 ```
-	-allow-duplicates	allow duplicates when searching for matches
-	-append-edit-distance	append column with edit distance found (useful for tuning levenshtein)
-	-case-sensitive	perform a case sensitive match (default is false)
-	-col	column to search for match in the CSV file
-	-contains	use contains phrase for matching
-	-d	set delimiter character
-	-delete-cost	set the delete cost to use for levenshtein matching
-	-delimiter	set delimiter character
-	-example	display example(s)
-	-h	display help
-	-help	display help
-	-i	input filename
-	-input	input filename
-	-insert-cost	set the insert cost to use for levenshtein matching
-	-l	display license
-	-levenshtein	use levenshtein matching
-	-license	display license
-	-max-edit-distance	set the edit distance thresh hold for match, default 0
-	-o	output filename
-	-output	output filename
-	-skip-header-row	skip the header row
-	-stop-words	use the colon delimited list of stop words
-	-substitute-cost	set the substitution cost to use for levenshtein matching
-	-trim-spaces	trim spaces around cell values before comparing
-	-v	display version
-	-version	display version
+    -allow-duplicates    allow duplicates when searching for matches
+    -append-edit-distance    append column with edit distance found (useful for tuning levenshtein)
+    -case-sensitive    perform a case sensitive match (default is false)
+    -col    column to search for match in the CSV file
+    -contains    use contains phrase for matching
+    -d    set delimiter character
+    -delete-cost    set the delete cost to use for levenshtein matching
+    -delimiter    set delimiter character
+    -example    display example(s)
+    -h    display help
+    -help    display help
+    -i    input filename
+    -input    input filename
+    -insert-cost    set the insert cost to use for levenshtein matching
+    -l    display license
+    -levenshtein    use levenshtein matching
+    -license    display license
+    -max-edit-distance    set the edit distance thresh hold for match, default 0
+    -o    output filename
+    -output    output filename
+    -skip-header-row    skip the header row
+    -stop-words    use the colon delimited list of stop words
+    -substitute-cost    set the substitution cost to use for levenshtein matching
+    -trim-spaces    trim spaces around cell values before comparing
+    -v    display version
+    -version    display version
 ```
 
 ## EXAMPLES