2015-04-06 14:46:55 +02:00
|
|
|
Waf 1.8 is on https://github.com/waf-project/waf
|
|
|
|
|
------------------------------------------------
|
2011-09-10 11:13:51 +02:00
|
|
|
|
|
|
|
|
waflib the core library
|
|
|
|
|
waflib/Tools essential waf tools
|
2015-04-06 14:46:55 +02:00
|
|
|
waflib/extras contributed tools which are not included in the waf file by default
|
|
|
|
|
build_system_kit examples of build systems that can be created from Waf
|
2011-09-10 21:25:03 +02:00
|
|
|
tests various unit tests, most are unused anymore
|
2015-04-06 14:46:55 +02:00
|
|
|
playground experimental examples and test, most tools lie in the folder waflib/extras
|
|
|
|
|
demos integration tests - the folder can be configured as a standalone project
|
2011-09-10 11:13:51 +02:00
|
|
|
demos/* integration tests and examples used as documentation
|
|
|
|
|
docs documentation
|
2015-04-06 14:46:55 +02:00
|
|
|
docs/sphinx project extracting the docstrings from the source code to create the API documentation
|
2011-09-10 21:25:03 +02:00
|
|
|
|
2015-04-06 14:46:55 +02:00
|
|
|
Documentation
|
|
|
|
|
-------------------------------------------------
|
2011-09-10 21:25:03 +02:00
|
|
|
|
2015-04-06 14:46:55 +02:00
|
|
|
API documentation https://waf.io/apidocs/
|
|
|
|
|
The Waf Book https://waf.io/book/
|
2011-09-10 21:25:03 +02:00
|
|
|
|
2015-04-06 14:46:55 +02:00
|
|
|
Coding guidelines
|
|
|
|
|
-----------------
|
2012-02-26 10:10:08 +01:00
|
|
|
|
2015-04-06 14:46:55 +02:00
|
|
|
* We use tabs, no spaces
|
2012-02-26 10:10:08 +01:00
|
|
|
* Do not use x.split("\n") but x.splitlines()
|
2013-11-09 15:29:22 +01:00
|
|
|
* Do not catch all exceptions unless you have a good reason to do so (no "except:")
|
2012-02-26 10:10:08 +01:00
|
|
|
* File handles are too easy to get wrong, use Node.readf/Node.writef/Utils.readf/Utils.writef
|
|
|
|
|
|
