FWGS/waf
2
0
Fork 0
mirror of https://gitlab.com/ita1024/waf.git synced 2024-11-21 17:35:55 +01:00
Code Issues Projects Releases Wiki Activity

docs

Browse Source
This commit is contained in:
Thomas Nagy 2016-08-21 00:32:33 +02:00
parent 46ab6405dc
commit 2c9c7aa52c
No known key found for this signature in database
GPG Key ID: 49B4C67C05277AAA
2 changed files with 8 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
docs/sphinx/confmap.rst
View File

@ -333,6 +333,10 @@ Configuration methods
* find_scc_
.. _find_single_qt5_lib: tools/qt5.html#waflib.Tools.qt5.find_single_qt5_lib
* find_single_qt5_lib_
.. _find_sxx: tools/suncxx.html#waflib.Tools.suncxx.find_sxx
* find_sxx_

9
docs/sphinx/featuremap_example.txt
View File

@ -1,9 +1,8 @@
The Waf *feature* system provides a way to weave specific behaviors onto existing targets (task generators) with minimum changes to the build scripts. The main benefits are flexibility and reduced maintenance efforts. This approach is comparable to the CSS class declarations in the web design context.
The Waf `feature` system weaves additional behaviors onto existing targets (task generators) with no changes to the build scripts. The main benefits are flexibility and reduced maintenance efforts. This approach is comparable to the CSS class declarations in the web design context.
The *features* themselves are declared by annotating functions with a name
through a specific Python decorator function :py:func:`waflib.TaskGen.feature`.
This decorator then binds the given functions as class methods
onto the Task generator class :py:class:`waflib.TaskGen.task_gen.
The `features` themselves are declared by annotating functions
through a specific Python decorator function :py:func:`waflib.TaskGen.feature` and passing a name.
Such functions then become methods bound to the Task generator class :py:class:`waflib.TaskGen.task_gen`.
The association between feature names and methods is *many-to-many*; in other words
a method may be used by in several features, and that a feature may reference