1. SCons
  2. Core
  3. SCons


Gary Oberbrunner  committed 3e206cf Merge

Merged in thosrtanner/trt_scons_missing_doc (pull request #95)

Add some information about --warn=target-not-built to the troubleshooting

  • Participants
  • Parent commits 8e42d86, cbaef35
  • Branches default

Comments (0)

Files changed (2)

File doc/generated/examples/troubleshoot_explain1_3.xml

View file
+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="http://www.scons.org/dbxsd/v1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.scons.org/dbxsd/v1.0/scons.xsd scons.xsd">% <userinput>scons -Q --warn=target-not-built</userinput>
+scons: building `file.out' because it doesn't exist
+cp file.in file.oout
+scons: warning: Cannot find target file.out after building

File doc/user/troubleshoot.xml

View file
 <!DOCTYPE sconsdoc [
     <!ENTITY % scons SYSTEM "../scons.mod">
     <!ENTITY % builders-mod SYSTEM "../generated/builders.mod">
     <!ENTITY % functions-mod SYSTEM "../generated/functions.mod">
+    Note that you can also use --warn=target-not-built which checks
+    whether or not expected targets exist after a build rule is
+    executed.
+    </para>
+    <scons_output example="troubleshoot_explain1" os="posix" suffix="3">
+      <scons_output_command>scons -Q --warn=target-not-built</scons_output_command>
+    </scons_output>
+    <para>
     The &debug-explain; option also comes in handy
     to help figure out what input file changed.