fixed formatting for help text based on changes in cli package

Author: rsdoiel

cmds/csv2json/csv2json.go

@@ -40,14 +40,19 @@ import (
 var (
 	usage = `USAGE: %s [OPTIONS]`
 
-	description = `SYNOPSIS
+	description = `
+
+SYNOPSIS
 
 %s reads CSV from stdin and writes a JSON to stdout. JSON output
 can be either an array of JSON blobs or one JSON blob (row as object)
 per line.
+
 `
 
-	examples = `EXAMPLES
+	examples = `
+
+EXAMPLES
 
 Convert data1.csv to data1.json using Unix pipes.
 
@@ -56,6 +61,7 @@ Convert data1.csv to data1.json using Unix pipes.
 Convert data1.csv to JSON blobs, one line per blob
 
     %s -as-blobs -i data1.csv
+
 `
 
 	// Standard Options

cmds/csv2mdtable/csv2mdtable.go

@@ -36,13 +36,18 @@ import (
 var (
 	usage = `USAGE: %s [OPTIONS]`
 
-	description = `SYNOPSIS
+	description = `
+
+SYNOPSIS
 
 %s reads CSV from stdin and writes a Github Flavored Markdown
 table to stdout.
+
 `
 
-	examples = `EXAMPLES
+	examples = `
+
+EXAMPLES
 
 Convert data1.csv to data1.md using Unix pipes.
 
@@ -51,6 +56,7 @@ Convert data1.csv to data1.md using Unix pipes.
 Convert data1.csv to data1.md using options.
 
     %s -i data1.csv -o data1.md
+
 `
 
 	// Standard Options

cmds/csv2xlsx/csv2xlsx.go

@@ -39,13 +39,18 @@ import (
 var (
 	usage = `USAGE: %s [OPTIONS] WORKBOOK_NAME SHEET_NAME`
 
-	description = `SYNOPSIS
+	description = `
+
+SYNOPSIS
 
 %s will take CSV input and create a new sheet in an Excel Workbook.
 If the Workbook does not exist then it is created.
+
 `
 
-	examples = `EXAMPLE
+	examples = `
+
+EXAMPLE
 
 	%s -i data.csv MyWorkbook.xlsx 'My worksheet'
 
@@ -56,6 +61,7 @@ called 'MyWorkbook.xlsx' with the contents of data.csv.
 
 This does the same but the contents of data.csv are piped into
 the workbook's sheet.
+
 `
 
 	// Standard Options

cmds/csvcols/csvcols.go

@@ -45,14 +45,19 @@ const (
 var (
 	usage = `USAGE: %s [OPTIONS] [ARGS_AS_COL_VALUES]`
 
-	description = `SYNOPSIS
+	description = `
+
+SYNOPSIS
 
 %s converts a set of command line args into columns output in CSV format.
 It can also be used CSV input rows and rendering only the column numbers
 listed on the commandline (first column is 1 not 0).
+
 `
 
-	examples = `EXAMPLES
+	examples = `
+
+EXAMPLES
 
 Simple usage of building a CSV file one row at a time.
 
@@ -73,6 +78,7 @@ Filter a 10 column CSV file for columns 1,4,6 (left most column is one)
 Filter a 10 columns CSV file for columns 1,4,6 from file named "10col.csv"
 
     %s -i 10col.csv -col 1,4,6 > 3col.csv
+
 `
 
 	// Standard Options

cmds/csvfind/csvfind.go

@@ -35,14 +35,19 @@ import (
 var (
 	usage = `USAGE: %s [OPTIONS] TEXT_TO_MATCH`
 
-	description = `SYNOPSIS
+	description = `
+
+SYNOPSIS
 
 %s processes a CSV file as input returning rows that contain the column
 with matched text. Columns are count from one instead of zero. Supports 
 exact match as well as some Levenshtein matching.
+
 `
 
-	examples = `EXAMPLES
+	examples = `
+
+EXAMPLES
 
 Find the rows where the third column matches "The Red Book of Westmarch" exactly
 
@@ -61,6 +66,7 @@ In this example we've appended the edit distance to see how close the matches ar
 You can also search for phrases in columns.
 
     %s -i books.csv -col=2 -contains "Red Book"
+
 `
 
 	// Standard Options

cmds/csvjoin/csvjoin.go

@@ -35,14 +35,19 @@ import (
 var (
 	usage = `USAGE: %s [OPTIONS] CSV1 CSV2 COL1 COL2`
 
-	description = `SYNOPSIS
+	description = `
+
+SYNOPSIS
 
 %s outputs CSV content based on two CSV files with matching column values.
 Each CSV input file has a designated column to match on. The values are
 compared as strings. Columns are counted from one rather than zero.
+
 `
 
-	examples = `EXAMPLES
+	examples = `
+
+EXAMPLES
 
 Simple usage of building a merged CSV file from data1.csv
 and data2.csv where column 1 in data1.csv matches the value in
@@ -52,6 +57,7 @@ merged-data.csv..
     %s -csv1=data1.csv -col1=2 \
        -csv2=data2.csv -col2=4 \
        -output=merged-data.csv
+
 `
 
 	// Standard Options

cmds/csvrows/csvrows.go

@@ -42,15 +42,20 @@ const (
 var (
 	usage = `USAGE: %s [OPTIONS] [ARGS_AS_ROW_VALUES]`
 
-	description = `SYNOPSIS
+	description = `
+
+SYNOPSIS
 
 %s converts a set of command line args into rows of CSV formated output.
 It can also be used to filter or list specific rows of CSV input
 The first row is 1 not 0. Often row 1 is the header row and %s makes it
 easy to output only the data rows.
+
 `
 
-	examples = `EXAMPLES
+	examples = `
+
+EXAMPLES
 
 Simple usage of building a CSV file one rows at a time.
 
@@ -71,6 +76,7 @@ Filter a 10 row CSV file for rows 1,4,6 (top most row is one)
 Filter a 10 row CSV file for rows 1,4,6 from file named "10row.csv"
 
     %s -i 10row.csv -row 1,4,6 > 3rows.csv
+
 `
 
 	// Standard options

cmds/finddir/finddir.go

@@ -38,16 +38,22 @@ import (
 var (
 	usage = `USAGE: %s [OPTIONS] [TARGET] [DIRECTORIES_TO_SEARCH]`
 
-	description = `SYNOPSIS
+	description = `
+
+SYNOPSIS
 
 %s finds directory based on matching prefix, suffix or contained text in base filename.
+
 `
 
-	examples = `EXAMPLE
+	examples = `
+
+EXAMPLE
 
 	%s -p img
 
 Find all subdirectories starting with "img".
+
 `
 
 	// Standard Options

cmds/findfile/findfile.go

@@ -38,16 +38,22 @@ import (
 var (
 	usage = `USAGE: %s [OPTIONS] [TARGET] [DIRECTORIES_TO_SEARCH]`
 
-	description = `SYNOPSIS
+	description = `
+
+SYNOPSIS
 
 %s finds files based on matching prefix, suffix or contained text in base filename.
+
 `
 
-	examples = `EXAMPLE
+	examples = `
+
+EXAMPLE
 
 	%s -s .md
 
 Search the current directory and subdirectories for Markdown files with extension of ".md".
+
 `
 
 	// Standard Options

cmds/jsoncols/jsoncols.go

@@ -26,7 +26,9 @@ import (
 var (
 	usage = `USAGE: %s [OPTIONS] [EXPRESSION] [INPUT_FILENAME] [OUTPUT_FILENAME]`
 
-	description = `SYSNOPSIS
+	description = `
+
+SYSNOPSIS
 
 %s provides scripting flexibility for data extraction from JSON data 
 returning the results in columns.  This is helpful in flattening content 
@@ -40,9 +42,12 @@ extracted is a comma. This can be overridden with an option.
 + OUTPUT_FILENAME is the filename to write or a dash "-" if you want to 
   explicity write to stdout
 	+ if not provided then %s write to stdout
+
 `
 
-	examples = `EXAMPLES
+	examples = `
+
+EXAMPLES
 
 If myblob.json contained
 
@@ -73,6 +78,7 @@ You can also pipe JSON data in.
 Would yield
 
    "Doe, Jane",[email protected],42
+
 `
 
 	// Basic Options