X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=d9084de8d80bdb7659a419d0904e6c24f30e6d66;hb=65e82b29ad883d06f9ffd129de304041f5022abd;hp=93660837faa6bbab503107e2a4f5d231f6284ce3;hpb=2edcb9426a00a159847e0b4adb7c048c2d058b87;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index 93660837fa..d9084de8d8 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -3,23 +3,82 @@ @settitle GNU LilyPond + +@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. -@c * install-info: (texinfo)Invoking install-info. Update info/dir entries. -@c * texi2dvi: (texinfo)Format with texi2dvi. Print Texinfo documents. +* 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 +@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 + +* don't refer to LilyPond in the text. The reader knows what the +manual is about + +* if you do, capitalization is LilyPond. + + +* don't explicitly refer to the reader/user. There is no one else +besides the reader and the writer. + +* don't use abbreviations (don't, won't, etc.) + +* 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 + +@ifhtml +This document is also available in @uref{../lilypond.ps.gz,gzipped +PostScript} and @uref{../lilypond.pdf,PDF}. +@end ifhtml + + @titlepage @title GNU LilyPond @subtitle The music typesetter -@author Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano +@author Han-Wen Nienhuys +@author Jan Nieuwenhuizen +@author J@"{u}rgen Reuter +@author Rune Zedeler -Copyright @copyright{} 1999--2001 by the authors +Copyright @copyright{} 1999--2003 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 @@ -28,13 +87,31 @@ Copyright @copyright{} 1999--2001 by the authors A copy of the license is included in the section entitled ``GNU Free Documentation License''. +@vskip 20pt + + +@lilypond[singleline] +\score { \context Lyrics \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 + @end titlepage -@ifinfo + +@ifnottex This file documents GNU LilyPond. -Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano +Copyright 1999--2003 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 @@ -43,24 +120,16 @@ Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano A copy of the license is included in the section entitled ``GNU Free Documentation License''. -@end ifinfo - -@ifhtml +@end ifnottex -This document is also available as a @uref{../lilypond.ps.gz,gzipped -postscript file}. - -@end ifhtml @ifnottex @node Top -@c FIXME: this should not be necessary... @top @chapter GNU LilyPond --- The music typesetter -LilyPond produces sheet music from input files. This document describes -how to use LilyPond. +This is the user manual for GNU LilyPond 1.8.0. @cindex web site @@ -68,41 +137,40 @@ 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 -* Tutorial:: A tutorial introduction to LilyPond. -* Reference Manual:: Reference Manual. -* Tricks:: Features, tips and tricks. +* Preface:: Preface. +* Introduction:: What, Why, How. +* Tutorial:: A tutorial introduction. +* Notation manual:: All notation supported, and how to + produce it. +* Literature:: Books about notation and engraving. +* Technical manual:: How it all works. * Invoking LilyPond:: Operation. -* Bug reports:: Where to report bugs. -* ly2dvi:: Generating nice output with titles. -* convert-ly:: Upgrading input files. -* Conversion tools:: Converting from MIDI input. -* Internals:: How it all works. -* Literature:: additional reading -* Index of internals:(lilypond-internals). Auto generated detailed documentation. -* Index:: Unified index. -* Function Index:: Function index. -* GNU Free Documentation License:: FDL. +* Converting from other formats:: Converting to lilypond source format. +* lilypond-book manual:: Integrating text and music with lilypond-book. +* Index:: Unified index. +* Reference manual details:: +* Cheat sheet:: +* GNU Free Documentation License:: FDL. @end menu @end ifnottex @contents - @mbinclude macros.itexi +@mbinclude preface.itely +@mbinclude introduction.itely @mbinclude tutorial.itely @mbinclude refman.itely -@mbinclude tricks.itely +@mbinclude literature.itely @mbinclude internals.itely @mbinclude invoking.itexi -@mbinclude bugs.itexi -@mbinclude ly2dvi.itexi -@mbinclude convert-ly.itexi -@mbinclude convertors.itely -@mbinclude literature.itely +@mbinclude lilypond-book.itely +@mbinclude converters.itely + @c FIXME: Index has two alphabetically sorted lists @code vs plain? @node Index @@ -110,11 +178,8 @@ this and other documentation. @printindex cp -@node Function Index -@unnumbered Function Index - -@printindex fn - +@mbinclude appendices.itely +@mbinclude cheatsheet.itely @mbinclude fdl.itexi @bye