X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=8d2ca906d8a3f986259bf7c824ed26321ee9f493;hb=1423508c355989fa26a8cfe5985b0d6e1ab0a538;hp=0631951f5ae237ab2a5e22c3f9c1008e4eea1073;hpb=3dd560c0c440c9e97730ca13f6d5abbb020bb02e;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index 0631951f5a..8d2ca906d8 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -6,18 +6,13 @@ version that you are working on. See TRANSLATION for details. @end ignore @setfilename lilypond.info -@settitle GNU LilyPond user manual +@settitle GNU LilyPond Notation Reference @documentencoding UTF-8 @documentlanguage en -@iftex +@include macros.itexi + @afourpaper -@c don't replace quotes with directed quotes -@tex -\gdef\SETtxicodequoteundirected{Foo} -\gdef\SETtxicodequotebacktick{Bla} -@end tex -@end iftex @c Keep this here, since it pertains to the direntry below. @ignore @@ -58,17 +53,31 @@ Distributions will want to install lilypond.info in postinstall, doing: @c don't remove this comment. @ignore @omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival -@omfdescription User manual of the LilyPond music engraving system +@omfdescription Notation Reference of the LilyPond music engraving system @omftype user manual @omfcategory Applications|Publishing @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/user/lilypond.pdf,PDF} and as @uref{source/Documentation/user/lilypond-big-page.html,one big page}. +@end ifclear +@ifset bigpage +This document is also available as a +@uref{source/Documentation/user/lilypond.pdf,PDF} and as a +@uref{source/Documentation/user/lilypond/index.html,HTML indexed multiple pages}. +@end ifset @end ifhtml @@ -82,10 +91,10 @@ This document is also available as a @titlepage @title LilyPond @subtitle The music typesetter -@titlefont{User manual} +@titlefont{Notation Reference} @author The LilyPond development team -Copyright @copyright{} 1999--2007 by the authors +Copyright @copyright{} 1999--2009 by the authors @quotation Permission is granted to copy, distribute and/or modify this document @@ -98,25 +107,11 @@ Free Documentation License''. @vskip 20pt -@lilypond[ragged-right] -\score { - \context Lyrics { - \override Score.RehearsalMark #'self-alignment-X = #LEFT - \override Score.RehearsalMark #'font-size = #-2 - \mark #(ly:export (string-append - "(For LilyPond version " (lilypond-version) ")")) - s2 - } - \layout { - indent = 0.0\pt - } -} -@end lilypond - +For LilyPond version @version{} @end titlepage @copying -Copyright @copyright{} 1999--2007 by the authors +Copyright @copyright{} 1999--2009 by the authors @quotation Permission is granted to copy, distribute and/or modify this document @@ -131,7 +126,7 @@ Free Documentation License''. @ifnottex This file documents GNU LilyPond. -Copyright 1999--2007 by the authors +Copyright 1999--2009 by the authors @quotation Permission is granted to copy, distribute and/or modify this document @@ -144,14 +139,9 @@ Free Documentation License''. @end ifnottex @ifnottex -@node Top -@top GNU LilyPond --- The music typesetter -@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX. - -This is the user manual for GNU LilyPond 2.11.x series. -@ifhtml -(See the bottom of this page for the exact version number). -@end ifhtml +This is the Notation Reference (NR) for GNU LilyPond version @version{}. +For more information about how this fits with the other +documentation, see @rlearning{About the documentation}. @cindex web site @cindex URL @@ -166,9 +156,8 @@ of this and other documentation. * Musical notation:: Musical notation. * Specialist notation:: Notation which is only used for specific purposes. -* Input syntax:: General information about - lilypond input files. -* Non-musical notation:: Output that is not musical notation. +* General input and output:: General information about + LilyPond input and output. * Spacing issues:: Display of output on paper. * Changing defaults:: Tuning output. * Interfaces for programmers:: Expert usage. @@ -178,6 +167,7 @@ Appendices * Literature list:: Reference works about music notation. * Notation manual tables:: Tables and charts. * Cheat sheet:: Summary of LilyPond syntax. +* LilyPond grammar:: Syntax diagram for LilyPond parser. * GNU Free Documentation License:: License of this document. * LilyPond command index:: * LilyPond index:: @@ -187,13 +177,10 @@ Appendices @contents -@include macros.itexi - @include notation.itely @include specialist.itely @include input.itely -@include non-music.itely @include spacing.itely @include changing-defaults.itely @@ -203,19 +190,39 @@ Appendices @include literature.itely @include notation-appendices.itely @include cheatsheet.itely + +@node LilyPond grammar +@appendix LilyPond grammar + +This appendix contains a description of the LilyPond grammar, as +output from the parser. + +@verbatiminclude ly-grammar.txt + @include fdl.itexi @node LilyPond command index @appendix LilyPond command index -This index does blah blah blah. +This index lists all the LilyPond commands and keywords with links +to those sections of the manual which describe or discuss their +use. Each link is in two parts. The first part points to the +exact location in the manual where the command or keyword appears; +the second part points to the start of the section of the manual +in which the command or keyword appears. @printindex ky @node LilyPond index @appendix LilyPond index -In contrast, this index does blaz blaz blaz. +In addition to all the LilyPond commands and keywords, this index +lists musical terms and words which relate to each of them, with +links to those sections of the manual which describe or discuss +that topic. Each link is in two parts. The first part points to +the exact location in the manual where the topic appears; the +second part points to the start of the section of the manual where +that topic is discussed. @printindex cp