release: 1.3.56

[lilypond.git] / Documentation / user / refman.itely

diff --git a/Documentation/user/refman.itely b/Documentation/user/refman.itely
index 4a5a95c7a2a5a6763a27b6d22042cc8ee1a706e9..f7e64d0e283accf0eec1d487188276f8c216b0b2 100644 (file)
--- a/Documentation/user/refman.itely
+++ b/Documentation/user/refman.itely
@@ -312,8 +312,6 @@ Simply include the language specific init file.  For example:
 `@code{\include "english.ly"}'.  The available language files and the
 names they define are:
 
-@quotation
-
 @example 
                         Note Names               sharp       flat
 nederlands.ly  c   d   e   f   g   a   bes b   -is         -es
@@ -325,8 +323,6 @@ italiano.ly    do  re  mi  fa  sol la  sid si  -d          -b
 catalan.ly     do  re  mi  fa  sol la  sid si  -d/-s       -b 
 @end example 
 
-@end quotation
-
 Pitch names can be redefined using the
 @code{\notenames}@keyindex{notenames} command, see
 subsection XREF-notenames [FIXME].
@@ -394,7 +390,7 @@ different modes have different rules for deciding what is a word.
     over 127, or a two-character combination of a backslash followed
     by one of `@code{`}', `@code{'}', `@code{"}', or
     `@code{^}'.@footnote{The purpose of Lyrics mode is that you can
-    enter lyrics in TeX format or a standard encoding without
+    enter lyrics in @TeX{} format or a standard encoding without
     needing quotes.  The precise definition of this mode indeed is
     ludicrous.  This will remain so until the authors of LilyPond
     acquire a deeper understanding of character encoding, or someone
@@ -410,10 +406,7 @@ different modes have different rules for deciding what is a word.
     spaces into words without using quotes.  Quoted words can also be
     used in Lyrics mode to specify words that cannot be written with
     the above rules.  Here are some examples.  Not all of these words
-    are printable by TeX.
-
-
-    @quotation
+    are printable by @TeX{}.
 
 @example 
 Ah!             % a word
@@ -422,8 +415,6 @@ Ah!             % a word
 _ _ _ _         % 4 words, each one a space 
 @end example 
 
-    @end quotation
-
     Since combinations of numbers and dots are used for indicating
     durations, you can not enter real numbers in this mode.
 @end table
@@ -703,11 +694,10 @@ r1 r2 r4 r8 r16 r32 r64 r64
     loose_column_distance = 2.5 * \interline;
     linewidth = -1.0;
     \translator {
-      \type "Score_engraver";
-      \name "Score";
-      \consists "Rest_engraver";
-      \consists "Stem_engraver";
-      \consists "Rhythmic_column_engraver";
+       \StaffContext
+       \remove "Clef_engraver";
+       \remove "Staff_symbol_engraver";
+       \remove "Bar_engraver";
     }
   }
 }
@@ -784,6 +774,33 @@ Usually this is used to switch staffs in Piano music, e.g.
 @end example
 
 
+@cindex output properties
+
+
+These allow you to tweak what is happening in the back-end
+directly. If you want to control every detail of the output
+formatting, this is the feature to use. The downside to this is that
+you need to know exactly how the backend works. Example:
+
+
+@mudela[fragment,verbatim]
+\relative c'' { c4
+       \context Staff \outputproperty
+               #(make-type-checker 'Note_head)
+               #'extra-offset = #'(5.0 . 7.5)
+<c8 e g> }
+@end mudela
+
+This selects all note heads occurring at current staff level, and sets
+the extra-offset of those heads to (5,7.5), shifting them up and
+right.
+
+Use of this feature is entirely on your own risk: if you use this, the
+result will depend very heavily on the implentation of the backend,
+which we change unscrupulously.
+
+
+
 
 @cindex commands
 
@@ -1011,6 +1028,8 @@ Some more elaborate constructions:
 
 Beaming can be generated automatically; see section XREF-autobeam [FIXME].
 
+[OUTDATED, FIXME]
+
 To place tremolo marks 
 @cindex tremolo beams
  between two notes, begin
@@ -1107,7 +1126,7 @@ name of the corresponding symbol appearing underneath.
 @end mudela
 
 In addition, it is possible to place arbitrary strings of text or
-TeX above or below notes by using a string instead of an
+@TeX{} above or below notes by using a string instead of an
 identifier: `@code{c^"text"}'.  Fingerings 
 @cindex fingering
  can be
@@ -1255,13 +1274,13 @@ The slur syntax with parentheses is a shorthand for this.
 
 @cindex tremolo marks
 
-@node tremolo, , ,  Reference Manual
+@node stem tremolo, , ,  Reference Manual
 
 Tremolo marks can be printed on a single note by adding
 `@code{:}[@var{length}]' after the note.  The length must be at
 least 8.  A @var{length} value of 8 gives one line across
 the note stem.  If the length is omitted, then the last value is
-used, or the value of the @code{abbrev}@indexcode{abbrev} property if there was
+used, or the value of the @code{tremoloFlags}@indexcode{tremoloFlags} property if there was
 no last value.
 
 @mudela[verbatim,fragment,center]
@@ -2739,7 +2758,7 @@ The engravers for paper output are:
 
   @item @code{Staff_group_bar_engraver}@indexcode{Staff_group_bar_engraver}
 
-  @item @code{Staff_margin_engraver}@indexcode{Staff_margin_engraver}  
+  @item @code{Instrument_name_engraver}@indexcode{Instrument_name_engraver}
     Prints the name of the instrument (specified by
     @code{Staff.instrument} and @code{Staff.instr}) at the left of the
     staff.
@@ -2808,8 +2827,7 @@ instrument name should be chosen from the following list.  If the
 selected string does not exactly match, then LilyPond uses the default
 piano.
 
-
-@quotation
+@c @quotation
 
 @example 
 "acoustic grand"            "contrabass"           "lead 7 (fifths)"
@@ -2857,7 +2875,7 @@ piano.
 "cello"                     "lead 6 (voice)" 
 @end example 
 
-@end quotation
+@c @end quotation
 
 
 @cindex MIDI types and performers