Tom Tanner committed 0ae0a8c

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

Comments (0)

Files changed (2)


+<?xml version="1.0" encoding="UTF-8"?>
+<screen xmlns="" xmlns:xsi="" xsi:schemaLocation=" scons.xsd">% <userinput>scons -Q --warn=target-not-built</userinput>
+scons: building `file.out' because it doesn't exist
+cp file.oout
+scons: warning: Cannot find target file.out after building


 <!DOCTYPE sconsdoc [
     <!ENTITY % scons SYSTEM "../scons.mod">
     <!ENTITY % builders-mod SYSTEM "../generated/builders.mod">
     <!ENTITY % functions-mod SYSTEM "../generated/functions.mod">
     that something was wrong with
     the command that we invoked to build it.
+    <para>
+    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>
+    <para>
+    <scons_output example="troubleshoot_explain1" os="posix" suffix="3">
+      <scons_output_command>scons -Q --warn=target-not-built</scons_output_command>
+    </scons_output>
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.