Issue 5167/6: Changes: show \markup xxx = ... \etc assignments

[lilypond.git] / Documentation / essay.tely

diff --git a/Documentation/essay.tely b/Documentation/essay.tely
index f77504bafe5d3da04cd1f48fad23e863658065a8..323e963521c5ee9dd23689537a256c77082cf21d 100644 (file)
--- a/Documentation/essay.tely
+++ b/Documentation/essay.tely
@@ -3,17 +3,34 @@
     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
 
     When revising a translation, copy the HEAD committish of the
-    version that you are working on.  See TRANSLATION for details.
+    version that you are working on.  For details, see the Contributors'
+    Guide, node Updating translation committishes..
 @end ignore
+
 @setfilename lilypond-essay.info
-@settitle GNU LilyPond Notation Reference
+@settitle Essay on automated music engraving
 @documentencoding UTF-8
 @documentlanguage en
+@afourpaper
+
+@macro manualIntro
+This essay discusses automatic music engraving functions within
+LilyPond version @version{}.
+@end macro
+
+@c `Essay' was born 2002-06-03 with this commit:
+@c tremolo segfault
+@c author: Han-Wen Nienhuys
+@c commit: 29262ca70c3d5209126150752fd3d804bef8e9a3
+@c   file: Documentation/user/introduction.itely
 
-@set web
+@macro copyrightDeclare
+Copyright @copyright{} 2002--2015 by the authors.
+@end macro
+
+@set FDL
 @include macros.itexi
 
-@afourpaper
 @c don't remove this comment.
 @ignore
 @omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen
@@ -23,86 +40,30 @@
 @omflanguage English
 @end ignore
 
-@ifnottex
-@node Top
-@top Essay on automated music engraving
-@end ifnottex
 
+@lilyTitlePage{Essay on automated music engraving}
 
-@ifhtml
-@ifclear bigpage
-This document is also available as a
-@uref{source/Documentation/essay.pdf,PDF} and as
-@uref{source/Documentation/essay-big-page.html,one big page}.
-@end ifclear
-@ifset bigpage
-This document is also available as a
-@uref{source/Documentation/essay.pdf,PDF} and as a
-@uref{source/Documentation/essay/index.html,HTML indexed multiple pages}.
-@end ifset
-@end ifhtml
-
-@finalout
-
-@titlepage
-@title LilyPond
-@subtitle The music typesetter
-@titlefont{Essay on automated music engraving}
-@author Han-Wen Nienhuys and Jan Nieuwenhuizen
-
-Copyright @copyright{} ???? by the authors
-
-@quotation
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
-or any later version published by the Free Software Foundation;
-with no Invariant Sections.
-A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
-@end quotation
-@end titlepage
-
-@copying
-Copyright @copyright{} ???? by the authors
-
-@quotation
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
-or any later version published by the Free Software Foundation;
-with no Invariant Sections.
-A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
-@end quotation
-@end copying
 
 @ifnottex
-Copyright ???? by the authors
-
-@quotation
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1
-or any later version published by the Free Software Foundation;
-with no Invariant Sections.
-A copy of the license is included in the section entitled ``GNU
-Free Documentation License''.
-@end quotation
-@end ifnottex
 
 @menu
 * Music engraving::
-* automated-engraving:: Essay on Automated engraving.
 * Literature list::
 * GNU Free Documentation License:: License of this document.
 * LilyPond index::
 @end menu
 
+@docMain
+@end ifnottex
+
+
 @contents
 
+@allowcodebreaks false
+
 @include essay/engraving.itely
-@include automated-engraving.itexi
 @include essay/literature.itely
 
-@clear web
 @include fdl.itexi
 
 @node LilyPond index