-\input texinfo @c -*-texinfo-*-
+\input texinfo @c -*- coding: latin-1; mode: texinfo; -*-
@setfilename lilypond.info
@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
@dircategory GNU music project
@direntry
-@c ;; prepend GNU for dir, must be unique
-* GNU LilyPond: (lilypond). The GNU music typesetter.
-@c * install-info: (texinfo)Invoking install-info. Update info/dir entries.
-@c * texi2dvi: (texinfo)Format with texi2dvi. Print Texinfo documents.
+@c prepend GNU for dir, must be unique
+@c do not list the `lilypond' node at toplevel, so that `info lilypond'
+@c goes to Top.
+@c * lilypond: (lilypond/lilypond)Running LilyPond. Invoking the
+@c LilyPond program.
+* GNU LilyPond: (lilypond/lilypond). The GNU music typesetter.
+* 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.
@end direntry
+@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
+
+@c don't remove this comment.
+
+@ignore
+
+HINTS FOR STYLE
+
+* Do not forget to create @cindex entries for new sections of text.
+
+* Try not to use punctuation between introductocing sentence and
+display material (verbatim, music, example code).
+
+* Do not refer to LilyPond in the text. The reader knows what the
+manual is about.
+
+* If you do, capitalization is LilyPond.
+
+* Do not explicitly refer to the reader/user. There is no one else
+besides the reader and the writer.
+
+* Do not use abbreviations (don't, won't, etc.).
+
+* Avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'')
+
+* Avoid long stretches of input code. Noone is going to read them in
+print. Instead refer to an example input file (@inputfileref), these
+are clickable in HTML.
+
+* Abbrevs in caps, e.g. HTML, DVI, MIDI, etc.
+
+* Colon usage
+ 0. Do not use a colon to introduce examples, sentences just continue
+
+ in the display material.
+
+ 1. To introduce lists
+ 2. When beginning a quote: "So, he said,..."
+ This usage is rarer. Americans often just use a comma.
+ 3. When adding a defining example at the end of a sentence.
+
+@end ignore
+
+@ifhtml
+This document is also available in @uref{../lilypond.ps.gz,gzipped
+PostScript} and @uref{../lilypond.pdf,PDF}.
+@end ifhtml
+
+
+@documentlanguage en
+@documentencoding ISO-8859-1
+
+@syncodeindex fn cp
+@syncodeindex ky cp
+@syncodeindex pg cp
+@syncodeindex tp cp
+@syncodeindex vr cp
+
+
@titlepage
@title GNU LilyPond
@subtitle The music typesetter
-@author
+@author The LilyPond development team
-Copyright @copyright{} 1999--2001 by the authors
+
+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
A copy of the license is included in the section entitled ``GNU
Free Documentation License''.
+@vskip 20pt
+
+@c Not yet debugged or reported. This crashes gs-8.01:
+@c compiling gs-8.01 right now... -- jcn
+@lilypond[raggedright]
+\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
+ raggedright = ##t
+ }
+}
+@end lilypond
@end titlepage
-@ifinfo
+
+@ifnottex
This file documents GNU LilyPond.
-Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen, Adrian Mariano
-Tom Cato Amundsen.
+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
A copy of the license is included in the section entitled ``GNU
Free Documentation License''.
-@end ifinfo
+@end ifnottex
+
@ifnottex
@node Top
-@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.3.x series.
@ifhtml
-This document is also available as a @uref{../lilypond.ps.gz,gzipped
-postscript file}.
+(See the bottom of this page for the exact version number).
@end ifhtml
-@chapter GNU LilyPond --- The music typesetter
-
-LilyPond produces sheet music from input files. This document describes
-how to use LilyPond.
-
@cindex web site
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.
-@mbinclude dedication.itely
+@include dedication.itely
@menu
* Preface:: Preface.
-* Tutorial:: A tutorial introduction to LilyPond.
-* Reference Manual:: Reference Manual.
-* Mutopia project:: Mutopia project.
-* Invoking LilyPond:: Operation.
-* Bug reports:: Where to report bugs.
-* ly2dvi:: Generating nice output with titles.
-* convert-ly:: Upgrading input files.
-* Conversion tools:: Converting to lilypond source format.
-* lilypond-book:: Interleaving text with music.
-* Internals:: How it all works.
-* Literature:: Additional reading
-* Full Grob interface list:: Generated list of all Grob properties.
-* Index of internals:(lilypond-internals). Auto generated detailed documentation.
-* Index:: Unified index.
-* Function Index:: Function index.
-* Refman appendix::
-* GNU Free Documentation License:: FDL.
+* Introduction:: What, Why, How.
+* Tutorial:: A tutorial introduction.
+* Example templates:: Larger examples
+* Notation manual:: All notation supported, and how to
+ produce it.
+* Sound:: Producing MIDI output
+* Changing defaults:: Tuning output.
+* Interfaces for programmers::
+* Running LilyPond:: Operation.
+* Converting from other formats:: Converting to lilypond source format.
+* Integrating text and music:: Integrating text and music with lilypond-book.
+* Literature list::
+* Scheme tutorial::
+* Notation manual details::
+* Point and click::
+* Unified index::
+* GNU Free Documentation License:: FDL.
+* Cheat sheet::
@end menu
@end ifnottex
-
@contents
-@mbinclude macros.itexi
-@mbinclude preface.itely
-@mbinclude tutorial.itely
-@mbinclude refman.itely
-@mbinclude mutopia.itely
-@mbinclude internals.itely
-@mbinclude invoking.itexi
-@mbinclude bugs.itexi
-@mbinclude ly2dvi.itexi
-@mbinclude convert-ly.itexi
-@mbinclude lilypond-book.itely
-@mbinclude converters.itely
-@mbinclude literature.itely
-@mbinclude interfaces.itexi
+
+@include macros.itexi
+@include preface.itely
+@include introduction.itely
+@include tutorial.itely
+@include examples.itely
+@include invoking.itely
+@include notation.itely
+@include sound-output.itexi
+@include changing-defaults.itely
+@include programming-interface.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
-@node Function Index
-@unnumbered Function Index
+@include literature.itely
+@include scheme-tutorial.itely
+@include notation-appendices.itely
+@include point-and-click.itely
+
+@node Unified index
+@appendix Unified index
+
+@printindex cp
-@printindex fn
+@include fdl.itexi
-@mbinclude appendices.itely
-@mbinclude fdl.itexi
+@include cheatsheet.itely
@bye