README

ODBC Shell
==========

   ODBC Shell is a command line ODBC client for Unix environments. The goal
   of ODBC Shell is to provide an easy and polished utility for accessing
   databases from the commandline.


Contents
--------

   1. Disclaimer
   2. Software Requirements
   3. Tested Platforms
   4. Maintainers
   5. Community
   6. Source Code
   7. Package Maintence Notes


Disclaimer
==========

   This software is provided by the copyright holders and contributors "as
   is" and any express or implied warranties, including, but not limited to,
   the implied warranties of merchantability and fitness for a particular
   purpose are disclaimed. In no event shall Bindle Binaries be liable for
   any direct, indirect, incidental, special, exemplary, or consequential
   damages (including, but not limited to, procurement of substitute goods or
   services; loss of use, data, or profits; or business interruption) however
   caused and on any theory of liability, whether in contract, strict
   liability, or tort (including negligence or otherwise) arising in any way
   out of the use of this software, even if advised of the possibility of
   such damage.


Software Requirements
=====================

   GNU GCC 4.2.1
   GNU Libtool 2.4
   GNU Autoconf 2.65
   GNU Automake 1.11.1
   GNU Readline 6.1
   Git 1.7.2.3
   Driver Manager:
      iODBC 2.52.6 
      unixODBC 2.3.0


Tested Platforms
================

   FreeBSD 8.1
      - MyODBC 3.51.26
      - SQLite ODBC 0.88

   OS X 10.6.6
      - FileMaker xDBC 11.3.76
      - MyODBC 5.1.8
      - SQLite ODBC 0.88

   Slackware 13.1
      - MyODBC 5.1.8
      - SQLite ODBC 0.88


Maintainers
===========

   David M. Syzdek
   Bindle Binaries
   syzdek@bindlebinaries.com


Community
=========

   Web Page:
      http://www.bindlebinaries.com/products/nix/odbcshell/

   Mailing List:
      odbc-shell@lists.bindlebinaries.com
      https://lists.bindlebinaries.com/mailman/listinfo/odbcshell

   Bug Reports:
      https://support.bindlebinaries.com/projects/odbcshell

   Downloads:
      http://sourceforge.net/projects/odbcshell/files/


Source Code
===========

   The source code for this project is maintained using git
   (http://git-scm.com).  The following contains information to checkout the
   source code from the git repository.

   Browse Source:
      https://github.com/bindle/odbcshell
      http://odbcshell.git.sourceforge.net/
      http://scm.bindlebinaries.com/scm/com.bindlebinaries/odbcshell.git

   Git URLs:
      git://github.com/bindle/odbcshell.git
      git://odbcshell.git.sourceforge.net/gitroot/odbcshell/odbcshell
      git://git.scm.bindlebinaries.com/pub/scm/com.bindlebinaries/odbcshell.git
      http://http.scm.bindlebinaries.com/pub/scm/com.bindlebinaries/odbcshell.git
      ssh://ssh.scm.bindlebinaries.com/pub/scm/com.bindlebinaries/odbcshell.git

   Downloading Source:

      $ git clone git://github.com/bindle/odbcshell.git

   Preparing Source:

      $ cd odbcshell
      $ ./build-aux/autogen.sh

   Git Branches:
      master - Current release of packages.
      next   - changes staged for next release
      pu     - proposed updates for next release
      xx/yy+ - branch for testing new changes before merging to 'pu' branch


Package Maintence Notes
=======================

   This is a collection of notes for developers to use when maintaining this
   package.

   New Release Checklist:

      - Switch to 'master' branch in Git repository.
      - Update version in configure.ac.
      - Update date and version in ChangeLog.
      - Commit configure.ac and ChangeLog changes to repository.
      - Create tag in git repository:
           $ git tag -s v${MAJOR}.${MINOR}
      - Push repository to publishing server:
           $ git push --tags origin master:master next:next pu:pu

   Creating Source Distribution Archives:

      $ ./configure
      $ make update
      $ make distcheck
      $ make dist-bzip2