\input texinfo @c -*-texinfo-*-
@setfilename lilypond.info
-@settitle LilyPond Reference Manual
+@settitle GNU LilyPond
+@html
+<!--- @@WEB-TITLE@@=User Manual --->
+@end html
+@ignore
+Distributions will want to install lilypond.info doing:
-@titlepage
-@title LilyPond Reference Manual
-@subtitle The GNU Project Typesetter
-@author Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano
+ ./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.
+@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 Music
+@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.
+* don't explicitly refer to the reader/user. There is no one else
+besides the reader and the writer.
-Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano
+* don't use abbreviations (don't, won't, etc.)
-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.
+* avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'')
-@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 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.
@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}gen Reuter
+@author Rune Zedeler
-@ignore
-Should add disclaimer, abstract
-"GNU LilyPond has no connection with the music package Rosegarden, other
-than the names being similar :-)"
-@end ignore
+Copyright @copyright{} 1999--2003 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''.
-@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
+@end titlepage
-@macro keyindex {word}
-@cindex \word\
-@end macro
+@ifnottex
+This file documents GNU LilyPond.
-@macro indexcode {word}
-@cindex \word\
+Copyright 1999--2003 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''.
+@end ifnottex
-@mbinclude tutorial.itely
+@ifnottex
+@node Top
+@top
-@include invoking.itexi
+@chapter GNU LilyPond --- The music typesetter
-@include bugs.itexi
+This is the user manual for GNU LilyPond 1.7.16.
-@mbinclude refman.itely
+@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
+
+@menu
+* Preface:: Preface.
+* Introduction:: What, Why, How.
+* Tutorial:: A tutorial introduction to LilyPond.
+* Reference Manual:: Reference Manual.
+* Advanced Topics:: 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.
+* Literature:: Additional reading material.
+* Index:: Unified index.
+* Reference manual details::
+* GNU Free Documentation License:: FDL.
+@end menu
+@end ifnottex
-@include glossary.itexi
-@include moreinfo.itexi
+@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 convert-mudela.itexi
-@node Index, , , Top
+@c FIXME: Index has two alphabetically sorted lists @code vs plain?
+@node Index
@unnumbered Index
@printindex cp
+@mbinclude appendices.itely
+@mbinclude fdl.itexi
+
@bye
projects / lilypond.git / blobdiff