From fdc28069ac81a12240fb6ad4fc31966afea25a19 Mon Sep 17 00:00:00 2001 From: Thomas Nagy Date: Sun, 23 Sep 2012 10:02:08 +0200 Subject: [PATCH] docs --- docs/book/nodes.txt | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/book/nodes.txt b/docs/book/nodes.txt index ef437863..550e944e 100644 --- a/docs/book/nodes.txt +++ b/docs/book/nodes.txt @@ -115,7 +115,7 @@ def dosomething(ctx): print(nd3) nd2.write('some text') <5> - print(nd2.read()) + print(nd2.read()) <6> print(ctx.path.listdir()) --------------- @@ -125,6 +125,7 @@ def dosomething(ctx): <3> Search for a node but do not try to create it <4> Search for a file which does not exist <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: @@ -327,5 +328,13 @@ def build(bld): ) --------------- +In practice, it is easier to use a wrapper that conceals these details (more examples can be found in +demos/subst+): + +[source,python] +--------------- +def build(bld): + bld(features='subst', source='wscript', target='wscript', is_copy=True) +--------------- + // ==== Serialization concerns