-\input texinfo @c -*-texinfo-*-
+\input texinfo @c -*- coding: utf-8; mode: texinfo; -*-
@setfilename lilypond.info
@settitle GNU LilyPond
+@iftex
+@afourpaper
+@end iftex
-@html
-<!--- @@WEB-TITLE@@=User Manual --->
-@end html
-
-@ignore
-Distributions will want to install lilypond.info doing:
-
- ./install-info --info-dir=/usr/share/info out/lilypond.info
-
-@end ignore
@dircategory GNU music project
@direntry
-@c ;; prepend GNU for dir, must be unique
-* GNU LilyPond: (lilypond). The GNU music typesetter.
-* ly2dvi: (lilypond)Invoking ly2dvi:: Titling LilyPond scores.
-* Glossary: (music-glossary). Glossary of music terms.
-* convert-ly: (lilypond)Invoking convert-ly:: Older LilyPond versions.
-* midi2ly: (lilypond)Invoking midi2ly:: Importing MIDI.
-* etf2ly: (lilypond)Invoking etf2ly:: Importing Finale.
-* abc2ly: (lilypond)Invoking abc2ly:: Importing ABC.
-* pmx2ly: (lilypond)Invoking pmx2ly:: Importing PMX.
-* musedata2ly: (lilypond)Invoking musedata2ly::
- Importing Musedata.
-* mup2ly: (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
-
-* 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.
-
-* don't use abbreviations (don't, won't, etc.)
+@ifhtml
+This document is also available in @uref{source/Documentation/user/lilypond.pdf,PDF}.
+@end ifhtml
-* avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'')
-* 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
-@end ignore
+@c FIXME: Index has two alphabetically sorted lists @code vs plain?
+@syncodeindex fn cp
+@syncodeindex ky cp
+@syncodeindex pg cp
+@syncodeindex tp cp
+@syncodeindex vr cp
-@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--2003 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
A copy of the license is included in the section entitled ``GNU
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
@end titlepage
@ifnottex
This file documents GNU LilyPond.
-Copyright 1999--2003 by the authors
+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
@ifnottex
@node Top
-@top
+@top GNU LilyPond --- The music typesetter
+@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
-@chapter GNU LilyPond --- The music typesetter
-
-This is the user manual for GNU LilyPond 1.8.0.
+This is the user manual for GNU LilyPond 2.8.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.
+@uref{http://@/www@/.lilypond@/.org/}. The website contains on-line copies
+of this and other documentation.
-@mbinclude dedication.itely
+@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
-* Literature:: Books about notation and engraving.
-* Technical manual:: How it all works.
-* Invoking LilyPond:: Operation.
+* Putting it all together:: Advanced tutorial? FIXME title
+* Working on LilyPond projects:: Demonstrates real-life LilyPond usage.
+* Tweaking output:: Tutorial-style explanation of chapters 10 and 11. FIXME title
+
+Notation reference
+
+* Basic notation:: Standard musical notation.
+* Instrument-specific notation:: Notation that is only used for some
+ instruments.
+* Advanced notation:: Less frequently used notation.
+* Changing defaults:: Tuning output.
+* Global issues:: What LilyPond produces.
+* Interfaces for programmers::
+
+Technical details
+
+* 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.
-* Index:: Unified index.
-* Reference manual details::
+
+Appendices
+
+* Literature list::
+* Scheme tutorial::
+* Notation manual details::
+* Example templates:: Larger examples.
* Cheat sheet::
* GNU Free Documentation License:: FDL.
+* LilyPond index::
@end menu
@end ifnottex
-
@contents
-@mbinclude macros.itexi
-@mbinclude preface.itely
-@mbinclude introduction.itely
-@mbinclude tutorial.itely
-@mbinclude refman.itely
-@mbinclude literature.itely
-@mbinclude internals.itely
-@mbinclude invoking.itexi
-@mbinclude lilypond-book.itely
-@mbinclude converters.itely
+@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 global.itely
+@include programming-interface.itely
+
+@include invoking.itely
+@include lilypond-book.itely
+@include converters.itely
-@c FIXME: Index has two alphabetically sorted lists @code vs plain?
-@node Index
-@unnumbered Index
-@printindex cp
-@mbinclude appendices.itely
-@mbinclude cheatsheet.itely
-@mbinclude fdl.itexi
+
+@include literature.itely
+@include scheme-tutorial.itely
+@include notation-appendices.itely
+@include examples.itely
+@include cheatsheet.itely
+@include fdl.itexi
+
+@node LilyPond index
+@appendix LilyPond index
+
+@printindex cp
@bye
projects / lilypond.git / blobdiff