Imported Upstream version 2.19.45

[lilypond.git] / Documentation / snippets / tweaking-clef-properties.ly

diff --git a/Documentation/snippets/tweaking-clef-properties.ly b/Documentation/snippets/tweaking-clef-properties.ly
index a43faaca38bdd9a3d6d57e21e2d41674bdc70033..5d1e69c13a328ed61686be8ba5945e60815aad58 100644 (file)
--- a/Documentation/snippets/tweaking-clef-properties.ly
+++ b/Documentation/snippets/tweaking-clef-properties.ly
@@ -1,41 +1,30 @@
 %% DO NOT EDIT this file manually; it is automatically
-%% generated from LSR http://lsr.dsi.unimi.it
+%% generated from LSR http://lsr.di.unimi.it
 %% Make any changes in LSR itself, or in Documentation/snippets/new/ ,
 %% and then run scripts/auxiliar/makelsr.py
 %%
 %% This file is in the public domain.
-\version "2.17.18"
+\version "2.18.0"
 
 \header {
   lsrtags = "pitches, staff-notation, tweaks-and-overrides"
 
   texidoc = "
-The command @code{\\clef \"treble_8\"} is equivalent to setting
-@code{clefGlyph}, @code{clefPosition} (which controls the vertical
-position of the clef), @code{middleCPosition} and
-@code{clefTransposition}. A clef is printed when any of the properties
-except @code{middleCPosition} are changed.
+Changing the Clef glyph, its position, or the ottavation does not
+change the position of subsequent notes on the staff.  To get key
+signatures on their correct staff lines @code{middleCClefPosition} must
+also be specified, with positive or negative values moving @code{middle
+C} up or down respectively, relative to the staff's center line.
 
 
-Note that changing the glyph, the position of the clef, or the
-octavation does not in itself change the position of subsequent notes
-on the staff: the position of middle C must also be specified to do
-this. In order to get key signatures on the correct staff lines,
-@code{middleCClefPosition} must also be set.  The positional parameters
-are relative to the staff center line, positive numbers displacing
-upwards, counting one for each line and space. The
-@code{clefTransposition} value would normally be set to 7, -7, 15 or -15,
-but other values are valid.
+For example, @code{\\clef \"treble_8\"} is equivalent to setting the
+@code{clefGlyph}, @code{clefPosition} (the vertical position of the
+clef itself on the staff), @code{middleCPosition} and
+@code{clefTransposition}. Note that when any of these properties
+(except @code{middleCPosition}) are changed a new clef symbol is
+printed.
 
 
-When a clef change takes place at a line break the new clef symbol is
-printed at both the end of the previous line and the beginning of the
-new line by default. If the warning clef at the end of the previous
-line is not required it can be suppressed by setting the @code{Staff}
-property @code{explicitClefVisibility} to the value
-@code{end-of-line-invisible}. The default behavior can be recovered
-with  @code{\\unset Staff.explicitClefVisibility}.
-
 The following examples show the possibilities when setting these
 properties manually. On the first line, the manual changes preserve the
 standard relative positioning of clefs and notes, whereas on the second
@@ -45,7 +34,6 @@ line, they do not.
   doctitle = "Tweaking clef properties"
 } % begin verbatim
 
-\layout { ragged-right = ##t }
 {
   % The default treble clef
   \key f \major