From: Phil Holmes <mail@philholmes.net>
Date: Wed, 13 Jun 2012 15:22:29 +0000 (+0100)
Subject: Creates make log-clean and documents it
X-Git-Tag: release/2.15.41-1~40
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=a201640e7109588c5feb1efa93484928ce565642;p=lilypond.git

Creates make log-clean and documents it
---

diff --git a/Documentation/included/compile.itexi b/Documentation/included/compile.itexi
index b9cfb9c45f..eb24c59180 100644
--- a/Documentation/included/compile.itexi
+++ b/Documentation/included/compile.itexi
@@ -616,9 +616,11 @@ make [-j@var{X} CPU_COUNT=@var{X}] doc  @emph{## usually faster than initial bui
 @item
 Reset:
 
-In some cases, it is possible to clean the compiled documentation
-with @samp{make@tie{}doc-clean}, but this method is not guaranteed
-to fix everything.  Instead, we recommend that you delete your
+It is generally possible to remove the compiled documentation from
+your system
+with @samp{make@tie{}doc-clean}, but this method is not 100%
+guaranteed.  Instead, if you want to be sure you have a clean
+system, we recommend that you delete your
 @file{build/} directory, and begin compiling from scratch.  Since
 the documentation compile takes much longer than the
 non-documentation compile, this does not increase the overall time
@@ -660,9 +662,20 @@ the docs.  Please do not complain about anything which is broken
 in those places; the only complete set of documentation is in
 @file{out-www/offline-root/} from the top of the source tree.
 
-@code{make doc} compiles the documents for all languages.  To save
-some compile time, the English language documents can be compiled
-on their own with:
+@command{make@tie{}doc} sends the output from most of the
+compilation to logfiles.  If the build fails for any reason, it
+should prompt you with the name of a logfile which will provide
+information to help you work out why the build failed.  These
+logfiles are not deleted with @command{make@tie{}doc-clean}.  To
+remove all the logfiles generated by the compilation process, use:
+
+@example
+make log-clean
+@end example
+
+@code{make@tie{}doc} compiles the documents for all languages.  To
+save some compile time, the English language documents can be
+compiled on their own with:
 
 @example
 make LANGS='' doc
diff --git a/stepmake/stepmake/generic-targets.make b/stepmake/stepmake/generic-targets.make
index fa7dc2e104..9a51aaa728 100644
--- a/stepmake/stepmake/generic-targets.make
+++ b/stepmake/stepmake/generic-targets.make
@@ -1,5 +1,6 @@
 .PHONY : all clean bin-clean config default dist exe help html lib TAGS\
-	 po doc doc-stage-1 WWW-1 WWW-2 WWW-post local-WWW-1 local-WWW-2
+	 po doc doc-stage-1 WWW-1 WWW-2 WWW-post local-WWW-1 local-WWW-2\
+	 log-clean
 
 all:	 default
 	$(LOOP)
@@ -14,6 +15,9 @@ clean: local-clean
 	-rm -rf $(outdir)
 	$(LOOP)
 
+log-clean:
+	find . -name "*.log" -delete
+
 ifeq (,$(findstring metafont,$(STEPMAKE_TEMPLATES)))
 bin-clean: local-bin-clean
 	-rm -rf $(outdir)