X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=bdad180430fa831607e91c1357f20f9eeffd2f7b;hb=832c21ee509c9ad488e1490ad59a650e89c8f53a;hp=ccb26410603a2cb825a302e5a34d27aa9e33d766;hpb=cda8fc1780778b760905c8832f7e984161218f20;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index ccb2641060..bdad180430 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -1,88 +1,153 @@ \input texinfo @c -*-texinfo-*- @setfilename lilypond.info @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 GNU LilyPond -@subtitle The music typesetter -@author Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano +@dircategory GNU music project +@direntry +@c prepend GNU for dir, must be unique +@c do not list the `lilypond' node at toplevel, so that `info lilypond' +@c goes to Top. +@c * lilypond: (lilypond/lilypond)Invoking LilyPond. Titling LilyPond scores. +* GNU LilyPond: (lilypond/lilypond). The GNU music typesetter. +* 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. +* 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 +* Do not forget to create @cindex entries for new sections of text. -@ifinfo -This file documents GNU LilyPond. +* Try not to use punctuation between introductocing sentence and +display material (verbatim, music, example code). -Copyright 1999 Han-Wen Nienhuys, Jan Nieuwenhuizen and Adrian Mariano +* Do not refer to LilyPond in the text. The reader knows what the +manual is about. -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. +* If you do, capitalization is LilyPond. -@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). +* Do not explicitly refer to the reader/user. There is no one else +besides the reader and the writer. -@end ignore +* Do not 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 going 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 +* Colon usage + 0. Do not use a colon to introduce examples, sentences just continue + + in the display material. -"GNU LilyPond has no connection with the music package Rosegarden, other -than the names being similar :-)" + 1. To introduce lists + 2. When beginning a quote: "So, he said,..." + This usage is rarer. Americans often just use a comma. + 3. When adding a defining example at the end of a sentence. @end ignore -@node Top, , , (dir) -@chapter GNU LilyPond --- The music typesetter +@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--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 + +@c Not yet debugged or reported. This crashes gs-8.01: +@c compiling gs-8.01 right now... -- jcn +@lilypond[raggedright] +\score { + \context Lyrics { + \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 + +@end titlepage + + +@ifnottex +This file documents GNU LilyPond. + +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''. + +@end ifnottex -LilyPond produces sheet music from input files. This document describes -how to use LilyPond. +@ifnottex +@node Top +@top GNU LilyPond --- The music typesetter +@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX. + +This is the user manual for GNU LilyPond 2.3.x series. +@ifhtml +(See the bottom of this page for the exact version number). +@end ifhtml @cindex web site @@ -90,45 +155,56 @@ 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 dedication.itely @menu -* Tutorial:: A tutorial introduction to lilypond. +* Preface:: Preface. +* Introduction:: What, Why, How. +* Tutorial:: A tutorial introduction. +* Example templates:: Larger examples +* Notation manual:: All notation supported, and how to + produce it. +* Changing defaults:: Tuning output. +* Interfaces for programmers:: * Invoking LilyPond:: Operation. -* Reporting Bugs:: Where to report bugs. -* Reference Manual:: Reference Manual. -@c Move to Reference Manual? -* Internals:(lilypond-internals). Auto generated detailed documentation. -* convert-ly:: Upgrading input files. -* Index:: Unified index. +* Converting from other formats:: Converting to lilypond source format. +* lilypond-book manual:: Integrating text and music with lilypond-book. +* Unified index:: +* Notation manual details:: +* Literature list:: +* Cheat sheet:: +* GNU Free Documentation License:: FDL. @end menu +@end ifnottex @contents -@macro keyindex {word} -@cindex \word\ - -@end macro - -@macro indexcode {word} -@cindex \word\ - -@end macro +@include macros.itexi +@include preface.itely +@include introduction.itely +@include tutorial.itely +@include examples.itely +@include invoking.itexi +@include notation.itely +@include changing-defaults.itely +@include programming-interface.itely +@include lilypond-book.itely +@include converters.itely -@mbinclude tutorial.itely -@include invoking.itexi +@c FIXME: Index has two alphabetically sorted lists @code vs plain? +@node Unified index +@unnumbered Unified index -@include bugs.itexi +@printindex cp -@mbinclude refman.itely +@include notation-appendices.itely -@include convert-ly.itexi +@include literature.itely -@node Index, , , Top -@unnumbered Index +@include cheatsheet.itely -@printindex cp +@include fdl.itexi @bye