See Section 2.8.3, “Installing from the Development Source Tree”, for instructions on how to download and install BitKeeper.

After BitKeeper is installed, first go to the directory you want to work from, and then use this command if you want to clone the MyODBC 3.51 branch:

shell> bk clone bk://mysql.bkbits.net/myodbc3 myodbc-3.51

In the preceding example, the source tree is set up in the myodbc-3.51/ or by default myodbc3/ subdirectory of your current directory. If you are behind the firewall and can only initiate HTTP connections, you can also use BitKeeper via HTTP. If you are required to use a proxy server, simply set the environment variable http_proxy to point to your proxy:

shell> export http_proxy="https://your.proxy.server:8080/"

Replace the bk:// with https:// when doing a clone. Example:

shell> bk clone https://mysql.bkbits.net/myodbc3 myodbc-3.51

The initial download of the source tree may take a while, depending on the speed of your connection; be patient.

You need GNU autoconf 2.52 (or newer), automake 1.4, libtool 1.4, and m4 to run the next set of commands.

shell> cd myodbc-3.51
shell> bk -r edit
shell> aclocal; autoheader; autoconf;  automake;
shell> ./configure  # Add your favorite options here
shell> make

For more information on how to build, refer to INSTALL file located in the same directory. On Windows, make use of Windows Makefiles WIN-Makefile and WIN-Makefile_debug in building the driver, for more information, see Section 26.1.6, “Installing MyODBC from a Source Distribution on Windows”.

When the build is done, run make install to install the MyODBC 3.51 driver on your system.

If you have gotten to the make stage and the distribution does not compile, please report it to <[email protected]>.

After the initial bk clone operation to get the source tree, you should run bk pull periodically to get the updates.

You can examine the change history for the tree with all the diffs by using bk sccstool. If you see some funny diffs or code that you have a question about, do not hesitate to send email message to <[email protected]>.

Also, if you think you have a better idea on how to do something, send an email message to the same address with a patch. bk diffs produces a patch for you after you have made changes to the source. If you do not have the time to code your idea, just send a description.

BitKeeper has a help utility that you can access via bk helptool.