Go to file
Jérôme Carretero 340551d8a0 extras: file_to_object: basic file name escape (fixes issue on Windows) 2015-03-02 18:22:24 -05:00
build_system_kit Initial commit 2011-09-10 11:13:51 +02:00
demos Note on Configure.autoconfig (True/False/'clobber') 2015-02-18 01:03:10 +01:00
docs docs 2014-11-16 23:11:05 +01:00
playground Example to how how to obtain build dependencies through strace 2015-02-26 22:30:47 +01:00
tests More tests for the Waf preprocessor 2014-11-02 00:16:48 +01:00
utils Fix the g++ compiler detection which is broken by the new clang tool 2015-02-20 14:23:04 +01:00
waflib extras: file_to_object: basic file name escape (fixes issue on Windows) 2015-03-02 18:22:24 -05:00
zip waf-zip: zip-packed waf 2013-08-12 19:34:43 -04:00
.gitignore Revert the build* change to .gitignore since it's likely to have unintended side-effects on Windows. 2012-06-21 17:44:18 +02:00
ChangeLog waf 1.8.7, coming soon 2015-02-27 21:16:03 +01:00
DEVEL docs 2013-11-09 15:29:22 +01:00
README First commit of the year 2015 2015-01-01 16:24:54 +01:00
TODO Removed the accidental dependency on git to create the waf file 2015-03-01 12:04:11 +01:00
configure Initial commit 2011-09-10 11:13:51 +02:00
waf-light waf 1.8.7, coming soon 2015-02-27 21:16:03 +01:00
wscript Removed the accidental dependency on git to create the waf file 2015-03-01 12:04:11 +01:00

README

WHAT YOU WILL FIND HERE
-----------------------

Waf 1.8 - for Waf 1.7 use the branch waf-1.7

For the manual: http://docs.waf.googlecode.com/git/book_16/single.html
For the api docs: http://docs.waf.googlecode.com/git/apidocs_16/index.html
For the examples: see the folder demos/

HOW TO CREATE THE WAF SCRIPT
----------------------------

Python 2.6, 2.7, 3.0, 3.1, 3.2, 3.3 or 3.4 is required to generate the waf script. The waf script is then the version that can run on Python 2.5.
Just execute:
$ ./waf-light configure build
Or, if you have several python versions installed:
$ python3 ./waf-light configure build

The Waf tools in waflib/extras are not added to the waf script. To add
some of them, use the --tools switch:
$ ./waf-light --tools=compat15,swig

To add a tool that does not exist in the folder extras, pass an absolute path, and
to customize the initialization, pass the parameter 'prelude'. Here is for example
how to create a waf file using the compat15 module:
$ ./waf-light --tools=compat15 --prelude=$'\tfrom waflib.extras import compat15\n'

Any kind of initialization is possible, though one may prefer the build system kit (folder build_system_kit):
$ ./waf-light --make-waf --tools=compat15,/comp/waf/aba.py --prelude=$'\tfrom waflib.extras import compat15\n\tprint("ok")'

Or if you do not want to regenerate the waf file all the time, set the WAFDIR environment variable to the directory containing "waflib".

HOW TO TRY THE EXAMPLES
-----------------------

Try this:
$ cp waf demos/c/
$ cd demos/c/
$ ./waf configure build

USING GIT
---------

$ git clone https://code.google.com/p/waf/
set $HOME/.netrc to read:
machine code.google.com login user@gmail.com password pass
$ git remote add code https://code.google.com/p/waf.docs/
... make a few changes
$ git push code

---------------------------
Thomas Nagy, 2014-2015 (ita)