2 files changed, 20 insertions, 21 deletions
diff --git a/doc/texi/building/chapter.overview.texi b/doc/texi/building/chapter.overview.texi
deleted file mode 100644
index 29dec0394..000000000
--- a/doc/texi/building/chapter.overview.texi
+++ /dev/null
@@ -1,21 +0,0 @@
-@anchor{overview}
-@chapter Build Overview
-The build system has several
-
-This chapter is for building from a terminal/shell environment in as few commands as possible. If more flexibility is required you should skip this chapter and jump to @ref{process}.
-
-@example
-[email protected]{}
-./configure --launch
-@end example
-
-The special option @command{--launch} selected launch mode and performs the following steps:
-
-@itemize
-@item assert scratch directory @file{build/} does not exist
-@item create scratch directory @file{build/}
-@item change to directory @file{build/}
-@item launch @command{make}
-@item capture build output to @file{build/log.txt}
-@item echo build output
-@end itemize
diff --git a/doc/texi/building/chapter.troubleshooting.texi b/doc/texi/building/chapter.troubleshooting.texi
new file mode 100644
index 000000000..4d42e76a3
--- /dev/null
+++ b/doc/texi/building/chapter.troubleshooting.texi
@@ -0,0 +1,20 @@
+@anchor{troubleshooting}
+@chapter Troubleshooting
+When troubleshooting build issues, the following files relative to the @file{build/} directory may be especially useful:
+
+@table @file
+@item GNUmakefile
+Top-level makefile which contains build settings generated via @b{configure}.
+
+@item log/config.info.txt
+Record of output from @b{configure}.
+
+@item log/config.verbose.txt
+Record of verbose output from @b{configure}.
+
+@item log/build.txt
+Record of output from @command{configure --launch}. Similar output may be recorded using @command{make} depending on which shell is in use, eg: @command{make >& log/build.txt} or @command{make > log/build.txt 2>&1}.
+
+@item log/xcodemake.env.txt
+Environment (variables) dump as seen when Xcode forks @command{make}. @value{OS.osx} only.
+@end table