1iODBC Driver Manager
2Copyright (C) 1995 by Ke Jin <kejin@empress.com>
3Copyright (C) 1996-2006 by OpenLink Software <iodbc@openlinksw.com>
4All Rights Reserved.
5
6
7Introduction
8============
9This document describes how to checkout a copy of the CVS tree for
10development purposes. It also lists the packages that need to be
11installed prior to generating the necessary scripts and Makefiles to
12build the project.
13
14CVS access is only needed for developers who want to actively track
15progress of the iODBC source code and contribute bugfixes or enhancements
16to the project. It requires basic knowledge about the general layout
17of open source and GNU projects, the use of autoconf and automake etc,
18which is beyond the scope of this document. If you have any questions,
19please email us at <iodbc@openlinksw.com>.
20
21
22CVS Archive Server Access
23=========================
24OpenLink currently provides read-only CVS Archive access throught the
25SourceForge.net servers:
26
27$ cvs -d:pserver:anonymous@iodbc.cvs.sourceforge.net:/cvsroot/iodbc login 
28
29(The password is blank)
30
31$ cvs -z3 -d:pserver:anonymous@iodbc.cvs.sourceforge.net:/cvsroot/iodbc co iODBC
32
33
34Package Dependencies
35====================
36To generate the configure script and all other build files necessary,
37please make sure the following packages and recommended versions are
38installed on your system.
39
40        Package	  Version  From
41	========  =======  ==================================
42	autoconf  2.57	   ftp://ftp.gnu.org/pub/gnu/autoconf
43	automake  1.6.3	   ftp://ftp.gnu.org/pub/gnu/automake
44	libtool   1.4.3	   ftp://ftp.gnu.org/pub/gnu/libtool
45	gtk+	  1.2.10   ftp://ftp.gtk.org/pub/gtk/v1.2
46
47The above version are used for generating the source distributions with
48are currently generated on a standard RedHat 9 installation. Older version
49of these packages can sometimes be used, but could cause build problems.
50
51To check the version number of the tools installed on your system,
52use one of the following commands:
53
54    $ autoconf --version
55    $ automake --version
56    $ libtoolize --version
57    $ gtk-config --version
58
59
60Generate build files
61====================
62To generate the configure script and all related build files, use one
63of the following commands:
64
65    $ autoreconf --install
66
67or use the supplied script in your CVS checkout directory:
68
69    $ ./bootstrap.sh
70
71If the above commands succeed without any error messages, please use the
72following command to check out all the options you can use:
73
74    $ ./configure --help
75
76Certain build targets are only enabled when the --enable-maintainer-mode
77flag is added to configure.
78
79Please read the files INSTALL and README in this directory for further
80information on how to configure the package and install it on your system.
81
82
83Submitting fixes and enhancements
84=================================
85Patches and new contributions can be submitted as diffs from the current
86CVS archive by:
87
88    $ cvs add newfiles
89
90    $ cvs -z3 diff -uN > diffs
91
92Patches and contributions can be send to the OpenLink iODBC source
93archive manager at <iodbc@openlinksw.com> to be included the next
94distribution. Please provide accompanying documentation on which bugs
95are fixed or new features are introduced.
96