X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=e5680ee7d5fbb0acba6fff2431164659d185bc9a;hb=30e462f74757398c1146564089ec78aff3c19b65;hp=7e5f04918588b0ece6e36d7d8edad6288f3684a3;hpb=ac1340846e81661575ba3036b251e8ab55b13023;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index 7e5f049185..e5680ee7d5 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -6,16 +6,26 @@ version that you are working on. See TRANSLATION for details. @end ignore @setfilename lilypond.info -@settitle GNU LilyPond +@settitle GNU LilyPond Notation Reference +@documentencoding UTF-8 +@documentlanguage en + +@include macros.itexi + @iftex @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. @@ -30,32 +40,44 @@ 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)Invoking abc2ly. Importing ABC. -* convert-ly: (lilypond/lilypond)Invoking convert-ly. Older LilyPond versions. -* etf2ly: (lilypond/lilypond)Invoking etf2ly. Importing Finale. -* lilypond-book: (lilypond/lilypond)LilyPond-book. Itegrating text and music. -* midi2ly: (lilypond/lilypond)Invoking midi2ly. Importing MIDI. -* mup2ly: (lilypond/lilypond)Invoking mup2ly. Importing Mup. +* 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 This document is also available as a -@uref{source/Documentation/user/lilypond.pdf,PDF}. +@uref{source/Documentation/user/lilypond.pdf,PDF} and as +@uref{source/Documentation/user/lilypond-big-page.html,one big page}. @end ifhtml @@ -63,20 +85,16 @@ This document is also available as a @syncodeindex fn cp @syncodeindex vr cp -@documentlanguage en -@documentencoding utf-8 - @finalout @titlepage @title LilyPond @subtitle The music typesetter +@titlefont{Notation Reference} @author The LilyPond development team - - -Copyright @copyright{} 1999--2006 by the authors +Copyright @copyright{} 1999--2008 by the authors @quotation Permission is granted to copy, distribute and/or modify this document @@ -89,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--2006 by the authors +Copyright @copyright{} 1999--2008 by the authors @quotation Permission is granted to copy, distribute and/or modify this document @@ -122,7 +126,7 @@ Free Documentation License''. @ifnottex This file documents GNU LilyPond. -Copyright 1999--2006 by the authors +Copyright 1999--2008 by the authors @quotation Permission is granted to copy, distribute and/or modify this document @@ -135,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 @@ -154,37 +153,19 @@ of this and other documentation. @include dedication.itely @menu -Learning Manual - -* Preface:: Preface. -* Introduction:: What, Why, How. -* Tutorial:: A tutorial introduction. -* Putting it all together:: More explanation about LilyPond concepts. -* Working on LilyPond projects:: Discusses real-life usage. -* Tweaking output:: Introduction to modifying output. - -Notation Reference - -* Basic notation:: Standard musical notation. -* Instrument-specific notation:: Specialized notation. -* Advanced notation:: Less frequently used notation. -* Changing defaults:: Tuning output. -* Non-musical notation:: Output that is not musical notation. +* Musical notation:: 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. -Program usage - -* Running LilyPond:: Operation. -* LilyPond-book:: Integrating text and music. -* Converting from other formats:: Converting to lilypond source format. - Appendices * Literature list:: Reference works about music notation. -* Scheme tutorial:: Programming inside LilyPond. * Notation manual tables:: Tables and charts. -* Templates:: Ready-made templates. * Cheat sheet:: Summary of LilyPond syntax. * GNU Free Documentation License:: License of this document. * LilyPond command index:: @@ -195,42 +176,44 @@ Appendices @contents -@include macros.itexi -@include preface.itely -@include introduction.itely -@include tutorial.itely -@include putting.itely -@include working.itely -@include tweaks.itely - -@include basic-notation.itely -@include instrument-notation.itely -@include advanced-notation.itely -@include changing-defaults.itely -@include non-music.itely +@include notation.itely +@include specialist.itely + +@include input.itely @include spacing.itely -@include programming-interface.itely -@include running.itely -@include lilypond-book.itely -@include converters.itely +@include changing-defaults.itely +@include programming-interface.itely @include literature.itely -@include scheme-tutorial.itely @include notation-appendices.itely -@include templates.itely @include cheatsheet.itely @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