Recent changes to Program_Options_by_Example

Program_Options_by_Example modified by Larry Jordan

Larry Jordan — Tue, 20 May 2014 23:51:44 -0000

--- v3
+++ v4
@@ -17,29 +17,19 @@

 Micro Management Report 

-Date  Task  Minutes 
-
-2000-01-01 
-_**Dummy**_
-0 
+|Date | Task | Minutes |
+|-----|------|---------|
+|2000-01-01 |_**Dummy**_|0 |

 ### **Output** output.odt

 Micro Management Report 

-Date  Task  Minutes 
-
-2011-06-14 
-_**Sweep floor**_
-30 
-
-2011-06-15 
-_**Count beans**_
-60 
-
-2011-07-10 
-_**Pickup chips**_
-45 
+|Date | Task | Minutes |
+|--|--|--|
+|2011-06-14 |_**Sweep floor**_|30 |
+|2011-06-15 |_**Count beans**_|60 |
+|2011-07-10 |_**Pickup chips**_|45 |

 The contents of the csv data file has been inserted into the document. The formatting in the document has also been applied to the csv data. 

@@ -55,20 +45,20 @@
 -h : displays help information 
 -v : verbose mode 
 [-H](Option_H_Example) : insert the first csv row into the header 
-[-c &lt;_char_&gt;](Option_c_Example) : use _char_ as delimiter instead of comma 
-[--comment=&lt;text&gt;](Option_comment_Example) : replace [csv2odf-comment] within the document with &lt;text&gt; 
-[-o &lt;_spec_&gt;](Option_o_Example) : specify column order: 2,1,3 = second csv column is first. Also use to leave the contents of a template column: 1,2,,3,4 = the 3rd template column is not overwritten. Useful if a column contains a formula. The formula cell references will be offset to the correct row. 
-[-s &lt;_n_&gt;](Option_s_Example) : start reading at the nth row of the csv file 
-[-e &lt;_n_&gt;](Option_e_Example) : end reading at the nth row of the csv file 
-[-S &lt;_n_&gt;](Option_S_Example) : skip the first n rows of the template file, the header will be the next row after those skipped 
--t &lt;_n_&gt; : specify which tab or table to add data to, default first table 
-[-d &lt;_fmt_&gt;](Option_d_Example) : date format within csv data is specified by _fmt_ string, see -D for codes 
+[-c <_char_>](Option_c_Example) : use _char_ as delimiter instead of comma 
+[--comment=<text>](Option_comment_Example) : replace [csv2odf-comment] within the document with <text> 
+[-o <_spec_>](Option_o_Example) : specify column order: 2,1,3 = second csv column is first. Also use to leave the contents of a template column: 1,2,,3,4 = the 3rd template column is not overwritten. Useful if a column contains a formula. The formula cell references will be offset to the correct row. 
+[-s <_n_>](Option_s_Example) : start reading at the nth row of the csv file 
+[-e <_n_>](Option_e_Example) : end reading at the nth row of the csv file 
+[-S <_n_;gt;](Option_S_Example) : skip the first n rows of the template file, the header will be the next row after those skipped 
+-t <_n_> : specify which tab or table to add data to, default first table 
+[-d <_fmt_>](Option_d_Example) : date format within csv data is specified by _fmt_ string, see -D for codes 
 -D : show a list of date format codes 
 -q : suppress all warning messages 
 -x : create an xml output file instead of odf 
 -n : do not merge the data into output, use with -x to extract template xml codes 
-\--input=&lt;_file_&gt; : specify the csv data file location 
-\--template=&lt;_file_&gt; : specify the tempate file location 
-\--output=&lt;_file_&gt; : specify the output file location 
+\--input=<_file_> : specify the csv data file location 
+\--template=<_file_> : specify the tempate file location 
+\--output=<_file_> : specify the output file location 
 -V : display version number 
 -z : display debugging information

Program_Options_by_Example modified by Larry Jordan

Larry Jordan — Tue, 20 May 2014 23:25:31 -0000

--- v2
+++ v3
@@ -54,15 +54,15 @@

 -h : displays help information 
 -v : verbose mode 
-[-H](Option_H) : insert the first csv row into the header 
-[-c &lt;_char_&gt;](Option_c) : use _char_ as delimiter instead of comma 
-[--comment=&lt;text&gt;](Option_comment) : replace [csv2odf-comment] within the document with &lt;text&gt; 
-[-o &lt;_spec_&gt;](Option_o) : specify column order: 2,1,3 = second csv column is first. Also use to leave the contents of a template column: 1,2,,3,4 = the 3rd template column is not overwritten. Useful if a column contains a formula. The formula cell references will be offset to the correct row. 
-[-s &lt;_n_&gt;](Option_s) : start reading at the nth row of the csv file 
-[-e &lt;_n_&gt;](Option_e) : end reading at the nth row of the csv file 
-[-S &lt;_n_&gt;](Option_S) : skip the first n rows of the template file, the header will be the next row after those skipped 
+[-H](Option_H_Example) : insert the first csv row into the header 
+[-c &lt;_char_&gt;](Option_c_Example) : use _char_ as delimiter instead of comma 
+[--comment=&lt;text&gt;](Option_comment_Example) : replace [csv2odf-comment] within the document with &lt;text&gt; 
+[-o &lt;_spec_&gt;](Option_o_Example) : specify column order: 2,1,3 = second csv column is first. Also use to leave the contents of a template column: 1,2,,3,4 = the 3rd template column is not overwritten. Useful if a column contains a formula. The formula cell references will be offset to the correct row. 
+[-s &lt;_n_&gt;](Option_s_Example) : start reading at the nth row of the csv file 
+[-e &lt;_n_&gt;](Option_e_Example) : end reading at the nth row of the csv file 
+[-S &lt;_n_&gt;](Option_S_Example) : skip the first n rows of the template file, the header will be the next row after those skipped 
 -t &lt;_n_&gt; : specify which tab or table to add data to, default first table 
-[-d &lt;_fmt_&gt;](Option_d) : date format within csv data is specified by _fmt_ string, see -D for codes 
+[-d &lt;_fmt_&gt;](Option_d_Example) : date format within csv data is specified by _fmt_ string, see -D for codes 
 -D : show a list of date format codes 
 -q : suppress all warning messages 
 -x : create an xml output file instead of odf

Program_Options_by_Example modified by Larry Jordan

Larry Jordan — Tue, 20 May 2014 23:25:31 -0000

--- v1
+++ v2
@@ -61,14 +61,14 @@
 [-s &lt;_n_&gt;](Option_s) : start reading at the nth row of the csv file 
 [-e &lt;_n_&gt;](Option_e) : end reading at the nth row of the csv file 
 [-S &lt;_n_&gt;](Option_S) : skip the first n rows of the template file, the header will be the next row after those skipped 
-[-t &lt;_n_&gt;](Option_t) : specify which tab or table to add data to, default first table 
+-t &lt;_n_&gt; : specify which tab or table to add data to, default first table 
 [-d &lt;_fmt_&gt;](Option_d) : date format within csv data is specified by _fmt_ string, see -D for codes 
 -D : show a list of date format codes 
 -q : suppress all warning messages 
 -x : create an xml output file instead of odf 
 -n : do not merge the data into output, use with -x to extract template xml codes 
-[--input=&lt;_file_&gt;](Option_input) : specify the csv data file location 
-[--template=&lt;_file_&gt;](Option_template) : specify the tempate file location 
-[--output=&lt;_file_&gt;](Option_output) : specify the output file location 
+\--input=&lt;_file_&gt; : specify the csv data file location 
+\--template=&lt;_file_&gt; : specify the tempate file location 
+\--output=&lt;_file_&gt; : specify the output file location 
 -V : display version number 
 -z : display debugging information

Program_Options_by_Example modified by Larry Jordan

Larry Jordan — Tue, 20 May 2014 23:25:31 -0000

Here are illustrations of the operation of csv2odf. The wiki may not look exactly like a document, but maybe you will get the idea of what the various options do.

Basic Operation
Option Examples

Basic Operation

Here is how the program works without options.

Input data.csv

2011-06-14, "Sweep floor", 30
2011-06-15, "Count beans", 60
2011-07-10, "Pickup chips", 45

Template template.odt

Micro Management Report

Date Task Minutes

2000-01-01
Dummy
0

Output output.odt

Micro Management Report

Date Task Minutes

2011-06-14
Sweep floor
30

2011-06-15
Count beans
60

2011-07-10
Pickup chips
45

The contents of the csv data file has been inserted into the document. The formatting in the document has also been applied to the csv data.

Command

csv2odf data.csv template.odt output.odt

Option Examples

Click on the option you are interested in to see an example.

-h : displays help information
-v : verbose mode
-H : insert the first csv row into the header
-c <char> : use char as delimiter instead of comma
--comment=<text> : replace [csv2odf-comment] within the document with <text>
-o <spec> : specify column order: 2,1,3 = second csv column is first. Also use to leave the contents of a template column: 1,2,,3,4 = the 3rd template column is not overwritten. Useful if a column contains a formula. The formula cell references will be offset to the correct row.
-s <n> : start reading at the nth row of the csv file
-e <n> : end reading at the nth row of the csv file
-S <n> : skip the first n rows of the template file, the header will be the next row after those skipped
-t <n> : specify which tab or table to add data to, default first table
-d <fmt> : date format within csv data is specified by fmt string, see -D for codes
-D : show a list of date format codes
-q : suppress all warning messages
-x : create an xml output file instead of odf
-n : do not merge the data into output, use with -x to extract template xml codes
--input=<file> : specify the csv data file location
--template=<file> : specify the tempate file location
--output=<file> : specify the output file location
-V : display version number
-z : display debugging information