X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond.tely;h=c06925c2f0a61ea07261a75dedd919953f291d25;hb=b230681e00b54adaba3846209250505a0d0b41f0;hp=a3fd84272ab7625155073ca46cf9d7599dc9ca75;hpb=5252d929e73b2d6a7fa9aa68bdaffd32f41ec392;p=lilypond.git diff --git a/Documentation/user/lilypond.tely b/Documentation/user/lilypond.tely index a3fd84272a..c06925c2f0 100644 --- a/Documentation/user/lilypond.tely +++ b/Documentation/user/lilypond.tely @@ -1,31 +1,30 @@ \input texinfo @c -*-texinfo-*- @setfilename lilypond.info @settitle GNU LilyPond - -@html - -@end html +@iftex +@afourpaper +@end iftex @ignore -Distributions will want to install lilypond.info doing: +Distributions will want to install lilypond.info in postinstall, doing: - ./install-info --info-dir=/usr/share/info out/lilypond.info + 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. +@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 @@ -43,23 +42,37 @@ Distributions will want to install lilypond.info doing: HINTS FOR STYLE -* don't refer to LilyPond in the text. The reader knows what the -manual is about +* Try not to use punctuation between introductocing sentence and +display material (verbatim, music, example code). -* if you do, capitalization is LilyPond. +* Do not 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 +* Do not 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.) +* Do not use abbreviations (don't, won't, etc.). -* avoid fluff (``Notice that,'' ``as you can see,'' ``Currently,'') +* 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 +* 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. +* Abbrevs in caps, e.g. HTML, DVI, MIDI, etc. + +* Colon usage + 0. Do not use a colon to introduce examples, sentences just continue + + in the display material. + + 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 @ifhtml @@ -78,7 +91,7 @@ PostScript} and @uref{../lilypond.pdf,PDF}. -Copyright @copyright{} 1999--2003 by the authors +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 @@ -87,6 +100,24 @@ Copyright @copyright{} 1999--2003 by the authors A copy of the license is included in the section entitled ``GNU Free Documentation License''. +@vskip 20pt + +%% Not yet debugged or reported. This crashes gs-8.01: +%% compiling gs-8.01 right now... -- jcn +@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 @end titlepage @@ -94,7 +125,7 @@ Copyright @copyright{} 1999--2003 by the authors @ifnottex This file documents GNU LilyPond. -Copyright 1999--2003 by the authors +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 @@ -108,11 +139,13 @@ Copyright 1999--2003 by the authors @ifnottex @node Top -@top +@top GNU LilyPond --- The music typesetter +@c HJJ: Info needs `@top', which is a synonym for `@unnumbered' in TeX. -@chapter GNU LilyPond --- The music typesetter - -This is the user manual for GNU LilyPond 1.8.0. +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 @@ -120,7 +153,7 @@ 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 dedication.itely @menu * Preface:: Preface. @@ -128,41 +161,47 @@ this and other documentation. * 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. +* Changing defaults:: Tuning output. * 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:: +* Unified index:: +* Notation manual details:: +* Literature list:: +* Interfaces for programmers:: * 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 literature.itely -@mbinclude internals.itely -@mbinclude invoking.itexi -@mbinclude lilypond-book.itely -@mbinclude converters.itely + +@include macros.itexi +@include preface.itely +@include introduction.itely +@include tutorial.itely +@include notation.itely +@include changing-defaults.itely +@include invoking.itexi +@include lilypond-book.itely +@include converters.itely @c FIXME: Index has two alphabetically sorted lists @code vs plain? -@node Index -@unnumbered Index +@node Unified index +@unnumbered Unified index @printindex cp -@mbinclude appendices.itely -@mbinclude cheatsheet.itely -@mbinclude fdl.itexi +@include notation-appendices.itely + +@include literature.itely + +@include programming-interface.itely + +@include cheatsheet.itely + +@include fdl.itexi @bye