Differences From:
File
BUILD.txt
part of check-in
[7a2c37063a]
- merge trunk into creole branch
by
bob on
2009-09-22 07:49:39.
Also file
BUILD.txt
part of check-in
[713b8be852]
- Deleted some obsolete "todo" files. Updated the FAQ. Modified the the
"vinfo" page to show check-in differences and made "vinfo" the default
display for check-ins instead of "vdiff".
by
drh on
2009-08-28 22:59:27.
[view]
To:
File
BUILD.txt
part of check-in
[fb1fa7f1a6]
- Make it easier to do out of source builds by optionally including config.mak or config.w32.
by
jeremy_c on
2009-12-09 22:05:46.
Also file
BUILD.txt
part of check-in
[1c2d878d12]
- Merge with trunk
by
btheado on
2009-12-13 01:16:13.
[view]
@@ -3,14 +3,41 @@
use the Makefile. To do a complete build, just type:
make
-That should work out-of-the-box on Macs and Linux systems. If
-you have trouble, or you want to do something fancy, just edit
-the Makefile in the top-level folder. There are 5 things you
-might want to change in the Makefile. All 5 things are well
-commented. The complete Makefile is only a few dozen lines long.
-Do not be intimidated.
+That should work out-of-the-box on Macs and Linux systems. If you are
+building on a Windows box, install MinGW as well as MinGW's make (or
+MSYS). You can then type:
+
+ make -f Makefile.w32
+
+If you have trouble, or you want to do something fancy, just look at
+top level makefile. There are 5 configuration options that are all well
+commented. Instead of editing the Makefile, create a new file named
+config.mak (for Macs and Linux systems) or config.w32 (for Windows) and
+override any settings you wish there.
+
+Out of source builds?
+--------------------------------------------------------------------------
+
+An out of source build is pretty easy:
+
+ 1. Make a new directory to do the builds in.
+ 2. Create a config.mak (or .w32 ... explained above) and add something
+ along the lines of:
+
+ SRCDIR=../src
+
+ 3. From that directory, type:
+
+ Macs and Linux:
+ $ make -f ../Makefile
+
+ Windows:
+ C:\fossil\build> make -f ../Makefile.w32
+
+This will now keep all generates files seperate from the maintained
+source code.
--------------------------------------------------------------------------
Here are some notes on what is happening behind the scenes: