summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorWilliam Deegan <bill@baddogconsulting.com>2017-10-20 20:40:59 (GMT)
committerWilliam Deegan <bill@baddogconsulting.com>2017-10-20 20:40:59 (GMT)
commitf335e6b2af2f554da43d4ae7896bc8fa3a487be7 (patch)
tree41986d1296089a17984af09fe07dce00eb691c01 /doc
parent9d1dbea5f930d2c86430ddc58eadaa24d0b47803 (diff)
downloadSCons-f335e6b2af2f554da43d4ae7896bc8fa3a487be7.zip
SCons-f335e6b2af2f554da43d4ae7896bc8fa3a487be7.tar.gz
SCons-f335e6b2af2f554da43d4ae7896bc8fa3a487be7.tar.bz2
Add printing time processing each SConscript when --debug=time is specified on command line
Diffstat (limited to 'doc')
-rw-r--r--doc/man/scons.xml23
1 files changed, 14 insertions, 9 deletions
diff --git a/doc/man/scons.xml b/doc/man/scons.xml
index 1f99753..1f38b5d 100644
--- a/doc/man/scons.xml
+++ b/doc/man/scons.xml
@@ -853,14 +853,18 @@ and ultimately removed.</para>
<varlistentry>
<term>--debug=time</term>
<listitem>
-<para>Prints various time profiling information:
-the time spent executing each individual build command;
-the total build time (time SCons ran from beginning to end);
-the total time spent reading and executing SConscript files;
-the total time spent SCons itself spend running
-(that is, not counting reading and executing SConscript files);
-and both the total time spent executing all build commands
-and the elapsed wall-clock time spent executing those build commands.
+<para>Prints various time profiling information:</para>
+<itemizedlist>
+<listitem>The time spent executing each individual build command</listitem>
+<listitem>The total build time (time SCons ran from beginning to end)</listitem>
+<listitem>The total time spent reading and executing SConscript files</listitem>
+<listitem>The total time spent SCons itself spend running
+(that is, not counting reading and executing SConscript files)</listitem>
+<listitem>The total time spent executing all build commands</listitem>
+<listitem>The elapsed wall-clock time spent executing those build commands</listitem>
+<listitem>The time spent processing each file passed to the <emphasis>SConscript()</emphasis> function</listitem>
+</itemizedlist>
+<para>
(When
<command>scons</command>
is executed without the
@@ -884,7 +888,8 @@ be significantly smaller than the
total time spent executing all the build commands,
since multiple build commands and
intervening SCons processing
-should take place in parallel.)</para>
+should take place in parallel.)
+</para>
</listitem>
</varlistentry>