FWGS/waf
2
0
Fork 0
mirror of https://gitlab.com/ita1024/waf.git synced 2024-11-22 09:57:15 +01:00
Code Issues Projects Releases Wiki Activity

verbose notes on nodes in the waf book

Browse Source
This commit is contained in:
Thomas Nagy 2012-09-23 10:13:22 +02:00
parent fdc28069ac
commit 50f107de2e
1 changed files with 4 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/book/nodes.txt
View File

@ -115,7 +115,7 @@ def dosomething(ctx):
print(nd3) print(nd3)
nd2.write('some text') <5> nd2.write('some text') <5>
print(nd2.read()) <6> print(nd2.read())
print(ctx.path.listdir()) print(ctx.path.listdir())
--------------- ---------------
@ -125,7 +125,6 @@ def dosomething(ctx):
<3> Search for a node but do not try to create it <3> Search for a node but do not try to create it
<4> Search for a file which does not exist <4> Search for a file which does not exist
<5> Write to the file pointed by the node, creating or overwriting the file <5> Write to the file pointed by the node, creating or overwriting the file
<6> In practice, it is best to use the read/write methods to prevent file handle inheritance issues on win32 systems when performing parallel builds
The output will be the following: The output will be the following:
@ -146,7 +145,9 @@ some text
NOTE: More methods may be found in the http://docs.waf.googlecode.com/git/apidocs_17/index.html[API documentation] NOTE: More methods may be found in the http://docs.waf.googlecode.com/git/apidocs_17/index.html[API documentation]
WARNING: These methods are not safe for concurrent access. The node class methods are not meant to be thread-safe. WARNING: The Node methods are not meant to be safe for concurrent access. The code executed in parallel (method run() of task objects for example) must avoid modifying the Node object data structure.
WARNING: The Node methods read/write must be used to prevent file handle inheritance issues on win32 systems instead of plain open/read/write. Such problems arise when spawning processes during parallel builds.
==== Listing files and folders ==== Listing files and folders