Author: wyoung
Date: Thu Jan 3 20:30:41 2008
New Revision: 2093
URL: http://svn.gna.org/viewcvs/mysqlpp?rev=2093&view=rev
Log:
Clarified new "bootstrapping" section in HACKERS.txt
Modified:
trunk/HACKERS.txt
Modified: trunk/HACKERS.txt
URL:
http://svn.gna.org/viewcvs/mysqlpp/trunk/HACKERS.txt?rev=2093&r1=2092&r2=2093&view=diff
==============================================================================
--- trunk/HACKERS.txt (original)
+++ trunk/HACKERS.txt Thu Jan 3 20:30:41 2008
@@ -21,44 +21,48 @@
~~~~~~~~~~~~~~~~~~~~~~~~~
When you check out MySQL++ from svn, there are a lot of things
"missing" as compared to a distributed tarball, because the svn
- repository doesn't contain any generated files. The tarball
- contains all of the generated files mentioned below, for
- convenience. You can group these generated files into classes,
- based on how they're generated:
-
- - Makefile.in, Makefile.mingw, *.vcproj, *.sln:
-
- These are all generated by Bakefile (http://bakefile.org/) from
+ repository doesn't contain any generated files.
+
+ If you're on a Unixy platform, you can generate these files
+ by running the 'bootstrap' script. You'll need autoconf 1.59,
+ Bakefile 0.2.3, and Perl 5 installed on the system for bootstrap
+ to run. There are more details about the boostrap script in a
+ separate section below.
+
+ On Windows, things are a bit harder because the bootstrap script
+ (and its dependencies) are very Unix-centric, even though most
+ of its outputs are not. Here are the files you need to generate
+ to get MySQL++ to build on Windows:
+
+ - Makefile.mingw, *.vcproj, *.sln:
+
+ These are generated by Bakefile (http://bakefile.org/) from
Bakefiles.bkgen and mysql++.bkl. MySQL++ currently requires
- Bakefile v0.2.3 or newer.
-
- On Unixy systems, run the bootstrap script; see below for
- details.
-
- The bootstrap script is overkill for Windows, so for it, run
- rebake.bat instead.
-
- - configure, mysql++.spec, lib/Doxyfile, lib/mysql++.h:
-
- These are generated by autoconf.
-
- On Unixy systems, bootstrap takes care of this for you.
-
- On Windows, the only file in this set that you absolutely
- must have is lib/mysql++.h, but autoconf doesn't run natively
- on Windows. One way around this is to install Cygwin so you
- can run autoconf by hand. Another is to install MySQL++ on a
- Linux box and let that system generate mysql++.h for you, then
- copy it over to the Windows box. mysql++.h.in (the source file
- for mysql++.h) doesn't change very often, so this shouldn't be
- a hardship.
+ Bakefile 0.2.3 or newer. Run rebake.bat to rebuild these files.
+
+ As of this writing Bakefile 0.2.3 hasn't been released, so
+ if you're not using Visual C++ 2003, you can change all the
+ 'msvs2003prj' strings to 'msvs2005prj' in Bakefiles.bkgen,
+ mysql++.bkl and rebake.bat to make it generate VC++ 2005
+ compatible project files instead of VC++ 2003 project files.
+ This will let you use Bakefile 0.2.2.
+
+ - lib/mysql++.h:
+
+ This file (and several others used on Unixy systems) is generated
+ by autoconf. But, autoconf doesn't run natively on Windows.
+ One way around this is to install Cygwin so you can run autoconf
+ by hand. (As opposed to running it via bootstrap, which is more
+ trouble than it's worth, on Windows.) Another is to install
+ MySQL++ on a Linux box and let that system generate mysql++.h
+ for you, then copy it over to the Windows box. mysql++.h.in
+ (the source file for mysql++.h) doesn't change very often,
+ so this shouldn't be a hardship.
- lib/ssqls.h and lib/querydef.h:
- On Unixy systems, the bootstrap script builds these for you.
-
- On Windows, run lib/ssqls.pl and lib/querydef.pl with a Perl
- interpreter to create these files.
+ Run lib/ssqls.pl and lib/querydef.pl with a Perl interpreter
+ to create these files.
Submitting Patches
_______________________________________________
Mysqlpp-commits mailing list
[email protected]
https://mail.gna.org/listinfo/mysqlpp-commits
