X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=2b0b3091e44e9ce1446fee381fbbe9dca2123871;hb=78f563e58de2de28fd17067fd434a42cb9f055a5;hp=9468c84fe16d35814ecb47f4255f8b3a95cab2fa;hpb=9d9904fb14f112a64d2ff726f86c5cd8c256b1a7;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index 9468c84fe1..2b0b3091e4 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -1,165 +1,188 @@ -\input texinfo @c -*-texinfo-*- +\input texinfo @c -*- coding: utf-8; mode: texinfo; -*- @setfilename lilypond.info @settitle GNU LilyPond @iftex @afourpaper @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 - + + * Prepend GNU for dir, must be unique. + + * Do not list the `lilypond' node at toplevel, so that `info lilypond' + goes to Top. + + * List all commands in direntry. + +@c * lilypond: (lilypond/lilypond)Running LilyPond. Invoking the +@c LilyPond program. @end ignore -@dircategory GNU music project + +@c +@c Info files are installed in subdirectories to allow images to be present. +@c +@dircategory LilyPond @direntry -@c ;; prepend GNU for dir, must be unique -* GNU LilyPond: (./lilypond/lilypond). The GNU music typesetter. -* lilypond: (./lilypond/lilypond)Invoking LilyPond. Titling LilyPond scores. -* Glossary: (./lilypond/music-glossary). Glossary of music terms. -* convert-ly: (./lilypond/lilypond)Invoking convert-ly. Older LilyPond versions. -* midi2ly: (./lilypond/lilypond)Invoking midi2ly. Importing MIDI. -* etf2ly: (./lilypond/lilypond)Invoking etf2ly. Importing Finale. -* abc2ly: (./lilypond/lilypond)Invoking abc2ly. Importing ABC. -* musedata2ly: (./lilypond/lilypond)Invoking musedata2ly. Importing MuseData. -* mup2ly: (./lilypond/lilypond)Invoking mup2ly. Importing Mup. +* 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. @end direntry - +@c don't remove this comment. @ignore -@omfcreator Han-Wen Nienhuys and Jan Nieuwenhuizen -@omfdescription User manual of the LilyPond music engraving system +@omfcreator Han-Wen Nienhuys, Jan Nieuwenhuizen and Graham Percival +@omfdescription User manual of the LilyPond music engraving system @omftype user manual @omfcategory Applications|Publishing @omflanguage English @end ignore -@c don't remove this comment. - -@ignore - -HINTS FOR STYLE - -* Try not to use punctuation between introductocing sentence and -display material (verbatim, music, example code). -* don't refer to LilyPond in the text. The reader knows what the -manual is about - -* if you do, capitalization is LilyPond. - -* don't explicitly refer to the reader/user. There is no one else -besides the reader and the writer. +@ifhtml +This document is also available as a +@uref{source/Documentation/user/lilypond.pdf,PDF}. +@end ifhtml -* don't use abbreviations (don't, won't, etc.) -* avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'') +@c This produces the unified index +@syncodeindex fn cp +@syncodeindex vr cp -* avoid long stretches of input code. Noone is go to read them in -print. Instead refer to an example input file (@inputfileref), these -are clickable in HTML. +@documentlanguage en +@documentencoding utf-8 -* abbrevs in caps, e.g. HTML, DVI, MIDI, etc. - -@end ignore - -@ifhtml -This document is also available in @uref{../lilypond.ps.gz,gzipped -PostScript} and @uref{../lilypond.pdf,PDF}. -@end ifhtml +@finalout @titlepage -@title GNU LilyPond +@title LilyPond @subtitle The music typesetter -@author Han-Wen Nienhuys -@author Jan Nieuwenhuizen -@author J@"{u}rgen Reuter -@author Rune Zedeler +@author The LilyPond development team -Copyright @copyright{} 1999--2004 by the authors +Copyright @copyright{} 1999--2006 by the authors - 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''. +@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 @vskip 20pt - -@lilypond[raggedright] +@lilypond[ragged-right] \score { - \context Lyrics \notes { - \override Score.RehearsalMark #'self-alignment-X = #LEFT - \mark #(ly:export (string-append - "(For LilyPond version " (lilypond-version) ")")) - s2 - } - \paper { - indent = 0.0\pt - raggedright = ##t - } + \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 - @end titlepage +@copying +Copyright @copyright{} 1999--2006 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--2004 by the authors - - 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''. +Copyright 1999--2006 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 @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.1.x series. +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 @cindex web site +@cindex URL -A further source of information is the website, which can be found at -@uref{http://www.lilypond.org/}. The website contains on-line copies of -this and other documentation. +More information can be found at +@uref{http://@/www@/.lilypond@/.org/}. The website contains on-line copies +of this and other documentation. @include dedication.itely @menu +Learning Manual + * Preface:: Preface. * Introduction:: What, Why, How. * Tutorial:: A tutorial introduction. -* Notation manual:: All notation supported, and how to - produce it. -* Changing defaults:: Tuning output -* Invoking LilyPond:: Operation. +* 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. +* Spacing issues:: Display of output on paper. +* 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. -* lilypond-book manual:: Integrating text and music with lilypond-book. -* Unified index:: -* Notation manual details:: -* Literature list:: -* Interfaces for programmers:: -* Cheat sheet:: -* GNU Free Documentation License:: FDL. + +Appendices + +* Literature list:: Reference works about music notation. +* Scheme tutorial:: Programming inside LilyPond. +* Notation manual tables:: Tables and charts. +* Example templates:: Ready-made templates. +* Cheat sheet:: Summary of LilyPond syntax. +* GNU Free Documentation License:: License of this document. +* LilyPond command index:: +* LilyPond index:: @end menu @end ifnottex @@ -168,29 +191,40 @@ this and other documentation. @include macros.itexi @include preface.itely -@include introduction.itely +@include introduction.itely @include tutorial.itely -@include notation.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 invoking.itexi +@include non-music.itely +@include spacing.itely +@include programming-interface.itely + +@include running.itely @include lilypond-book.itely @include converters.itely -@c FIXME: Index has two alphabetically sorted lists @code vs plain? -@node Unified index -@unnumbered Unified index - -@printindex cp - +@include literature.itely +@include scheme-tutorial.itely @include notation-appendices.itely +@include templates.itely +@include cheatsheet.itely +@include fdl.itexi -@include literature.itely +@node LilyPond command index +@appendix LilyPond command index -@include programming-interface.itely +@printindex ky -@include cheatsheet.itely +@node LilyPond index +@appendix LilyPond index -@include fdl.itexi +@printindex cp @bye