[unixODBC] Added manual pages for iusql, dltest, odbc_config

Tue Feb 18 09:40:27 UTC 2014

commit 1a1c1c22ae2f41534185b5f92fbc1a6e8c6f8242
Author: Jan Staněk <jstanek at redhat.com>
Date:   Tue Feb 18 10:41:10 2014 +0100

    Added manual pages for iusql, dltest, odbc_config

 dltest.1              |   52 ++++++++++++++++++++++
 iusql.1               |    1 +
 odbc_config.1         |  117 +++++++++++++++++++++++++++++++++++++++++++++++++
 unixODBC-isql.1.patch |   22 +++++++++
 unixODBC-man.patch    |   63 --------------------------
 unixODBC.7            |   52 ++++++++++++++++++++++
 unixODBC.spec         |   17 ++++++-
 7 files changed, 259 insertions(+), 65 deletions(-)
---

diff --git a/dltest.1 b/dltest.1
new file mode 100644
index 0000000..5e7de60
--- /dev/null
+++ b/dltest.1
@@ -0,0 +1,52 @@
+.TH dltest 1 "Thu 13 Feb 2014" "version 2.3.2" "UnixODBC manual pages"
+.SH NAME
+dltest \- A simple library symbol test
+
+.SH SYNOPSIS
+.B dltest
+.R [
+.I library symbol
+.R ]
+
+.SH DESCRIPTION
+.B dltest
+is simple test of occurence of the
+.I symbol
+in the
+.IR library .
+The
+.I library
+must be a full (with path) file name of the shared object, in which the search for
+.I symbol
+should be performed.
+
+Without any parameters, dltest print short help message.
+
+.SH EXAMPLES
+To determine if the symbol
+.B printf
+is found in the
+.IR libc-2\.18\.so :
+
+.RS
+$ dltest /usr/lib/libc-2.18.so printf
+.RE
+
+.SH AUTHORS
+The authors of unixODBC are
+.MT pharvey at codebydesign.com
+Peter Harvey
+.ME
+and
+.MT nick at lurcher.org
+Nick Gorham
+.ME .
+For the full list of contributors see the
+.I AUTHORS
+file.
+
+.SH COPYRIGHT
+unixODBC is licensed under the GNU Lesser General Public License. For details
+about the license, see the
+.I COPYING
+file.
diff --git a/iusql.1 b/iusql.1
new file mode 100644
index 0000000..b717d4d
--- /dev/null
+++ b/iusql.1
@@ -0,0 +1 @@
+.so man1/isql.1
diff --git a/odbc_config.1 b/odbc_config.1
new file mode 100644
index 0000000..8271289
--- /dev/null
+++ b/odbc_config.1
@@ -0,0 +1,117 @@
+.TH odbc_config 1 "Thu 13 Feb 2014" "version 2.3.2" "UnixODBC manual pages"
+
+.SH NAME
+odbc_config \- get compile options for compiling unixODBC client
+
+.SH SYNOPSIS
+.SY odbc_config
+.OP \-\-prefix
+.OP \-\-exec-prefix
+.OP \-\-include-prefix
+.OP \-\-lib-prefix
+.OP \-\-bin-prefix
+.OP \-\-version
+.OP \-\-libs
+.OP \-\-static-libs
+.OP \-\-libtool-libs
+.OP \-\-cflags
+.OP \-\-odbcversion
+.OP \-\-odbcini
+.OP \-\-odbcinstini
+.OP \-\-header
+.OP \-\-ulen
+.YS
+
+.SH DESCRIPTION
+.B odbc_config
+provides built-in options, specified at build time of the unixODBC suite, which
+are useful for building unixODBC clients and similar programs.
+
+.SH OPTIONS
+.B
+.IP \-\-prefix
+Prefix for architecture-independent file tree.
+
+.B
+.IP \-\-exec-prefix
+Prefix for architecture-dependent file tree.
+
+.B
+.IP \-\-include-prefix
+Directory with C header files for unixODBC.
+
+.B
+.IP \-\-lib-prefix
+Directory with object code (.so) libraries.
+
+.B
+.IP \-\-bin-prefix
+Location of user executables.
+
+.B
+.IP \-\-version
+unixODBC version.
+
+.B
+.IP \-\-libs
+Compiler flags for linking dynamic libraries.
+
+.B
+.IP \-\-static-libs
+Absolute file name of static unixODBC library.
+
+.B
+.IP \-\-libtool-libs
+Absolute file name of libtool unixODBC library.
+
+.B
+.IP \-\-cflags
+Compiler flags to find include files and critical compiler flags and defines used
+when compiling the libodbc library.
+
+.B
+.IP \-\-odbcversion
+Version of the ODBC specification used by the unixODBC.
+
+.B
+.IP \-\-odbcini
+Absolute file name of the system-wide DSN configuration file
+.IR odbc.ini .
+
+.B
+.IP \-\-odbcinstini
+Absolute file name of the driver configuration file
+.IR odbcinst.ini .
+
+.B
+.IP \-\-header
+Definitions of used C preprocessor constants. It is suitable to be piped into
+C header file.
+
+.B
+.IP \-\-ulen
+Compiler flag for defining
+.IR SIZEOF_SQLULEN .
+
+.SH SEE ALSO
+.BR odbcinst.ini (5),
+.BR odbc.ini (5)
+
+.SH AUTHORS
+The authors of unixODBC are
+.MT pharvey at codebydesign.com
+Peter Harvey
+.ME
+and
+.MT nick at lurcher.org
+Nick Gorham
+.ME .
+For the full list of contributors see the
+.I AUTHORS
+file.
+
+.SH COPYRIGHT
+unixODBC is licensed under the GNU Lesser General Public License. For details
+about the license, see the
+.I COPYING
+file.
diff --git a/unixODBC-isql.1.patch b/unixODBC-isql.1.patch
new file mode 100644
index 0000000..0f97e79
--- /dev/null
+++ b/unixODBC-isql.1.patch
@@ -0,0 +1,22 @@
+--- unixODBC-2.3.2/man/isql.1	2013-07-04 15:32:06.000000000 +0200
++++ unixODBC-2.3.2/man/isql.1.new	2014-02-18 10:06:43.913129715 +0100
+@@ -1,8 +1,7 @@
+-\" vim:language en_US.UTF-8:
+ .TH isql 1 "Tue 25 Jun 2013" "version 2.3.2" "UnixODBC manual pages"
+ 
+ .SH NAME
+-isql - unixODBC command-line interactive SQL tool
++isql, iusql \- unixODBC command-line interactive SQL tool
+ 
+ .SH SYNOPSIS
+ \fBisql\fR \fIDSN\fR [\fIUSER\fR [\fIPASSWORD\fR]] [\fIoptions\fR] 
+@@ -13,6 +12,9 @@
+ or interactively. It has some interesting options such as an option to generate
+ output wrapped in an HTML table.
+ 
++.B iusql
++is the same tool with built-in Unicode support.
++
+ .SH ARGUMENTS
+ 
+ .IP \fBDSN\fR
diff --git a/unixODBC.7 b/unixODBC.7
new file mode 100644
index 0000000..2c28dca
--- /dev/null
+++ b/unixODBC.7
@@ -0,0 +1,52 @@
+.TH unixODBC 7 "Tue 22. Oct 2013" "version 2.3.2" "unixODBC manual pages"
+
+.SH NAME
+unixODBC \- An ODBC implementation for Unix
+
+.SH DESCRIPTION
+ODBC is an open specification for providing application developers with a
+predictable API with which to access Data Sources. Data Sources include SQL
+Servers and any Data Source with an ODBC Driver.
+
+The unixODBC Project goals are to develop and promote unixODBC to be the
+definitive standard for ODBC on non MS Windows platforms.
+
+.SH ENVIRONMENT VARIABLES
+
+.IP \fBODBCSYSINI
+Overloads path to unixODBC configuration files. By default equals to '/etc'.
+
+.IP \fBODBCINSTINI
+Overloads the name of the drivers configuration file. It is relative to
+\fBODBCSYSINI\fR and by default set to 'odbcinst.ini'.
+
+.IP \fBODBCINSTUI
+Overloads the library name for UI. The final name that is searched for is
+evaluated as "lib$ODBCINSTUI". By default it is set to 'odbcinstQ4', so 
+the resulting library name is 'libodbcinstQ4'.
+
+.IP \fBODBCSEARCH
+Overloads the configuration mode and determines where to look for configuration
+files. Must be set to one of ODBC_SYSTEM_DSN, ODBC_USER_DSN or ODBC_BOTH_DSN 
+(the last one is the default value).
+
+.IP \fBODBCINI
+Overloads the path to user configuration file. By default it is set 
+to "~/.odbc.ini".
+
+.SH SEE ALSO
+.BR isql (1),
+.BR odbcinst (1),
+.BR odbc.ini (5),
+.BR odbcinst.ini (5)
+
+.SH AUTHORS
+
+The authors of unixODBC are Peter Harvey <\fIpharvey at codebydesign.com\fR> and
+Nick Gorham <\fInick at easysoft.com\fR>. For the full list of contributors see the
+AUTHORS file.
+
+.SH COPYRIGHT
+
+unixODBC is licensed under the GNU Lesser General Public License. For details
+about the license, see the COPYING file.
diff --git a/unixODBC.spec b/unixODBC.spec
index ea01d89..6517a08 100644
--- a/unixODBC.spec
+++ b/unixODBC.spec
@@ -1,7 +1,7 @@
 Summary: A complete ODBC driver manager for Linux
 Name: unixODBC
 Version: 2.3.2
-Release: 3%{?dist}
+Release: 4%{?dist}
 Group: System Environment/Libraries
 URL: http://www.unixODBC.org/
 # Programs are GPL, libraries are LGPL, except News Server library is GPL.
@@ -11,12 +11,16 @@ Source: http://www.unixODBC.org/%{name}-%{version}.tar.gz
 Source1: odbcinst.ini
 Source4: conffile.h
 Source5: README.dist
+Source6: iusql.1
+Source7: dltest.1
+Source8: odbc_config.1
+Source9: unixODBC.7
 
 Patch1: depcomp.patch
 Patch6: export-symbols.patch
 Patch8: so-version-bump.patch
 Patch9: keep-typedefs.patch
-Patch10: unixODBC-man.patch
+Patch10: unixODBC-isql.1.patch
 
 Conflicts: iodbc
 
@@ -125,6 +129,12 @@ do
     mv -f devel-so-list.x devel-so-list
 done
 
+# install man pages that are not part of the upstream yet
+install -Dm644 %{SOURCE6} $RPM_BUILD_ROOT%{_mandir}/man1/iusql.1
+install -Dm644 %{SOURCE7} $RPM_BUILD_ROOT%{_mandir}/man1/dltest.1
+install -Dm644 %{SOURCE8} $RPM_BUILD_ROOT%{_mandir}/man1/odbc_config.1
+install -Dm644 %{SOURCE9} $RPM_BUILD_ROOT%{_mandir}/man7/unixODBC.7
+
 %files -f base-so-list
 %doc README COPYING AUTHORS ChangeLog NEWS doc
 %doc README.dist
@@ -144,6 +154,9 @@ done
 %postun -p /sbin/ldconfig
 
 %changelog
+* Tue Feb 18 2014 Jan Stanek <jstanek at redhat.com> - 2.3.2-4
+- Added manual pages for iusql, dltest, odbc_config
+
 * Fri Dec 06 2013 Jan Stanek <jstanek at redhat.com> - 2.3.2-3
 - Renamed README.fedora to README.dist
 
