2
0
mirror of https://gitlab.com/ita1024/waf.git synced 2024-11-17 07:27:30 +01:00
waf/DEVEL
Thomas Nagy 5bf2132211
docs
2016-03-15 19:26:31 +01:00

29 lines
1.2 KiB
Plaintext

Waf 1.9 is on https://github.com/waf-project/waf
------------------------------------------------
waflib the core library
waflib/Tools essential waf tools
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
tests various unit tests, most are unused anymore
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
demos/* integration tests and examples used as documentation
docs documentation
docs/sphinx project extracting the docstrings from the source code to create the API documentation
Documentation
-------------------------------------------------
API documentation https://waf.io/apidocs/
The Waf Book https://waf.io/book/
Coding guidelines
-----------------
* We use tabs, no spaces
* Use x.splitlines() instead of x.split('\n')
* No "except:" and and no "except Exception:" unless there is a very good reason
* File handles are too easy to get wrong, use Node.readf/Node.writef/Utils.readf/Utils.writef