From: Graham Percival Date: Sun, 6 Sep 2009 07:39:08 +0000 (+0100) Subject: Doc: use title page macro for other manuals. X-Git-Tag: release/2.13.4-1~68 X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=c180877fdc1442afbce5e1b9ff0ee6a81c312cce;p=lilypond.git Doc: use title page macro for other manuals. --- diff --git a/Documentation/application.tely b/Documentation/application.tely index aae341afcf..eec87cb22d 100644 --- a/Documentation/application.tely +++ b/Documentation/application.tely @@ -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 @@ -27,60 +30,11 @@ @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 diff --git a/Documentation/contributor.texi b/Documentation/contributor.texi index 4cc96c1440..b4db2d5ac7 100644 --- a/Documentation/contributor.texi +++ b/Documentation/contributor.texi @@ -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 diff --git a/Documentation/essay.tely b/Documentation/essay.tely index f77504bafe..5f6bd57d58 100644 --- a/Documentation/essay.tely +++ b/Documentation/essay.tely @@ -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 @@ -23,70 +28,11 @@ @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 diff --git a/Documentation/learning.tely b/Documentation/learning.tely index 4537466ade..69a7522fdd 100644 --- a/Documentation/learning.tely +++ b/Documentation/learning.tely @@ -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 @@ -27,59 +29,10 @@ @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 diff --git a/Documentation/notation.tely b/Documentation/notation.tely index 2489b1a059..cc7810e861 100644 --- a/Documentation/notation.tely +++ b/Documentation/notation.tely @@ -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