]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/notation.itely
* lily/ledger-line-engraver.cc: new file.
[lilypond.git] / Documentation / user / notation.itely
index 48dda9a530595023e2f77135a4acc859ceecb669..ebd2d1fdd39897927ce1dbab90c9ffa0077644b0 100644 (file)
@@ -107,7 +107,7 @@ Half-flats and half-sharps are formed by adding @code{-eh} and
 @cindex quarter tones
 @cindex semi-flats, semi-sharps
 
-@lilypond[quote,verbatim,relative=3]
+@lilypond[fragment,quote,verbatim,relative=3]
 ceses4
 ceseh
 ces
@@ -206,7 +206,7 @@ A chord is formed by a enclosing a set of pitches in @code{<} and
 @code{>}. A chord may be followed by  a duration, and a set of
 articulations, just like simple notes.
 
-@lilypond[quote,relative=1]
+@lilypond[fragment,quote,relative=1]
 <c e g>4 <c>8 <>8 
 @end lilypond
 
@@ -219,7 +219,7 @@ articulations, just like simple notes.
 
 Rests are entered like notes, with the note name @code{r}
 
-@lilypond[quote,raggedright,verbatim]
+@lilypond[fragment,quote,raggedright,verbatim]
 r1 r2 r4 r8
 @end lilypond
 
@@ -235,7 +235,7 @@ leave these rests alone
 
 @cindex @code{\rest}
  
-@lilypond[quote,raggedright,verbatim]
+@lilypond[fragment,quote,raggedright,verbatim]
 a'4\rest d'4\rest
 @end lilypond
 
@@ -254,7 +254,7 @@ Program reference: @internalsref{RestEvent}, and @internalsref{Rest}.
 An invisible rest (also called a `skip') can be entered like a note
 with note name `@code{s}' or with @code{\skip @var{duration}}
 
-@lilypond[quote,raggedright,verbatim]
+@lilypond[fragment,quote,raggedright,verbatim]
 a2 s4 a4 \skip 1 a4 
 @end lilypond
 
@@ -1181,7 +1181,7 @@ The command @code{\bar }@var{bartype} is a short cut for doing
 is set to a string, a bar line of that type is created.
 
 @cindex whichBar
-@cindex repeatCommands
+@cindex @code{repeatCommands}
 @cindex defaultBarType
 
 You are encouraged to use @code{\repeat} for repetitions.  See
@@ -1417,7 +1417,7 @@ all 16th or shorter beams at beat positions, as defined by the
 @code{beatLength} property.
 
 
-@lilypond[quote,relative=2,verbatim,noindent]
+@lilypond[fragment,quote,relative=2,verbatim,noindent]
 c16[ c c c c c c c]
 \set subdivideBeams = ##t
 c16[ c c c c c c c]
@@ -1753,36 +1753,23 @@ f( g)( a) a8 b( a4 g2 f4)
 <c e>2( <b d>2)
 @end lilypond
 
+The direction of a slur can be set with the
+generic commands
 
-@c TODO: should explain that ^( and _( set directions
-@c should set attachments with ^ and _ ?  
-
-Slurs avoid crossing stems, and are generally attached to note heads.
-However, in some situations with beams, slurs may be attached to stem
-ends.  If you want to override this layout you can do this through the
-object property @code{attachment} of @internalsref{Slur}.  Its value
-is a pair of symbols, specifying the attachment type of the left and
-right end points
-
-@lilypond[quote,fragment,relative=1,verbatim]
-\slurUp
-\override Stem #'length = #5.5
-g'8(g g4)
-\override Slur #'attachment = #'(stem . stem)
-g8( g g4)
-@end lilypond
+@example
+  \override Slur #'direction = #UP
+  \slurUp     % shortcut for the previous line 
+@end example
 
-If a slur would strike through a stem or beam, the slur will be moved
-away upward or downward. If this happens, attaching the slur to the
-stems might look better
+@noindent
+However, there is a convenient shorthand for forcing slur
+directions. By adding @code{_} or @code{^} before the opening
+parentheses, the direction is also set. For example,  
 
-@lilypond[quote,fragment,relative=1,verbatim]
-\stemUp \slurUp
-d32( d'4 d8..)
-\override Slur #'attachment = #'(stem . stem)
-d,32( d'4 d8..)
+@lilypond[relative=2,fragment]
+   c4_( c)   c^( c)
 @end lilypond
-
 @refcommands
 
 
@@ -1802,12 +1789,6 @@ d,32( d'4 d8..)
 Program reference: @seeinternals{Slur}, and @internalsref{SlurEvent}.
 
 
-@refbugs
-
-Producing nice slurs is a difficult problem, and LilyPond 
-uses a simple, empiric method to produce slurs. In some cases, its
-results are ugly.
-
 
 @cindex Adjusting slurs
 
@@ -1850,8 +1831,7 @@ Program reference: see also @internalsref{PhrasingSlur}, and
 
 @refbugs
 
-Phrasing slurs have the same limitations in their formatting as normal
-slurs. Putting phrasing slurs over rests leads to spurious warnings.
+Putting phrasing slurs over rests leads to spurious warnings.
 
 @node Breath marks
 @subsection Breath marks
@@ -3753,6 +3733,9 @@ ambitus.
 @node Tablatures
 @section Tablatures
 
+@cindex tablature
+@cindex guitar tablature
+
 Tablature notation is used for notating music for plucked string
 instruments.  It notates pitches not by using note heads, but by
 indicating on which string and fret a note must be played.  LilyPond
@@ -3782,6 +3765,7 @@ are printed as tablature, by using @internalsref{TabStaff} and
 @end lilypond
 
 @cindex minimumFret
+@cindex fret
 
 When no string is specified, the first string that does not give a
 fret number less than @code{minimumFret} is selected. The default
@@ -4334,7 +4318,7 @@ and @internalsref{Staff}.@code{instr}. This will print a string before
 the start of the staff. For the first start, @code{instrument} is
 used, for the next ones @code{instr} is used.
 
-@lilypond[quote,verbatim,raggedright,relative=1]
+@lilypond[quote,verbatim,raggedright,relative=1,fragment]
 \set Staff.instrument = "Ploink "
 \set Staff.instr = "Plk "
 c1
@@ -5041,7 +5025,7 @@ with respect to that clef.
 modern style mensural C clef @tab
 @code{neo_mensural_c1}, @code{neo_mensural_c2},
 @code{neo_mensural_c3}, @code{neo_mensural_c4} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "neo_mensural_c2" c
 @end lilypond
@@ -5065,7 +5049,7 @@ petrucci style mensural C clefs, for use  on different  staff lines
 @code{petrucci_c5}
 
 @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "petrucci_c2" c
 @end lilypond
@@ -5074,7 +5058,7 @@ petrucci style mensural C clefs, for use  on different  staff lines
 @code{clefs-petrucci_f} @tab
 petrucci style mensural F clef @tab
 @code{petrucci_f} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "petrucci_f" c
 @end lilypond
@@ -5083,7 +5067,7 @@ petrucci style mensural F clef @tab
 @code{clefs-petrucci_g} @tab
 petrucci style mensural G clef @tab
 @code{petrucci_g} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "petrucci_g" c
 @end lilypond
@@ -5093,7 +5077,7 @@ petrucci style mensural G clef @tab
 historic style mensural C clef @tab
 @code{mensural_c1}, @code{mensural_c2}, @code{mensural_c3},
 @code{mensural_c4} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "mensural_c2" c
 @end lilypond
@@ -5102,7 +5086,7 @@ historic style mensural C clef @tab
 @code{clefs-mensural_f} @tab
 historic style mensural F clef @tab
 @code{mensural_f} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "mensural_f" c
 @end lilypond
@@ -5111,7 +5095,7 @@ historic style mensural F clef @tab
 @code{clefs-mensural_g} @tab
 historic style mensural G clef @tab
 @code{mensural_g} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "mensural_g" c
 @end lilypond
@@ -5120,7 +5104,7 @@ historic style mensural G clef @tab
 @code{clefs-vaticana_do} @tab
 Editio Vaticana style do clef @tab
 @code{vaticana_do1}, @code{vaticana_do2}, @code{vaticana_do3} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
     \override Staff.StaffSymbol   #'line-count = #4
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "vaticana_do2" c
@@ -5130,7 +5114,7 @@ Editio Vaticana style do clef @tab
 @code{clefs-vaticana_fa} @tab
 Editio Vaticana style fa clef @tab
 @code{vaticana_fa1}, @code{vaticana_fa2} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[quote,relative=1,notime,fragment]
     \override Staff.StaffSymbol   #'line-count = #4
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "vaticana_fa2" c
@@ -5140,7 +5124,7 @@ Editio Vaticana style fa clef @tab
 @code{clefs-medicaea_do} @tab
 Editio Medicaea style do clef @tab
 @code{medicaea_do1}, @code{medicaea_do2}, @code{medicaea_do3} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
     \override Staff.StaffSymbol   #'line-count = #4
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "medicaea_do2" c
@@ -5150,7 +5134,7 @@ Editio Medicaea style do clef @tab
 @code{clefs-medicaea_fa} @tab
 Editio Medicaea style fa clef @tab
 @code{medicaea_fa1}, @code{medicaea_fa2} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
     \override Staff.StaffSymbol   #'line-count = #4
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "medicaea_fa2" c
@@ -5160,7 +5144,7 @@ Editio Medicaea style fa clef @tab
 @code{clefs-hufnagel_do} @tab
 historic style hufnagel do clef @tab
 @code{hufnagel_do1}, @code{hufnagel_do2}, @code{hufnagel_do3} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
     \override Staff.StaffSymbol   #'line-count = #4
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "hufnagel_do2" c
@@ -5170,7 +5154,7 @@ historic style hufnagel do clef @tab
 @code{clefs-hufnagel_fa} @tab
 historic style hufnagel fa clef @tab
 @code{hufnagel_fa1}, @code{hufnagel_fa2} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
     \override Staff.StaffSymbol   #'line-count = #4
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "hufnagel_fa2" c
@@ -5180,7 +5164,7 @@ historic style hufnagel fa clef @tab
 @code{clefs-hufnagel_do_fa} @tab
 historic style hufnagel combined do/fa clef @tab
 @code{hufnagel_do_fa} @tab
-@lilypond[quote,relative=1,notime]
+@lilypond[fragment,quote,relative=1,notime]
 \override Staff.TimeSignature   #'transparent = ##t
 \clef "hufnagel_do_fa" c
 @end lilypond
@@ -7540,7 +7524,7 @@ Examples: @inputfileref{input/regression,balloon.ly}.
 The `easy play' note head includes a  name inside the head.  It is
 used in music for beginners
 
-@lilypond[quote,raggedright,verbatim,staffsize=26]
+@lilypond[quote,raggedright,verbatim,fragment,staffsize=26]
 \setEasyHeads
 c'2 e'4 f' | g'1
 @end lilypond