Update User's Guide for changes to --debug=taskmastertrace output.

git-svn-id: http://scons.tigris.org/svn/scons/trunk@2950 fdb21ef1-2011-0410-befe-b5e4ea1792b1

diff --git a/doc/user/troubleshoot.xml b/doc/user/troubleshoot.xml
index 0a345597dfd873982e8b75e4ea8ddba0d4f13077..510587adc1375203454a321fb5e6915c8431bd87 100644 (file)
--- a/doc/user/troubleshoot.xml
+++ b/doc/user/troubleshoot.xml
@@ -1115,7 +1115,7 @@
       % <userinput>scons -Q --debug=stacktrace</userinput>
       scons: *** Source `prog.c' not found, needed by target `prog.o'.  Stop.
       scons: internal stack trace:
-        File "bootstrap/src/engine/SCons/Job.py", line 187, in start
+        File "bootstrap/src/engine/SCons/Job.py", line 198, in start
         File "bootstrap/src/engine/SCons/Script/Main.py", line 169, in prepare
         File "bootstrap/src/engine/SCons/Taskmaster.py", line 184, in prepare
         File "bootstrap/src/engine/SCons/Executor.py", line 171, in prepare
@@ -1175,29 +1175,32 @@
       % <userinput>scons -Q --taskmastertrace=- prog</userinput>
       
       Taskmaster: Looking for a node to evaluate
-      Taskmaster:     Considering node &lt;no_state   'prog'&gt; and its children:
-      Taskmaster:        &lt;no_state   'prog.o'&gt;
-      Taskmaster:     Considering node &lt;no_state   'prog.o'&gt; and its children:
-      Taskmaster:        &lt;no_state   'prog.c'&gt;
-      Taskmaster:        &lt;no_state   'inc.h'&gt;
-      Taskmaster:     Considering node &lt;no_state   'prog.c'&gt; and its children:
-      Taskmaster: Evaluating &lt;pending    'prog.c'&gt;
+      Taskmaster:     Considering node &lt;no_state   0   'prog'&gt; and its children:
+      Taskmaster:        &lt;no_state   0   'prog.o'&gt;
+      Taskmaster:      adjusting ref count: &lt;pending    1   'prog'&gt;
+      Taskmaster:     Considering node &lt;no_state   0   'prog.o'&gt; and its children:
+      Taskmaster:        &lt;no_state   0   'prog.c'&gt;
+      Taskmaster:        &lt;no_state   0   'inc.h'&gt;
+      Taskmaster:      adjusting ref count: &lt;pending    1   'prog.o'&gt;
+      Taskmaster:      adjusting ref count: &lt;pending    2   'prog.o'&gt;
+      Taskmaster:     Considering node &lt;no_state   0   'prog.c'&gt; and its children:
+      Taskmaster: Evaluating &lt;pending    0   'prog.c'&gt;
       
       Taskmaster: Looking for a node to evaluate
-      Taskmaster:     Considering node &lt;no_state   'inc.h'&gt; and its children:
-      Taskmaster: Evaluating &lt;pending    'inc.h'&gt;
+      Taskmaster:     Considering node &lt;no_state   0   'inc.h'&gt; and its children:
+      Taskmaster: Evaluating &lt;pending    0   'inc.h'&gt;
       
       Taskmaster: Looking for a node to evaluate
-      Taskmaster:     Considering node &lt;pending    'prog.o'&gt; and its children:
-      Taskmaster:        &lt;up_to_date 'prog.c'&gt;
-      Taskmaster:        &lt;up_to_date 'inc.h'&gt;
-      Taskmaster: Evaluating &lt;pending    'prog.o'&gt;
+      Taskmaster:     Considering node &lt;pending    0   'prog.o'&gt; and its children:
+      Taskmaster:        &lt;up_to_date 0   'prog.c'&gt;
+      Taskmaster:        &lt;up_to_date 0   'inc.h'&gt;
+      Taskmaster: Evaluating &lt;pending    0   'prog.o'&gt;
       cc -o prog.o -c -I. prog.c
       
       Taskmaster: Looking for a node to evaluate
-      Taskmaster:     Considering node &lt;pending    'prog'&gt; and its children:
-      Taskmaster:        &lt;executed   'prog.o'&gt;
-      Taskmaster: Evaluating &lt;pending    'prog'&gt;
+      Taskmaster:     Considering node &lt;pending    0   'prog'&gt; and its children:
+      Taskmaster:        &lt;executed   0   'prog.o'&gt;
+      Taskmaster: Evaluating &lt;pending    0   'prog'&gt;
       cc -o prog prog.o
       
       Taskmaster: Looking for a node to evaluate