Skip to content

Commit

Permalink
Drop autogen.sh: Do use autoconf
Browse files Browse the repository at this point in the history
Automake is changing and some of the stuff in autogen.sh is expected to fail
soon:
https://www.gnu.org/software/automake/manual/html_node/Future-of-aclocal.html

"autoreconf -if" will overwrite the INSTALL file, so its content is now in the
README file.

Added NEWS warning

Adjusted .gitignore
  • Loading branch information
Nirgal Vourgère committed Jul 14, 2013
1 parent 5312060 commit a636923
Show file tree
Hide file tree
Showing 5 changed files with 101 additions and 270 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ dumptypes.h
Makefile.in
Makefile
doc/*.1
INSTALL
include/config.h
include/config.h.in
include/mdbver.h
Expand Down
97 changes: 0 additions & 97 deletions INSTALL

This file was deleted.

12 changes: 7 additions & 5 deletions NEWS
Original file line number Diff line number Diff line change
@@ -1,15 +1,17 @@
Version 0.7.1
=============
An experimental (buggy) version of ODBC driver that supports UCS-2 interface
is now available: libmdbodbcW.so
Note that libmdbodbc supports UTF-8 really well, so that this is usually not
needed.
autogen.sh is no more. Use "autoreconf" -if to bootstrap the configuration.

autoconf/automake has been updates to more recent standards.
autoconf/automake has been updated to more recent standards.
- config.guess config.sub depcomp install-sh ltmain.sh missing ylwrap
files are now in build-aux/ directory
You'll now need autoconf >= 2.58

An experimental (buggy) version of ODBC driver that supports UCS-2 interface
is now available: libmdbodbcW.so
Note that libmdbodbc supports UTF-8 really well, so that this is usually not
needed.

Version 0.3
===========
The organization of the project files has changed a bit from that last release.
Expand Down
101 changes: 93 additions & 8 deletions README
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,26 @@ pieces are:

. libmdb - the core library that allows access to MDB files programatically.
. libmdbsql - builds on libmdb to provide a SQL engine (aka Jet)
. utils - provides command line utilities to list tables, export schema,
and data, show the version of the files, and other useful stuff.
. utils - provides command line utilities:
mdb-ver -- prints the version (JET 3 or 4) of an mdb file.
mdb-dump -- simple hex dump utility that I've been using to look
at mdb files.
mdb-schema -- prints DDL for the specified table.
mdb-export -- export table to CSV format.
mdb-tables -- a simple dump of table names to be used with shell
scripts
mdb-header -- generates a C header to be used in exporting mdb
data to a C prog.
mdb-parsecvs -- generates a C program given a CSV file made with
mdb-export
mdb-sql -- if --enable-sql is specified, a simple SQL engine
(also used by ODBC and gmdb).
- And some utilities useful for debugging:
prcat -- prints the catalog table from an mdb file.
prkkd -- dump of information about design view data given the offset to it.
prtable -- dump of a table definition.
prdata -- dump of the data given a table name.
prole -- dump of ole columns given a table name and sargs.
. mdb-sql - a command line SQL tool that allows one to type sql queries and
get results.
. odbc - An ODBC driver for use with unixODBC or iODBC driver manager.
Expand All @@ -20,16 +38,83 @@ where the code stands and what has been gleened of the file format.

The initial goal of these tools is to be able to extract data structures and
data from mdb files. This goal will of course expand over time as the file
format becomes more well understood.
format becomes more well understood.

Files in libmdb, libmdbsql, and libmdbodbc are licensed under LGPL and the
utilities and gui program are under the GPL, see COPYING.LIB and COPYING files
Files in libmdb, libmdbsql, and libmdbodbc are licensed under LGPL and the
utilities and gui program are under the GPL, see COPYING.LIB and COPYING files
respectively.

To install see the INSTALL file

Check out https://github.com/brianb/mdbtools for latest version of sources.
Check out http://mdbtools.sourceforge.net for mailing list and similar.
Requirements:
=============

First, you must have reasonably current installations of:
libtool
automake
autoconf (version >= 2.58)
If you don't you should install them first. Sources are available at
ftp.gnu.org.

If you want to build the SQL engine, you'll need bison or byacc, and flex.

If you want to build the ODBC driver, you'll need unixodbc (version 2.2.10 or
above) or iodbc.

If you want to build man pages, you'll need txt2man. Source is available at
http://mvertes.free.fr/download/.

If you want to generate the html version of the docbook, you'll need openjade
and basic dsl catalogs.


Installation from source:
=========================

Last version is available at https://github.com/brianb/mdbtools

$ autoreconf -i -f

If you want to build the html version of the docbook documentation, you need to
set the environment variable DOCBOOK_DSL to the modular dsl translation file.
For exemple, before configure, you need something like:

$ export DOCBOOK_DSL=/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl

$ ./configure

OR for a complete install (requires bison, flex, and unixODBC):

$ ./configure --with-unixodbc=/usr/local

configure can be passed any of the following flags to turn on other
capabilities. Note that the options --with-unixodbc and --with-iodbc are
mutually exclusive.
--with-unixodbc specifies the location of the unixODBC driver manager and
causes the unixODBC driver to be built.
--with-iodbc specifies the location of the iODBC driver manager and
causes the iODBC driver to be built.
A list of general options is available in the INSTALL file, and
"configure --help" will give you the list of mdbtools specific options.

$ make

Once MDB Tools has been compiled, libmdb.[so|a] will be in the src/libmdb
directory and the utility programs will be in the src/util directory.

You can then run 'make install' as root to install (to /usr/local by default).
Some systems will also need the ld cache to be updated after installation;
You can do that running 'ldconfig' as root.


Contacts
========

The mailing list from the old site a available at
http://mdbtools.sourceforge.net

Please send bug repports to the new github platform.
https://github.com/brianb/mdbtools/issues


Brian Bruns
brian@bruns.com
Expand Down
Loading

0 comments on commit a636923

Please sign in to comment.