X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=8d2ca906d8a3f986259bf7c824ed26321ee9f493;hb=1423508c355989fa26a8cfe5985b0d6e1ab0a538;hp=c470c50127c7c7cc3fc8a30d70c78acb3897ba79;hpb=c14fbcd481f9f637b2cfe8318ff818c01892214a;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index c470c50127..8d2ca906d8 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -6,24 +6,19 @@ 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 Distributions will want to install lilypond.info in postinstall, doing: - install-info --info-dir=/usr/share/info out/lilypond.info + install-info --info-dir=/usr/share/info out[-www]/lilypond.info * Prepend GNU for dir, must be unique. @@ -38,32 +33,51 @@ Distributions will want to install lilypond.info in postinstall, doing: @c -@c Info files are installed in subdirectories to allow images to be present. -@c -@dircategory LilyPond +@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 @direntry -* LilyPond: (lilypond/lilypond). The GNU music typesetter. -* abc2ly: (lilypond/lilypond-program)Invoking abc2ly. Importing ABC. -* convert-ly: (lilypond/lilypond-program)Invoking convert-ly. Older LilyPond versions. -* etf2ly: (lilypond/lilypond-program)Invoking etf2ly. Importing Finale. -* lilypond-book: (lilypond/lilypond-program)LilyPond-book. Integrating text and music. -* midi2ly: (lilypond/lilypond-program)Invoking midi2ly. Importing MIDI. +* LilyPond Learning Manual: (lilypond-learning). Start here. +* Music Glossary: (music-glossary). For non-English users. +* LilyPond: (lilypond). LilyPond Notation Reference. +* LilyPond Internals Reference: (lilypond-internals). Definitions for tweaking. +* LilyPond Application Usage: (lilypond-program). Installing and running applications. +* abc2ly: (lilypond-program)Invoking abc2ly. Importing ABC. +* convert-ly: (lilypond-program)Updating files with convert-ly. Older LilyPond versions. +* etf2ly: (lilypond-program)Invoking etf2ly. Importing Finale. +* lilypond-book: (lilypond-program)LilyPond-book. Integrating text and music. +* midi2ly: (lilypond-program)Invoking midi2ly. Importing MIDI. +* musicxml2ly: (lilypond-program)Invoking musicxml2ly. Importing MusicXML. @end direntry @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 @@ -77,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 @@ -93,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 @@ -126,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 @@ -139,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 @@ -159,9 +154,12 @@ of this and other documentation. @menu * Musical notation:: Musical notation. -* Changing defaults:: Tuning output. -* Non-musical notation:: Output that is not musical notation. +* Specialist notation:: Notation which is only used for + specific purposes. +* 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. Appendices @@ -169,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:: @@ -178,29 +177,53 @@ Appendices @contents -@include macros.itexi - @include notation.itely +@include specialist.itely -@include changing-defaults.itely -@include non-music.itely +@include input.itely @include spacing.itely + +@include changing-defaults.itely @include programming-interface.itely @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 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 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 @bye