diff options
| author | William Deegan <bill@baddogconsulting.com> | 2019-12-10 16:24:13 (GMT) |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-12-10 16:24:13 (GMT) |
| commit | 00c82b641c13ede400982f51b75f01938c99353b (patch) | |
| tree | 2a217fa865d49438b730b4f2472f168719d726ac /doc/man | |
| parent | dc8aaebf2271cbd78edeeda923ce2c8acd67f946 (diff) | |
| parent | 392d323e36bf8c80c7a6d43160148359cfae8ff6 (diff) | |
| download | SCons-00c82b641c13ede400982f51b75f01938c99353b.zip SCons-00c82b641c13ede400982f51b75f01938c99353b.tar.gz SCons-00c82b641c13ede400982f51b75f01938c99353b.tar.bz2 | |
Merge branch 'master' into py3-doctasks
Diffstat (limited to 'doc/man')
| -rw-r--r-- | doc/man/scons.xml | 57 |
1 files changed, 18 insertions, 39 deletions
diff --git a/doc/man/scons.xml b/doc/man/scons.xml index 01f38d1..a7327ea 100644 --- a/doc/man/scons.xml +++ b/doc/man/scons.xml @@ -686,19 +686,32 @@ option except for the way default targets are handled. When this option is used and no targets are specified on the command line, all default targets are built, whether or not they are below the current directory.</para> - </listitem> </varlistentry> + <varlistentry> - <term>--debug=<emphasis>type</emphasis></term> + <term>--debug=<replaceable>type</replaceable>[<replaceable>,type</replaceable>...]</term> <listitem> <para>Debug the build process. -<emphasis>type[,type...]</emphasis> -specifies what type of debugging. Multiple types may be specified, -separated by commas. The following types are valid:</para> +<emphasis>type</emphasis> +specifies the kind of debugging info to emit. +Multiple types may be specified, separated by commas. +The following entries show the recognized types:</para> + </listitem> + </varlistentry> + <varlistentry> + <term>--debug=action-timestamps</term> + <listitem> +<para>Prints additional time profiling information. For +each command, shows the absolute start and end times. +This may be useful in debugging parallel builds. +Implies the <option>--debug=time</option> option. +</para> +<para>Since &scons; 3.1.</para> </listitem> </varlistentry> + <varlistentry> <term>--debug=count</term> <listitem> @@ -893,40 +906,6 @@ should take place in parallel.) </listitem> </varlistentry> -<varlistentry> - <term>--debug=action_timestamps</term> - <listitem> - <para>Prints additional time profiling information:</para> - <itemizedlist> - <listitem> - <para>The time spent executing each individual build command</para> - </listitem> - <listitem> - <para>The total build time (time SCons ran from beginning to end)</para> - </listitem> - <listitem> - <para>The total time spent reading and executing SConscript files</para> - </listitem> - <listitem> - <para>The total time spent SCons itself spend running -(that is, not counting reading and executing SConscript files)</para> - </listitem> - <listitem> - <para>The total time spent executing all build commands</para> - </listitem> - <listitem> - <para>The elapsed wall-clock time spent executing those build commands</para> - </listitem> - <listitem> - <para>The absolute start and end wall-clock time spent executing those build commands</para> - </listitem> - <listitem> - <para>The time spent processing each file passed to the <emphasis>SConscript()</emphasis> function</para> - </listitem> - </itemizedlist> - </listitem> -</varlistentry> - <varlistentry> <term>--diskcheck=<emphasis>types</emphasis></term> <listitem> |