X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=d9084de8d80bdb7659a419d0904e6c24f30e6d66;hb=65e82b29ad883d06f9ffd129de304041f5022abd;hp=1567ec748ee37501cbb3b7b4343574e639a95325;hpb=0cf97b5cdceecbba937f43ac827f4065aad5001e;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index 1567ec748e..d9084de8d8 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -1,128 +1,185 @@ \input texinfo @c -*-texinfo-*- @setfilename lilypond.info -@settitle LilyPond Reference Manual +@settitle GNU LilyPond -@titlepage -@title LilyPond -@subtitle The GNU Project Typesetter -@author Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano +@ignore +Distributions will want to install lilypond.info doing: - Copyright @copyright 1999 by the authors + ./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 -@vskip 0pt plus 1filll -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 +@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 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. +@c don't remove this comment. -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. +@ignore -@end titlepage +HINTS FOR STYLE -@ifinfo -This file documents GNU LilyPond. +* don't refer to LilyPond in the text. The reader knows what the +manual is about -Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano +* if you do, capitalization is LilyPond. -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 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 explicitly refer to the reader/user. There is no one else +besides the reader and the writer. -@end ignore +* don't use abbreviations (don't, won't, etc.) -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 fluff (``Notice that,'' ``as you can see,'' ``Currently,'') -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. +* 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 ifinfo +* abbrevs in caps, e.g. HTML, DVI, MIDI, etc. -@ignore -Should add disclaimer, abstract +@end ignore -"GNU LilyPond has no connection with the music package Rosegarden, other -than the names being similar :-)" +@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 +@author Jan Nieuwenhuizen +@author J@"{u}rgen Reuter +@author Rune Zedeler + + + +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 + 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[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 ignore +@end titlepage -@contents -@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 +@ifnottex +This file documents GNU LilyPond. -@macro keyindex {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''. -@macro indexcode {word} -@cindex \word\ +@end ifnottex -@end macro +@ifnottex +@node Top +@top -@mbinclude tutorial.itely +@chapter GNU LilyPond --- The music typesetter +This is the user manual for GNU LilyPond 1.8.0. -@include invoking.itexi +@cindex web site -@include bugs.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. -@mbinclude refman.itely +@mbinclude dedication.itely -@include glossary.itexi +@menu +* 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. +* 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 -@include moreinfo.itexi -@include convert-mudela.itexi +@contents -@node Index, , , Top +@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 + + +@c FIXME: Index has two alphabetically sorted lists @code vs plain? +@node Index @unnumbered Index @printindex cp +@mbinclude appendices.itely +@mbinclude cheatsheet.itely +@mbinclude fdl.itexi + @bye