2
0
mirror of https://gitlab.com/ita1024/waf.git synced 2024-11-17 23:46:53 +01:00
waf/DEVEL
Thomas Nagy 603af4ce6a docs
2013-11-09 15:29:22 +01:00

46 lines
2.0 KiB
Plaintext

Main repository for waf 1.8 on http://waf.googlecode.com/git/
-------------------------------------------------------------
waflib the core library
waflib/Tools essential waf tools
waflib/extras contributed tools which are not included in the
waf file by default (except "compat15")
build_system_kit examples of build systems that can be created from waf
tests various unit tests, most are unused anymore
playground experiments and integration tests for the tools 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 apidocs
Documentation repository on http://docs.waf.googlecode.com/git/
---------------------------------------------------------------
Contains the documentation:
API documentation http://docs.waf.googlecode.com/git/apidocs_17/index.html
The Waf Book http://docs.waf.googlecode.com/git/book_17/single.html
The Waf Book for Waf 1.6 (deprecated) http://docs.waf.googlecode.com/git/book_16/single.html
The Waf Book for Waf 1.5 (deprecated) http://docs.waf.googlecode.com/git/book_15/single.html
Programming details
-------------------
* Do not use x.split("\n") but x.splitlines()
* Do not catch all exceptions unless you have a good reason to do so (no "except:")
* File handles are too easy to get wrong, use Node.readf/Node.writef/Utils.readf/Utils.writef
Wiki documentation on http://wiki.waf.googlecode.com/git/
---------------------------------------------------------
The wiki documentation is always outdated
Previous branches
-----------------
old svn repository http://waf.googlecode.com/svn/trunk/ (for waf 1.5, read-only and unused)
old branch for waf 1.5 http://waf.googlecode.com/svn/branches/waf-1.5/ (again, read-only and unused)