\input texinfo @c -*-texinfo-*-
@setfilename lilypond.info
-@settitle LilyPond Reference Manual
+@settitle GNU LilyPond
+@iftex
+@afourpaper
+@end iftex
+@ignore
+Distributions will want to install lilypond.info in postinstall, doing:
+ install-info --info-dir=/usr/share/info out/lilypond.info
+
+@end ignore
-@titlepage
-@title LilyPond Reference Manual
-@subtitle The GNU Project Typesetter
-@author Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano
+@dircategory GNU music project
+@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.
+* pmx2ly: (./lilypond/lilypond)Invoking pmx2ly. Importing PMX.
+* musedata2ly: (./lilypond/lilypond)Invoking musedata2ly. Importing MuseData.
+* mup2ly: (./lilypond/lilypond)Invoking mup2ly. Importing Mup.
+@end direntry
- Copyright @copyright 1999 by the authors
-@vskip 0pt plus 1filll
+@ignore
+@omfcreator Han-Wen Nienhuys and Jan Nieuwenhuizen
+@omfdescription User manual of the LilyPond music engraving system
+@omftype user manual
+@omfcategory Applications|Publishing
+@omflanguage English
+@end ignore
-Permission is granted to make and distribute verbatim
-copies of this manual provided the copyright notice and
-this permission notice are preserved on all copies.
+@c don't remove this comment.
-Permission is granted to copy and distribute modified
-versions of this manual under the conditions for
-verbatim copying, provided also that the sections
-entitled ``Copying'' and ``GNU General Public License''
-are included exactly as in the original, and provided
-that the entire resulting derived work is distributed
-under the terms of a permission notice identical to this
-one.
+@ignore
-Permission is granted to copy and distribute
-translations of this manual into another language,
-under the above conditions for modified versions,
-except that this permission notice may be stated in a
-translation approved by the Free Software Foundation.
+HINTS FOR STYLE
-@end titlepage
+* don't refer to LilyPond in the text. The reader knows what the
+manual is about
-@ifinfo
-This file documents GNU LilyPond.
+* if you do, capitalization is LilyPond.
-Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano
-Permission is granted to make and distribute verbatim
-copies of this manual provided the copyright notice and
-this permission notice are preserved on all copies.
+* don't explicitly refer to the reader/user. There is no one else
+besides the reader and the writer.
-@ignore
-Permission is granted to process this file through TeX
-and print the results, provided the printed document
-carries a copying permission notice identical to this
-one except for the removal of this paragraph (this
-paragraph not being relevant to the printed manual).
+* don't use abbreviations (don't, won't, etc.)
-@end ignore
+* avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'')
-Permission is granted to copy and distribute modified
-versions of this manual under the conditions for
-verbatim copying, provided also that the sections
-entitled ``Copying'' and ``GNU General Public License''
-are included exactly as in the original, and provided
-that the entire resulting derived work is distributed
-under the terms of a permission notice identical to this
-one.
+* 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.
-Permission is granted to copy and distribute
-translations of this manual into another language,
-under the above conditions for modified versions,
-except that this permission notice may be stated in a
-translation approved by the Free Software Foundation.
+* abbrevs in caps, e.g. HTML, DVI, MIDI, etc.
-@end ifinfo
+@end ignore
-@ignore
-Should add disclaimer, abstract
+@ifhtml
+This document is also available in @uref{../lilypond.ps.gz,gzipped
+PostScript} and @uref{../lilypond.pdf,PDF}.
+@end ifhtml
-"GNU LilyPond has no connection with the music package Rosegarden, other
-than the names being similar :-)"
-@end ignore
+@titlepage
+@title GNU LilyPond
+@subtitle The music typesetter
+@author Han-Wen Nienhuys
+@author Jan Nieuwenhuizen
+@author J@"{u}rgen Reuter
+@author Rune Zedeler
+
+
+
+Copyright @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''.
+
+@vskip 20pt
+
+
+@lilypond[raggedright]
+\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
+ }
+}
+@end lilypond
+
-@contents
+@end titlepage
-@node Top, , , (dir)
-@menu
-* Tutorial:: a tutorial introduction to lilypond.
-* Invoking LilyPond:: Operation.
-* Reporting Bugs:: Where to report bugs.
-* Reference Manual:: Reference Manual.
-* Glossary:: A dictionary of musical terms.
-* More information:: Where to turn to for more help.
-* convert-mudela:: Upgrading input files.
-* Index:: Unified index.
-@end menu
+@ifnottex
+This file documents GNU LilyPond.
-@macro keyindex {word}
-@cindex \word\
+Copyright 1999--2004 by the authors
-@end macro
+ 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''.
-@macro indexcode {word}
-@cindex \word\
+@end ifnottex
-@end macro
+@ifnottex
+@node Top
+@top GNU LilyPond --- The music typesetter
+@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX.
-@mbinclude tutorial.itely
+This is the user manual for GNU LilyPond 2.1.x series.
+@ifhtml
+(See the bottom of this page for the exact version number).
+@end ifhtml
+@cindex web site
-@include invoking.itexi
+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.
-@include bugs.itexi
+@include dedication.itely
-@mbinclude refman.itely
+@menu
+* Preface:: Preface.
+* Introduction:: What, Why, How.
+* Tutorial:: A tutorial introduction.
+* Notation manual:: All notation supported, and how to
+ produce it.
+* Using LilyPond:: How it all works.
+* Technical manual:: How it all works.
+* Invoking LilyPond:: Operation.
+* Converting from other formats:: Converting to lilypond source format.
+* lilypond-book manual:: Integrating text and music with lilypond-book.
+* Unified index::
+* Reference manual details::
+* Cheat sheet::
+* GNU Free Documentation License:: FDL.
+@end menu
+@end ifnottex
+
+@contents
-@include glossary.itexi
-@include moreinfo.itexi
+@include macros.itexi
+@include preface.itely
+@include introduction.itely
+@include tutorial.itely
+@include refman.itely
+@include running.itely
+@include internals.itely
+@include invoking.itexi
+@include lilypond-book.itely
+@include converters.itely
-@include convert-mudela.itexi
-@node Index, , , Top
-@unnumbered Index
+@c FIXME: Index has two alphabetically sorted lists @code vs plain?
+@node Unified index
+@unnumbered Unified index
@printindex cp
+@include appendices.itely
+@include cheatsheet.itely
+@include fdl.itexi
+
@bye