Add --version option to the CLI tools

See #232
2025-09-18 18:22:07 +08:00 · 2021-01-19 20:37:25 -05:00
parent 9e85bc4153
commit f99c5539e7
19 changed files with 159 additions and 37 deletions
--- a/doc/mdb-count.txt
+++ b/doc/mdb-count.txt
@@ -3,6 +3,7 @@ NAME

 SYNOPSIS
  mdb-count file table
+  mdb-count --version

 DESCRIPTION
  mdb-count is a utility program distributed with MDB Tools.
@@ -10,6 +11,7 @@ DESCRIPTION
  It outputs the number of rows in a table.

 OPTIONS
+  --version           Print the mdbtools version and exit.

 NOTES

--- a/doc/mdb-export.txt
+++ b/doc/mdb-export.txt
@@ -5,6 +5,7 @@ SYNOPSIS
  mdb-export [--no-header] [--delimiter delim] [--row-delimiter delim] [[--no-quote] | [--quote char [--escape char]]] [--escape-invisible] [--date-format fmt] [--datetime-format fmt] [--bin strip|raw|octal|hex] [--boolean-words] database table
  mdb-export --insert backend [--namespace prefix] [--batch-size int] database table
  mdb-export -h|--help
+  mdb-export --version

 DESCRIPTION
  mdb-export is a utility program distributed with MDB Tools. 
@@ -29,6 +30,7 @@ OPTIONS
  -0, --null char               Use char to represent a NULL value.
  -b, --bin strip|raw|octal|hex Binary export mode: strip binaries, export as-is, output \\ooo style octal data or output \\xx style hexadecimal data.
  -B, --boolean-words           Use TRUE/FALSE in Boolean fields (default is 0/1).
+  --version                     Print the mdbtools version and exit.

 NOTES 
  Most of the formatting options actually also works with --insert.
--- a/doc/mdb-import.txt
+++ b/doc/mdb-import.txt
@@ -4,6 +4,7 @@ NAME
 SYNOPSIS
  mdb-import [-H lines] [-d char] database table csvfile
  mdb-import -h|--help
+  mdb-import --version

 DESCRIPTION
  mdb-import is a utility program distributed with MDB Tools. 
@@ -13,6 +14,7 @@ DESCRIPTION
 OPTIONS
  -H, --header lines    Skip lines of CSV header.
  -d, --delimiter char  Specify an alternative column delimiter. Default is , (comma).
+  --version             Print the mdbtools version and exit

 NOTES 

--- a/doc/mdb-json.txt
+++ b/doc/mdb-json.txt
@@ -4,6 +4,7 @@ NAME
 SYNOPSIS
  mdb-json [-D fmt] [-T fmt] [-U] database table
  mdb-json -h|--help
+  mdb-json --version

 DESCRIPTION
  mdb-json is a utility program distributed with MDB Tools. 
@@ -13,7 +14,8 @@ DESCRIPTION
 OPTIONS
  -D, --date-format fmt     Set the date format (see strftime(3) for details).
  -T, --time-format fmt     Set the date/time format (see strftime(3) for details).
-  -U, --no-unprintable      Change unprintable characters to spaces (otherwise escaped as \\u00XX)
+  -U, --no-unprintable      Change unprintable characters to spaces (otherwise escaped as \\u00XX).
+  --version                 Print the mdbtools version and exit.

 NOTES 

--- a/doc/mdb-prop.txt
+++ b/doc/mdb-prop.txt
@@ -3,6 +3,7 @@ NAME

 SYNOPSIS
  mdb-prop database name [propcol]
+  mdb-prop --version

 DESCRIPTION
  mdb-prop is a utility program distributed with MDB Tools.
@@ -13,6 +14,9 @@ DESCRIPTION

  propcol is the name of the system table MSysObjects' column containing properties. It defaults to LvProp.

+OPTIONS
+  --version           Print the mdbtools version and exit.
+
 ENVIRONMENT
  MDB_JET3_CHARSET    Defines the charset of the input JET3 (access 97) file. Default is CP1252. See iconv(1).
  MDBICONV            Defines the output charset. Default is UTF-8. mdbtools must have been compiled with iconv.
--- a/doc/mdb-queries.txt
+++ b/doc/mdb-queries.txt
@@ -3,6 +3,7 @@ NAME

 SYNOPSIS
  mdb-queries [-L] [-1] [-d delim] database query
+  mdb-queries --version
  mdb-queries -h|--help

 DESCRIPTION
@@ -13,7 +14,8 @@ DESCRIPTION
 OPTIONS
  -L, --list             List queries in the database (default if no query name is passed)
  -1, --newline          Use newline as the delimiter (used in conjunction with listing)
-  -d, --delimiter delim  Specify delimiter to use
+  -d, --delimiter delim  Specify delimiter to use (defaults to space)
+  --version              Print the mdbtools version and exit

 NOTES 

--- a/doc/mdb-schema.txt
+++ b/doc/mdb-schema.txt
@@ -4,6 +4,7 @@ NAME
 SYNOPSIS
  mdb-schema [options] [-T tablename] [-N prefix] database [backend]
  mdb-schema -h|--help
+  mdb-schema --version

 DESCRIPTION
  mdb-schema is a utility program distributed with MDB Tools. 
@@ -27,6 +28,7 @@ OPTIONS
  --no-indexes            Don't export INDEXes.
  --relations             Export foreign keys constraints. This is the default.
  --no-relations          Don't export foreign keys constraints.
+  --version               Print the mdbtools version and exit.

  backend	Specifies target DDL dialect. Supported values are access, sybase, oracle, postgres, mysql and sqlite. If not specified the generated DDL will be in access format.

--- a/doc/mdb-sql.txt
+++ b/doc/mdb-sql.txt
@@ -4,6 +4,7 @@ NAME
 SYNOPSIS
  mdb-sql [-HFp] [-d char] [-i file] [-o file] [database]
  mdb-sql -h|--help
+  mdb-sql --version

 DESCRIPTION
  mdb-sql is a utility program distributed with MDB Tools. 
@@ -23,6 +24,7 @@ specified, columns will be delimited by a tab character if pretty printing
 (-p) is turned off. If pretty printing is enabled this option is meaningless.
  -i, --input file             Specify an input file. This option allows an input file containing the SQL to be passed to mdb-sql.  See Notes.
  -o, --output file            Specify an output file. This option allows the name of an output file to be used instead of stdout.
+  --version                    Print the mdbtools version and exit.

 COMMANDS
  mdb-sql in interactive mode takes some special commands. 
--- a/doc/mdb-tables.txt
+++ b/doc/mdb-tables.txt
@@ -4,6 +4,7 @@ NAME
 SYNOPSIS
  mdb-tables [-S] [-1 | -d delim] [-t form|table|macro|systable|report|query|linkedtable|module|relationship|dbprop|any|all] [-T] database
  mdb-tables -h|--help
+  mdb-tables --version

 DESCRIPTION
  mdb-tables is a utility program distributed with MDB Tools. 
@@ -16,6 +17,7 @@ OPTIONS
  -d, --delimiter delim  Specifies an alternative delimiter. If no delimiter is specified, table names will be delimited by a tab character, or by newline if the -1 option was specified.
  -t, --type type        Filters entries to show alternate types. Autorized values are form, table, macro, systable, report, query, linkedtable, module, relationship, dbprop, any, and all. Default value is table.
  -T, --showtype         Display the entry type indentifier before each entry.
+  --version              Print the mdbtools version and exit.

 NOTES 

--- a/doc/mdb-ver.txt
+++ b/doc/mdb-ver.txt
@@ -3,8 +3,8 @@ NAME

 SYNOPSIS
  mdb-ver database
-  mdb-ver -M
  mdb-ver -h|--help
+  mdb-ver -M|--version

 DESCRIPTION
  mdb-ver is a utility program distributed with MDB Tools. 
@@ -12,8 +12,7 @@ DESCRIPTION
  It will return a single line of output corresponding to the program that produced the file: 'JET3' (for files produced by Access 97), 'JET4' (Access 2000, XP and 2003), 'ACE12' (Access 2007), 'ACE14' (Access 2010), 'ACE15' (Access 2013), or 'ACE16' (Access 2016).

 OPTIONS
-
-  -M, --mdbtools	Prints the version of MDB Tools itself instead of the MDB file.
+  -M, --version     Print the version of mdbtools (rather than the MDB file) and exit.

 NOTES 
  Access changed its format between Jet 3 used in Access 97 and Jet 4 used for Access 2000 and XP. The nature of the changes included moving the page size from 2K to 4K and added support for unicode. MDB Tools actively supports both formats. Newer version are very much like Jet4.