]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/user/refman.itely
* mf/GNUmakefile: always trace pfa fonts.
[lilypond.git] / Documentation / user / refman.itely
index de7758a847a4a843633bd9779a6f2314ea502c60..8e3eae139c92cd638f73ee24cd2e2b6828c78f0f 100644 (file)
@@ -109,6 +109,9 @@ names are the Dutch note names.  In Dutch, @code{aes} is contracted to
 Half-flats and half-sharps are formed by adding @code{-eh} and
 @code{-ih}; the following is a series of Cs with increasing pitches:
 
+@cindex quarter tones
+@cindex semi-flats, semi-sharps
+
 @lilypond[verbatim,relative 2]
   ceses4
   ceseh
@@ -813,7 +816,7 @@ using @code{\override} or @code{\set}.  At the moment that
 @code{\property Staff} is interpreted, a @internalsref{Staff} context
 is made, and the @internalsref{StaffSymbol} is created before any
 @code{\override} is effective. Properties can be changed in a
-@code{\translator} definition, or by using @code{\outputproperty}.
+@code{\translator} definition, or by using @code{\applyoutput}.
 
 @refbugs
 
@@ -3554,18 +3557,19 @@ making or a music identifier @code{\foo} containing the syllable
 @subsection Ambitus
 @cindex ambitus
 
-The term @emph{ambitus} denotes a range of pitches for a given voice in
-a part of music.  It also may denote the pitch range that a musical
-instrument is capable of playing.  Most musical instruments have their
-ambitus standardized (or at least there is agreement upon the minimal
-ambitus of a particular type of instrument), such that a composer or
-arranger of a piece of music can easily meet the ambitus constraints of
-the targeted instrument.  However, the ambitus of the human voice
-depends on individual physiological state, including education and
-training of the voice.  Therefore, a singer potentially has to check for
-each piece of music if the ambitus of that piece meets his individual
-capabilities.  This is why the ambitus of a piece may be of particular
-value to vocal performers.
+The term @emph{ambitus} (plural: ambituses) denotes a range of pitches
+for a given voice in a part of music.  It also may denote the pitch
+range that a musical instrument is capable of playing.  Most musical
+instruments have their ambitus standardized (or at least there is
+agreement upon the minimal ambitus of a particular type of
+instrument), such that a composer or arranger of a piece of music can
+easily meet the ambitus constraints of the targeted instrument.
+However, the ambitus of the human voice depends on individual
+physiological state, including education and training of the voice.
+Therefore, a singer potentially has to check for each piece of music
+if the ambitus of that piece meets his individual capabilities.  This
+is why the ambitus of a piece may be of particular value to vocal
+performers.
 
 The ambitus is typically notated on a per-voice basis at the very
 beginning of a piece, e.g. nearby the initial clef or time signature of
@@ -3619,7 +3623,7 @@ ambitus per staff rather than per each voice, then add the
 @internalsref{Ambitus_engraver} to the @internalsref{Staff} context
 rather than to the @internalsref{Voice} context.
 
-It is possible to tune individual ambiti for multiple voices on a
+It is possible to tune individual ambituses for multiple voices on a
 single staff, for example by erasing or shifting them horizontally. An
 example is in @inputfileref{input/test,ambitus-mixed.ly}
 
@@ -3708,7 +3712,7 @@ chord.
 You can change the number of strings, by setting the number of lines
 in the @internalsref{TabStaff} (the @code{line-count} property of
 @internalsref{TabStaff} can only be changed using
-@code{\outputproperty}, for more information, see @ref{Tuning
+@code{\applyoutput}, for more information, see @ref{Tuning
 objects}).
 
 You can change the tuning of the strings. A string tuning is given as
@@ -3722,8 +3726,8 @@ g:
 @lilypond[fragment,verbatim]
   \context TabStaff <<
 
-    \outputproperty #(make-type-checker 'staff-symbol-interface)
-                    #'line-count = #4
+    \applyoutput #(outputproperty-compatibility (make-type-checker 'staff-symbol-interface)
+                    'line-count 4)
     \property TabStaff.stringTunings =  #'(-5 -10 -15 -20)
     
     \notes {
@@ -4887,7 +4891,7 @@ Editio Vaticana style do clef @tab
 @code{vaticana_do1}, @code{vaticana_do2}, @code{vaticana_do3} @tab
 @lilypond[relative 0, notime]
 \context Staff
-\outputproperty #(make-type-checker 'staff-symbol-interface) #'line-count = #4
+\applyoutput #(outputproperty-compatibility (make-type-checker 'staff-symbol-interface) 'line-count 4)
 \property Staff.TimeSignature \set #'transparent = ##t
 \clef "vaticana_do2" c
 @end lilypond
@@ -4898,7 +4902,7 @@ Editio Vaticana style fa clef @tab
 @code{vaticana_fa1}, @code{vaticana_fa2} @tab
 @lilypond[relative 0, notime]
 \context Staff
-\outputproperty #(make-type-checker 'staff-symbol-interface) #'line-count = #4
+\applyoutput #(outputproperty-compatibility (make-type-checker 'staff-symbol-interface) 'line-count 4)
 \property Staff.TimeSignature \set #'transparent = ##t
 \clef "vaticana_fa2" c
 @end lilypond
@@ -4909,7 +4913,7 @@ Editio Medicaea style do clef @tab
 @code{medicaea_do1}, @code{medicaea_do2}, @code{medicaea_do3} @tab
 @lilypond[relative 0, notime]
 \context Staff
-\outputproperty #(make-type-checker 'staff-symbol-interface) #'line-count = #4
+\applyoutput #(outputproperty-compatibility (make-type-checker 'staff-symbol-interface) 'line-count 4)
 \property Staff.TimeSignature \set #'transparent = ##t
 \clef "medicaea_do2" c
 @end lilypond
@@ -4920,7 +4924,7 @@ Editio Medicaea style fa clef @tab
 @code{medicaea_fa1}, @code{medicaea_fa2} @tab
 @lilypond[relative 0, notime]
 \context Staff
-\outputproperty #(make-type-checker 'staff-symbol-interface) #'line-count = #4
+\applyoutput #(outputproperty-compatibility (make-type-checker 'staff-symbol-interface) 'line-count 4)
 \property Staff.TimeSignature \set #'transparent = ##t
 \clef "medicaea_fa2" c
 @end lilypond
@@ -4931,7 +4935,7 @@ historic style hufnagel do clef @tab
 @code{hufnagel_do1}, @code{hufnagel_do2}, @code{hufnagel_do3} @tab
 @lilypond[relative 0, notime]
 \context Staff
-\outputproperty #(make-type-checker 'staff-symbol-interface) #'line-count = #4
+\applyoutput #(outputproperty-compatibility (make-type-checker 'staff-symbol-interface) 'line-count 4)
 \property Staff.TimeSignature \set #'transparent = ##t
 \clef "hufnagel_do2" c
 @end lilypond
@@ -4942,7 +4946,7 @@ historic style hufnagel fa clef @tab
 @code{hufnagel_fa1}, @code{hufnagel_fa2} @tab
 @lilypond[relative 0, notime]
 \context Staff
-\outputproperty #(make-type-checker 'staff-symbol-interface) #'line-count = #4
+\applyoutput #(outputproperty-compatibility (make-type-checker 'staff-symbol-interface) 'line-count 4)
 \property Staff.TimeSignature \set #'transparent = ##t
 \clef "hufnagel_fa2" c
 @end lilypond
@@ -8509,17 +8513,13 @@ The contexts for MIDI output are defined in @file{ly/performer-init.ly}.
 
 @cindex instrument names
 @cindex @code{Staff.midiInstrument}
-@cindex @code{Staff.instrument}
 
 The MIDI instrument name is set by the @code{Staff.midiInstrument}
-property or, if that property is not set, the @code{Staff.instrument}
 property.  The instrument name should be chosen from the list in
 @ref{MIDI instruments}.
 
 @refbugs
 
-If the selected string does not exactly match, then LilyPond uses the
-default (Grand Piano). It is not possible to select an instrument by
-number.
-
+If the selected string does not exactly match, then the default is
+used, which is the Grand Piano.