Re: Doc: CG Update compile.itexi for doc build (issue 5967060)

[pkx166h]

Reviewers: Julien Rioux, Trevor Daniels,

Message:
committer       James Lowe <address@hidden>       
Sun, 8 Apr 2012 10:53:06 +0000 (11:53 +0100)
commit  539eb86b35a1269be607c4554b0fae6aa8d897ec

Description:
Doc: CG Update compile.itexi for doc build

Issue 2416

There should no longer be a need to 'touch' soe files when
wanting to rebuild doc after making changes.

Removed @knownissue describing this.

Edited next para so it made syntactical sense running on from the
now previous para.

Please review this at http://codereview.appspot.com/5967060/

Affected files:
  M Documentation/included/compile.itexi


Index: Documentation/included/compile.itexi
diff --git a/Documentation/included/compile.itexi  
b/Documentation/included/compile.itexi
index  
c3aa45de1cffeaaae70ba9c589b04c9e68eec87c..933f5c9829e3789f9df86369d1de9844d66df2a2  
100644
--- a/Documentation/included/compile.itexi
+++ b/Documentation/included/compile.itexi
@@ -672,53 +672,10 @@ done separately by issuing:
 make info
 @end example

address@hidden
-
-If source files have changed since the last documentation build,
-output files that need to be rebuilt are normally rebuilt, even if
-you do not run @address@hidden first.  However, build
-dependencies in the documentation are so complex that some
-newly-edited files may not be rebuilt as they should be; a
-workaround is to @command{touch} the top source file for any
-manual you've edited.  For example, if you make changes to a file
-in @file{notation/}, do:
-
address@hidden
-touch Documentation/notation.tely
address@hidden example
-
address@hidden
-The top sources possibly affected by this are:
-
address@hidden
-Documentation/extend.texi
-Documentation/changes.tely
-Documentation/contributor.texi
-Documentation/essay.tely
-Documentation/extending.tely
-Documentation/learning.tely
-Documentation/notation.tely
-Documentation/snippets.tely
-Documentation/usage.tely
-Documentation/web.texi
address@hidden example
-
address@hidden
-You can @command{touch} all of them at once with:
-
address@hidden
-touch Documentation/*te??
address@hidden example
-
address@hidden
-However, this will rebuild all of the manuals
-indiscriminately---it is more efficient to @command{touch} only
-the affected files.
-
 @noindent
-Another typical issue when switching branches between master and
-lilypond/translation is the appearance/disappearance of translated
-versions of some manuals.  If you see such a warning from make:
+An issue when switching branches between master and lilypond/translation
+is the appearance/disappearance of translated versions of some manuals.
+If you see such a warning from make:

 @example
 No rule to make target `X', needed by `Y'