X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=69f48c53cc885bf8faf97c024fbbd9d381ff5f44;hb=2745cbd907f8216a4cc1fc5f488ae19efdfdbd10;hp=07cecc95ffdb028810f92b4c2face7a6d7538eb8;hpb=876ccb4004d92f3b7bd539753f8f9339b7d48490;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index 07cecc95ff..69f48c53cc 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -1,126 +1,162 @@ \input texinfo @c -*-texinfo-*- @setfilename lilypond.info -@settitle LilyPond Reference Manual +@settitle GNU LilyPond +@html + +@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) -@top -@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 -@macro keyindex {word} -@cindex \word\ +@end titlepage + -@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 -@include glossary.itexi +@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 + + +@contents -@include moreinfo.itexi +@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