]> git.donarmstrong.com Git - lilypond.git/commitdiff
Merge branch 'master' into lilypond/translation
authorJohn Mandereau <john.mandereau@gmail.com>
Wed, 13 Aug 2008 16:39:57 +0000 (18:39 +0200)
committerJohn Mandereau <john.mandereau@gmail.com>
Wed, 13 Aug 2008 16:39:57 +0000 (18:39 +0200)
* master:
  Add 'See also's to LM 3 'Fundamental concepts'
  Move sections in French and German docs
  GDP LM 3.3.4 Explaining \context
  Updates to chords.itely, fretted-strings.itely
  Compile fix.
  Update from Kurt.
  Update fretted-strings.itely
  staff-symbol-referencer.cc: Junk redundant functions.
  Robustify Staff_symbol_referencer::on_line ().
  Update fretted-strings.itely
  Change type predicate for 'layer to integer.
  Replacing "User Manual" with "Notation Ref" in SL

20 files changed:
Documentation/de/user/ancient.itely
Documentation/de/user/pitches.itely
Documentation/de/user/spacing.itely
Documentation/de/user/tweaks.itely
Documentation/de/user/working.itely
Documentation/fr/user/ancient.itely
Documentation/fr/user/changing-defaults.itely
Documentation/fr/user/editorial.itely
Documentation/fr/user/pitches.itely
Documentation/fr/user/spacing.itely
Documentation/fr/user/tweaks.itely
Documentation/fr/user/working.itely
Documentation/user/chords.itely
Documentation/user/fretted-strings.itely
Documentation/user/fundamental.itely
Documentation/user/music-glossary.tely
input/lsr/lilypond-snippets.tely
lily/include/staff-symbol-referencer.hh
lily/staff-symbol-referencer.cc
scm/define-grob-properties.scm

index 6f1446db67dcdefaa687889f0121e60251b302b2..77cfa539570e6d3d0b0d7ce35d41dd96619b2a7d 100644 (file)
@@ -163,7 +163,7 @@ des @rinternals{KeySignature}-Objektes gesetzt wird.
 
 @seealso
 
-In diesem Handbuch: @ref{Pitches}, @ref{Cautionary accidentals} und
+In diesem Handbuch: @ref{Pitches}, @ref{Accidentals} und
 @ref{Automatic accidentals} geben eine allgemeine Einführung in die Benutzung
 von Versetzungszeichen. Der Abschnitt @ref{Key signature} zeigt die allgemeine
 Benutzung von Vorzeichen.
index 17ce46f1a314c06a83fc7af8686469abc576c1ee..f7404f332e7b0d1b801c71de886b4a27e47f3d51 100644 (file)
@@ -29,15 +29,14 @@ This section discusses how to specify the pitch of notes.
 Into text.
 
 @menu
-* Normal pitches::              
+* Absolute octave entry::       
+* Relative octave entry::       
 * Accidentals::                 
-* Cautionary accidentals::      
-* Micro tones::                 
 * Note names in other languages::  
 @end menu
 
-@node Normal pitches
-@unnumberedsubsubsec Normal pitches
+@node Absolute octave entry
+@unnumberedsubsubsec Absolute octave entry
 
 @cindex Tonhöhenbezeichnungen
 
@@ -82,7 +81,94 @@ Eine alternative Methode gibt am Anfang die Oktave vor,
 innerhalb derer die Noten gesetzt werden, dabei werden 
 unter Umständen weniger Oktavangaben (@code{'} oder @code{,})
 benötigt. Siehe auch 
-@ref{Relative octaves}.
+@ref{Relative octave entry}.
+
+
+@node Relative octave entry
+@unnumberedsubsubsec Relative octave entry
+
+@cindex Relativ
+@cindex Relative Oktavbestimmung
+@funindex \relative
+
+Oktaven werden angegeben, indem man @code{'} oder @code{,}
+an die Notenbezeichnung hängt. Wenn Sie schon existierende 
+Musik kopieren, passiert es schnell, eine Note aus Versehen 
+in die falsche Oktave zu setzen, und der Fehler ist schwer zu 
+finden. Der relative Oktaven-Modus verhindert solche Fehler,
+indem mögliche Fehler stark vergrößert werden: ein einziger 
+Oktavierungsfehler wirkt sich auf den gesamten Rest des Stückes aus.
+
+Die Syntax des Befehls lautet:
+
+@example
+\relative @var{Referenzoktave} @var{musikalischer Ausdruck}
+@end example
+
+@noindent
+oder:
+
+@example
+\relative @var{musikalischer Ausdruck}
+@end example
+
+@noindent
+Das eingestrichene C (@code{c'}) wird als Referenzoktave angenommen, 
+wenn sie nicht extra angegeben wird.
+
+Die Oktave von Noten, die im musikalischen Ausdruck notiert sind, 
+wird wie folgt erschlossen: Wenn keine Oktavversetzungszeichen 
+benutzt werden, wird als Intervall zwischen der Noten und der 
+vorhergehenden immer eine Quarte oder kleiner angenommen. Dieser 
+Abstand wird ohne Rücksicht auf Alterationen bestimmt. Eine 
+übermäßige Quarte ist also ein kleineres Intervall als eine 
+verminderte Quinte, auch wenn beide sechs Halbtöne groß sind.
+
+Die Oktavversetzungszeichen @code{'} und @code{,} können 
+hinzugefügt werden, um die Tonhöhe um eine Oktave zu erhöhen 
+oder zu erniedrigen. Wenn der relative Modus beginnt, kann 
+ein Referenzton angegeben werden, der als die vorhergehende Note 
+für die erste Tonhöhe des musikalischen Ausdrucks verwendet 
+wird. Wenn dieser Referenzton nicht angeben wird, wird das 
+eingestrichene C verwendet.
+
+So funktioniert der relative Modus:
+
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+  b c d c b c bes a
+}
+@end lilypond
+
+Oktavversetzungen müssen für alle Intervalle angezeigt werden, 
+die größer als eine Quarte sind.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c'' {
+  c g c f, c' a, e''
+}
+@end lilypond
+
+Wenn der vorherige Ausdruck ein Akkord ist, wird die erste Note 
+des Akkordes benutzt, um die erste Note des nächsten Akkordes zu 
+bestimmen.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  c <c e g>
+  <c' e g>
+  <c, e' g>
+}
+@end lilypond
+
+Die Tonhöhe nach @code{\relative} muss eine Notenbezeichnung enthalten.
+
+Die relative Veränderung wirkt sich nicht auf 
+Transposition (@code{\transpose}),
+Akkordnotation (@code{\chordmode}) oder @code{\relative}-Abschnitte 
+aus.  Um den relativen Modus innerhalb von transponierter Musik zu 
+verwenden, muss ein zusätzliches @code{\relative} innerhalb der 
+Klammern des @code{\transpose}-Befehls gesetzt werden.
 
 
 @node Accidentals
@@ -158,7 +244,34 @@ Programmreferenz: @rinternals{LedgerLineSpanner},
 @rinternals{NoteHead}.
 
 
-@node Cautionary accidentals
+@unnumberedsubsubsec Micro tones
+
+@cindex Vierteltöne
+@cindex Vorzeichen, Vierteltöne
+@cindex Versetzungszeichen, Vierteltöne
+@cindex Mikrotöne
+
+Versetzungszeichen für Vierteltöne werden durch Anhängen der Endungen 
+@code{-eh} (Erniedrigung) und @code{-ih} (Erhöhung) an den 
+Tonhöhenbuchstaben erstellt. Das Beispiel zeigt eine in Vierteltönen 
+aufsteigende Serie vom kleinen C.
+
+@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
+\set Staff.extraNatural = ##f
+ceseh ceh cih cisih
+@end lilypond
+
+Mikrotöne werden auch in die MIDI-Dateien geschrieben.
+
+
+
+@knownissues
+
+Es gibt keine allgemein anerkannten Standards für die 
+Notation von Dreiviertelton-Erniedrigungszeichen. LilyPonds
+Symbol entspricht also keinem Standard.
+
+
 @unnumberedsubsubsec Cautionary accidentals
 
 @cindex Versetzungszeichen, Erinnerung
@@ -190,35 +303,6 @@ beeinflusst werden. Mehr Information dazu siehe
  @ref{Automatic accidentals}.
 
 
-@node Micro tones
-@unnumberedsubsubsec Micro tones
-
-@cindex Vierteltöne
-@cindex Vorzeichen, Vierteltöne
-@cindex Versetzungszeichen, Vierteltöne
-@cindex Mikrotöne
-
-Versetzungszeichen für Vierteltöne werden durch Anhängen der Endungen 
-@code{-eh} (Erniedrigung) und @code{-ih} (Erhöhung) an den 
-Tonhöhenbuchstaben erstellt. Das Beispiel zeigt eine in Vierteltönen 
-aufsteigende Serie vom kleinen C.
-
-@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
-\set Staff.extraNatural = ##f
-ceseh ceh cih cisih
-@end lilypond
-
-Mikrotöne werden auch in die MIDI-Dateien geschrieben.
-
-
-
-@knownissues
-
-Es gibt keine allgemein anerkannten Standards für die 
-Notation von Dreiviertelton-Erniedrigungszeichen. LilyPonds
-Symbol entspricht also keinem Standard.
-
-
 @node Note names in other languages
 @unnumberedsubsubsec Note names in other languages
 
@@ -286,99 +370,12 @@ espanol.ly     do  re  mi  fa  sol la  sib si
 @subsection Changing multiple pitches
 
 @menu
-* Relative octaves::            
-* Octave check::                
+* Octave checks::               
 * Transpose::                   
 @end menu
 
-@node Relative octaves
-@unnumberedsubsubsec Relative octaves
-
-@cindex Relativ
-@cindex Relative Oktavbestimmung
-@funindex \relative
-
-Oktaven werden angegeben, indem man @code{'} oder @code{,}
-an die Notenbezeichnung hängt. Wenn Sie schon existierende 
-Musik kopieren, passiert es schnell, eine Note aus Versehen 
-in die falsche Oktave zu setzen, und der Fehler ist schwer zu 
-finden. Der relative Oktaven-Modus verhindert solche Fehler,
-indem mögliche Fehler stark vergrößert werden: ein einziger 
-Oktavierungsfehler wirkt sich auf den gesamten Rest des Stückes aus.
-
-Die Syntax des Befehls lautet:
-
-@example
-\relative @var{Referenzoktave} @var{musikalischer Ausdruck}
-@end example
-
-@noindent
-oder:
-
-@example
-\relative @var{musikalischer Ausdruck}
-@end example
-
-@noindent
-Das eingestrichene C (@code{c'}) wird als Referenzoktave angenommen, 
-wenn sie nicht extra angegeben wird.
-
-Die Oktave von Noten, die im musikalischen Ausdruck notiert sind, 
-wird wie folgt erschlossen: Wenn keine Oktavversetzungszeichen 
-benutzt werden, wird als Intervall zwischen der Noten und der 
-vorhergehenden immer eine Quarte oder kleiner angenommen. Dieser 
-Abstand wird ohne Rücksicht auf Alterationen bestimmt. Eine 
-übermäßige Quarte ist also ein kleineres Intervall als eine 
-verminderte Quinte, auch wenn beide sechs Halbtöne groß sind.
-
-Die Oktavversetzungszeichen @code{'} und @code{,} können 
-hinzugefügt werden, um die Tonhöhe um eine Oktave zu erhöhen 
-oder zu erniedrigen. Wenn der relative Modus beginnt, kann 
-ein Referenzton angegeben werden, der als die vorhergehende Note 
-für die erste Tonhöhe des musikalischen Ausdrucks verwendet 
-wird. Wenn dieser Referenzton nicht angeben wird, wird das 
-eingestrichene C verwendet.
-
-So funktioniert der relative Modus:
-
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
-}
-@end lilypond
-
-Oktavversetzungen müssen für alle Intervalle angezeigt werden, 
-die größer als eine Quarte sind.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
-}
-@end lilypond
-
-Wenn der vorherige Ausdruck ein Akkord ist, wird die erste Note 
-des Akkordes benutzt, um die erste Note des nächsten Akkordes zu 
-bestimmen.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
-}
-@end lilypond
-
-Die Tonhöhe nach @code{\relative} muss eine Notenbezeichnung enthalten.
-
-Die relative Veränderung wirkt sich nicht auf 
-Transposition (@code{\transpose}),
-Akkordnotation (@code{\chordmode}) oder @code{\relative}-Abschnitte 
-aus.  Um den relativen Modus innerhalb von transponierter Musik zu 
-verwenden, muss ein zusätzliches @code{\relative} innerhalb der 
-Klammern des @code{\transpose}-Befehls gesetzt werden.
-
-@node Octave check
-@unnumberedsubsubsec Octave check
+@node Octave checks
+@unnumberedsubsubsec Octave checks
 
 @cindex Oktavenüberprüfung
 
@@ -739,30 +736,39 @@ Programmreferenz: @rinternals{KeyCancellation},
 @node Ottava brackets
 @unnumberedsubsubsec Ottava brackets
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
-
+@end ifhtml
 
 @node Instrument transpositions
 @unnumberedsubsubsec Instrument transpositions
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 
 @node Automatic accidentals
 @unnumberedsubsubsec Automatic accidentals
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @node Ambitus
 @unnumberedsubsubsec Ambitus
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 
 @node Note heads
 @subsection Note heads
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @menu
 * Special note heads::          
@@ -774,19 +780,27 @@ UNTRANSLATED NODE: IGNORE ME
 @node Special note heads
 @unnumberedsubsubsec Special note heads
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @node Easy notation note heads
 @unnumberedsubsubsec Easy notation note heads
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @node Shape note heads
 @unnumberedsubsubsec Shape note heads
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
 
 @node Improvisation
 @unnumberedsubsubsec Improvisation
 
+@ifhtml
 UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
index d5ffc2ac68bbf39a61491ef73afa69534a9dab8f..80d801229490cf3635ebb084d65aa461528e5776 100644 (file)
@@ -1,7 +1,7 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: de -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
+    Translation of GIT committish: 3121682025660b6c85fbf3f22bb9cd8396699ad1
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
@@ -293,10 +293,87 @@ UNTRANSLATED NODE: IGNORE ME
 @node Changing spacing
 @subsection Changing spacing
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
-
-
+Manchmal bleiben nur noch ein oder zwei Systeme auf der 
+letzten Seite übrig. Das ist immer ärgerlich, besonders 
+wenn es scheint, dass auf den vorigen Seiten genug Platz 
+ist, um die Systeme noch unterzubringen.
+
+Wenn man versucht, das Layout zu verändern, kommt einem 
+der Befehl @code{annotate-spacing} zu Hilfe. Mit diesem 
+Befehl erhält man die Werte von verschiedenen Abstandsbefehlen 
+ausgedruckt, mehr Information im Kapitel @ref{Displaying spacing}.
+Anhand dieser Angaben kann dann entschieden werden, welche 
+Werte verändert werden müssen.
+
+Neben Rändern gibt es nämlich weitere Optionen, Platz zu sparen:
+
+@itemize
+@item
+LilyPond kann die Systeme so dicht wie möglich platzieren (damit 
+so viele Systeme wie möglich auf eine Seite passen), aber sie 
+dann so anordnen, dass kein weißer Rand unten auf der Seite entsteht.
+
+@example
+\paper @{
+  between-system-padding = #0.1
+  between-system-space = #0.1
+  ragged-last-bottom = ##f
+  ragged-bottom = ##f
+@}
+@end example
+
+@item
+Die Anzahl der Systeme kann reduziert werden (wenn LilyPond 
+die Musik auf 11 Systeme verteilt, kann man die Benutzung von 
+nur 10 Systemen erzwingen).
+
+@example
+\paper @{
+  system-count = #10
+@}
+@end example
+
+@item
+Vermeidung von Objekten, die den vertikalen Abstand von Systemen 
+vergrößern, hilft oft. Die Verwendung von Klammern bei Wiederholungen 
+etwa braucht mehr Platz. Wenn die Noten innerhalb der Klammern  auf 
+zwei Systeme verteilt sind, brauchen sie mehr Platz, als wenn sie 
+nur auf einer Zeile gedruckt werden.
+
+Ein anderes Beispiel ist es, Dynamik-Zeichen, die besonders 
+weit @qq{hervorstehen}, zu verschieben.
+
+@lilypond[verbatim,quote,fragment]
+\relative c' {
+  e4 c g\f c
+  \override DynamicLineSpanner #'padding = #-1.8
+  \override DynamicText #'extra-offset = #'( -2.1 . 0)
+  e4 c g\f c
+}
+@end lilypond
+
+@item
+Die horizontalen Abstände können mit der 
+ @code{SpacingSpanner}-Eigenschaft verändert werden.  Siehe
+@ref{Changing horizontal spacing} für Einzelheiten.
+
+@lilypond[verbatim,quote]
+\score {
+  \relative c'' {
+    g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
+    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+    d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
+    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+  }
+  \layout {
+    \context {
+      \Score
+      \override SpacingSpanner
+                #'base-shortest-duration = #(ly:make-moment 1 4)
+    }
+  }
+}
+@end lilypond
+
+@end itemize
 
-@c -- SKELETON FILE --
index 2eb716d3c9a289f8d04d2e6cb753fa80552384c1..01604d3c583f1f17cae3c337df5cd7d0aa2b675e 100644 (file)
@@ -18,18 +18,172 @@ Notenfragment kann geändert werden.
 
 
 @menu
-* Moving objects::              
-* Fixing overlapping notation::  
+* Tweaking basics::             
+* The Internals Reference manual::  
+* Appearance of objects::       
+* Placement of objects::        
+* Collisions of objects::       
 * Common tweaks::               
-* Default files::               
-* Fitting music onto fewer pages::  
-* Advanced tweaks with Scheme::  
-* Avoiding tweaks with slower processing::  
+* Further tweaking::            
 @end menu
 
 
+@node Tweaking basics
+@section Tweaking basics
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Introduction to tweaks::      
+* Objects and interfaces::      
+* Naming conventions of objects and properties::  
+* Tweaking methods::            
+@end menu
+
+@node Introduction to tweaks
+@subsection Introduction to tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Objects and interfaces
+@subsection Objects and interfaces
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Naming conventions of objects and properties
+@subsection Naming conventions of objects and properties
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Tweaking methods
+@subsection Tweaking methods
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node The Internals Reference manual
+@section The Internals Reference manual
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Properties of layout objects::  
+* Properties found in interfaces::  
+* Types of properties::         
+@end menu
+
+@node Properties of layout objects
+@subsection Properties of layout objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Properties found in interfaces
+@subsection Properties found in interfaces
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Types of properties
+@subsection Types of properties
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Appearance of objects
+@section Appearance of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Visibility and color of objects::  
+* Size of objects::             
+* Length and thickness of objects::  
+@end menu
+
+@node Visibility and color of objects
+@subsection Visibility and color of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Size of objects
+@subsection Size of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Length and thickness of objects
+@subsection Length and thickness of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Placement of objects
+@section Placement of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Automatic behavior::          
+* Within-staff objects::        
+* Outside staff objects::       
+@end menu
+
+@node Automatic behavior
+@subsection Automatic behavior
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Within-staff objects
+@subsection Within-staff objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Outside staff objects
+@subsection Outside staff objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+
+@node Collisions of objects
+@section Collisions of objects
+
+@menu
+* Moving objects::              
+* Fixing overlapping notation::  
+* Real music example::          
+@end menu
+
 @node Moving objects
-@section Moving objects
+@subsection Moving objects
 
 Es wird vielleicht eine Überraschung sein, aber LilyPond ist nicht 
 perfekt. Einige Notationselemente können sich überschneiden. Das 
@@ -171,7 +325,7 @@ c4^"piu mosso" d e f
 
 
 @node Fixing overlapping notation
-@section Fixing overlapping notation
+@subsection Fixing overlapping notation
 
 Im Kapitel @ref{Moving objects} wurde gezeigt, wie man Texte 
 (@code{TextScript}-Objekte) verschiebt. Mit der gleichen 
@@ -214,8 +368,18 @@ aber die gebräuchlichsten finden sich hier:
 @end multitable
 
 
+@node Real music example
+@subsection Real music example
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+
+@c DEPRECATED SECTION
 @node Common tweaks
 @section Common tweaks
+
 Bestimmte Korrekturen sind so häufig, dass für sie schon fertige 
 angepasste Befehle bereitgestellt sind, so etwa 
  @code{\slurUp} um einen Bindebogen oberhalb anzuzeigen oder 
@@ -352,8 +516,33 @@ verhalten sich anders, etwa die Dicke von Balken ist an die
 Notenzeilenabstände gekoppelt. Mehr Information findet sich 
 im relevanten Teil der Programmreferenz.
 
-@node Default files
-@section Default files
+@node Further tweaking
+@section Further tweaking
+
+@menu
+* Other uses for tweaks::       
+* Using variables for tweaks::  
+* Other sources of information::  
+* Avoiding tweaks with slower processing::  
+* Advanced tweaks with Scheme::  
+@end menu
+
+@node Other uses for tweaks
+@subsection Other uses for tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Using variables for tweaks
+@subsection Using variables for tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Other sources of information
+@subsection Other sources of information
 
 Die Programmreferenz enthält sehr viel Information über LilyPond, aber 
 noch mehr Information findet sich in den internen 
@@ -386,96 +575,23 @@ Dateien wie @file{ly/property-init.ly} und
 @file{ly/declarations-init.ly} definieren alle häufig vorkommenden Veränderungen.
 
 
-@node Fitting music onto fewer pages
-@section Fitting music onto fewer pages
-
-Manchmal bleiben nur noch ein oder zwei Systeme auf der 
-letzten Seite übrig. Das ist immer ärgerlich, besonders 
-wenn es scheint, dass auf den vorigen Seiten genug Platz 
-ist, um die Systeme noch unterzubringen.
-
-Wenn man versucht, das Layout zu verändern, kommt einem 
-der Befehl @code{annotate-spacing} zu Hilfe. Mit diesem 
-Befehl erhält man die Werte von verschiedenen Abstandsbefehlen 
-ausgedruckt, mehr Information im Kapitel @ruser{Displaying spacing}. 
-Anhand dieser Angaben kann dann entschieden werden, welche 
-Werte verändert werden müssen.
-
-Neben Rändern gibt es nämlich weitere Optionen, Platz zu sparen:
-
-@itemize
-@item
-LilyPond kann die Systeme so dicht wie möglich platzieren (damit 
-so viele Systeme wie möglich auf eine Seite passen), aber sie 
-dann so anordnen, dass kein weißer Rand unten auf der Seite entsteht.
-
-@example
-\paper @{
-  between-system-padding = #0.1
-  between-system-space = #0.1
-  ragged-last-bottom = ##f
-  ragged-bottom = ##f
-@}
-@end example
+@node Avoiding tweaks with slower processing
+@subsection Avoiding tweaks with slower processing
 
-@item
-Die Anzahl der Systeme kann reduziert werden (wenn LilyPond 
-die Musik auf 11 Systeme verteilt, kann man die Benutzung vo
-nur 10 Systemen erzwingen).
+LilyPond kann einige zusätzliche Tests durchführen, während 
+die Noten gesetzt werden. Dadurch braucht das Programm länger, 
+um den Notensatz zu produzieren, aber üblicherweise werde
+weniger nachträgliche Anpassungen nötig sein.
 
 @example
-\paper @{
-  system-count = #10
-@}
+%%  Um sicher zu gehen, dass Texte und Liedtext 
+%%  innerhalb der Papierränder bleiben
+\override Score.PaperColumn #'keep-inside-line = ##t 
 @end example
 
-@item
-Vermeidung von Objekten, die den vertikalen Abstand von Systemen 
-vergrößern, hilft oft. Die Verwendung von Klammern bei Wiederholungen 
-etwa braucht mehr Platz. Wenn die Noten innerhalb der Klammern  auf 
-zwei Systeme verteilt sind, brauchen sie mehr Platz, als wenn sie 
-nur auf einer Zeile gedruckt werden.
-
-Ein anderes Beispiel ist es, Dynamik-Zeichen, die besonders 
-weit @qq{hervorstehen}, zu verschieben.
-
-@lilypond[verbatim,quote,fragment]
-\relative c' {
-  e4 c g\f c
-  \override DynamicLineSpanner #'padding = #-1.8
-  \override DynamicText #'extra-offset = #'( -2.1 . 0)
-  e4 c g\f c
-}
-@end lilypond
-
-@item
-Die horizontalen Abstände können mit der 
- @code{SpacingSpanner}-Eigenschaft verändert werden.  Siehe
-@ruser{Changing horizontal spacing} für Einzelheiten.
-
-@lilypond[verbatim,quote]
-\score {
-  \relative c'' {
-    g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-    d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-  }
-  \layout {
-    \context {
-      \Score
-      \override SpacingSpanner
-                #'base-shortest-duration = #(ly:make-moment 1 4)
-    }
-  }
-}
-@end lilypond
-
-@end itemize
-
 
 @node Advanced tweaks with Scheme
-@section Advanced tweaks with Scheme
+@subsection Advanced tweaks with Scheme
 
 Es wurde schon gezeigt, wie die LilyPond-Ausgabe sehr stark verändert 
 werden kann, indem man Befehle wie 
@@ -535,20 +651,3 @@ pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
 }
 @end lilypond
 
-
-@node Avoiding tweaks with slower processing
-@section Avoiding tweaks with slower processing
-
-LilyPond kann einige zusätzliche Tests durchführen, während 
-die Noten gesetzt werden. Dadurch braucht das Programm länger, 
-um den Notensatz zu produzieren, aber üblicherweise werden 
-weniger nachträgliche Anpassungen nötig sein.
-
-@example
-%%  Um sicher zu gehen, dass Texte und Liedtext 
-%%  innerhalb der Papierränder bleiben
-\override Score.PaperColumn #'keep-inside-line = ##t 
-@end example
-
-
-
index 402500ad7f834030b2b09ad17d1c94477390e6e3..4d4c8de092244d6b307f01eefffeeba4906bbc0f 100644 (file)
@@ -83,7 +83,7 @@ vor einem Jahr verwendet hat. Auch @code{convert-ly} benötigt die
 Versionsnummer.
 
 @item @strong{Benutzen Sie Überprüfungen}: @ruser{Bar check}, 
-@ruser{Octave check} und
+@ruser{Octave checks} und
 @ruser{Barnumber check}.  Wenn Sie hier und da diese Überprüfungen 
 einfügen, finden Sie einen möglichen Fehler weit schneller. Wie oft 
 aber 
index 76dec30fc73453d0c771a307ddaa982dfba2169e..6a1c73f25575097a2bbcf810cde38ce12b9a4338 100644 (file)
@@ -236,7 +236,7 @@ par la propriété @code{glyph-name-alist} de l'objet
 
 @seealso
 
-Dans ce manuel : @ref{Pitches}, @ref{Cautionary accidentals}, et
+Dans ce manuel : @ref{Pitches}, @ref{Accidentals}, et
 @ref{Automatic accidentals}, pour les principes généraux d'utilisation
 des altérations ; @ref{Key signature} pour les armures.
 
index 79364ec95831ed4ad6c8967805cf541df2f8c27e..5606cb51d4d2b9d4a84b17b177b8f848f1caf5ea 100644 (file)
@@ -80,368 +80,12 @@ des listes, des chaînes de caractères ou des symboles, en Scheme.}
 @section Automatic notation
 
 Cette section s'intéresse au réglage de l'impression automatique des
-altérations accidentelles et ligatures.
+ligatures.
 
 @menu
-* Automatic accidentals::       
 * Setting automatic beam behavior::  
 @end menu
 
-@node Automatic accidentals
-@subsection Automatic accidentals
-@cindex Altérations accidentelles automatiques
-
-Une fonction a été créée pour regrouper les règles suivant lesquelles
-s'impriment les altérations.  Elle s'invoque de la manière suivante :
-
-@funindex set-accidental-style
-@example
-#(set-accidental-style 'REGLE)
-@end example
-
-@c TODO: check the context stuff below
-@c -does it *really* work?
-@c -the default contexts as specified in
-@c  scm/music-function.scm seem to be different -vv
-
-Cette fonction prend pour argument le nom de la règle d'altérations,
-auquel peut s'ajouter, comme argument facultatif, le contexte
-devant être affecté :
-
-@example
-#(set-accidental-style 'REGLE #('CONTEXTE#))
-@end example
-
-Si aucun contexte n'est spécifié, le contexte @code{Staff} sera affecté ; 
-cependant on peut souhaiter l'appliquer au contexte @code{Voice} en lieu 
-et place.
-
-Les régles d'altérations suivantes sont possibles :
-
-@table @code
-@item default
-C'est la règle d'impression par défaut, qui se rapporte à l'usage 
-en vigueur au XVIIIème siècle : les altérations accidentelles sont valables toute
-une mesure, et uniquement à leur propre octave.
-
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              %#(set-accidental-style 'default) 
-       \musicA }
-       \context Staff = "down"{
-              %#(set-accidental-style 'default)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
-}
-@end lilypond
-
-@item voice
-En principe, LilyPond se souvient de toutes les altérations présentes sur la
-portée (contexte Staff).  Avec cette règle, cependant, les altérations sont indépendantes
-pour chacune des voix. 
-
-
-@example
- \new Staff <<
-        #(set-accidental-style 'voice)
-       @{ @dots{} @}
-       >>
-@end example
-
-De ce fait, les altérations d'une voix sont ignorées dans les autres voix,
-ce qui peut donner lieu à un résultat malencontreux.  Dans l'exemple suivant,
-il est difficile de dire si le deuxième @samp{la} est dièse ou naturel.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'voice) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'voice)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
-}
-@end lilypond
-
-La règle @code{voice} n'est à envisager que dans le cas de voix devant être lues par
-des musiciens différents.  S'il s'agit d'un @q{conducteur}, ou d'une portée destinée
-à un seul musicien, il vaut mieux utiliser @code{modern} ou @code{modern-cautionary}.
-
-
-@item modern
-@funindex modern style accidentals
-Cette règle est la plus courante au XXème siècle.  Les altérations accidentelles
-sont imprimées comme avec le style @code{default}, mais lorsqu'une note non-altérée
-apparaît à une octave différente, ou bien dans la mesure suivante, des bécarres de précaution
-sont ajoutés.  Dans l'exemple suivant, notez ainsi les deux bécarres dans la
-deuxième mesure de la main droite.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern" }}}
-}
-@end lilypond
-
-@item @code{modern-cautionary}
-@funindex modern-cautionary
-Cette règle est équivalente à @code{modern}, mais les bécarres de précaution sont
-imprimés de façon particulière : soit plus petits, soit (par défaut) entre parenthèses.
-Il est possible de le définir au moyen de la propriété @code{cautionary-style}
-pour l'objet @rinternals{AccidentalSuggestion}.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-cautionary" }}}
-}
-@end lilypond
-
-@funindex modern-voice
-@item modern-voice
-Cette règle sert aux altérations dans de la musique polyphonique destinée
-autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble des voix.
-Les altérations sont imprimées voix par voix, mais les autres voix, dans le même 
-contexte @rinternals{Staff}, en @emph{tiennent compte} cette fois.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern-voice) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern-voice)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice" }}}
-}
-@end lilypond
-
-@funindex modern-voice-cautionary
-@item modern-voice-cautionary
-Cette régle est similaire à la précédente, mais les altérations de précautions
-(celles que n'aurait pas ajoutées @code{voice}), sont imprimées de façon
-particulière.  On retrouve donc toutes les altérations qu'imprimerait
-@code{default}, mais certaines sont considérées comme étant @qq{de précaution}.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'modern-voice-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'modern-voice-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice-cautionary" }}}
-}
-@end lilypond
-
-@item piano
-@funindex piano accidentals
-Cette règle est adaptée aux contextes GrandStaff -- ce qui n'empêche pas de devoir la spécifier 
-pour chaque portée individuelle au sein du contexte GrandStaff.
-
-@example
-\new GrandStaff @{ <<
-  \new Staff = "up" @{ <<
-    #(set-accidental-style 'piano)
-    @{ @dots{} @}
-  >> @}
-  \new Staff = "down"@{ <<
-    #(set-accidental-style 'piano)
-  @{ @dots{} @}
-  >> @}
->> @}
-@end example
-
-Cette règle est communément employée pour les partitions de piano au XXème siècle.
-Très similaire à @code{modern} de par son comportement, elle s'en distingue en ce que
-les altérations tiennent compte des autre portées du contexte @rinternals{GrandStaff} ou
-@rinternals{PianoStaff}.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'piano) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'piano)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'piano" }}}
-}
-@end lilypond
-
-@item piano-cautionary
-@funindex #(set-accidental-style 'piano-cautionary)
-Identique à @code{#(set-accidental-style 'piano)}, mais les altérations de précaution
-sont imprimées différemment.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'piano-cautionary) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'piano-cautionary)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'piano-cautionary" }}}
-}
-@end lilypond
-
-@item no-reset
-@funindex no-reset accidental style
-C'est la même règle que @code{default}, mais l'effet des altérations accidentelles
-ne cesse jamais, même dans les mesures suivantes.
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'no-reset) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'no-reset)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
-}
-@end lilypond
-
-@item forget
-Tout le contraire de @code{no-reset}: l'effet des altérations cesse aussitôt,
-et de ce fait, toutes les altérations, quelque soit leur place dans la mesure, sont
-imprimées, en fonction de l'éventuelle armure.
-
-@lilypond[quote,ragged-right]
-musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
-       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
-
-musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
-       \change Staff = up cis' \change Staff = down <fis, a>  
-       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
-       <f a d>2 |  } }}
-
-\score { 
-       \new PianoStaff {
-       << \context Staff = "up" {
-              #(set-accidental-style 'forget) 
-       \musicA }
-       \context Staff = "down"{
-              #(set-accidental-style 'forget)
-       \musicB } >> }
-       \header { piece = \markup {\fill-line { \fontsize #3  "'forget" }}}
-}
-@end lilypond
-@end table
-
-
-@seealso
-
-Référence du programme : @rinternals{Accidental_engraver},
-@rinternals{Accidental}, @rinternals{AccidentalSuggestion} et @rinternals{AccidentalPlacement}.
-
-
-@knownissues
-
-Les notes simultanées sont considérées comme des évènements séquentiels.
-Ce qui implique que, dans un accord, les altérations accidentelles seront 
-imprimées comme si les notes de l'accords apparaissaient une par une, en fonction
-de l'ordre dans lequels elles ont été saisies -- ce qui peut poser problème lorsqu'au
-sein d'un accord certaines altérations dépendent les unes des autres.
-Ce problème est à résoudre manuellement, en insérant des @code{!} et des @code{?} après les notes
-concernées.
-
-
 @node Setting automatic beam behavior
 @subsection Setting automatic beam behavior
 
@@ -1554,7 +1198,7 @@ propriétés internes).
 Pour aller encore plus loin, plutôt que de simplement parler de l'objet
 @code{Fingering}, ce qui ne nous avance pas à grand chose, on peut aller explorer
 son âme même, dans les fichiers source de LilyPond (voir
-@rlearning{Default files}), en l'occurence le fichier
+@rlearning{Other sources of information}), en l'occurence le fichier
 @file{scm/@/define@/-grobs@/.scm} :
 
 @example
index e502b8ba62683879b7f1b56fc4c5e784f985eaa4..4236c4547d7dbc271422ff04d0c0ec757cbc9743 100644 (file)
@@ -31,7 +31,6 @@
 * Hidden notes::                
 * Coloring objects::            
 * Parentheses::                 
-* Ambitus::                     
 * Stems::                       
 @end menu
 
@@ -291,100 +290,6 @@ comprendre qu'une seule note.
 @end example
 
 
-@node Ambitus
-@unnumberedsubsubsec Ambitus
-@cindex ambitus
-
-L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
-partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
-est capable d'atteindre.  Souvent, cet ambitus est imprimé au début des
-partitions vocales, afin que les exécutants puissent voir au premier
-coup d'oeil s'ils sont en mesure de tenir la partie en question.
-
-Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
-représentant la hauteur la plus basse et la plus haute.  Pour imprimer
-cet ambitus, il faut ajouter le graveur @rinternals{Ambitus_engraver}
-au contexte @rinternals{Voice}.  Ainsi,
-
-@example
-\layout @{
-  \context @{
-    \Voice
-    \consists Ambitus_engraver
-  @}
-@}
-@end example
-
-@noindent
-donne pour résultat
-
-@lilypond[quote,ragged-right]
-\layout {
-  \context {
-    \Staff
-    \consists Ambitus_engraver
-  }
-}
-
-\relative \new Staff {
-  as'' c e2 cis,2
-}
-@end lilypond
-
-Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
-graveur @rinternals{Ambitus_engraver} au contexte @rinternals{Staff}
-plutôt qu'au contexte @rinternals{Voice} ; l'ambitus affiché sera
-alors celui de toutes les voix cumulées, non d'une seule des voix
-actives.
-
-@lilypond[verbatim,ragged-right,quote]
-\new Staff \with {
-  \consists "Ambitus_engraver"
-}
-<<
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c'' {
-    \override Ambitus #'X-offset = #-1.0
-    \voiceOne
-    c4 a d e f2
-  }
-  \new Voice \with {
-    \remove "Ambitus_engraver"
-  } \relative c' {
-    \voiceTwo
-    es4 f g as b2
-  }
->>
-@end lilypond
-
-@noindent
-Cet exemple met en œuvre une fonctionnalité avancée :
-
-@example
-\override Ambitus #'X-offset = #-1.0
-@end example
-
-@noindent
-Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
-être obtenu avec @code{extra-offset}, mais alors le système de mise en
-forme n'aurait pas attribué d'espace supplémentaire pour l'objet
-déplacé.
-
-@seealso
-
-Référence du programme : @rinternals{Ambitus},
-@rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
-@rinternals{AmbitusAccidental}.
-
-Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
-
-@knownissues
-
-LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
-une même portée.
-
-
 @node Stems
 @unnumberedsubsubsec Stems
 
index da5dc12ebb1d72860cd6fe1d66071c17f7c8af8d..fdf73a4530bf6743458fab2f7402d7bbec76ab3b 100644 (file)
@@ -24,28 +24,33 @@ et les options de gravure.
 * Writing pitches::             
 * Changing multiple pitches::   
 * Displaying pitches::          
-* Note heads::
+* Note heads::                  
 @end menu
 
 
 @node Writing pitches
 @subsection Writing pitches
 
-Cette section
+Cette section explique la manière d'indiquer les hauteurs de note.  Il
+y a deux modes d'indiquer l'octave des notes : le mode absolu, et le
+mode relatif.  Le dernier est le plus pratique lors de la saisie d'un
+fichier source au clavier de l'ordinateur.
 
 @menu
-* Normal pitches::              
+* Absolute octave entry::       
+* Relative octave entry::       
 * Accidentals::                 
-* Cautionary accidentals::      
-* Micro tones::                 
 * Note names in other languages::  
 @end menu
 
-@node Normal pitches
-@unnumberedsubsubsec Normal pitches
+@node Absolute octave entry
+@unnumberedsubsubsec Absolute octave entry
 
 @cindex noms de note
 @cindex hauteurs
+@cindex absolues, hauteurs
+@cindex absolues, octaves
+@cindex octaves absolues
 
 La hauteur s'écrit --- à moins de préciser une autre langue --- avec la
 notation anglaise, en utilisant les lettres @code{a} à @code{g}.
@@ -81,7 +86,91 @@ c, c,, e, g d,, d, d c
 
 Il existe une autre méthode pour préciser à quelle octave se situe la
 note à graver ; cette méthode demande moins d'indications d'octave
-(@code{'} ou @code{,}) --- voir @ref{Relative octaves}.
+(@code{'} ou @code{,}) --- voir @ref{Relative octave entry}.
+
+
+@node Relative octave entry
+@unnumberedsubsubsec Relative octave entry
+
+@cindex relatif
+@cindex indication d'octave relative
+@funindex \relative
+
+On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
+hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
+à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
+Le mode d'écriture \relative prévient ces erreurs dans la mesure où
+elles deviennent beaucoup plus évidentes : une seule erreur décale le
+reste de la pièce à une mauvaise octave.
+
+
+@example
+\relative @var{startpitch} @var{musicexpr}
+@end example
+
+@noindent
+ou
+
+@example
+\relative @var{musicexpr}
+@end example
+
+@noindent
+@code{c'} est utilisé par défaut si aucune hauteur de départ n'est
+définie.
+
+L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
+la manière suivante : si aucun signe de changement d'octave n'est
+utilisé, l'intervalle de base entre la note actuelle et la précédente
+sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
+tenir compte des altérations ; ainsi un @code{fisis} après un
+@code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
+une quarte doublement augmentée demeure considérée comme un intervavlle
+plus petit qu'une quinte diminuée, bien que la quarte doublement
+augmentée soit de sept demi-tons et la quinte diminuée de seulement six
+demi-tons.
+
+Les signes de changement d'octave @code{'} et @code{,} peuvent être
+ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
+Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
+départ peut être spécifiée, et agira dès lors comme si elle précédait la
+première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
+spécifiée, le do central sert de point de départ.
+
+Voici le mode \relative en action.
+@lilypond[quote,fragment,ragged-right,verbatim]
+\relative c'' {
+  b c d c b c bes a
+}
+@end lilypond
+
+On utilise les signes de changement d'octave pour les intervalles
+dépassant la quarte.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c'' {
+  c g c f, c' a, e''
+}
+@end lilypond
+
+Si l'expression précédente est un accord, c'est la première note de
+l'accord qui détermine l'emplacement de la première note du prochain
+accord.
+
+@lilypond[quote,ragged-right,fragment,verbatim]
+\relative c' {
+  c <c e g>
+  <c' e g>
+  <c, e' g>
+}
+@end lilypond
+
+La hauteur après @code{\relative} contient un nom de note.
+
+La conversion en mode \relative n'affectera pas les sections @code{\transpose},
+@code{\chordmode} ou @code{\relative} situées dans son argument.  Pour
+utiliser \relative dans de la musique transposée, un code
+@code{\relative} additionnel doit être placé dans @code{\transpose}.
 
 
 @node Accidentals
@@ -141,7 +230,29 @@ Référence du programme : @rinternals{LedgerLineSpanner},
 @rinternals{NoteHead}.
 
 
-@node Cautionary accidentals
+@unnumberedsubsubsec Micro tones
+
+@cindex quarts de ton
+@cindex demi-bémols, demi-dièses
+
+Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
+@code{-eh} et @code{-ih}. Voici une série de dos altérés en hauteurs
+croissantes :
+
+@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
+\set Staff.extraNatural = ##f
+ceseh ceh cih cisih
+@end lilypond
+
+Les micro-intervalles sont aussi exportés dans le fichier MIDI.
+
+@knownissues
+
+Il n'y a pas de standard universellement accepté pour noter le bémol et
+demi (qui abaisse la hauteur trois quarts de ton), le symbole de
+LilyPond n'est donc conforme à aucun standard.
+
+
 @unnumberedsubsubsec Cautionary accidentals
 
 @cindex altération, de précaution
@@ -170,30 +281,6 @@ L'impression automatique des altérations peut être affinée de plusieurs
 manières.  Pour plus d'information, voir @ref{Automatic accidentals}.
 
 
-@node Micro tones
-@unnumberedsubsubsec Micro tones
-
-@cindex quarts de ton
-@cindex demi-bémols, demi-dièses
-
-Les demi-bémols et demi-dièses s'écrivent en ajoutant respectivement
-@code{-eh} et @code{-ih}. Voici une série de dos altérés en hauteurs
-croissantes :
-
-@lilypond[verbatim,ragged-right,quote,relative=2,fragment]
-\set Staff.extraNatural = ##f
-ceseh ceh cih cisih
-@end lilypond
-
-Les micro-intervalles sont aussi exportés dans le fichier MIDI.
-
-@knownissues
-
-Il n'y a pas de standard universellement accepté pour noter le bémol et
-demi (qui abaisse la hauteur trois quarts de ton), le symbole de
-LilyPond n'est donc conforme à aucun standard.
-
-
 @node Note names in other languages
 @unnumberedsubsubsec Note names in other languages
 
@@ -261,97 +348,12 @@ espanol.ly     do  re  mi  fa  sol la  sib si
 @subsection Changing multiple pitches
 
 @menu
-* Relative octaves::            
-* Octave check::                
+* Octave checks::                
 * Transpose::                   
 @end menu
 
-@node Relative octaves
-@unnumberedsubsubsec Relative octaves
-
-@cindex relatif
-@cindex indication d'octave relative
-@funindex \relative
-
-On spécifie les octaves en ajoutant @code{'} et @code{,} aux noms de
-hauteurs.  En recopiant de la musique, on a vite fait de mettre une note
-à la mauvaise octave, et ce genre d'erreur est difficile à retrouver.
-Le mode d'écriture \relative prévient ces erreurs dans la mesure où
-elles deviennent beaucoup plus évidentes : une seule erreur décale le
-reste de la pièce à une mauvaise octave.
-
-
-@example
-\relative @var{startpitch} @var{musicexpr}
-@end example
-
-@noindent
-ou
-
-@example
-\relative @var{musicexpr}
-@end example
-
-@noindent
-@code{c'} est utilisé par défaut si aucune hauteur de départ n'est
-définie.
-
-L'octave des notes mentionnées dans @var{musicexpr} va être calculée de
-la manière suivante : si aucun signe de changement d'octave n'est
-utilisé, l'intervalle de base entre la note actuelle et la précédente
-sera toujours au plus d'une quarte.  Cet intervalle est déterminé sans
-tenir compte des altérations ; ainsi un @code{fisis} après un
-@code{ceses} sera placé au-dessus du @code{ceses}.  En d'autres termes,
-une quarte doublement augmentée demeure considérée comme un intervavlle
-plus petit qu'une quinte diminuée, bien que la quarte doublement
-augmentée soit de sept demi-tons et la quinte diminuée de seulement six
-demi-tons.
-
-Les signes de changement d'octave @code{'} et @code{,} peuvent être
-ajoutés pour hausser ou baisser la note d'une octave supplémentaire.
-Lorsque l'on entre en mode @code{\relative}, une hauteur absolue de
-départ peut être spécifiée, et agira dès lors comme si elle précédait la
-première note de @var{musicexpr}.  Si aucune hauteur de départ n'est
-spécifiée, le do central sert de point de départ.
-
-Voici le mode \relative en action.
-@lilypond[quote,fragment,ragged-right,verbatim]
-\relative c'' {
-  b c d c b c bes a
-}
-@end lilypond
-
-On utilise les signes de changement d'octave pour les intervalles
-dépassant la quarte.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c'' {
-  c g c f, c' a, e''
-}
-@end lilypond
-
-Si l'expression précédente est un accord, c'est la première note de
-l'accord qui détermine l'emplacement de la première note du prochain
-accord.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\relative c' {
-  c <c e g>
-  <c' e g>
-  <c, e' g>
-}
-@end lilypond
-
-La hauteur après @code{\relative} contient un nom de note.
-
-La conversion en mode \relative n'affectera pas les sections @code{\transpose},
-@code{\chordmode} ou @code{\relative} situées dans son argument.  Pour
-utiliser \relative dans de la musique transposée, un code
-@code{\relative} additionnel doit être placé dans @code{\transpose}.
-
-
-@node Octave check
-@unnumberedsubsubsec Octave check
+@node Octave checks
+@unnumberedsubsubsec Octave checks
 
 @cindex vérification d'octave
 
@@ -503,6 +505,8 @@ musique apparaissant dans un @code{\transpose}.
 * Key signature::               
 * Ottava brackets::             
 * Instrument transpositions::   
+* Automatic accidentals::       
+* Ambitus::                     
 @end menu
 
 @node Clef
@@ -769,6 +773,455 @@ c'4^"en sol"
 ...
 @end example
 
+@node Automatic accidentals
+@unnumberedsubsubsec Automatic accidentals
+@cindex Altérations accidentelles automatiques
+
+Une fonction a été créée pour regrouper les règles suivant lesquelles
+s'impriment les altérations.  Elle s'invoque de la manière suivante :
+
+@funindex set-accidental-style
+@example
+#(set-accidental-style 'REGLE)
+@end example
+
+@c TODO: check the context stuff below
+@c -does it *really* work?
+@c -the default contexts as specified in
+@c  scm/music-function.scm seem to be different -vv
+
+Cette fonction prend pour argument le nom de la règle d'altérations,
+auquel peut s'ajouter, comme argument facultatif, le contexte
+devant être affecté :
+
+@example
+#(set-accidental-style 'REGLE #('CONTEXTE#))
+@end example
+
+Si aucun contexte n'est spécifié, le contexte @code{Staff} sera affecté ; 
+cependant on peut souhaiter l'appliquer au contexte @code{Voice} en lieu 
+et place.
+
+Les régles d'altérations suivantes sont possibles :
+
+@table @code
+@item default
+C'est la règle d'impression par défaut, qui se rapporte à l'usage 
+en vigueur au XVIIIème siècle : les altérations accidentelles sont valables toute
+une mesure, et uniquement à leur propre octave.
+
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              %#(set-accidental-style 'default) 
+       \musicA }
+       \context Staff = "down"{
+              %#(set-accidental-style 'default)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'default" }}}
+}
+@end lilypond
+
+@item voice
+En principe, LilyPond se souvient de toutes les altérations présentes sur la
+portée (contexte Staff).  Avec cette règle, cependant, les altérations sont indépendantes
+pour chacune des voix. 
+
+
+@example
+ \new Staff <<
+        #(set-accidental-style 'voice)
+       @{ @dots{} @}
+       >>
+@end example
+
+De ce fait, les altérations d'une voix sont ignorées dans les autres voix,
+ce qui peut donner lieu à un résultat malencontreux.  Dans l'exemple suivant,
+il est difficile de dire si le deuxième @samp{la} est dièse ou naturel.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'voice) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'voice)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'voice" }}}
+}
+@end lilypond
+
+La règle @code{voice} n'est à envisager que dans le cas de voix devant être lues par
+des musiciens différents.  S'il s'agit d'un @q{conducteur}, ou d'une portée destinée
+à un seul musicien, il vaut mieux utiliser @code{modern} ou @code{modern-cautionary}.
+
+
+@item modern
+@funindex modern style accidentals
+Cette règle est la plus courante au XXème siècle.  Les altérations accidentelles
+sont imprimées comme avec le style @code{default}, mais lorsqu'une note non-altérée
+apparaît à une octave différente, ou bien dans la mesure suivante, des bécarres de précaution
+sont ajoutés.  Dans l'exemple suivant, notez ainsi les deux bécarres dans la
+deuxième mesure de la main droite.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'modern) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern" }}}
+}
+@end lilypond
+
+@item @code{modern-cautionary}
+@funindex modern-cautionary
+Cette règle est équivalente à @code{modern}, mais les bécarres de précaution sont
+imprimés de façon particulière : soit plus petits, soit (par défaut) entre parenthèses.
+Il est possible de le définir au moyen de la propriété @code{cautionary-style}
+pour l'objet @rinternals{AccidentalSuggestion}.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'modern-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-cautionary" }}}
+}
+@end lilypond
+
+@funindex modern-voice
+@item modern-voice
+Cette règle sert aux altérations dans de la musique polyphonique destinée
+autant à des musiciens différents qu'à quelqu'un qui lirait l'ensemble des voix.
+Les altérations sont imprimées voix par voix, mais les autres voix, dans le même 
+contexte @rinternals{Staff}, en @emph{tiennent compte} cette fois.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'modern-voice) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern-voice)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice" }}}
+}
+@end lilypond
+
+@funindex modern-voice-cautionary
+@item modern-voice-cautionary
+Cette régle est similaire à la précédente, mais les altérations de précautions
+(celles que n'aurait pas ajoutées @code{voice}), sont imprimées de façon
+particulière.  On retrouve donc toutes les altérations qu'imprimerait
+@code{default}, mais certaines sont considérées comme étant @qq{de précaution}.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'modern-voice-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'modern-voice-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'modern-voice-cautionary" }}}
+}
+@end lilypond
+
+@item piano
+@funindex piano accidentals
+Cette règle est adaptée aux contextes GrandStaff -- ce qui n'empêche pas de devoir la spécifier 
+pour chaque portée individuelle au sein du contexte GrandStaff.
+
+@example
+\new GrandStaff @{ <<
+  \new Staff = "up" @{ <<
+    #(set-accidental-style 'piano)
+    @{ @dots{} @}
+  >> @}
+  \new Staff = "down"@{ <<
+    #(set-accidental-style 'piano)
+  @{ @dots{} @}
+  >> @}
+>> @}
+@end example
+
+Cette règle est communément employée pour les partitions de piano au XXème siècle.
+Très similaire à @code{modern} de par son comportement, elle s'en distingue en ce que
+les altérations tiennent compte des autre portées du contexte @rinternals{GrandStaff} ou
+@rinternals{PianoStaff}.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'piano) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'piano)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'piano" }}}
+}
+@end lilypond
+
+@item piano-cautionary
+@funindex #(set-accidental-style 'piano-cautionary)
+Identique à @code{#(set-accidental-style 'piano)}, mais les altérations de précaution
+sont imprimées différemment.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'piano-cautionary) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'piano-cautionary)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'piano-cautionary" }}}
+}
+@end lilypond
+
+@item no-reset
+@funindex no-reset accidental style
+C'est la même règle que @code{default}, mais l'effet des altérations accidentelles
+ne cesse jamais, même dans les mesures suivantes.
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'no-reset) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'no-reset)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'no-reset" }}}
+}
+@end lilypond
+
+@item forget
+Tout le contraire de @code{no-reset}: l'effet des altérations cesse aussitôt,
+et de ce fait, toutes les altérations, quelque soit leur place dans la mesure, sont
+imprimées, en fonction de l'éventuelle armure.
+
+@lilypond[quote,ragged-right]
+musicA = {  << \relative {  cis'8 fis, d'4 <a cis>8 f bis4 | cis2. <c, g'>4 | } \\
+       \relative { ais'2 cis, | fis8 b a4 cis2 | } >> }
+
+musicB = { \clef bass  \new Voice { \voiceTwo \relative { < fis, a cis>4 
+       \change Staff = up cis' \change Staff = down <fis, a>  
+       \change Staff = up dis' | \change Staff = down <fis, a cis>4 gis 
+       <f a d>2 |  } }}
+
+\score { 
+       \new PianoStaff {
+       << \context Staff = "up" {
+              #(set-accidental-style 'forget) 
+       \musicA }
+       \context Staff = "down"{
+              #(set-accidental-style 'forget)
+       \musicB } >> }
+       \header { piece = \markup {\fill-line { \fontsize #3  "'forget" }}}
+}
+@end lilypond
+@end table
+
+
+@seealso
+
+Référence du programme : @rinternals{Accidental_engraver},
+@rinternals{Accidental}, @rinternals{AccidentalSuggestion} et @rinternals{AccidentalPlacement}.
+
+
+@knownissues
+
+Les notes simultanées sont considérées comme des évènements séquentiels.
+Ce qui implique que, dans un accord, les altérations accidentelles seront 
+imprimées comme si les notes de l'accords apparaissaient une par une, en fonction
+de l'ordre dans lequels elles ont été saisies -- ce qui peut poser problème lorsqu'au
+sein d'un accord certaines altérations dépendent les unes des autres.
+Ce problème est à résoudre manuellement, en insérant des @code{!} et des @code{?} après les notes
+concernées.
+
+
+@node Ambitus
+@unnumberedsubsubsec Ambitus
+@cindex ambitus
+
+L'@emph{ambitus} est l'amplitude des hauteurs d'une voix donnée dans une
+partition.  Ce terme peut aussi désigner la tessiture qu'un instrument
+est capable d'atteindre.  Souvent, cet ambitus est imprimé au début des
+partitions vocales, afin que les exécutants puissent voir au premier
+coup d'oeil s'ils sont en mesure de tenir la partie en question.
+
+Pour exprimer l'ambitus d'une pièce, on indique avant la clé deux notes
+représentant la hauteur la plus basse et la plus haute.  Pour imprimer
+cet ambitus, il faut ajouter le graveur @rinternals{Ambitus_engraver}
+au contexte @rinternals{Voice}.  Ainsi,
+
+@example
+\layout @{
+  \context @{
+    \Voice
+    \consists Ambitus_engraver
+  @}
+@}
+@end example
+
+@noindent
+donne pour résultat
+
+@lilypond[quote,ragged-right]
+\layout {
+  \context {
+    \Staff
+    \consists Ambitus_engraver
+  }
+}
+
+\relative \new Staff {
+  as'' c e2 cis,2
+}
+@end lilypond
+
+Si plusieurs voix se trouvent sur une même portée, on peut attribuer le
+graveur @rinternals{Ambitus_engraver} au contexte @rinternals{Staff}
+plutôt qu'au contexte @rinternals{Voice} ; l'ambitus affiché sera
+alors celui de toutes les voix cumulées, non d'une seule des voix
+actives.
+
+@lilypond[verbatim,ragged-right,quote]
+\new Staff \with {
+  \consists "Ambitus_engraver"
+}
+<<
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c'' {
+    \override Ambitus #'X-offset = #-1.0
+    \voiceOne
+    c4 a d e f2
+  }
+  \new Voice \with {
+    \remove "Ambitus_engraver"
+  } \relative c' {
+    \voiceTwo
+    es4 f g as b2
+  }
+>>
+@end lilypond
+
+@noindent
+Cet exemple met en œuvre une fonctionnalité avancée :
+
+@example
+\override Ambitus #'X-offset = #-1.0
+@end example
+
+@noindent
+Ce réglage déplace l'ambitus vers la gauche.  Le même résultat aurait pu
+être obtenu avec @code{extra-offset}, mais alors le système de mise en
+forme n'aurait pas attribué d'espace supplémentaire pour l'objet
+déplacé.
+
+@seealso
+
+Référence du programme : @rinternals{Ambitus},
+@rinternals{AmbitusLine}, @rinternals{AmbitusNoteHead},
+@rinternals{AmbitusAccidental}.
+
+Exemples : @rlsr{Pitches}, @rlsr{Vocal music}.
+
+@knownissues
+
+LilyPond ne gère pas les collisions entre plusieurs ambitus présents sur
+une même portée.
+
+
 @node Note heads
 @subsection Note heads
 
index 406512147f83d4f413f62a320b6106b5efd6b0a1..ef876267474a19122bbe3f502fee68cb2e7b76ce 100644 (file)
@@ -1,20 +1,17 @@
 @c -*- coding: utf-8; mode: texinfo; documentlanguage: fr -*-
 @c This file is part of lilypond.tely
 @ignore
-    Translation of GIT committish: 6bcad9cdc487270910758b1ee39cf3c8aee1015e
+    Translation of GIT committish: 964d024dd4f022ba7cd66adc13c0169035d4c4e5
 
     When revising a translation, copy the HEAD committish of the
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
+@c \version "2.11.51"
 
 @node Spacing issues
 @chapter Spacing issues
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
-
 
 @menu
 * Paper and pages::
@@ -272,11 +269,6 @@ UNTRANSLATED NODE: IGNORE ME
 @node Fitting music onto fewer pages
 @section Fitting music onto fewer pages
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
-
-
 @menu
 * Displaying spacing::
 * Changing spacing::
@@ -293,10 +285,90 @@ UNTRANSLATED NODE: IGNORE ME
 @node Changing spacing
 @subsection Changing spacing
 
-@ifhtml
-UNTRANSLATED NODE: IGNORE ME
-@end ifhtml
-
-
+Parfois, une partition peut se terminer avec seulement 
+un ou deux systèmes sur la dernière page. Ceci peut être ennuyeux
+surtout si vous constatez, en regardant les pages précédentes, qu'il
+reste encore beaucoup de place sur celles-ci.
+
+Si vous vous intéressez aux problèmes de mise en page,
+@code{annotate-spacing} peut alors être un outil d'une valeur
+inestimable.  Cette commande imprime les valeurs 
+de nombreuses commandes d'espacement concernant la mise en page.  
+Consultez @ref{Displaying spacing} pour de plus amples informations.  À l'aide 
+des informations données par @code{annotate-spacing}, on peut 
+voir quelles marges il est souhaitable de modifier afin de résoudre le
+problème.
+
+
+En plus d'agir sur les marges, il existe d'autres possibilités
+qui permettent de gagner de la place.
+
+@itemize
+@item
+Demander à LilyPond de placer les systèmes aussi 
+près que possible les uns des autres (pour en disposer autant
+que possible sur une page), tout en répartissant les systèmes afin
+de ne pas laisser de blanc en bas de la dernière page.
+
+@example
+\paper @{
+  between-system-padding = #0.1
+  between-system-space = #0.1
+  ragged-last-bottom = ##f
+  ragged-bottom = ##f
+@}
+@end example
+
+@item
+Obliger LilyPond à mettre un certain nombre de systèmes
+par page.  Par exemple, si LilyPond veut placer onze systèmes dans une page,
+vous pouvez l'obliger à n'en mettre que dix.
+
+@example
+\paper @{
+  system-count = #10
+@}
+@end example
+
+@item
+Supprimer (ou réduire) les objets qui augmentent la hauteur du
+système.  C'est le cas en particulier de certaines reprises (avec des 
+alternatives) qui placent des crochets au dessus des portées. Si ces crochets 
+de reprise se poursuivent sur deux systèmes, ils prendront plus de
+place que s'ils sont regroupés sur un même système.
+
+Un autre exemple : déplacer les nuances qui @qq{débordent} d'un système.
+
+@lilypond[verbatim,quote,fragment]
+\relative c' {
+  e4 c g\f c
+  \override DynamicLineSpanner #'padding = #-1.8
+  \override DynamicText #'extra-offset = #'( -2.1 . 0)
+  e4 c g\f c
+}
+@end lilypond
+
+@item
+Modifier l'espacement vertical avec @code{SpacingSpanner}.  Reportez-vous à
+@ref{Changing horizontal spacing} pour plus de détails.
+
+@lilypond[verbatim,quote]
+\score {
+  \relative c'' {
+    g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
+    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+    d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
+    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
+  }
+  \layout {
+    \context {
+      \Score
+      \override SpacingSpanner
+                #'base-shortest-duration = #(ly:make-moment 1 4)
+    }
+  }
+}
+@end lilypond
+
+@end itemize
 
-@c -- SKELETON FILE --
index 4bd2d67920904d133664f43ed2a5ef1c017ccbc9..8cae3c4720556cf09358d0cb08cb1fc328127897 100644 (file)
@@ -20,18 +20,172 @@ LilyPond offre de nombreuses possibilités de réglages, permettant de modifier
 quasiment chaque élément de votre partition.
 
 @menu
-* Moving objects::              
-* Fixing overlapping notation::  
+* Tweaking basics::             
+* The Internals Reference manual::  
+* Appearance of objects::       
+* Placement of objects::        
+* Collisions of objects::       
 * Common tweaks::               
-* Default files::               
-* Fitting music onto fewer pages::  
-* Advanced tweaks with Scheme::  
-* Avoiding tweaks with slower processing::  
+* Further tweaking::            
+@end menu
+
+@node Tweaking basics
+@section Tweaking basics
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Introduction to tweaks::      
+* Objects and interfaces::      
+* Naming conventions of objects and properties::  
+* Tweaking methods::            
+@end menu
+
+@node Introduction to tweaks
+@subsection Introduction to tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Objects and interfaces
+@subsection Objects and interfaces
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Naming conventions of objects and properties
+@subsection Naming conventions of objects and properties
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Tweaking methods
+@subsection Tweaking methods
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node The Internals Reference manual
+@section The Internals Reference manual
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Properties of layout objects::  
+* Properties found in interfaces::  
+* Types of properties::         
 @end menu
 
+@node Properties of layout objects
+@subsection Properties of layout objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Properties found in interfaces
+@subsection Properties found in interfaces
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Types of properties
+@subsection Types of properties
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Appearance of objects
+@section Appearance of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Visibility and color of objects::  
+* Size of objects::             
+* Length and thickness of objects::  
+@end menu
+
+@node Visibility and color of objects
+@subsection Visibility and color of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Size of objects
+@subsection Size of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Length and thickness of objects
+@subsection Length and thickness of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Placement of objects
+@section Placement of objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@menu
+* Automatic behavior::          
+* Within-staff objects::        
+* Outside staff objects::       
+@end menu
+
+@node Automatic behavior
+@subsection Automatic behavior
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Within-staff objects
+@subsection Within-staff objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Outside staff objects
+@subsection Outside staff objects
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+
+@node Collisions of objects
+@section Collisions of objects
+
+
+@menu
+* Moving objects::              
+* Fixing overlapping notation::  
+* Real music example::          
+@end menu
 
 @node Moving objects
-@section Moving objects
+@subsection Moving objects
 
 Aussi surprenant que cela puisse paraître, LilyPond n'est pas parfait.
 Certains éléments sur la partition peuvent se chevaucher, ce qui est 
@@ -177,7 +331,7 @@ Dans ce même manuel : @ruser{The \override command}, @ref{Common tweaks}.
 
 
 @node Fixing overlapping notation
-@section Fixing overlapping notation
+@subsection Fixing overlapping notation
 
 Dans la section @ref{Moving objects}, nous avons vu comment
 déplacer un objet @code{TextScript}.  Ce même procédé peut être
@@ -220,6 +374,15 @@ les plus communs :
 @end multitable
 
 
+@node Real music example
+@subsection Real music example
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+
+@c DEPRECATED SECTION
 @node Common tweaks
 @section Common tweaks
 
@@ -355,8 +518,33 @@ l'unité staff-space.  Pour de plus amples informations,
 consultez les sections correspondantes de la Référence du programme.
 
 
-@node Default files
-@section Default files
+@node Further tweaking
+@section Further tweaking
+
+@menu
+* Other uses for tweaks::       
+* Using variables for tweaks::  
+* Other sources of information::  
+* Avoiding tweaks with slower processing::  
+* Advanced tweaks with Scheme::  
+@end menu
+
+@node Other uses for tweaks
+@subsection Other uses for tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Using variables for tweaks
+@subsection Using variables for tweaks
+
+@ifhtml
+UNTRANSLATED NODE: IGNORE ME
+@end ifhtml
+
+@node Other sources of information
+@subsection Other sources of information
 
 La Référence du programme contient
 beaucoup d'informations sur LilyPond. Cependant vous pouvez en découvrir 
@@ -392,99 +580,22 @@ intéressants.  En effet les fichiers du type
 @file{ly/property-init.ly} ou encore @file{ly/declarations-init.ly}
 déterminent toutes les définitions avancées communes.
 
-@node Fitting music onto fewer pages
-@section Fitting music onto fewer pages
-
-Parfois, une partition peut se terminer avec seulement 
-un ou deux systèmes sur la dernière page. Ceci peut être ennuyeux
-surtout si vous constatez, en regardant les pages précédentes, qu'il
-reste encore beaucoup de place sur celles-ci.
-
-Si vous vous intéressez aux problèmes de mise en page,
-@code{annotate-spacing} peut alors être un outil d'une valeur
-inestimable.  Cette commande imprime les valeurs 
-de nombreuses commandes d'espacement concernant la mise en page.  
-Consultez @ruser{Displaying spacing} pour de plus amples informations.  À l'aide 
-des informations données par @code{annotate-spacing}, on peut 
-voir quelles marges il est souhaitable de modifier afin de résoudre le
-problème.
-
-
-En plus d'agir sur les marges, il existe d'autres possibilités
-qui permettent de gagner de la place.
-
-@itemize
-@item
-Demander à LilyPond de placer les systèmes aussi 
-près que possible les uns des autres (pour en disposer autant
-que possible sur une page), tout en répartissant les systèmes afin
-de ne pas laisser de blanc en bas de la dernière page.
-
-@example
-\paper @{
-  between-system-padding = #0.1
-  between-system-space = #0.1
-  ragged-last-bottom = ##f
-  ragged-bottom = ##f
-@}
-@end example
+@node Avoiding tweaks with slower processing
+@subsection Avoiding tweaks with slower processing
 
-@item
-Obliger LilyPond à mettre un certain nombre de systèmes
-par page.  Par exemple, si LilyPond veut placer onze systèmes dans une page,
-vous pouvez l'obliger à n'en mettre que dix.
+LilyPond peut effectuer des vérifications supplémentaires lors du 
+traitement des fichiers, cependant le rendu nécessitera alors plus de
+temps.  En contrepartie, il y aura moins d'ajustements manuels à réaliser.
 
+  
 @example
-\paper @{
-  system-count = #10
-@}
+%%  Ceci sert à s'assurer que les indications textuelles resteront à l'intérieur des marges de la page.
+\override Score.PaperColumn #'keep-inside-line = ##t 
 @end example
 
-@item
-Supprimer (ou réduire) les objets qui augmentent la hauteur du
-système.  C'est le cas en particulier de certaines reprises (avec des 
-alternatives) qui placent des crochets au dessus des portées. Si ces crochets 
-de reprise se poursuivent sur deux systèmes, ils prendront plus de
-place que s'ils sont regroupés sur un même système.
-
-Un autre exemple : déplacer les nuances qui @qq{débordent} d'un système.
-
-@lilypond[verbatim,quote,fragment]
-\relative c' {
-  e4 c g\f c
-  \override DynamicLineSpanner #'padding = #-1.8
-  \override DynamicText #'extra-offset = #'( -2.1 . 0)
-  e4 c g\f c
-}
-@end lilypond
-
-@item
-Modifier l'espacement vertical avec @code{SpacingSpanner}.  Reportez-vous à
-@ruser{Changing horizontal spacing} pour plus de détails.
-
-@lilypond[verbatim,quote]
-\score {
-  \relative c'' {
-    g4 e e2 | f4 d d2 | c4 d e f | g4 g g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-    d4 d d d | d4 e f2 | e4 e e e | e4 f g2 |
-    g4 e e2 | f4 d d2 | c4 e g g | c,1 |
-  }
-  \layout {
-    \context {
-      \Score
-      \override SpacingSpanner
-                #'base-shortest-duration = #(ly:make-moment 1 4)
-    }
-  }
-}
-@end lilypond
-
-@end itemize
-
 
 @node Advanced tweaks with Scheme
-@section Advanced tweaks with Scheme
+@subsection Advanced tweaks with Scheme
 
 Nous avons déjà vu comment le résultat obtenu avec LilyPond peut être
 largement personnalisé à l'aide de commandes comme 
@@ -541,16 +652,3 @@ pattern = #(define-music-function (parser location x y) (ly:music? ly:music?)
 }
 @end lilypond
 
-
-@node Avoiding tweaks with slower processing
-@section Avoiding tweaks with slower processing
-
-LilyPond peut effectuer des vérifications supplémentaires lors du 
-traitement des fichiers, cependant le rendu nécessitera alors plus de
-temps.  En contrepartie, il y aura moins d'ajustements manuels à réaliser.
-
-  
-@example
-%%  Ceci sert à s'assurer que les indications textuelles resteront à l'intérieur des marges de la page.
-\override Score.PaperColumn #'keep-inside-line = ##t 
-@end example
index bd8b7d46375b8cab6aeec7de47b34112bb97dd58..7196704fa82ede7bca80478dd32da029c0f5b6e9 100644 (file)
@@ -81,7 +81,7 @@ années auparavant.  L'utilitaire @command{convert-ly} demande que vous
 spécifiiez la version de LilyPond vous utilisiez alors.
 
 @item @strong{Ajoutez des contrôles}: @ruser{Bar check}, @ruser{Octave
-check} et @ruser{Barnumber check}.  Si vous avez ajouté des contrôles de
+checks} et @ruser{Barnumber check}.  Si vous avez ajouté des contrôles de
 loin en loin, et que vous faites une erreur, vous pourrez la retrouver
 plus rapidement.  @qq{De loin en loin}, qu'est-ce à dire ?  Cela
 dépend de la complexité de la musique.  Pour de la musique très
index e9f5f52c7b35dc9167e448201dc2c05a6bf58207..df34a18956cf45d6ebfe7f9385e4f0ba31d4e17d 100644 (file)
@@ -724,6 +724,9 @@ example, the vertical spacing of the figures may be set with
 
 @seealso
 
+Music Glossary:
+@rglos{Figured Bass}.
+
 Snippets:
 @rlsr{Chords}
 
index 60394cd626b10f5dac35fd0fd2b45e133de10c12..83db0efed37a2699bcbf66d17eda68939245b8a7 100644 (file)
@@ -43,7 +43,7 @@ to fretted string instruments.
 @end menu
 
 @node References for fretted strings
-@subsubsection References for fretted strings
+@unnumberedsubsubsec References for fretted strings
 
 Music for fretted string instruments is normally notated on
 a single staff, either in traditional music notation or in
@@ -70,16 +70,17 @@ in @ref{Collision resolution}.
 @seealso
 
 Notation Reference:
-@ref{Instrument names},
-@ref{Writing music in parallel},
 @ref{Fingering instructions},
 @ref{Ties},
+@ref{Collision resolution},
+@ref{Instrument names},
+@ref{Writing music in parallel},
 @ref{Arpeggio},
 @ref{List of articulations},
 @ref{Clef}.
 
 @node String number indications
-@subsubsection String number indications
+@unnumberedsubsubsec String number indications
 
 @cindex String numbers
 
@@ -128,7 +129,7 @@ Internals Reference:
 
 
 @node Default tablatures
-@subsubsection Default tablatures
+@unnumberedsubsubsec Default tablatures
 @cindex Tablatures, basic
 @cindex Tablatures, default
 
@@ -221,29 +222,14 @@ melodia = \partcombine { e4 g g g }{ e4 e e e }
 
 
 @node Custom tablatures
-@subsubsection Custom tablatures
+@unnumberedsubsubsec Custom tablatures
 @cindex Tablatures, custom
 
-You can change the tuning of the strings.  A string tuning is
-given as a Scheme list with one integer number for each string,
-the number being the pitch (measured in semitones relative to
-middle C) of an open string.  The numbers specified for
-@code{stringTunings} are the numbers of semitones to subtract or
-add, starting the specified pitch by default middle C, in string
-order.  LilyPond automatically calculates the number of strings by
-looking at @code{stringTunings}.
-
-In the next example, @code{stringTunings} is set for the pitches
-e, a, d, and g.
-
-@lilypond[quote,ragged-right,fragment,verbatim]
-\new TabStaff <<
-  \set TabStaff.stringTunings = #'(-5 -10 -15 -20)
-  {
-    a,4 c' a e' e c' a e'
-  }
->>
-@end lilypond
+LilyPond tabulature automatically calculates the fret for 
+a note based on the string to which the note is assigned.
+In order to do this, the tuning of the strings must be
+specified.  The tuning of the strings is given in the
+@code{StringTunings} property.
 
 LilyPond comes with predefined string tunings for banjo, mandolin,
 guitar and bass guitar.  Lilypond automatically sets the correct 
@@ -252,34 +238,74 @@ for bass guitar, which sounds an octave lower than written.
 
 @lilypond[quote,ragged-right,verbatim]
 <<
-  \new Staff <<
+  \new Staff {
     \clef "bass_8"
     \relative c, {
-    c4 d e f
+      c4 d e f
     }
-  >>
-  \new TabStaff <<
+  }
+  \new TabStaff {
     \set TabStaff.stringTunings = #bass-tuning
     \relative c, {
-    c4 d e f
+      c4 d e f
     }
-  >>
+  }
 >>
 @end lilypond
 
-The default string tuning is @code{guitar-tuning} (the standard
-EADGBE tuning).  Some other predefined tunings are
+The default string tuning is @code{guitar-tuning}, which
+is the standard EADGBE tuning.  Some other predefined tunings are
 @code{guitar-open-g-tuning}, @code{mandolin-tuning} and
-@code{banjo-open-g-tuning}.
+@code{banjo-open-g-tuning}.  The predefined string tunings 
+are found in @code{scm/output-lib.scm}.
+
+A string tuning is a Scheme list of string pitches, 
+one for each string, ordered by string number from 1 to N,
+where string 1 is at the top of the tablature staff and
+string N is at the bottom.  This ordinarily results in ordering 
+from highest pitch to lowest pitch, but some instruments 
+(e.g. ukulele) do not have strings ordered by pitch.
+
+A string pitch in a string tuning list is the pitch difference  
+of the open string from middle C measured in semitones.  The 
+string pitch must be an integer.  Lilypond calculates the actual 
+pitch of the string by adding the string tuning pitch to the 
+actual pitch for middle C.
+
+LilyPond automatically calculates the number of strings in the
+@code{TabStaff} as the number of elements in @code{stringTunings}.
+
+Any desired string tuning can be created.  For example, we can
+define a string tuning for a four-string instrument with pitches
+of @code{a''},  @code{d''},  @code{g'}, and @code{c'}:
+
+
+@lilypond[quote,verbatim]
+mynotes = {
+    c'4 e' g' c'' |
+    e'' g'' b'' c'''
+}
+
+<<
+  \new Staff {
+    \clef treble
+    \mynotes
+  }
+  \new TabStaff {
+    \set TabStaff.stringTunings = #'(21 14 7 0)
+    \mynotes
+  }
+>>
+@end lilypond
 
 @seealso
 
+Installed Files:
+@file{scm/output-lib.scm}.
+
 Snippets:
 @rlsr{Fretted strings}.
 
-The file @file{scm/@/output@/-lib@/.scm} contains the predefined string
-tunings.
-
 Internals Reference: 
 @rinternals{Tab_note_heads_engraver}.
 
@@ -287,8 +313,9 @@ Internals Reference:
 
 No guitar special effects have been implemented.
 
+
 @node Fret diagram markups
-@subsubsection Fret diagram markups
+@unnumberedsubsubsec Fret diagram markups
 @cindex fret diagrams
 @cindex chord diagrams
 
@@ -620,7 +647,7 @@ Internals Reference:
 @rinternals{fret-diagram-interface}.
 
 @node Predefined fret diagrams
-@subsubsection Predefined fret diagrams
+@unnumberedsubsubsec Predefined fret diagrams
 @cindex fret diagrams
 @cindex chord diagrams
 
@@ -843,7 +870,7 @@ Internals Reference:
 
 
 @node Automatic fret diagrams
-@subsubsection Automatic fret diagrams
+@unnumberedsubsubsec Automatic fret diagrams
 @cindex fret diagrams
 @cindex chord diagrams
 
@@ -988,8 +1015,8 @@ Details are found at @rinternals{fret-diagram-interface}.  For a
 @code{FretBoards.FretBoard}.
 
 @predefined
-\predefinedFretboardsOff,
-\predefinedFretboardsOn.
+@code{\predefinedFretboardsOff},
+@code{\predefinedFretboardsOn}.
 
 @seealso
 
@@ -1004,7 +1031,7 @@ Internals Reference:
 
 
 @node Right-hand fingerings
-@subsubsection Right-hand fingerings
+@unnumberedsubsubsec Right-hand fingerings
 
 Right-hand fingerings @var{p-i-m-a} must be entered within a  
 chord construct @code{<>} for them to be printed in the score, 
@@ -1067,7 +1094,7 @@ or, for experienced users, a typesetter like GuitarTeX.
 @end menu
 
 @node Indicating position and barring
-@subsubsection Indicating position and barring
+@unnumberedsubsubsec Indicating position and barring
 
 This example demonstrates how to include guitar position and
 barring indications.
@@ -1092,7 +1119,7 @@ Snippets:
 @rlsr{Expressive marks}.
 
 @node Indicating harmonics and dampened notes
-@subsubsection Indicating harmonics and dampened notes
+@unnumberedsubsubsec Indicating harmonics and dampened notes
 
 Special note heads can be used to indicate dampened notes or 
 harmonics.  Harmonics are normally further explained with a 
@@ -1125,7 +1152,7 @@ Notation Reference:
 @end menu
 
 @node Banjo tablatures
-@subsubsection Banjo tablatures
+@unnumberedsubsubsec Banjo tablatures
 @cindex Banjo tablatures
 
 LilyPond has basic support for the five-string banjo.  When making tablatures
index c406a0e863940a775eb639a32a780b991228439e..7c57879ede912840a0e14004258e90a20772f983 100644 (file)
@@ -199,10 +199,6 @@ block, but a @code{\layout} block outside of a @code{\score} block
 (and thus in a @code{\book} block, either explicitly or
 implicitly) will affect every @code{\score} in that @code{\book}.
 
-Every @code{\context} block will affect the named context (e.g.,
-@code{\StaffGroup}) throughout the block (@code{\score} or
-@code{\book}) in which it appears.
-
 For details see @ruser{Multiple scores in a book}.
 
 @cindex variables
@@ -249,9 +245,9 @@ For a complete definition of the input format, see
 @cindex Music expression, compound
 
 We saw the general organization of LilyPond input files in the
-previous section, @ref{How LilyPond input files work}.  But we seemed to
-skip over the most important part: how do we figure out what to
-write after @code{\score}?
+previous section, @ref{Introduction to the LilyPond file structure}.
+But we seemed to skip over the most important part: how do we figure
+out what to write after @code{\score}?
 
 We didn't skip over it at all.  The big mystery is simply that
 there @emph{is} no mystery.  This line explains it all:
@@ -384,6 +380,9 @@ each smaller level.  It also really helps to be strict with
 indentation -- make sure that each item on the same level starts
 on the same horizontal position in your text editor.
 
+@seealso
+
+Notation Reference: @ruser{Structure of a score}.
 
 @node Nesting music expressions
 @subsection Nesting music expressions
@@ -446,10 +445,14 @@ of a single Staff.  Here it says that the new staff should be
 placed above the staff called @qq{main} instead of the default
 position which is below.
 
+@seealso
+
 Ossia are often written without clef and without
 time signature and are usually in a smaller font.
 These require further commands which
-have not yet been introduced.  See @ref{Size of objects}.
+have not yet been introduced.  See @ref{Size of objects},
+and @ruser{Ossia staves}.
+
 
 @node On the un-nestedness of brackets and ties
 @subsection On the un-nestedness of brackets and ties
@@ -895,6 +898,10 @@ to see how to correct this, so we shall leave this problem until a
 later section --- see the @code{force-hshift} property in @ref{Fixing
 overlapping notation}.
 
+@seealso
+
+Notation Reference: @ruser{Multiple voices}.
+
 
 @node Explicitly instantiating voices
 @subsection Explicitly instantiating voices
@@ -1121,6 +1128,11 @@ same direction are placed at the same position and both voices
 have no shift or the same shift specified, the error message
 @qq{Too many clashing note columns} will be produced.
 
+@seealso
+
+Notation Reference: @ruser{Multiple voices}.
+
+
 @node Voices and vocals
 @subsection Voices and vocals
 
@@ -1455,6 +1467,11 @@ refrainwordsB = \lyricmode {
 }
 @end lilypond
 
+@seealso
+
+Notation Reference: @ruser{Vocal music}.
+
+
 @node Contexts and engravers
 @section Contexts and engravers
 
@@ -1544,6 +1561,11 @@ words, each word being capitalized and joined immediately to the
 preceding word with no hyphen or underscore, e.g.,
 @code{GregorianTranscriptionStaff}.
 
+@seealso
+
+Notation Reference: @ruser{Contexts explained}.
+
+
 @node Creating contexts
 @subsection Creating contexts
 
@@ -1646,7 +1668,11 @@ Note the distinction between the name of the context type,
 particular instance of that type, which can be any sequence of letters
 and digits invented by the user.  The identifying name is used to
 refer back to that particular instance of a context.  We saw this in
-use in the section on lyrics in @ref{Voices and vocals}.
+use in the section on lyrics, see @ref{Voices and vocals}.
+
+@seealso
+
+Notation Reference: @ruser{Creating contexts}.
 
 
 @node Engravers explained
@@ -1729,6 +1755,10 @@ from the name, or vice versa.
 We shall see later how the output of LilyPond can be changed
 by modifying the action of Engravers.
 
+@seealso
+
+Internals reference: @rinternals{Engravers and performers}.
+
 
 @node Modifying context properties
 @subsection Modifying context properties
@@ -1923,6 +1953,7 @@ should be enclosed in double quotation signs, as above, although we
 shall see later that text can actually be specified in a much more
 general way by using the very powerful @code{markup} command.
 
+@unnumberedsubsubsec Setting context properties with @code{\with}
 
 @funindex \with
 @cindex context properties, setting with \with
@@ -1965,6 +1996,48 @@ value of the font size.  If it is later changed with @code{\set},
 this new default value may be restored with the
 @code{\unset fontSize} command.
 
+@unnumberedsubsubsec Setting context properties with @code{\context}
+
+The values of context properties may be set in @emph{all} contexts
+of a particular type, such as all @code{Staff} contexts, with a single
+command.  The context type is identified by using its
+type name, like @code{Staff}, prefixed by a back-slash: @code{\Staff}.
+The statement which sets the property value is the same as that in a 
+@code{\with} block, introduced above.  It is placed in a
+@code{\context} block within a @code{\layout} block.  Each
+@code{\context} block will affect all contexts of the type specified
+throughout the @code{\score} or @code{\book} block in which the
+@code{\layout} block appears.  Here is a example to show the format:
+
+@lilypond[verbatim,quote]
+\score {
+  \new Staff {
+    \relative c'' {
+      cis4 e d ces
+    }
+  }
+  \layout {
+    \context {
+      \Staff
+      extraNatural = ##t
+    }
+  }
+}
+@end lilypond
+
+@noindent
+Context properties set in this way may be overridden for particular
+instances of contexts by statements in a @code{\with} block, and by
+@code{\set} commands embedded in music statements.
+
+@seealso
+
+Notation Reference: @ruser{Changing context default settings},
+@ruser{The set command}.
+
+Internals Reference: @rinternals{Contexts},
+@rinternals{Tunable context properties}.
+
 
 @node Adding and removing engravers
 @subsection Adding and removing engravers
@@ -2106,6 +2179,11 @@ for all contexts of a particular type by including the
 @code{\set} command in a @code{\context} block in the
 same way.
 
+@seealso
+
+Notation Reference: @ruser{Modifying context plug-ins},
+@ruser{Changing context default settings}.
+
 
 @node Extending the templates
 @section Extending the templates
index ff12ff62be72199b8c4663fa583895e6c68e37cb..cdcb02e3703707c8c93a23e27d4d868f8e8d42e3 100644 (file)
@@ -166,8 +166,8 @@ Languages in this order.
 * arpeggio::                    
 * articulation::                
 * ascending interval::          
-* augmentation::          
 * augmented interval::          
+* augmentation::                
 * autograph::                   
 * B::                           
 * backfall::                    
@@ -179,7 +179,7 @@ Languages in this order.
 * bass clef::                   
 * beam::                        
 * beat::                        
-* beat repeat::                        
+* beat repeat::                 
 * bind::                        
 * brace::                       
 * bracket::                     
@@ -212,7 +212,7 @@ Languages in this order.
 * contralto::                   
 * copying music::               
 * counterpoint::                
-* countertenor::               
+* countertenor::                
 * crescendo::                   
 * cue-notes::                   
 * custos::                      
@@ -225,11 +225,13 @@ Languages in this order.
 * didymic comma::               
 * diminished interval::         
 * diminuendo::                  
-* diminution::          
+* diminution::                  
 * direct::                      
 * disjunct movement::           
 * dissonance::                  
 * dissonant interval::          
+* divisio::                     
+* doit::                        
 * dominant::                    
 * dominant ninth chord::        
 * dominant seventh chord::      
@@ -260,12 +262,14 @@ Languages in this order.
 * extender line::               
 * F::                           
 * F clef::                      
+* fall::                        
 * feathered beam::              
 * fermata::                     
 * fifth::                       
 * figured bass::                
 * fingering::                   
 * flag::                        
+* flageolet::                   
 * flat::                        
 * forefall::                    
 * forte::                       
@@ -283,14 +287,17 @@ Languages in this order.
 * grave::                       
 * gruppetto::                   
 * H::                           
+* hairpin::                     
 * half note::                   
 * half rest::                   
 * harmonic cadence::            
+* harmonics::                   
 * harmony::                     
 * hemiola::                     
 * homophony::                   
+* hymn meter::                  
 * interval::                    
-* inversion::           
+* inversion::                   
 * inverted interval::           
 * just intonation::             
 * key::                         
@@ -314,7 +321,7 @@ Languages in this order.
 * major interval::              
 * meantone temperament::        
 * measure::                     
-* measure repeat::                     
+* measure repeat::              
 * mediant::                     
 * melisma::                     
 * melisma line::                
@@ -344,17 +351,17 @@ Languages in this order.
 * note head::                   
 * note names::                  
 * note value::                  
-* octavation::                      
+* octavation::                  
 * octave::                      
-* octave mark::                      
-* octave marking::                      
+* octave mark::                 
+* octave marking::              
 * octave sign::                 
 * ornament::                    
 * ossia::                       
 * part::                        
 * pause::                       
 * pennant::                     
-* percent repeat::                  
+* percent repeat::              
 * percussion::                  
 * perfect interval::            
 * phrase::                      
@@ -370,9 +377,9 @@ Languages in this order.
 * portato::                     
 * presto::                      
 * proportion::                  
-* Pythagorean comma::          
+* Pythagorean comma::           
 * quadruplet::                  
-* quality::                  
+* quality::                     
 * quarter note::                
 * quarter rest::                
 * quarter tone::                
@@ -395,14 +402,14 @@ Languages in this order.
 * sextuplet::                   
 * shake::                       
 * sharp::                       
-* simile::                
+* simile::                      
 * simple meter::                
 * sixteenth note::              
 * sixteenth rest::              
 * sixth::                       
 * sixty-fourth note::           
 * sixty-fourth rest::           
-* slash repeat::                        
+* slash repeat::                
 * slur::                        
 * solmization::                 
 * sonata::                      
@@ -413,6 +420,7 @@ Languages in this order.
 * staff::                       
 * staves::                      
 * stem::                        
+* stringendo::                  
 * strings::                     
 * strong beat::                 
 * subdominant::                 
@@ -423,7 +431,7 @@ Languages in this order.
 * supertonic::                  
 * symphony::                    
 * syncopation::                 
-* syntonic comma::            
+* syntonic comma::              
 * system::                      
 * temperament::                 
 * tempo indication::            
@@ -2201,7 +2209,7 @@ S: crescendo,
 FI: cresendo, voimistuen.
 
 Increasing volume.  Indicated by a rightwards opening horizontal wedge
-or the abbreviation @samp{cresc.}.
+(hairpin) or the abbreviation @samp{cresc.}.
 
 @lilypond[fragment,ragged-right]
 \key g \major \time 4/4
@@ -2345,8 +2353,8 @@ DK: decrescendo,
 S: decrescendo,
 FI: decresendo, hiljentyen.
 
-Decreasing tone volume.  Indicated by a leftwards opening horizontal wedge
-or the abbreviation @samp{decresc.}.
+Decreasing tone volume.  Indicated by a leftwards opening horizontal
+wedge (hairpin) or the abbreviation @samp{decresc.}.
 
 @lilypond[fragment,ragged-right]
 \relative c'' {
@@ -2387,7 +2395,7 @@ A scale consisting of 5@w{ }@ref{whole tone}s and 2@w{ }@ref{semitone}s (S).
 Scales played on the white keys of a piano keybord are diatonic; and these
 scales are sometimes called, somewhat inaccurately, @q{church modes}).
 
-These @q{modes} are used in gregorian chant and in pre-baroque early music
+These @q{modes} are used in Gregorian chant and in pre-baroque early music
 but also to some extent in newer jazz music.
 
 @lilypond[fragment,notime,ragged-right]
@@ -2699,6 +2707,62 @@ FI: dissonanssi, dissonoiva intervalli, riitasointi.
 @ref{harmony}.
 
 
+@node divisio
+@section divisio
+
+ES: ?,
+I: ?,
+F: ?,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+[Latin: @q{division}: pl. @emph{divisiones}] In Gregorian chant, a
+vertical stroke through part or all of the staff that serves to
+structure a chant into phrases and sections.  There are four types:
+
+@itemize
+
+@item @emph{divisio minima}, a short pause
+
+@item @emph{divisio maior}, a medium pause
+
+@item @emph{divisio maxima}, a long pause
+
+@item @emph{finalis}, to indicate the end of a chant, or the end of a
+section in a long antiphonal or responsorial chant.
+
+@end itemize
+
+TODO: musical example here?
+
+@seealso
+
+None yet.
+
+
+@node doit
+@section doit
+
+ES: ?,
+I: ?,
+F: ?,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+Indicator for a indeterminately rising pitch bend.  Compare with
+@emph{glissando}, which has determinate starting and ending pitches.
+
+@seealso
+
+@ref{fall}, @ref{glissando}.
+
+
 @node dominant
 @section dominant
 
@@ -3307,6 +3371,26 @@ double bass @ref{strings}).
 @c F:  'point d'orgue' on a note, 'point d'arret' on a rest.
 
 
+@node fall
+@section fall
+
+ES: ?,
+I: ?,
+F: ?,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+Indicator for a indeterminately falling pitch bend.  Compare with
+@emph{glissando}, which has determinate starting and ending pitches.
+
+@seealso
+
+@ref{doit}, @ref{glissando}.
+
+
 @node feathered beam
 @section feathered beam
 
@@ -3412,8 +3496,6 @@ above the bass notes.
 @end lilypond
 
 
-
-
 @node fingering
 @section fingering
 
@@ -3457,6 +3539,36 @@ less than a quarter note.  The number of flags determines the
 @end lilypond
 
 
+@node flageolet
+@section flageolet
+
+ES: ?,
+I: ?,
+F: ?,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+An articulation for string players that means the note or passage is to
+be played in harmonics.
+
+Also:
+
+@itemize
+
+@item A duct flute similar to the recorder.
+
+@item An organ stop of flute scale at 1' or 2' pitch.
+
+@end itemize
+
+@seealso
+
+@ref{articulation}, @ref{harmonics}.
+
+
 @node flat
 @section flat
 
@@ -3786,7 +3898,18 @@ usage.  In the standard usage of these countries, @samp{B} means
 
 @seealso
 
-@ref{Pitch names}, @ref{B}
+@ref{Pitch names}, @ref{B}.
+
+
+@node hairpin
+@section hairpin
+
+Graphical version of the @notation{crescendo} and @notation{decrescendo}
+dynamic marks.
+
+@seealso
+
+@ref{crescendo}, @ref{decrescendo}.
 
 
 @node half note
@@ -3865,6 +3988,31 @@ A sequence of chords that terminates a musical phrase or section.
 @end lilypond
 
 
+@node harmonics
+@section harmonics
+
+ES: sonidos del flautín,
+I: suoni flautati,
+F: flageolet, sons harmoniques,
+D: Flageolett-Töne,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+The general class of pitches produced by sounding the second or higher
+harmonic of a tone producer: string, column of air, and so on.
+
+On stringed instruments, these pitches sound rather flute-like; hence,
+their name in languages other than English.  They are produced by
+lightly touching the string at a node for the desired mode of vibration
+while it is being bowed or plucked.
+
+For instruments of the violin family, there are two types of harmonics:
+natural harmonics, which are those played on the open string; and
+artificial harmonics, which are produced on stopped strings.
+
+
 @node harmony
 @section harmony
 
@@ -3973,6 +4121,53 @@ voices more or less in the same rhythm.  In contrast to
 @ref{polyphony}.
 
 
+@node hymn meter
+@section hymn meter
+
+ES: ?,
+I: ?,
+F: ?,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+A group or list of numbers that indicate the number of syllables in a
+line of a hymn's verse.  Different hymnals have different ways of noting
+the hymn meter -- consider a hymn having four lines in two couplets that
+alternate between eight and seven syllables.  The @emph{English Hymnal}
+notes this as 87.@w{ }87.  Other hymnals may note it as 8787, 87.87, or
+8@w{ }7@w{ }8@w{ }7.
+
+Some frequently-used hymn meters have traditional names:
+
+@itemize
+
+@item 66.86 is called Short Meter (abbreviated SM or S.M.)
+
+@item 86.86 is called Common Meter (CM or C.M.)
+
+@item 88.88 is called Long Meter (LM or L.M.)
+
+@end itemize
+
+Some hymns and their tunes are doubled versions of a simpler meter: for
+easier reading, a hymn with a meter of 87.87.87.87 is usually written
+87.87D.  The traditional names above also have doubled versions:
+
+@itemize
+
+@item 66.86.66.86 is Double Short Meter (DSM or D.S.M.)
+
+@item 86.86.86.86 is Double Common Meter (DCM or D.C.M.)
+
+@item 88.88.88.88 is Double Long Meter (DLM or D.L.M.)
+
+@end itemize
+
+
+
 @node interval
 @section interval
 
@@ -5882,7 +6077,7 @@ original chord and the quality of the seventh added.
 
 Five common types of seventh chords have standard symbols. The chord quality
 indications are sometimes superscripted and sometimes not (e.g. Dm7, Dm^7,
-and D^m7 are all identical). The last three chords are not used commonly
+and D^m7 are all identical). The last three chords are not commonly used
 except in jazz.
 
 @seealso
@@ -6667,6 +6862,26 @@ whole note.
 @end lilypond
 
 
+@node stringendo
+@section stringendo
+
+ES: ?,
+I: stringendo,
+F: ?,
+D: ?,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+[It, @q{pressing}].  Pressing, urging, or hastening the time, as to a
+climax.
+
+@seealso
+
+@ref{accelerando}.
+
+
 @node strings
 @section strings
 
index dad9d6a4ac85fa0139b79873542da6975317f4e2..29d814ab571e125a19e8da8b79a5a2848a5df196 100644 (file)
@@ -21,7 +21,7 @@
 
 @ifnottex
 @macro ruser{NAME}
-These snippets illustrate the User Manual,
+These snippets illustrate the Notation Reference,
 section @ref{\NAME\,,,lilypond,Notation Reference}.
 @end macro
 
index 4a43a94e037e46d221bd60d68eb9fba8703f1b05..51fe44fc466fdd3a26280b294e6823c28119be77 100644 (file)
@@ -31,10 +31,8 @@ public:
   static Real line_thickness (Grob *);
   static Real staff_space (Grob *);
   static Grob *get_staff_symbol (Grob *);
-  static bool on_line (Grob *);
   static bool on_line (Grob *, int);
   static bool on_staff_line (Grob *, int);
-  static bool on_staff_line (Grob *);
   static int line_count (Grob *);
   static Real get_position (Grob *);
   static Real staff_radius (Grob *);
index dbff0245c609874af177b329914bafcc8d1056d5..38c39e04fe1851ec00dbc26893937040e065acee 100644 (file)
@@ -20,22 +20,11 @@ Staff_symbol_referencer::line_count (Grob *me)
   return st ? Staff_symbol::line_count (st) : 0;
 }
 
-bool
-Staff_symbol_referencer::on_line (Grob *me)
-{
-  return on_line (me, (int) rint (get_position (me)));
-}
-
-bool
-Staff_symbol_referencer::on_staff_line (Grob *me)
-{
-  return on_staff_line (me, (int) rint (get_position (me)));
-}
-
 bool
 Staff_symbol_referencer::on_line (Grob *me, int pos)
 {
-  return Staff_symbol::on_line (me, pos);
+  Grob *st = get_staff_symbol (me);
+  return st ? Staff_symbol::on_line (st, pos) : false;
 }
 
 bool
index 1f71b6b7eb1b8d8615ed04d590a3aaf8530873b5..9015764dc1f028f8df0fb5f6bfdb5d53a074ae67 100644 (file)
@@ -354,7 +354,7 @@ correction amount for kneed beams.  Set between @code{0} for no
 correction and @code{1} for full correction.")
 
      (labels ,list? "List of labels (symbols) placed on a column")
-     (layer ,number? "The output layer (a value between 0 and@tie{}2:
+     (layer ,integer? "The output layer (a value between 0 and@tie{}2:
 Layers define the order of printing objects.  Objects in lower layers
 are overprinted by objects in higher layers.")
      (ledger-line-thickness ,number-pair? "The thickness of ledger