X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=8a187a9b08513381e92d1ea76c21217caee120ca;hb=969b3b0a27bbdaa721cb6b78a9ce82a9b0300277;hp=9e913171064c1236db80fe1bce76562987172fd5;hpb=fdb66b65c89bf9e98da8975999815228d5f0449e;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index 9e91317106..8a187a9b08 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -1,125 +1,189 @@ \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. -* 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 moreinfo.itexi -@include convert-mudela.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 -@c @include out/lilypond-internals.texi -@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