]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc: use title page macro for other manuals.
authorGraham Percival <graham@percival-music.ca>
Sun, 6 Sep 2009 07:39:08 +0000 (08:39 +0100)
committerGraham Percival <graham@percival-music.ca>
Sun, 6 Sep 2009 23:05:25 +0000 (00:05 +0100)
Documentation/application.tely
Documentation/contributor.texi
Documentation/essay.tely
Documentation/learning.tely
Documentation/notation.tely

index aae341afcf035b2c877c60f84a72e6a8bd0717ed..eec87cb22dad537f7d7abe7dce3c1be58d466d82 100644 (file)
@@ -5,17 +5,20 @@
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
+
 @setfilename lilypond-application.info
 @settitle GNU LilyPond Application usage
 @documentencoding UTF-8
 @documentlanguage en
 
+@macro manualIntro
+This file explains how to execute the programs distributed with
+GNU LilyPond version @version{}.  In addition, it suggests some
+@qq{best practices} for efficient usage.
+@end macro
+
 @include macros.itexi
-@c  This produces the unified index
-@syncodeindex fn cp
-@syncodeindex vr cp
 
-@afourpaper
 
 @c don't remove this comment.
 @ignore
 @end ignore
 
 
-@copying
-Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, 2005,
-2006, 2007, 2008, 2009 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
-
-@macro introText
-@cartouche
-This file explains how to execute the programs distributed with
-GNU LilyPond version @version{}.  In addition, it suggests some
-@qq{best practices} for efficient usage.
-@end cartouche
-@end macro
-
-
-@c TITLE PAGE
-@ifnottex
-@node Top
-@top GNU LilyPond --- Application Usage
-@end ifnottex
-
-@finalout
-
-@titlepage
-@title LilyPond
-@subtitle The music typesetter
-@titlefont{Application Usage}
-@author The LilyPond development team
-
-@vskip 100pt
-
-@introText{}
-
-@vskip 0pt plus 1filll
-@c @vskip 20pt
-
-@insertcopying{}
-
-For LilyPond version @version{}
-@end titlepage
+@lilyTitlePage{Usage}
 
 
 @c TOC -- non-tex
-
 @ifnottex
-@introText{}
 
 @c  maybe add a "Tasks" or "Specific tasks" or something like
 @c  that, after Suggestions  -gp
@@ -96,9 +50,10 @@ Appendices
 * GNU Free Documentation License:: License of this document.
 * LilyPond index::
 @end menu
-@end ifnottex
 
 @docMain
+@end ifnottex
+
 
 @contents
 
index 4cc96c144006eb47e8f1d9286eb1224b696b4d72..b4db2d5ac78e6f80c92f0daca06b859ddeb7d38d 100644 (file)
@@ -30,7 +30,7 @@ contributors should follow.
 @end ignore
 
 
-@lilyTitlePage{Learning Manual}
+@lilyTitlePage{Contributor's Guide}
 
 
 @c TOC -- non-tex
@@ -46,6 +46,10 @@ contributors should follow.
 * Regression tests::
 * Programming work::
 * Release work::
+
+Appendices
+
+* GNU Free Documentation License:: License of this document.
 @end menu
 
 @docMain
@@ -64,5 +68,7 @@ contributors should follow.
 @include contributor/programming-work.itexi
 @include contributor/release-work.itexi
 
+@include fdl.itexi
+
 @bye
 
index f77504bafe5d3da04cd1f48fad23e863658065a8..5f6bd57d58e1c27ccf71b687938499c8b060e0c6 100644 (file)
@@ -5,12 +5,17 @@
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
+
 @setfilename lilypond-essay.info
-@settitle GNU LilyPond Notation Reference
+@settitle LilyPond Notation Reference
 @documentencoding UTF-8
 @documentlanguage en
 
-@set web
+@macro manualIntro
+This essay discusses automatic music engraving functions within
+GNU LilyPond version @version{}.
+@end macro
+
 @include macros.itexi
 
 @afourpaper
 @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::
@@ -95,6 +41,8 @@ Free Documentation License''.
 * GNU Free Documentation License:: License of this document.
 * LilyPond index::
 @end menu
+@end ifnottex
+
 
 @contents
 
index 4537466ade455f5e139ca9d1b5f2a876807885b1..69a7522fdd740db5f889ea0f939c2fc595ffeb0b 100644 (file)
@@ -5,17 +5,19 @@
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
+
 @setfilename lilypond-learning.info
-@settitle GNU LilyPond Learning Manual
+@settitle LilyPond Learning Manual
 @documentencoding UTF-8
 @documentlanguage en
 
+@macro manualIntro
+This file provides an introduction to GNU LilyPond version
+@version{}.
+@end macro
+
 @include macros.itexi
-@c  This produces the unified index
-@syncodeindex fn cp
-@syncodeindex vr cp
 
-@afourpaper
 
 @c don't remove this comment.
 @ignore
 @end ignore
 
 
-@copying
-Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, 2005,
-2006, 2007, 2008, 2009 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
-
-@macro introText
-@cartouche
-This file provides an introduction to GNU LilyPond version
-@version{}.
-@end cartouche
-@end macro
-
-
-@c TITLE PAGE
-@ifnottex
-@node Top
-@top GNU LilyPond --- Learning Manual
-@end ifnottex
-
-@finalout
-
-@titlepage
-@title LilyPond
-@subtitle The music typesetter
-@titlefont{Learning Manual}
-@author The LilyPond development team
-
-@vskip 100pt
-
-@introText{}
-
-@vskip 0pt plus 1filll
-@c @vskip 20pt
-
-@insertcopying{}
-
-For LilyPond version @version{}
-@end titlepage
-
+@lilyTitlePage{Learning Manual}
 
 @c TOC -- non-tex
-
 @ifnottex
-@introText{}
 
 @menu
 * Introduction::                   Basics of typesetting with LilyPond.
@@ -95,9 +48,8 @@ Appendices
 * LilyPond index::
 @end menu
 
-@end ifnottex
-
 @docMain
+@end ifnottex
 
 
 @c TOC - tex
index 2489b1a05919d2903ed236d9f69cbf66ad3f3231..cc7810e861257e22507501d8e81eb453cca8b704 100644 (file)
@@ -5,15 +5,22 @@
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
+
 @setfilename lilypond-notation.info
-@settitle GNU LilyPond Notation Reference
+@settitle LilyPond Notation Reference
 @documentencoding UTF-8
 @documentlanguage en
 
-@include macros.itexi
+@macro manualIntro
+This manual provides a reference for all notation that can be
+produced with GNU LilyPond version @version{}.  It assumes that
+the reader is familiar with the material in the
+@rlearningnamed{Top, Learning Manual}.
+@end macro
 
-@afourpaper
+@include macros.itexi
 
+@c  TODO: all the direntry stuff should be moved to general.texi
 @c  Keep this here, since it pertains to the direntry below.
 @ignore
 Distributions will want to install lilypond.info in postinstall, doing:
@@ -31,8 +38,6 @@ Distributions will want to install lilypond.info in postinstall, doing:
 @c    LilyPond  program.
 @end ignore
 
-
-@c
 @c Info files are no longer installed in a subdirectory, images are
 @c expected to be found in lilypond/ subdirectory.
 @dircategory GNU LilyPond --- the music typesetter
@@ -60,99 +65,11 @@ Distributions will want to install lilypond.info in postinstall, doing:
 @omflanguage English
 @end ignore
 
-@ifnottex
-@node Top
-@top GNU LilyPond --- Notation Reference
-@chapheading The music typesetter
-@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
-@end ifnottex
-
-
-@ifhtml
-@ifclear bigpage
-This document is also available as a
-@uref{source/Documentation/notation.pdf,PDF} and as
-@uref{source/Documentation/notation-big-page.html,one big page}.
-@end ifclear
-@ifset bigpage
-This document is also available as a
-@uref{source/Documentation/notation.pdf,PDF} and as a
-@uref{source/Documentation/notation/index.html,HTML indexed multiple pages}.
-@end ifset
-@end ifhtml
-
-
-@c  This produces the unified index
-@syncodeindex fn cp
-@syncodeindex vr cp
-
-
-@finalout
-
-@titlepage
-@title LilyPond
-@subtitle The music typesetter
-@titlefont{Notation Reference}
-@author The LilyPond development team
-
-Copyright @copyright{} 1999--2009 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
+@lilyTitlePage{Notation Reference}
 
-@vskip 20pt
-
-For LilyPond version @version{}
-@end titlepage
-
-@copying
-Copyright @copyright{} 1999--2009 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
-This file documents GNU LilyPond.
-
-Copyright 1999--2009 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
-
-@ifnottex
-This is the Notation Reference (NR) for GNU LilyPond version @version{}.
-For more information about how this fits with the other
-documentation, see
-FIXME FIXME FIXME 
-@c @rlearning{About the documentation}.
-
-@cindex web site
-@cindex URL
-
-More information can be found at
-@uref{http://@/www@/.lilypond@/.org/}.  The website contains on-line copies
-of this and other documentation.
-
 
 @menu
 * Musical notation::               Notation which is used in
@@ -174,8 +91,9 @@ Appendices
 * LilyPond command index::
 * LilyPond index::
 @end menu
+
+@docMain
 @end ifnottex
-@c * Literature list::                Reference works about music notation.
 
 @contents
 
@@ -190,10 +108,11 @@ Appendices
 @include notation/programming-interface.itely
 
 
-@c @include notation/literature.itely
 @include notation/notation-appendices.itely
 @include notation/cheatsheet.itely
 
+
+
 @node LilyPond grammar
 @appendix LilyPond grammar
 
@@ -202,8 +121,10 @@ output from the parser.
 
 @verbatiminclude ly-grammar.txt
 
+
 @include fdl.itexi
 
+
 @node LilyPond command index
 @appendix LilyPond command index