\input texinfo @c -*-texinfo-*-
@setfilename lilypond.info
@settitle GNU LilyPond
+@iftex
+@afourpaper
+@end iftex
+@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.
+* lilypond: (lilypond)Invoking lilypond:: 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.
+@end direntry
-@titlepage
-@title GNU LilyPond
-@subtitle The music typesetter
-@author Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano
- Copyright @copyright{} 1999 by the authors
+@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
-@vskip 0pt plus 1filll
+@c don't remove this comment.
-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.
+@ignore
-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.
+HINTS FOR STYLE
-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.
+* don't refer to LilyPond in the text. The reader knows what the
+manual is about
-@end titlepage
+* if you do, capitalization is LilyPond.
-@ifinfo
-This file documents GNU LilyPond.
-Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano
+* don't explicitly refer to the reader/user. There is no one else
+besides the reader and the writer.
-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 use abbreviations (don't, won't, etc.)
-@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).
+* 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.
+
+* abbrevs in caps, e.g. HTML, DVI, MIDI, etc.
@end ignore
-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.
+@ifhtml
+This document is also available in @uref{../lilypond.ps.gz,gzipped
+PostScript} and @uref{../lilypond.pdf,PDF}.
+@end ifhtml
-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.
-@end ifinfo
+@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 LyricsVoice \notes {
+ \property Score.RehearsalMark \set #'self-alignment-X = #LEFT
+ \mark #(ly:export (string-append
+ "(For LilyPond version " (lilypond-version) ")"))
+ s2
+ }
+ \paper {
+ indent = 0.0\pt
+ raggedright = ##t
+ }
+}
+@end lilypond
+
-@ignore
-Should add disclaimer, abstract
+@end titlepage
-"GNU LilyPond has no connection with the music package Rosegarden, other
-than the names being similar :-)"
-@end ignore
+@ifnottex
+This file documents GNU LilyPond.
-@node Top, , , (dir)
-@chapter GNU LilyPond --- The music typesetter
+Copyright 1999--2004 by the authors
-@contents
+ 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''.
-@menu
-* Tutorial:: A tutorial introduction to lilypond.
-* Invoking LilyPond:: Operation.
-* Reporting Bugs:: Where to report bugs.
-* Reference Manual:: Reference Manual.
-@c Move to Reference Manual?
-* Internals:(lilypond-internals). Auto generated detailed documentation.
-* More information:: Where to turn to for more help.
-* convert-mudela:: Upgrading input files.
-@c Hmm, having the generated doco in a separate file,
-@c the index can't refer to that.
-* Index:: Unified index.
-@end menu
+@end ifnottex
-@macro keyindex {word}
-@cindex \word\
-@end macro
+@ifnottex
+@node Top
+@top
-@macro indexcode {word}
-@cindex \word\
+@chapter GNU LilyPond --- The music typesetter
-@end macro
+This is the user manual for GNU LilyPond 2.1.0.
+@cindex web site
-@mbinclude tutorial.itely
+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 dedication.itely
-@include invoking.itexi
+@menu
+* Preface:: Preface.
+* Introduction:: What, Why, How.
+* Tutorial:: A tutorial introduction.
+* Notation manual:: All notation supported, and how to
+ produce it.
+* Literature list:: Books about notation and engraving.
+* 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
-@include bugs.itexi
+@contents
-@mbinclude refman.itely
-@include moreinfo.itexi
+@include macros.itexi
+@include preface.itely
+@include introduction.itely
+@include tutorial.itely
+@include refman.itely
+@include literature.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
projects / lilypond.git / blobdiff