]> git.donarmstrong.com Git - lilypond.git/commitdiff
Merge branch 'master' into lilypond/translation
authorFrancisco Vila <francisco.vila@hispalinux.es>
Wed, 15 Oct 2008 07:39:51 +0000 (09:39 +0200)
committerFrancisco Vila <francisco.vila@hispalinux.es>
Wed, 15 Oct 2008 07:39:51 +0000 (09:39 +0200)
21 files changed:
Documentation/de/user/vocal.itely
Documentation/es/user/vocal.itely
Documentation/fr/user/introduction.itely
Documentation/fr/user/vocal.itely
Documentation/user/expressive.itely
Documentation/user/input.itely
Documentation/user/music-glossary.tely
Documentation/user/programming-interface.itely
Documentation/user/simultaneous.itely
Documentation/user/staff.itely
Documentation/user/unfretted-strings.itely
Documentation/user/vocal.itely
VERSION
input/manual/simultaneous-headword.ly
input/manual/unfretted-headword.ly
input/manual/unfretted-strings-headword.ly [deleted file]
tex/texinfo.tex
tex/txi-de.tex [new file with mode: 0644]
tex/txi-en.tex [new file with mode: 0644]
tex/txi-es.tex [new file with mode: 0644]
tex/txi-fr.tex [new file with mode: 0644]

index c0562cd90b289d1d4905b3c8269d980bb5ab31fd..7b803357d28fef85b9aed2b5b728de442117e1bf 100644 (file)
 
 
 @menu
+* Common notation for vocal music::
 * Entering lyrics::
 * Aligning lyrics to a melody::
 * Specific uses of lyrics::
 * Stanzas::
 @end menu
 
+
+
+@node Common notation for vocal music
+@subsection Common notation for vocal music
+
+@untranslated
+
+@menu
+* References for vocal music and lyrics::
+* Opera::
+* Song books::
+* Chants::
+* Spoken music::
+* Ancient vocal music::
+@end menu
+
+
+@node References for vocal music and lyrics
+@unnumberedsubsubsec References for vocal music and lyrics
+
+@untranslated
+
+@node Opera
+@unnumberedsubsubsec Opera
+
+@untranslated
+
+@node Song books
+@unnumberedsubsubsec Song books
+
+@untranslated
+
+@node Spoken music
+@unnumberedsubsubsec Spoken music
+
+@untranslated
+
+@node Chants
+@unnumberedsubsubsec Chants
+
+@untranslated
+
+@node Ancient vocal music
+@unnumberedsubsubsec Ancient vocal music
+
+@untranslated
+
 @node Entering lyrics
 @subsection Entering lyrics
 
@@ -31,7 +79,6 @@
 * Lyrics explained::
 * Setting simple songs::
 * Working with lyrics and variables::
-* References for vocal music::
 @end menu
 
 
 
 @untranslated
 
-@node References for vocal music
-@unnumberedsubsubsec References for vocal music
-
-@untranslated
-
 
 @node Aligning lyrics to a melody
 @subsection Aligning lyrics to a melody
 @menu
 * Divisi lyrics::
 * Lyrics independent of notes::
-* Chants::
 * Spacing out syllables::
 * Centering lyrics between staves::
 @end menu
 @untranslated
 
 
-@node Chants
-@unnumberedsubsubsec Chants
-
-@untranslated
-
-
 @node Spacing out syllables
 @unnumberedsubsubsec Spacing out syllables
 
index 7357b56f2ae9b14c17ab0f35091ed690422b0649..fca24d75d446c78e97accb9287da38b4b3b01f2d 100644 (file)
@@ -33,6 +33,7 @@ examinando el método más simple, y poco a poco iremos aumentando la
 complejidad.
 
 @menu
+* Common notation for vocal music::
 * Entering lyrics::  
 * Aligning lyrics to a melody::  
 * Specific uses of lyrics::         
@@ -64,6 +65,58 @@ Para hacer que la letra evite las líneas divisorias también, utilice
 @}
 @end example
 
+
+@node Common notation for vocal music
+@subsection Common notation for vocal music
+
+@untranslated
+
+
+@menu
+* References for vocal music and lyrics::
+* Opera::
+* Song books::
+* Chants::
+* Spoken music::
+* Ancient vocal music::
+@end menu
+
+
+@node References for vocal music and lyrics
+@unnumberedsubsubsec References for vocal music and lyrics
+
+@untranslated
+
+@node Opera
+@unnumberedsubsubsec Opera
+
+@untranslated
+
+@node Song books
+@unnumberedsubsubsec Song books
+
+@untranslated
+
+@node Spoken music
+@unnumberedsubsubsec Spoken music
+
+@c TODO Add @refs
+
+@q{Parlato} es texto hablado sin notas pero con ritmo; su notación se
+realiza mediante cabezas de nota en forma de cruz.  Esto queda demostrado en
+@ref{Special note heads}.
+
+@node Chants
+@unnumberedsubsubsec Chants
+
+@untranslated
+
+@node Ancient vocal music
+@unnumberedsubsubsec Ancient vocal music
+
+@untranslated
+
+
 @node Entering lyrics
 @subsection Entering lyrics
 
@@ -71,7 +124,6 @@ Para hacer que la letra evite las líneas divisorias también, utilice
 * Lyrics explained::
 * Setting simple songs::
 * Working with lyrics and variables::
-* References for vocal music::
 @end menu
 
 
@@ -317,16 +369,6 @@ El código de entrada definitivo sería algo como
 Referencia de funcionamiento interno:
 @rinternals{LyricCombineMusic}, @rinternals{Lyrics}.
 
-@node References for vocal music
-@unnumberedsubsubsec References for vocal music
-
-@c TODO Add @refs
-
-@q{Parlato} es texto hablado sin notas pero con ritmo; su notación se
-realiza mediante cabezas de nota en forma de cruz.  Esto queda demostrado en
-@ref{Special note heads}.
-
-
 @node Aligning lyrics to a melody
 @subsection Aligning lyrics to a melody
 
@@ -631,8 +673,7 @@ mediante @code{\lyricsto}.
 
 @menu
 * Divisi lyrics::               
-* Lyrics independent of notes::  
-* Chants::                      
+* Lyrics independent of notes::                    
 * Spacing out syllables::       
 * Centering lyrics between staves::  
 @end menu
@@ -711,11 +752,6 @@ lyr = \lyricmode { I like my cat! }
 >>
 @end lilypond
 
-@node Chants
-@unnumberedsubsubsec Chants
-
-@untranslated
-
 
 @node Spacing out syllables
 @unnumberedsubsubsec Spacing out syllables
index 53f77e6d0d892eed27d643df0ef6e5b5f2f7254e..6086b660f7c0323c0bde65877071e672c177259b 100644 (file)
@@ -69,7 +69,7 @@ désagréables à jouer.
 
 @c introduce illustrating aspects of engraving, font...
 Les images ci-dessous illustrent la différence entre la gravure
-traditionelle et l'impression typique par ordinateur, et la troisème
+traditionelle et l'impression typique par ordinateur, et la troisième
 image montre comment LilyPond mime l'aspect traditionnel.  L'image de
 gauche est une numérisation d'un symbole bémol d'une édition publiée
 en 2000.  Celle du centre montre un bémol d'une gravure à la main de
index 6634728d5e975ba5e8f0f13d07faaf4b441b2609..df57be70ed252d755cb1721573ff3de3e4effbf8 100644 (file)
@@ -32,6 +32,7 @@ Plusieurs solutions existent pour ajouter des paroles ; nous les
 examinerons par degré croissant de complexité.
 
 @menu
+* Common notation for vocal music::
 * Entering lyrics::  
 * Aligning lyrics to a melody::  
 * Specific uses of lyrics::         
@@ -62,6 +63,53 @@ Pour que les paroles évitent également les barres de mesure, ajoutez
 @end example
 
 
+@node Common notation for vocal music
+@subsection Common notation for vocal music
+
+@untranslated
+
+@menu
+* References for vocal music and lyrics::
+* Opera::
+* Song books::
+* Chants::
+* Spoken music::
+* Ancient vocal music::
+@end menu
+
+@node References for vocal music and lyrics
+@unnumberedsubsubsec References for vocal music and lyrics
+
+@untranslated
+
+@node Opera
+@unnumberedsubsubsec Opera
+
+@untranslated
+
+@node Song books
+@unnumberedsubsubsec Song books
+
+@untranslated
+
+@node Spoken music
+@unnumberedsubsubsec Spoken music
+
+Le @emph{parlato} est du texte scandé en rythme, mais sans hauteurs
+définies ; il est indiqué par des notes en croix, à l'instar des
+percussions --- voir @ref{Special note heads}.
+
+@node Chants
+@unnumberedsubsubsec Chants
+
+@untranslated
+
+@node Ancient vocal music
+@unnumberedsubsubsec Ancient vocal music
+
+@untranslated
+
+
 @node Entering lyrics
 @subsection Entering lyrics
 
@@ -69,7 +117,6 @@ Pour que les paroles évitent également les barres de mesure, ajoutez
 * Lyrics explained::
 * Setting simple songs::
 * Working with lyrics and variables::
-* References for vocal music::
 @end menu
 
 
@@ -309,17 +356,6 @@ Référence du programme : @rinternals{LyricCombineMusic},
 @rinternals{Lyrics}.  
 
 
-@node References for vocal music
-@unnumberedsubsubsec References for vocal music
-
-@c TODO Add @refs
-
-Le @emph{parlato} est du texte scandé en rythme, mais sans hauteurs
-définies ; il est indiqué par des notes en croix, à l'instar des
-percussions --- voir @ref{Special note heads}.
-
-
-
 @node Aligning lyrics to a melody
 @subsection Aligning lyrics to a melody
 
@@ -624,8 +660,7 @@ La commande @code{\lyricsto} permet de prendre en compte ces variantes.
 
 @menu
 * Divisi lyrics::               
-* Lyrics independent of notes::  
-* Chants::                      
+* Lyrics independent of notes::                
 * Spacing out syllables::       
 * Centering lyrics between staves::  
 @end menu
@@ -704,10 +739,6 @@ lyr = \lyricmode { I like my cat! }
 >>
 @end lilypond
 
-@node Chants
-@unnumberedsubsubsec Chants
-
-@untranslated
 @ifnothtml
 @englishref
 @end ifnothtml
index 8e1fc4a30928160fcda4e3b15612cf8bd28ed588..65e197b242aa91151223e57abb549d794d9742ff 100644 (file)
@@ -707,7 +707,8 @@ divisiones, are supported.  For details, see @ref{Divisiones}.
 
 @seealso
 
-@c TODO When available add Glossary: @r glos{caesura}.
+Music Glossary: 
+@rglos{caesura}.
 
 Notation Reference:
 @ref{Divisiones}.
index 2896c2139174c55c97190eca50ba53a7a87ea778..392fbb3ea00f7094959440fdf70b8cefaefbffdb 100644 (file)
@@ -1171,22 +1171,38 @@ portuguese = \lyricmode {
 @end lilypond
 
 To enter a single character for which the Unicode escape sequence
-is known but which is not available in the editor being used, enter
+is known but which is not available in the editor being used, use
+@code{\char ##xhhhh} within a @code{\markup} block, where
+@code{hhhh} is the hexadecimal code for the character required.
+For example, @code{\char ##x03BE} enters the Unicode U+03BE
+character, which has the Unicode name @qq{Greek Small Letter Xi}.
+Any Unicode hexadecimal code may be substituted, and if all special
+characters are entered in this format it is not necessary to save
+the input file in UTF-8 format.  Of course, a font containing all
+such encoded characters must be installed and available to LilyPond.
+
+The following example shows UTF-8 coded characters being used in
+four places -- in a rehearsal mark, as articulation text, in lyrics
+and as stand-alone text below the score:
 
-@example
-#(ly:export (ly:wide-char->utf-8 #x03BE))
-@end example
+@lilypond[quote,verbatim]
+\score {
+  \relative c'' {
+    c1 \mark \markup { \char ##x03EE }
+    c1_\markup { \tiny { \char ##x03B1 " to " \char ##x03C9 } }
+  }
+  \addlyrics { O \markup { \concat{ Ph \char ##x0153 be! } } }
+}
+\markup { "Copyright 2008" \char ##x00A9 }
+@end lilypond
 
-where in this example @code{x03BE} is the hexadecimal code for the
-Unicode U+03BE character, which has the Unicode name @qq{Greek Small
-Letter Xi}.  Any Unicode hexadecimal code may be substituted, and
-if all special characters are entered in this format it is not
-necessary to save the input file in UTF-8 format.
+To enter the copyright sign in the copyright notice use:
 
-@knownissues
-
-The @code{ly:export} format may be used in text within @code{\mark} or
-@code{\markup} commands but not in lyrics.
+@example
+\header @{
+  copyright = \markup @{ \char ##x00A9 "2008" @}
+@}
+@end example
 
 @node Displaying LilyPond notation
 @subsection Displaying LilyPond notation
@@ -1547,6 +1563,7 @@ player that supports pitch bend.)
 @item Dynamic marks
 @item Crescendi, decrescendi over multiple notes
 @item Tempo changes entered with a tempo marking
+@item Lyrics
 @end itemize
 
 @unnumberedsubsubsec Unsupported in MIDI
@@ -1563,8 +1580,6 @@ The following items of notation have no effect on the MIDI output:
 @item Crescendi, decrescendi over a single note
 @item Tremolos entered with @q{@code{:}[@var{number}]}
 @item Figured bass
-@c TODO Check Lyrics
-@item Lyrics
 @end itemize
 
 
index a68d9ae4d6181051dcc300a7945174660c77988e..49a1f5bd7bf4c5868bf90c5cd60096d2b921e3b1 100644 (file)
 * Glossary: (lilypond/music-glossary).  Glossary of music terms.
 @end direntry
 
-@ifnottex
-@node Top
-@top Music Glossary
-@end ifnottex
-
-
 @ifhtml
 This document is also available in
 @uref{source/Documentation/user/music-glossary.pdf,PDF}
@@ -64,24 +58,103 @@ Copyright @copyright{} 1999--2008 by the authors
 @omflanguage English
 @end ignore
 
+@ifnottex
+@node Top
+@top Music glossary
+@end ifnottex
+
 
 @ifnottex
 
-This glossary was brought you by
-
-@multitable {Jan Nieuwenhuizen} {Original glossary of GNU music project, French glossary,}
-@item Adrian Mariano @tab Italian glossary,
-@item Bjoern Jacke @tab German glossary,
-@item Christian Mondrup @tab Original author of LilyPond glossary, Danish glossary,
-@item David González @tab Spanish glossary,
-@item François Pinard @tab Original glossary of GNU music project, French glossary,
-@item Han-Wen Nienhuys @tab Dutch glossary,
-@item Heikki Junes @tab Finnish glossary translations,
-@item Jan Nieuwenhuizen @tab Dutch glossary,
-@item Kurtis Kroon @tab English glossary,
-@item Mats Bengtsson @tab Swedish glossary,
-@item Neil Jerram @tab English glossary translations.
-@end multitable
+This glossary was brought you by:
+
+@itemize
+
+@item @b{Christian Mondrup}: Original author of LilyPond glossary, Danish,
+@item @b{François Pinard}: Original glossary of GNU music project, French,
+
+@item @b{Han-Wen Nienhuys}: Dutch,
+@item @b{Jan Nieuwenhuizen}: Dutch,
+
+@item @b{Neil Jerram}: English,
+@item @b{Kurtis Kroon}: English,
+
+@item @b{Heikki Junes}: Finnish,
+
+@item @b{Bjoern Jacke}: German,
+
+@item @b{Adrian Mariano}: Italian,
+
+@item @b{David González}: Spanish,
+
+@item @b{Mats Bengtsson}: Swedish,
+
+@end itemize
+
+with additional contributions: thanks to all who have contributed.
+
+@ignore
+
+The list is rather long ...
+
+@itemize
+
+@item Danish:
+@itemize
+@item Rune Zedeler, @emph{pace}
+@item Eyolf Østrem
+@end itemize
+
+@item Dutch:
+@itemize
+@item Alard de Boer
+@end itemize
+
+@item English:
+@itemize
+@item Trevor Bača
+@item Trevor Daniels
+@item Andrew Hawryluk
+@item Ian Hulin
+@item Kieren MacMillan
+@item Patrick McCarty
+@item Ralph Palmer
+@item Carl D. Sorensen
+@item Anh Hai Trinh
+@end itemize
+
+@item Finnish:
+@itemize
+@item Risto Vääräniemi
+@end itemize
+
+@item German:
+@itemize
+@item Orm Finnendahl
+@item Reinhold Kainhofer
+@item Werner Lemberg
+@item Till Rettig
+@item Thomas Scharkowski
+@end itemize
+
+@item Italian
+@itemize
+@item Andrea Valle
+@end itemize
+
+@item Spanish
+@itemize
+@item Francisco Vila
+@end itemize
+
+@item Swedish
+@itemize
+@item Simon Dahlbacka
+@end itemize
+
+@end itemize
+@end ignore
+
 @*
 Copyright 1999--2008 by the authors
 
@@ -102,7 +175,6 @@ This is the Music Glossary (MG) for GNU LilyPond version @version{}.
 For more information about how this fits with the other
 documentation, see @rlearning{About the documentation}.
 
-@shortcontents
 
 @c arrowref
 @macro aref{word}
@@ -120,6 +192,7 @@ documentation, see @rlearning{About the documentation}.
 * Pitch names::
 @end menu
 
+
 @node Musical terms A-Z
 @chapter Musical terms A-Z
 
@@ -136,6 +209,7 @@ Languages in this order.
 @item FI - Finnish
 @end itemize
 
+
 @menu
 * A::
 * a due::
@@ -182,6 +256,7 @@ Languages in this order.
 * C clef::
 * cadence::
 * cadenza::
+* caesura::
 * canon::
 * cent::
 * central C::
@@ -338,7 +413,7 @@ Languages in this order.
 * movement::
 * multi-measure rest::
 * natural::
-* neighbour tones::
+* neighbor tones::
 * ninth::
 * non-legato::
 * note::
@@ -481,7 +556,7 @@ Languages in this order.
 
 @seealso
 
-@ref{Pitch names}
+@ref{Pitch names}.
 
 
 @node a due
@@ -512,7 +587,7 @@ or groups of players (@q{desks}).
 
 @seealso
 
-@ref{Pitch names}
+None yet.
 
 
 @node accelerando
@@ -531,6 +606,10 @@ FI: accelerando, kiihdyttäen.
 
 Increase tempo
 
+@seealso
+
+None yet.
+
 
 @node accent
 @section accent
@@ -546,6 +625,10 @@ FI: aksentti, korostus.
 
 The stress of one tone over others.
 
+@seealso
+
+None yet.
+
 
 @node accessory
 @section accessory
@@ -580,11 +663,24 @@ DK: løst fortegn,
 S: tillfälligt förtecken,
 FI: tilapäinen etumerkki.
 
-An accidental has the effect of an @ref{alteration} of a note.  A
-sharp raises a tone by a @ref{semitone}, a double sharp raises it by a
-@ref{whole tone}, a flat lowers it by a semitone and a double flat
-lowers it by a whole tone.  A natural cancels the effect of a previous
-accidental, or a sharp or flat in the key signature.
+An accidental alters a note by:
+
+@itemize
+
+@item Raising its pitch:
+@itemize
+@item A @notation{double sharp}, by two semitones (a whole tone)
+@item A @notation{sharp}, by one semitone
+@end itemize
+
+@item Lowering its pitch:
+@itemize
+@item A @notation{flat}, by one semitone
+@item A @notation{double flat}, by two semitones (a whole tone)
+@end itemize
+
+@item Canceling the effects of the key signature or previous accidentals.
+@end itemize
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -600,6 +696,10 @@ accidental, or a sharp or flat in the key signature.
 >>
 @end lilypond
 
+@seealso
+
+@ref{alteration}, @ref{semitone}, @ref{whole tone}.
+
 
 @node adagio
 @section adagio
@@ -617,14 +717,18 @@ FI: adagio, hitaasti.
 
 @itemize
 
-@item Slow tempo, slower -- especially in even meter -- than
-@ref{andante} and faster than @ref{largo}.
+@item Slow tempo, slower -- especially in even meter -- than @notation{andante}
+and faster than @notation{largo}.
 
 @item A movement in slow tempo, especially the second (slow) movement
-of @ref{sonata}s, symphonies, etc.
+of sonatas, symphonies, etc.
 
 @end itemize
 
+@seealso
+
+@ref{andante}, @ref{largo}, @ref{sonata}.
+
 
 @node al niente
 @section al niente
@@ -665,8 +769,8 @@ text markup, rather than as part of the @notation{decrescendo} text:
 @end lilypond
 
 Since one does not crescendo @emph{to} nothing, it is not correct to use
-@notation{al niente} with the word @notation{crescendo}.  Instead, one
-should use @emph{dal niente} (@notation{@b{from} nothing}).
+@notation{al niente} with @notation{crescendo}.  Instead, one should use
+@emph{dal niente} (@notation{@b{from} nothing}).
 
 @seealso
 
@@ -685,8 +789,12 @@ DK: allegro,
 S: allegro,
 FI: allegro, nopeasti.
 
-[Italian: cheerful.]  Quick tempo.  Also used as a title for pieces in a quick
-tempo, especially the first and last movements of a @ref{sonata}.
+[Italian: @q{cheerful}.]  Quick tempo.  Also used as a title for pieces in a quick
+tempo, especially the first and last movements of a sonata.
+
+@seealso
+
+@ref{sonata}.
 
 
 @node alteration
@@ -702,7 +810,11 @@ S: ?,
 FI: ?.
 
 An alteration is the modification, raising or lowering, of a note's
-pitch.  It is established by an @ref{accidental}.
+pitch.  It is established by an accidental.
+
+@seealso
+
+@ref{accidental}.
 
 
 @node alto
@@ -720,7 +832,11 @@ FI: altto, matala naisääni.
 A female voice of low range (@emph{contralto}).  Originally the alto
 was a high male voice (hence the name), which by the use of falsetto
 reached the height of the female voice.  This type of voice is also
-known as @ref{countertenor}.
+known as countertenor.
+
+@seealso
+
+@ref{countertenor}.
 
 
 @node alto clef
@@ -759,6 +875,10 @@ Denotes a range of pitches for a given voice in a part of music.  It may
 also denote the pitch range that a musical instrument is capable of playing.
 Sometimes anglicized to @emph{ambit} (pl. @emph{ambits}).
 
+@seealso
+
+None yet.
+
 
 @node anacrusis
 @section anacrusis
@@ -776,10 +896,6 @@ An anacrusis (also known as pickup or upbeat) is an incomplete measure
 of music before a section of music. It also refers to the initial
 note(s) of a melody occurring in that incomplete measure.
 
-@seealso
-
-@ref{measure}, @ref{meter}.
-
 @lilypond[fragment,line-width=13.0\cm]
 \key f \major
 \time 4/4
@@ -788,6 +904,10 @@ note(s) of a melody occurring in that incomplete measure.
   bes( a) g f | bes4. a8 bes4 c | f,2. \bar "||" }
 @end lilypond
 
+@seealso
+
+@ref{measure}, @ref{meter}.
+
 
 @node ancient minor scale
 @section ancient minor scale
@@ -806,7 +926,7 @@ Also called @q{natural minor scale}.
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
 \relative c'' {
-a1 b c d e f g a }
+  a1 b c d e f g a }
 @end lilypond
 
 @seealso
@@ -826,8 +946,14 @@ DK: andante,
 S: andante,
 FI: andante, käyden.
 
+[Italian: present participle of @emph{andare}, @q{to walk}.]
+
 Walking tempo/character.
 
+@seealso
+
+None yet.
+
 
 @node appoggiatura
 @section appoggiatura
@@ -889,6 +1015,10 @@ An appoggiatura may have more notes preceding the main note.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node arpeggio
 @section arpeggio
@@ -902,6 +1032,8 @@ DK: arpeggio, akkordbrydning,
 S: arpeggio,
 FI: arpeggio, murtosointu.
 
+[Italian: @q{harp-like, played like a harp}.]
+
 @lilypond[fragment,line-width=13.0\cm]
  \context PianoStaff <<
   \context Staff = SA \relative c'' {
@@ -922,6 +1054,10 @@ FI: arpeggio, murtosointu.
 >>
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node articulation
 @section articulation
@@ -939,6 +1075,10 @@ Articulation refers to notation which indicates how a note or notes
 should be played.  Slurs, accents, staccato, and legato are all
 examples of articulation.
 
+@seealso
+
+None yet.
+
 
 @node ascending interval
 @section ascending interval
@@ -954,6 +1094,10 @@ FI: nouseva intervalli.
 
 A distance between a starting lower note and a higher ending note.
 
+@seealso
+
+None yet.
+
 
 @node augmented interval
 @section augmented interval
@@ -1015,6 +1159,10 @@ emulate engraving. This required more skill than did engraving.
 
 @end itemize
 
+@seealso
+
+None yet.
+
 
 @node B
 @section B
@@ -1063,6 +1211,15 @@ DK: taktstreg,
 S: taktstreck,
 FI: tahtiviiva.
 
+A vertical line through the staff (or through multiple staves) that
+separates measures.  Used very infrequently during the Renaissance (mostly
+in secular music, or in sacred music to indicate congruences between parts
+in otherwise-unmetered music).
+
+@seealso
+
+@ref{measure}.
+
 
 @node baritone
 @section baritone
@@ -1076,11 +1233,14 @@ DK: baryton,
 S: baryton,
 FI: baritoni, keskikorkuinen miesääni.
 
-The male voice intermediate between the @ref{bass} and the
-@ref{tenor}.
+The male voice intermediate in pitch between the bass and the tenor.
 
 @c F: clef de troisième ligne dropped
 
+@seealso
+
+@ref{bass}, @ref{tenor}.
+
 
 @node baritone clef
 @section baritone clef
@@ -1188,9 +1348,9 @@ DK: (takt)slag,
 S: taktslag,
 FI: aika-arvo.
 
-Note value used for counting, most often half-, fourth-, and eighth
-notes. The base counting value and the number of them per measure is
-indicated at the start of the music.
+Note value used for counting, most often half-, fourth-, and eighth notes.
+The base counting value and the number of them in each measure is indicated
+at the start of the music by the @notation{time signature}.
 
 @lilypond[fragment,line-width=13.0\cm]
 \key g \major
@@ -1200,6 +1360,10 @@ indicated at the start of the music.
 \relative c'' { g8 d' c | b c a | g4. \bar "||"}
 @end lilypond
 
+@seealso
+
+@ref{time signature}.
+
 
 @node beat repeat
 @section beat repeat
@@ -1250,6 +1414,10 @@ Angular brackets for connecting parts in an orchestral or choral score:
   \relative c \context Staff = SB { \clef bass c1 \bar "|." } >>
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node bracket
 @section bracket
@@ -1284,6 +1452,10 @@ A family of blown musical instruments made of brass, all using a cup
 formed mouth piece.  The brass instruments commonly used in a symphony
 orchestra are trumpet, trombone, french horn, and tube.
 
+@seealso
+
+None yet.
+
 
 @node breath mark
 @section breath mark
@@ -1299,18 +1471,25 @@ FI: hengitysmerkki.
 
 Indication of where to breathe in vocal and wind instrument parts.
 
+@seealso
+
+@ref{caesura}.
+
 
 @node breve
 @section breve
 
-ES: cuadrada, breve,
-I: breve,
-F: brève,
-D: Brevis,
-NL: brevis,
-DK: brevis,
-S: brevis,
-FI: brevis, kaksoiskokonuotti.
+@itemize
+@item US: breve, double-whole note,
+@item ES: cuadrada, breve,
+@item I: breve,
+@item F: brève,
+@item D: Brevis,
+@item NL: brevis,
+@item DK: brevis,
+@item S: brevis,
+@item FI: brevis, kaksoiskokonuotti.
+@end itemize
 
 Note value twice as long as a whole note.  Mainly used in pre-1650 music. 
 The shortest note value generally used in white mensural notation, hence the
@@ -1342,7 +1521,7 @@ name, which originally meant @q{of short duration}.
 
 @seealso
 
-@ref{Pitch names}
+@ref{Pitch names}.
 
 
 @node C clef
@@ -1378,6 +1557,10 @@ lines.
 >>
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node cadence
 @section cadence
@@ -1414,6 +1597,32 @@ chance to exhibit their technical skill and -- not last -- their
 ability to improvise.  Since the middle of the 19th century, however,
 most cadenzas have been written down by the composer.
 
+@seealso
+
+None yet.
+
+
+@node caesura
+@section caesura
+
+ES: cesura,
+I: cesura,
+F: césura,
+D: Zäsur,
+NL: ?,
+DK: ?,
+S: ?,
+FI: ?.
+
+[Latin: from the supine of @emph{caedere} @q{to cut down}.]
+
+The break between two musical phrases, sometimes (but not always) marked by a
+rest or a breath mark.
+
+@seealso
+
+@ref{breath mark}.
+
 
 @node canon
 @section canon
@@ -1446,11 +1655,11 @@ FI: sentti, puolisävelaskeleen sadasosa tasavireisessä
 viritysjärjestelmässä.
 
 Logarithmic unit of measurement.  1@tie{}cent is 1/1200 of an octave
-(1/100 of an equally tempered @ref{semitone}).
+(1/100 of an equally tempered semitone).
 
 @seealso
 
-@ref{equal temperament}.
+@ref{equal temperament}, @ref{semitone}.
 
 
 @node central C
@@ -1480,7 +1689,8 @@ may be extended with more thirds. Four-tone @emph{seventh chords} and
 five-tone @emph{ninth} major chords are most often used as dominants
 (functional harmony).  Chords having no third above the lower notes to
 define their mood are a special case called @q{open chords}.  The lack of
-the middle third means their quality is ambivalent: neither major nor minor.
+the middle third means their quality is ambivalent -- neither major nor
+minor.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -1524,13 +1734,17 @@ DK: kromatisk skala,
 S: kromatisk skala,
 FI: kromaattinen asteikko.
 
-A scale consisting of all 12 @ref{semitone}s.
+A scale consisting of all 12 semitones.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
 \relative c' { c1 cis d dis e f fis g gis a ais b c }
 @end lilypond
 
+@seealso
+
+@ref{semitone}.
+
 
 @node chromaticism
 @section chromaticism
@@ -1544,7 +1758,11 @@ DK: kromatik,
 S: kromatik,
 FI: kromatiikka.
 
-Use of tones extraneous to a @ref{diatonic scale} (minor, major).
+Using tones extraneous to a diatonic scale (minor, major).
+
+@seealso
+
+@ref{diatonic scale}.
 
 
 @node church mode
@@ -1576,10 +1794,6 @@ DK: nøgle,
 S: klav,
 FI: avain, nuottiavain.
 
-@seealso
-
-@ref{C clef}, @ref{F clef}, @ref{G clef}.
-
 The clef indicates which lines of the staff correspond to which
 pitches.  The three clef symbols in common use are:
 
@@ -1833,6 +2047,10 @@ major chord.
 }
 @end lilypond
 
+@seealso
+
+@ref{C clef}, @ref{F clef}, @ref{G clef}.
+
 
 @node cluster
 @section cluster
@@ -1872,6 +2090,10 @@ pitch contained in the cluster would be notated as an ordinary note.
 \makeClusters { <c e> <b f'> <b g'> <c g> <f e> }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node comma
 @section comma
@@ -1897,11 +2119,11 @@ same note derived from some other tuning method.
 @node common meter
 @section common meter
 
-@ref{common time}
+Another name for @ref{common time}.
 
 @seealso
 
-@ref{meter}.
+@ref{common time}, @ref{meter}.
 
 
 @node common time
@@ -1916,7 +2138,7 @@ DK: ?,
 S: ?,
 FI: ?.
 
-4/4 time.  The symbol, which resembles a capital letter C, derives from
+4/4 time.  The symbol, which resembles a capital letter C, comes from
 mensural notation.
 
 @seealso
@@ -1999,37 +2221,41 @@ A meter that includes a triplet subdivision within the beat: see
 @ref{compound meter}.
 
 @item
-A time signature that additively combines two or more unequal meters, e.g.
+A time signature that additively combines two or more unequal meters, e.g.,
 "3/8 + 2/8" instead of "5/8".  Sometimes called additive time signatures.
 
 @lilypond[fragment,line-width=13.0\cm]
 #(define (compound-time grob one two three num)
-  (interpret-markup
-   (ly:grob-layout grob)
-   '(((baseline-skip . 2)
-      (word-space . 1.5)
-      (font-family . number)))
-   (markup
-    #:line ( #:column (one) "+" #:column (two num) "+" #:column (three)))))
+  (grob-interpret-markup grob
+    (markup
+      #:override '(baseline-skip . 0)
+      #:number
+      #:line (
+        #:left-column (one num)
+        #:vcenter "+"
+        #:left-column (two num)
+        #:vcenter "+"
+        #:left-column (three num)))))
 
-  \relative c' {
-    \key f \major
-    #(set-time-signature 8 8 '(3 2 3))
-    \override Staff.TimeSignature  #'stencil
-      = #(lambda (grob) (compound-time grob "3" "2" "3" "8"))
-    #(override-auto-beam-setting '(end 1 8 8 8) 3 8)
-    #(override-auto-beam-setting '(end 1 8 8 8) 5 8)
-    \set Staff.beatGrouping = #'(3 2 3)
-
-   c8 d e f4 d8 c bes | c4 g'8 e c f4. \bar "||"
-  }
+\relative c' {
+  \key f \major
+  #(set-time-signature 8 8 '(3 2 3))
+  \override Staff.TimeSignature #'stencil = #(lambda (grob)
+    (compound-time grob "3" "2" "3" "8"))
+  #(override-auto-beam-setting '(end 1 8 8 8) 3 8)
+  #(override-auto-beam-setting '(end 1 8 8 8) 5 8)
+  
+  c8 d e f4 d8 c bes
+  c4 g'8 e c f4.
+  \bar "||"
+}
 @end lilypond
 
 @end enumerate
 
 @seealso
 
-@ref{compound meter}, @ref{meter}.
+@ref{compound meter}, @ref{meter}, @ref{polymetric time signature}.
 
 
 @node concert pitch
@@ -2048,32 +2274,35 @@ The pitch at which the piano and other nontransposing instruments play: such
 instruments are said to be @q{in C}.  The following list includes some (but not
 all) instruments that play in concert pitch:
 
-@itemize
+@c Let's see how easy (or hard) it is to put bulleted lists in tables.
+
+@multitable {alto trombone} {tenor trombone} {bass trombone}
+@headitem Woodwinds @tab Brass @tab Strings
 
-@item Woodwinds
+@item
 @itemize
 @item flute
 @item oboe
 @item bassoon
 @end itemize
 
-@item Brass
+@tab
+
 @itemize
 @item alto trombone
 @item tenor trombone
 @item bass trombone
 @end itemize
 
-@item Strings
+@tab
+
 @itemize
 @item violin
 @item viola
 @item violincello
 @end itemize
 
-@item piano
-
-@end itemize
+@end multitable
 
 The trombones are a special case: although they are said to be @q{in F} (alto or
 bass) or @q{in B-flat} (tenor), this refers to their fundamental note, not to
@@ -2110,14 +2339,18 @@ DK: trinvis bevægelse,
 S: stegvis rörelse,
 FI: asteittainen liike.
 
-Progressing melodically by intervals of a second.  The opposite of a
-@ref{disjunct movement}.
+Progressing melodically by intervals of a second, as contrasted with
+@emph{disjunct movement}.
 
 @lilypond[fragment,line-width=13.0\cm]
 \key g \major \time 4/4
 \relative c'' { g4 g g a | b2 a | g4 b a a | g1 \bar "||" }
 @end lilypond
 
+@seealso
+
+@ref{disjunct movement}.
+
 
 @node consonance
 @section consonance
@@ -2164,6 +2397,10 @@ music typesetters.
 
 @c Copying music required more skill than engraving.  Flagged for NPOV
 
+@seealso
+
+None yet.
+
 
 @node counterpoint
 @section counterpoint
@@ -2223,6 +2460,10 @@ has been one of the most popular polyphonic composition methods.
 >>
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node countertenor
 @section countertenor
@@ -2261,6 +2502,10 @@ Increasing volume.  Indicated by a rightwards opening horizontal wedge
 \relative c'' { g4 \< a b c | d1\! \bar "|." }
 @end lilypond
 
+@seealso
+
+@ref{decrescendo}, @ref{hairpin}.
+
 
 @node cue-notes
 @section cue-notes
@@ -2277,6 +2522,10 @@ FI: vihjenuotit.
 In a separate part notes belonging to another part with the purpose of
 hinting when to start playing.  Usually printed in a smaller type.
 
+@seealso
+
+None yet.
+
 
 @node custos
 @section custos
@@ -2290,17 +2539,16 @@ DK: ?,
 S: ?,
 FI: ?.
 
-A custos (plural: custodes) is a staff symbol that appears at the end
-of a staff line with monophonic musical contents (i.e., with a single
-voice).  It anticipates the pitch of the first note of the following
-line and thus helps the player or singer to manage line breaks during
-performance, thus enhancing readability of a score.
+A custos (plural: custodes) is a staff symbol that appears at the end of a
+staff line with monophonic musical contents (i.e., with a single voice).  It
+anticipates the pitch of the first note of the following line and thus helps
+the player or singer to manage line breaks during performance, which
+enhances the readability of a score.
 
-Custodes were frequently used in music notation until the 16th
-century.  There were different appearences for different notation
-styles.  Nowadays, they have survived only in special forms of musical
-notation such as via the Editio Vaticana dating back to the beginning
-of the 20th century
+Custodes were frequently used in music notation until the 16th century. 
+There were different appearences for different notation styles.  Nowadays,
+they have survived only in special forms of musical notation such as the
+@emph{Editio Vaticana}, dating from the beginning of the 20th century
 
 @lilypond
 \score {
@@ -2322,6 +2570,10 @@ of the 20th century
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node D
 @section D
@@ -2357,6 +2609,10 @@ FI: da capo, alusta.
 Abbreviated @notation{D.C.}.  Indicates that the piece is to be repeated from
 the beginning to the end or to a certain place marked @emph{fine}.
 
+@seealso
+
+None yet.
+
 
 @node dal niente
 @section dal niente
@@ -2407,6 +2663,10 @@ another place frequently near the beginning marked by a sign
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node decrescendo
 @section decrescendo
@@ -2429,6 +2689,10 @@ wedge (hairpin) or the abbreviation @notation{decresc.}.
 }
 @end lilypond
 
+@seealso
+
+@ref{crescendo}, @ref{diminuendo}, @ref{hairpin}.
+
 
 @node descending interval
 @section descending interval
@@ -2444,6 +2708,10 @@ FI: laskeva intervalli.
 
 A distance between a starting higher note and a lower ending note.
 
+@seealso
+
+None yet.
+
 
 @node diatonic scale
 @section diatonic scale
@@ -2457,11 +2725,11 @@ DK: diatonisk skala,
 S: diatonisk skala,
 FI: diatoninen asteikko.
 
-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}).
+A scale consisting of 5@w{ }whole tones and 2@w{ }semitones (S). Scales
+played on the white keys of a piano keybord are diatonic.  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 @emph{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]
@@ -2593,7 +2861,7 @@ the 6th and 7th tone.
     b^"~~ S" c d e^"~~ S" f g a
   }
  \lyrics {
-    "Ancient minor"
+    "Ancient (or Natural) minor"
   }
 >>
 @end lilypond
@@ -2644,6 +2912,10 @@ the 6th and 7th tone.
 >>
 @end lilypond
 
+@seealso
+
+@ref{semitone}, @ref{whole tone}.
+
 
 @node didymic comma
 @section didymic comma
@@ -2699,9 +2971,7 @@ DK: ?,
 S: ?,
 FI: ?.
 
-@c TODO: add definition
-
-This is a placeholder for diminution (wrt mensural notation).
+This is a stub for diminution (@emph{wrt} mensural notation).
 
 @seealso
 
@@ -2737,8 +3007,8 @@ DK: springende bevægelse,
 S: hoppande rörelse,
 FI: melodian hyppivä liike.
 
-Progressing melodically by intervals larger than a major second, as
-opposed to @ref{conjunct movement}.
+Progressing melodically by intervals larger than a major second, as contrasted
+with conjunct movement.
 
 @lilypond[fragment,ragged-right]
 \key a \major
@@ -2749,11 +3019,19 @@ opposed to @ref{conjunct movement}.
   fis2 d4. \bar "||" }
 @end lilypond
 
+@seealso
+
+@ref{conjunct movement}.
+
 
 @node dissonance
 @section dissonance
 
-@ref{dissonant interval}.
+Another name for @ref{dissonant interval}.
+
+@seealso
+
+@ref{dissonant interval}, @ref{harmony}.
 
 
 @node dissonant interval
@@ -2785,7 +3063,7 @@ DK: ?,
 S: ?,
 FI: ?.
 
-[Latin: @q{division}: pl. @emph{divisiones}] In Gregorian chant, a
+[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:
 
@@ -2841,7 +3119,11 @@ DK: dominant,
 S: dominant,
 FI: dominantti, huippusointu.
 
-The fifth @ref{scale degree} in @ref{functional harmony}.
+The fifth @emph{scale degree} in @emph{functional harmony}.
+
+@seealso
+
+@ref{functional harmony}, @ref{scale degree}.
 
 
 @node dominant ninth chord
@@ -2960,6 +3242,10 @@ FI: kaksoistahtiviiva.
 
 Indicates the end of a section within a movement.
 
+@seealso
+
+None yet.
+
 
 @node double dotted note
 @section double dotted note
@@ -3043,6 +3329,10 @@ FI: kaksoistrilli.
 
 A simultaneous trill on two notes, usually in the distance of a third.
 
+@seealso
+
+None yet.
+
 
 @node duple meter
 @section duple meter
@@ -3141,7 +3431,7 @@ indicate this information are called dynamic marks.
 
 @seealso
 
-@ref{church mode}.
+@ref{church mode}, @ref{diatonic scale}.
 
 
 @node eighth note
@@ -3198,12 +3488,12 @@ DK: ?,
 S: ?,
 FI: ?.
 
-More properly synalepha [New Lat. > Gr. συναλοιφη, from Greek συναλοιφην @q{to
-smear together}].
+More properly @emph{synalepha} [New Lat. > Gr. @emph{συναλοιφη}, from Greek
+@emph{συναλοιφην} @q{to smear together}].
 
 The singing of several syllables on a single note.  Elision may be indicated
-by a lyric tie, which is looks like (and serves the same function) as a
-musical tie.
+by a lyric tie, which looks like (and serves the same function) as a musical
+tie.
 
 @seealso
 
@@ -3237,6 +3527,10 @@ drafting or engineering drawing, using similar tools.
 The traditional process of music printing is done through cutting in a
 plate of metal.  Now also the term for the art of music typesetting.
 
+@seealso
+
+None yet.
+
 
 @node enharmonic
 @section enharmonic
@@ -3266,6 +3560,10 @@ names but equal pitch.
 >>
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node equal temperament
 @section equal temperament
@@ -3279,12 +3577,12 @@ DK: ligesvævende temperatur,
 S: liksvävande temperatur,
 FI: tasavireinen.
 
-Tuning system dividing the octave into 12 equal @ref{semitone}s
-(precisely 100 @ref{cent}s).
+A tuning system that divides the octave into 12 equal semitones (each of
+which is precisely equal to 100 cents).
 
 @seealso
 
-@ref{temperament}.
+@ref{cent}, @ref{semitone}, @ref{temperament}.
 
 
 @node expression mark
@@ -3303,12 +3601,17 @@ Performance indications concerning:
 
 @itemize
 
-@item volume, dynamics (for example @ref{forte}, @ref{crescendo}),
+@item volume, dynamics (for example, @notation{forte},
+@notation{crescendo}),
 
-@item tempo (for example @ref{andante}, @ref{allegro}).
+@item tempo (for example, @notation{andante}, @notation{allegro}).
 
 @end itemize
 
+@seealso
+
+@ref{allegro}, @ref{andante}, @ref{crescendo}, @ref{forte}.
+
 
 @node extender line
 @section extender line
@@ -3322,8 +3625,8 @@ DK: ?,
 S: ?,
 FI: ?.
 
-The generic term for a line (or dash) of arbitrary length that extends
-text (without indicating the musical @emph{function} of that text).
+The generic term (in LilyPond) for a line (or dash) of arbitrary length that
+extends text (without indicating the musical @emph{function} of that text).
 
 Used in many contexts, for example:
 
@@ -3362,8 +3665,8 @@ by the given number of octaves.
 
 @seealso
 
-@ref{melisma}, @ref{sul G}, @ref{thorough bass}, @ref{octave mark}, @ref{octave
-marking}.
+@ref{melisma}, @ref{sul G}, @ref{thorough bass}, @ref{octave mark},
+@ref{octave marking}.
 
 
 @node F
@@ -3401,8 +3704,8 @@ The position between the dots of the key symbol is the line of the F
 below central@w{ }C.  Used on the third, fourth and fifth note line. 
 A digit@w{ }8 above the clef symbol indicates that the notes must be
 played an octave higher (for example, bass recorder) while 8@w{ }below
-the clef symbol indicates playing an octave lower (for example, on
-double bass @ref{strings}).
+the clef symbol indicates playing an octave lower (for example, on the
+Double Bass).
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -3432,9 +3735,7 @@ double bass @ref{strings}).
 
 @seealso
 
-@ref{baritone clef}
-
-@c F:  'point d'orgue' on a note, 'point d'arret' on a rest.
+@ref{baritone clef}, @ref{strings}.
 
 
 @node fall
@@ -3482,6 +3783,8 @@ Internals Reference: @ruser{Manual beams}
 @node fermata
 @section fermata
 
+@c F:  'point d'orgue' on a note, 'point d'arret' on a rest.
+
 ES: calderón,
 I: corona,
 F: point d'orgue, point d'arrêt,
@@ -3500,6 +3803,10 @@ Prolonged note or rest of indefinite duration.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node fifth
 @section fifth
@@ -3532,9 +3839,11 @@ FI: kenraalibasso, numeroitu basso.
 
 Also called @q{thorough bass}.
 
-A method of indicating an accompaniment part by the bass notes only, together
-with figures designating the chief @ref{interval}s and @ref{chord}s to be played
-above the bass notes.
+A method of indicating an accompaniment part by the bass notes only,
+together with figures designating the chief intervals and chords to be
+played above the bass notes.
+
+TODO: Make the upper clef smaller, since it's usually "realized" in performance.
 
 @lilypond[fragment,line-width=13.0\cm]
 \context GrandStaff <<
@@ -3561,6 +3870,10 @@ above the bass notes.
 >>
 @end lilypond
 
+@seealso
+
+@ref{chord}, @ref{interval}.
+
 
 @node fingering
 @section fingering
@@ -3574,7 +3887,12 @@ DK: fingersætning,
 S: fingersättning,
 FI: sormitus.
 
-The methodical use of fingers in the playing of instruments.
+Figures to the side or above the note that methodically indicate which
+fingers to use while playing a passage.
+
+@seealso
+
+None yet.
 
 
 @node flag
@@ -3589,21 +3907,24 @@ DK: fane,
 S: flagga,
 FI: lippu, viiri.
 
-Ornament at the end of the stem of a note used for notes with values
-less than a quarter note.  The number of flags determines the
-@ref{note value}.
+Ornament at the end of the stem of a note used for notes with values less
+than a quarter note.  The number of flags determines the note value.
 
 @lilypond[fragment,notime,ragged-right]
 \set Score.automaticBars = ##f
 %\override Score.TextScript #'font-style = #'large
 \relative c'' {
-  g8_"1/8" s8
-  g16_"1/16" s8
-  g32_"1/32" s8
-  g64_"1/64" s8
+  g8_"8th" s8
+  g16_"16th" s8
+  g32_"32nd" s8
+  g64_"64th" s8
 }
 @end lilypond
 
+@seealso
+
+@ref{note value}.
+
 
 @node flageolet
 @section flageolet
@@ -3681,6 +4002,11 @@ Abbreviated @notation{@b{f}}.  Variants include:
 @item @emph{fortissimo}, very loud (notated @notation{@b{ff}}).
 @end itemize
 
+@seealso
+
+None yet.
+
+
 @node fourth
 @section fourth
 
@@ -3736,9 +4062,9 @@ DK: ?,
 S: ?,
 FI: ?.
 
-Analogous to Frenched scores (@emph{q.v}), a Frenched staff has unneeded
-measures or sections removed.  This would be useful for producing, for example,
-an @emph{ossia} staff.
+[Pl. @emph{Frenched staves}] Analogous to Frenched scores (@emph{q.v}), a
+Frenched staff has unneeded measures or sections removed.  This is useful
+for producing, for example, an @emph{ossia} staff.
 
 @seealso
 
@@ -3748,16 +4074,7 @@ an @emph{ossia} staff.
 @node Frenched staves
 @section Frenched staves
 
-ES: pentagramas a la francesa,
-I: ?,
-F: ?,
-D: ?,
-NL: ?,
-DK: ?,
-S: ?,
-FI: ?.
-
-The plural of @ref{Frenched staff}, @emph{q.v.}.
+Plural of @ref{Frenched staff}.
 
 
 @node fugue
@@ -3789,11 +4106,15 @@ DK: funktionsanalyse, funktionsharmonik,
 S: funktionslära,
 FI: harmoniajärjestelmä.
 
-A system of harmonic analysis.  It is based on the idea that, in a
-given key, there are only three functionally different chords: tonic
-(T, the chord on the first note of the scale), subdominant (S, the
-chord on the fourth note), and dominant (D, the chord on the fifth
-note).  Others are considered to be variants of the base chords.
+A system of harmonic analysis.
+
+It is based on the idea that, in a given key, there are only three
+functionally different chords: tonic (T, the chord on the first note of the
+scale), subdominant (S, the chord on the fourth note), and dominant (D, the
+chord on the fifth note).  Others are considered to be variants of the base
+chords.
+
+TODO: what does the @q{p} mean in Sp, Dp, Tp?
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -3806,6 +4127,10 @@ note).  Others are considered to be variants of the base chords.
 >>
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node G
 @section G
@@ -3838,11 +4163,11 @@ DK: g-nøgle,
 S: g-klav,
 FI: G-avain.
 
-A clef symbol indicating the G above middle@w{ }C.  Used on the first
-and second note lines.  A digit 8 above the clef symbol indicates that
-the notes must be played an octave higher while 8 below the clef
-symbol indicates playing or singing an octave lower (most tenor parts
-in choral scores are notated like that).
+A clef symbol that indicates G above middle@w{ }C.  Used on the first and
+second note lines.  A digit 8 above the clef symbol indicates that the notes
+must be played an octave higher while 8 below the clef symbol indicates
+playing or singing an octave lower (used most frequently to notate the tenor
+part in modern choral scores).
 
 @lilypond[fragment,notime,ragged-right]
 <<
@@ -3870,6 +4195,10 @@ in choral scores are notated like that).
 >>
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node glissando
 @section glissando
@@ -3885,6 +4214,10 @@ FI: glissando, liukuen.
 
 Letting the pitch slide fluently from one note to the other.
 
+@seealso
+
+None yet.
+
 
 @node grace notes
 @section grace notes
@@ -3938,7 +4271,11 @@ DK: grave,
 S: grave,
 FI: grave, raskaasti.
 
-Slow, solemn.
+[Italian] Slow, solemn.
+
+@seealso
+
+None yet.
 
 
 @node gruppetto
@@ -3994,15 +4331,17 @@ dynamic marks.
 @node half note
 @section half note
 
-UK: minim,
-ES: blanca,
-I: minima,
-F: blanche,
-D: Halbe, halbe Note,
-NL: halve noot,
-DK: halvnode,
-S: halvnot,
-FI: puolinuotti.
+@itemize
+@item UK: minim,
+@item ES: blanca,
+@item I: minima,
+@item F: blanche,
+@item D: Halbe, halbe Note,
+@item NL: halve noot,
+@item DK: halvnode,
+@item S: halvnot,
+@item FI: puolinuotti.
+@end itemize
 
 @seealso
 
@@ -4012,15 +4351,17 @@ FI: puolinuotti.
 @node half rest
 @section half rest
 
-UK: minim rest,
-ES: silencio de blanca,
-I: pausa di minima,
-F: demi-pause,
-D: halbe Pause,
-NL: halve, rust,
-DK: halvnodespause,
-S: halvpaus,
-FI: puolitauko.
+@itemize
+@item UK: minim rest,
+@item ES: silencio de blanca,
+@item I: pausa di minima,
+@item F: demi-pause,
+@item D: halbe Pause,
+@item NL: halve, rust,
+@item DK: halvnodespause,
+@item S: halvpaus,
+@item FI: puolitauko.
+@end itemize
 
 @seealso
 
@@ -4041,8 +4382,6 @@ FI: harmoninen kadenssi.
 
 A sequence of chords that terminates a musical phrase or section.
 
-@ref{functional harmony}.
-
 @lilypond[fragment,ragged-right]
 \context PianoStaff <<
   \context Staff = SA \relative c'' {
@@ -4066,6 +4405,10 @@ A sequence of chords that terminates a musical phrase or section.
 
 @end lilypond
 
+@seealso
+
+@ref{functional harmony}.
+
 
 @node harmonics
 @section harmonics
@@ -4091,6 +4434,10 @@ 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.
 
+@seealso
+
+None yet.
+
 
 @node harmony
 @section harmony
@@ -4135,7 +4482,11 @@ Dissonances:
 }
 @end lilypond
 
-Three note harmony @ref{chord}.
+For harmony that uses three or more notes, see @ref{chord}.
+
+@seealso
+
+@ref{chord}.
 
 
 @node hemiola
@@ -4150,13 +4501,13 @@ DK: ?,
 S: ?,
 FI: ?.
 
-[From Greek: in Latin, @emph{sesquialtera}] The ratio 3:2. Refers to
-the use of three notes of equal value in the time normally occupied by
-of two notes of equal value.  The resulting rhythm can be expressed in
-modern terms as a substitution (for example) of a bar in 3/2 for one
-of 6/4, or of a bar in 3/4 for one of 6/8.  During the Baroque era,
-hemiola is most frequently as a special effect (or @emph{affect}) at
-cadences.
+[Greek: in Latin, @emph{sesquialtera}] The ratio 3:2.
+
+Most frequently, a proportion (@emph{q.v.}) of three notes of equal value in the
+time normally occupied by two.  The resulting rhythm can be expressed in modern
+terms as a substitution (for example) of a bar in 3/2 for one of 6/4, or of a
+bar in 3/4 for one of 6/8.  During the Baroque era, hemiola is most frequently
+as a special effect (or @emph{affect}) at cadences.
 
 For example, this phrase in 6/4 time
 
@@ -4180,7 +4531,7 @@ and is therefore a polymeter (second definition) of considerable antiquity.
 
 @seealso
 
-@ref{mensural notation}, @ref{meter}, @ref{polymeter}.
+@ref{mensural notation}, @ref{meter}, @ref{polymeter}, @ref{proportion}.
 
 
 @node homophony
@@ -4195,10 +4546,12 @@ DK: homofoni,
 S: homofoni,
 FI: homofonia, yksiäänisyys.
 
-Music in which one voice leads melodically followed by the other
-voices more or less in the same rhythm.  In contrast to
-@ref{polyphony}.
+Music in which one voice leads melodically supported by the other voices in
+the same rhythm (more or less).  In contrast to @emph{polyphony}.
 
+@seealso
+
+@ref{polyphony}.
 
 @node hymn meter
 @section hymn meter
@@ -4212,23 +4565,19 @@ 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.
+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: for example, consider a hymn that has four lines in two couplets
+alternating regularly 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
@@ -4236,15 +4585,14 @@ 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
 
+@seealso
+
+None yet.
 
 
 @node interval
@@ -4259,11 +4607,11 @@ DK: interval,
 S: intervall,
 FI: intervalli, kahden sävelen korkeusero.
 
-Difference in pitch between two notes.  Intervals may be perfect,
-minor, major, diminished, or augmented.  The augmented fourth and the
-diminished fifth are identical (@ref{enharmonic}) and are called
-@emph{tritonus} because they consist of three @ref{whole tone}s.  The
-addition of such two intervals forms an octave.
+Difference in pitch between two notes.  Intervals may be perfect, minor,
+major, diminished, or augmented.  The augmented fourth and the diminished
+fifth are identical (or @emph{enharmonic}) and are called @emph{tritonus}
+because they consist of three whole tones.  The addition of such two
+intervals forms an octave.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -4325,6 +4673,10 @@ addition of such two intervals forms an octave.
 >>
 @end lilypond
 
+@seealso
+
+@ref{enharmonic}, @ref{whole tone}.
+
 
 @node inversion
 @section inversion
@@ -4338,12 +4690,13 @@ DK: ?,
 S: ?,
 FI: ?.
 
-When the bass is not the same as the root, the chord is inverted. The number
-of inversions that a chord can have is one fewer than the number of
-constituent notes. Triads, for example, (having three constituent notes) can
-have three positions, two of which are inversions:
+When a chord sounds with a bass note that differs from the root of the
+chord, it is said to be @emph{inverted}. The number of inversions that a
+chord can have is one fewer than the number of constituent notes.  For
+example, triads (which have three constituent notes) can have three
+positions, two of which are inversions:
 
-@table @code
+@table @dfn
 @item Root position
 The root note is in the bass, and above that are the third and the fifth. A
 triad built on the first scale degree, for example, is marked @notation{I}.
@@ -4363,6 +4716,10 @@ marked as @notation{I6/4} or @notation{Ic}. Second inversion is the most
 unstable chord position.
 @end table
 
+@seealso
+
+None yet.
+
 
 @node inverted interval
 @section inverted interval
@@ -4388,6 +4745,10 @@ The difference between an interval and an octave.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node just intonation
 @section just intonation
@@ -4404,6 +4765,8 @@ FI: puhdas viritys.
 Tuning system in which the notes are obtained by adding and subtracting
 natural fifths and thirds.
 
+@seealso
+
 @ref{temperament}.
 
 
@@ -4419,12 +4782,12 @@ DK: toneart,
 S: tonart,
 FI: tonaliteetti.
 
-According to the 12@w{ }tones of the @ref{chromatic scale} there are
+According to the 12@w{ }tones of the @emph{chromatic scale} there are
 12@w{ }keys, one on@w{ }c, one on c-sharp, etc.
 
 @seealso
 
-@ref{key signature}.
+@ref{chromatic scale}, @ref{key signature}.
 
 
 @node key signature
@@ -4442,6 +4805,8 @@ FI: sävellajiosoitus.
 The sharps or flats appearing at the beginning of each staff indicating the
 key of the music.
 
+@seealso
+
 @ref{accidental}.
 
 
@@ -4457,9 +4822,13 @@ DK: ?,
 S: ?,
 FI: ?.
 
-[From French, @q{Let vibrate}].  Most frequently associated with harp
+[French: @q{Let vibrate}.]  Most frequently associated with harp
 parts. Marked @notation{l.v.} in the score.
 
+@seealso
+
+None yet.
+
 
 @node largo
 @section largo
@@ -4473,8 +4842,8 @@ DK: largo,
 S: largo,
 FI: largo, hitaasti, leveästi.
 
-Very slow in tempo, usually combined with great expressiveness. 
-@emph{Larghetto} is less slow than largo.
+[Italian: @q{wide}.] Very slow in tempo, usually combined with great
+expressiveness. @emph{Larghetto} is less slow than largo.
 
 
 @node leading note
@@ -4489,10 +4858,14 @@ DK: ledetone,
 S: ledton,
 FI: johtosävel.
 
-The seventh @ref{scale degree}, a @ref{semitone} below the tonic; so
+The seventh @emph{scale degree}, a @emph{semitone} below the tonic; so
 called because of its strong tendency to @q{lead up} (resolve upwards)
 to the tonic scale degree.
 
+@seealso
+
+@ref{scale degree}, @ref{semitone}.
+
 
 @node ledger line
 @section ledger line
@@ -4513,6 +4886,10 @@ A ledger line is an extension of the staff.
 \relative c'' { a,1 s c'' }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node legato
 @section legato
@@ -4527,8 +4904,8 @@ S: legato,
 FI: legato, sitoen.
 
 To be performed (a) without any perceptible interruption between the
-notes, unlike (b) @emph{leggiero} or @emph{non-legato}, (c)
-@emph{portato}, and (d) @ref{staccato}.
+notes, unlike (b) @notation{leggiero} or @notation{non-legato}, (c)
+@notation{portato}, or (d) @notation{staccato}.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -4548,6 +4925,10 @@ notes, unlike (b) @emph{leggiero} or @emph{non-legato}, (c)
 >>
 @end lilypond
 
+@seealso
+
+@ref{staccato}.
+
 
 @node legato curve
 @section legato curve
@@ -4579,10 +4960,10 @@ FI: ligatuura.
 
 A ligature is a coherent graphical symbol that represents at least two
 distinct notes.  Ligatures originally appeared in the manuscripts of
-Gregorian chant notation roughly since the 9th century to denote ascending
-or descending sequences of notes.  In early notation, ligatures were used
-for monophonic tunes (Gregorian chant) and very soon denoted also the way of
-performance in the sense of articulation. With the invention of the metric
+Gregorian chant notation around the 9th century to denote ascending or
+descending sequences of notes.  In early notation, ligatures were used for
+monophonic tunes (Gregorian chant) and very soon denoted also the way of
+performance in the sense of articulation.  With the invention of the metric
 system of the white mensural notation, the need for ligatures to denote such
 patterns disappeared.
 
@@ -4605,8 +4986,13 @@ S: liljedamm,
 FI: liljalampi.
 
 A pond with lilies floating in it.
+
 Also, the name of a music typesetting program.
 
+@seealso
+
+None yet.
+
 
 @node line
 @section line
@@ -4637,7 +5023,7 @@ DK: ?,
 S: ?,
 FI: ?.
 
-[From Italian, @q{place}].  Instruction to play the following passage at the
+[Italian: @q{place}.]  Instruction to play the following passage at the
 written pitch.  Cancels octave mark (q.v.).
 
 @seealso
@@ -4665,28 +5051,31 @@ FI: pitkä appoggiatura, pitkä etuhele.
 @node longa
 @section longa
 
-ES: longa,
-I: longa,
-F: longa,
-D: Longa,
-NL: longa,
-DK: longa,
-S: longa,
-FI: longa.
+@itemize
+@item US: long, longa, 
+@item ES: longa,
+@item I: longa,
+@item F: longa,
+@item D: Longa,
+@item NL: longa,
+@item DK: longa,
+@item S: longa,
+@item FI: longa.
+@end itemize
 
-Note value: double length of @ref{breve}.
+Note value: double length of @notation{breve}.
 
 @lilypond[fragment,notime,ragged-right]
 \set Score.automaticBars = ##f
 \relative c'' {
   \override NoteHead #'style = #'mensural
-  g\longa
+  g\longa g\breve
 }
 @end lilypond
 
 @seealso
 
-@ref{note value}.
+@ref{breve}, @ref{note value}.
 
 
 @node lyric tie
@@ -4720,6 +5109,12 @@ DK: ?,
 S: ?,
 FI: sanoitus.
 
+@c Definition?
+
+@seealso
+
+None yet.
+
 
 @node major
 @section major
@@ -4767,11 +5162,14 @@ DK: middeltonetemperatur,
 S: medeltonstemperatur,
 FI: keskisävelviritys.
 
-Temperament yielding acoustically pure thirds by decreasing the
-natural fifth by 16@w{ }@ref{cent}s.  Due to the non-circular
-character of this @ref{temperament} only a limited set of keys are
-playable. Used for tuning keyboard instruments for performance of
-pre-1650 music.
+Temperament yielding acoustically pure thirds by decreasing the natural
+fifth by 16@w{ }cents.  Due to the non-circular character of this
+temperament only a limited set of keys are playable.  Used for tuning
+keyboard instruments for performance of pre-1650 music.
+
+@seealso
+
+@ref{cent}, @ref{temperament}.
 
 
 @node measure
@@ -4786,12 +5184,13 @@ DK: takt,
 S: takt,
 FI: tahti.
 
-A group of @ref{beat}s (units of musical time) the first of which
-bears an accent.  Such groups in numbers of two or more recur
-consistently throughout the composition and are marked from each other
-by bar-lines.
+A group of beats (units of musical time) the first of which bears an accent.
+Such groups in numbers of two or more recur consistently throughout the
+composition and are separated from each other by bar lines.
 
-@ref{meter}.
+@seealso
+
+@ref{bar line}, @ref{beat}, @ref{meter}.
 
 
 @node measure repeat
@@ -4818,14 +5217,15 @@ FI: keskisävel.
 
 @item The third @b{scale degree}.
 
-@item A @ref{chord} having its base tone a third from that of another
+@item A @emph{chord} having its base tone a third from that of another
 chord.  For example, the tonic chord may be replaced by its lower
 mediant (variant tonic).
 
 @end itemize
 
 @seealso
-@ref{functional harmony}, @ref{relative key}.
+
+@ref{chord}, @ref{functional harmony}, @ref{relative key}.
 
 
 @node melisma
@@ -4840,8 +5240,12 @@ DK: ?,
 S: ?,
 FI: melisma, laulettavan tavun sävelkuvio.
 
-A melisma (plural, from Greek: melismata) is a group of notes or tones
-sung on one syllable, especially as applied to liturgical chant.
+A melisma (Greek: plural @emph{melismata}) is a group of notes or tones sung
+on one syllable, especially as applied to liturgical chant.
+
+@seealso
+
+None yet.
 
 
 @node melisma line
@@ -4965,7 +5369,7 @@ frequently used prior to the 20th Century.
 
 @itemize
 
-  @item simple: groups of two.
+  @item simple: subdivided in groups of two.
 
     @itemize
 
@@ -4975,7 +5379,7 @@ frequently used prior to the 20th Century.
 
     @end itemize
 
-  @item compound: groups of three.
+  @item compound: subdivided in groups of three.
 
     @itemize
 
@@ -5029,6 +5433,11 @@ Simple quintuple meter (B. Marcello, 1686-1739):
   aes4 bes8 aes ges4 aes f8 es \bar "||"}
 @end lilypond
 
+(Aside: this is an example of @emph{Augenmusik}: the accidentals are thus in
+the source, with sharps in the accompaniment where the voice has flats and
+@emph{vice versa}.)
+
+
 Compound duple meter (unknown):
 
 @lilypond[fragment,line-width=13.0\cm]
@@ -5083,11 +5492,11 @@ DK: me@-tro@-nom,
 S: me@-tro@-nom,
 FI: metronomi.
 
-Device indicating the exact tempo of a piece.
+Device used to indicate the exact tempo of a piece.
 
 Invented ca. 1812 by Dietrich Nikolaus Winkler of Amsterdam, but takes its name
 from Johann Nepomuk Mälzel, who copied the device, added a scale of tempo
-divisions, and patented it as a "metronome".  The inevitable lawsuit that
+divisions, and patented it as a @q{metronome}.  The inevitable lawsuit that
 followed acknowledged Winkler as the creator, but by then Mälzel had already
 sold many of them, and people had taken to calling it a Mälzel Metronome.
 
@@ -5157,7 +5566,11 @@ Used to qualify other indications, such as:
   sopranos
   @end itemize
 
-@end itemize
+@end itemize
+
+@seealso
+
+None yet.
 
 
 @node mezzo-soprano
@@ -5203,6 +5616,10 @@ First C below the 440 Hz A.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node minor
 @section minor
@@ -5279,6 +5696,10 @@ Moving from one @ref{key} to another.  For example, the second subject
 of a @ref{sonata form} movement modulates to the dominant key if the
 key is major and to the @ref{relative key} if the key is minor.
 
+@seealso
+
+None yet.
+
 
 @node mordent
 @section mordent
@@ -5337,6 +5758,10 @@ theme or subject.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node movement
 @section movement
@@ -5354,6 +5779,10 @@ Greater musical works like @ref{symphony} and @ref{sonata} most often
 consist of several -- more or less -- independant pieces called
 movements.
 
+@seealso
+
+None yet.
+
 
 @node multi-measure rest
 @section multi-measure rest
@@ -5405,8 +5834,8 @@ FI: palautusmerkki.
 @ref{accidental}.
 
 
-@node neighbour tones
-@section neighbour tones
+@node neighbor tones
+@section neighbor tones
 
 @seealso
 
@@ -5457,6 +5886,10 @@ which produces the sound.  However, a clear distinction between the terms tone
 and @ref{note} is strongly recommended.  Briefly, one sees a note,
 and hears a tone.
 
+@seealso
+
+None yet.
+
 
 @node note head
 @section note head
@@ -5470,12 +5903,15 @@ DK: nodehovede,
 S: nothuvud,
 FI: nuotin pää.
 
-A head-like sign which indicates pitch by its position on a
-@ref{staff} provided with a @ref{clef}, and duration
-by a variety of shapes such as hollow or black heads with or without
-@ref{stem}s, @ref{flag}s, etc.  For percussion
-instruments (often having no defined pitch) the note head may indicate the
-instrument.
+A head-like sign which indicates pitch by its position on a @notation{staff}
+provided with a @notation{clef}, and duration by a variety of shapes such as
+hollow or black heads with or without @notation{stems}, @notation{flags}, etc. 
+For percussion instruments (often having no defined pitch) the note head may
+indicate the instrument.
+
+@seealso
+
+@ref{clef}, @ref{flag}, @ref{staff}, @ref{stem}.
 
 
 @node note names
@@ -5498,11 +5934,11 @@ DK nodeværdi,
 S: notvärde,
 FI: nuotin aika-arvo.
 
-Note values (durations) are measured as fractions, normally 1/2, of
-the next higher note value.  The longest duration normally used is
-called @emph{brevis}, but sometimes (mostly in pre-baroque music) the
-double-length note value @emph{longa} or the quadruple-length note
-value @emph{maxima} are used.
+Note values (durations) are measured as fractions -- normally half -- of the
+next higher note value.  The longest duration in current use is the
+@emph{breve}, but sometimes (especially music from the Baroque or earlier) the
+double-length note value @emph{longa} or the quadruple-length note value
+@emph{maxima} are used.
 
 @c TODO -- add maxima to this example, in a way that doesn't break it.
 
@@ -5563,6 +5999,10 @@ dotted notes are also frequently used.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node octavation
 @section octavation
@@ -5760,6 +6200,10 @@ Ossia (otherwise) marks an alternative.  It is an added staff or piano
 score, usually only a few measures long, which presents another version
 of the music, for example for small hands.
 
+@seealso
+
+None yet.
+
 
 @node part
 @section part
@@ -5855,6 +6299,10 @@ kettledrums (I: @emph{timpani}, D: @emph{Pauken}), snare drum, bass drum,
 tambourine, cymbals, chinese gong (tam-tam), triangle, celesta, glockenspiel,
 and xylophone.
 
+@seealso
+
+None yet.
+
 
 @node perfect interval
 @section perfect interval
@@ -5887,6 +6335,10 @@ FI: fraasi, lause.
 
 A natural division of the melodic line, comparable to a sentence of speech.
 
+@seealso
+
+@ref{caesura}.
+
 
 @node phrasing
 @section phrasing
@@ -5900,8 +6352,12 @@ DK: frasering,
 S: fra@-se@-ring,
 FI: fraseeraus, jäsentäminen.
 
-The clear rendering in musical performance of the @ref{phrase}s of
-the melody.  Phrasing may be indicated by a @ref{slur}.
+The clear rendering in musical performance of the @notation{phrases} of the
+melody.  Phrasing may be indicated by a @notation{slur}.
+
+@seealso
+
+@ref{phrase}, @ref{slur}.
 
 
 @node piano
@@ -5919,6 +6375,10 @@ FI, piano, hiljaa.
 @emph{piano} (@b{p}) soft, @emph{pianissimo} (@b{pp}) very soft,
 @emph{mezzo piano} (@b{mp}) medium soft.
 
+@seealso
+
+None yet.
+
 
 @node pickup
 @section pickup
@@ -5982,6 +6442,10 @@ FI: pizzicato, näppäillen.
 A technique for stringed instruments, abbr. @emph{pizz}.  To play by plucking
 the strings.
 
+@seealso
+
+None yet.
+
 
 @node polymeter
 @section polymeter
@@ -5997,7 +6461,8 @@ FI: ?.
 
 @itemize
 
-@item The simultaneous use of two or more meters, in two or more parts.
+@item The @emph{simultaneous} use of two or more meters, in two or more
+parts.
 
 @item The @emph{successive} use of different meters in one or more parts.
 
@@ -6020,7 +6485,8 @@ DK: ?,
 S: ?,
 FI: ?.
 
-Using two or more metric frameworks simultaneously or in alternation.
+Characterized by @emph{polymeter}: using two or more metric frameworks
+simultaneously or in alternation.
 
 @seealso
 
@@ -6061,12 +6527,20 @@ FI: polyfonia, moniäänisyys.
 Music written in a combination of several simultaneous voices (parts)
 of a more or less pronounced individuality.
 
+@seealso
+
 @ref{counterpoint}.
 
 
 @node portato
 @section portato
 
+[Italian: past participle of @emph{portare}, @q{to carry}]
+
+A stroke in which each of several notes is separated slightly within a slur,
+without changing the bow's direction. It is used for passages of a
+@notation{cantabile} character.
+
 @seealso
 
 @ref{legato}.
@@ -6084,9 +6558,15 @@ DK: presto,
 S: presto,
 FI: presto, hyvin nopeasti.
 
+[Italian]
+
 Very quick, i.e., quicker than @ref{allegro}; @emph{prestissimo}
 denotes the highest possible degree of speed.
 
+@seealso
+
+None yet.
+
 
 @node proportion
 @section proportion
@@ -6100,16 +6580,96 @@ DK: ?,
 S: ?,
 FI: ?.
 
-[From Latin @emph{proportio}]  In mensural notation, a ratio that expresses the
-relationship between the note values that follow with those that precede; or
-between the note values of a passage and the @q{normal} relationship of note
-values to the metrical pulse.
+[Latin: @emph{proportio}.] Described in great detail by Gaffurius, in
+@emph{Practica musicae} (published in Milan in 1496).  In mensural notation,
+proportion is:
+
+@enumerate
+
+@item A ratio that expresses the relationship between the note values that
+follow with those that precede;
+
+@item A ratio between the note values of a passage and the @q{normal}
+relationship of note values to the metrical pulse.  (A special case of the
+first definition.)
+
+@end enumerate
+
+The most common proportions are:
+
+@itemize
+@item 2:1 (or simply 2), expressed by a vertical line through the
+mensuration sign (the origin of the @q{cut-time} time signature), or by
+turning the sign backwards
+@item 3:1 (or simply 3)
+@item 3:2 (@emph{sesquialtera})
+@end itemize
+
+To @q{cancel} any of these, the inverse proportion is applied.  Thus:
+
+@itemize
+@item 1:2 cancels 2:1
+@item 1:3 cancels 3:1
+@item 2:3 cancels 3:2
+@item and so on.
+@end itemize
+
+Gaffurius enumerates five basic types of major:minor proportions and their
+inverses:
+
+@enumerate
+@item Multiplex, if the major number is an exact multiple of the minor (2:1,
+3:1, 4:2, 6:3); and its inverse, Submultiplex (1:2, 1:3, 2:4, 3:6)
+
+@item Epimoria or Superparticular [orig. @emph{Epimoria seu Superparticularis}],
+if the major number is one more than the minor (3:2, 4:3, 5:4); and its
+inverse, Subsuperparticular (2:3, 3:4, 4:5)
+
+@item Superpartiens, if the major number is one less than twice the minor
+(5:3, 7:4, 9:5, 11:6); and its inverse, subsuperpartiens (3:5, 4:7, 5:9, 6:11)
+
+@item Multiplexsuperparticular, if the major number is one more than twice the
+minor (5:2, 7:3, 9:4); and its inverse, Submultiplexsuperparticular (2:5, 3:7,
+4:9)
+
+@item Multiplexsuperpartiens, if the major number is one less than some other
+multiple (usually three or four) of the minor (8:3, 11:4, 14:5, 11:3); and its
+inverse, Submultiplexsuperpartiens (3:8, 4:11, 5:14, 3:11)
+
+@end enumerate
+
+He then continues to subdivide each type in various ways.  For the multiplex
+proportions, for example, he indicates how many times greater the major number
+is than the minor:
+
+@itemize
+
+@item If two times greater, the proportion is @emph{dupla}.  If inverted, it's
+called @emph{subdupla}.  Examples: 2:1, 4:2, and 6:3.
+
+@item If three, @emph{tripla}; and its inversion, @emph{subtripla}.  Example:
+3:1, 6:2, and 9:3.
+
+@item If four, @emph{quadrupla}; and its inversion, @emph{subquadrupla}. 
+Example: 4:1, 8:2, and 12:3
+
+@end itemize
+
+Other proportions were possible, but whether they were frequently used is
+another question:
+
+@itemize
+
+@item 33:9, @emph{triplasuperbipartientetertias}
+@item 51:15, @emph{triplasuperbipartientequintas}
+
+@end itemize
 
 @c TODO: add an example or two.  O => 4/3, and its modern equivalent
 
 @seealso
 
-@ref{mensural notation}
+@ref{mensural notation}.
 
 
 @node Pythagorean comma
@@ -6173,9 +6733,9 @@ first element is the root note (or simply @q{root}) of the chord, the second
 note is the @q{third} of the chord, and the last note is the @q{fifth} of
 the chord. These are described below:
 
-@multitable @columnfractions .10 .35 .35 .20
-
-@headitem Chord name @tab Component intervals
+@multitable {Chord name} {Component intervals} {Example} {C, CM, Cma, Cmaj, CΔ}
+@headitem Chord name
+  @tab Component intervals
   @tab Example
   @tab Symbol
 @item major triad @tab major third/perfect fifth
@@ -6293,7 +6853,9 @@ DK: rallentando,
 S: rallentando,
 FI: rallerdando, hidastuen.
 
-Abbreviation "rall.".
+[Italian] A performance indication, abbreviated "rall.".
+
+@seealso
 
 @ref{ritardando}.
 
@@ -6310,7 +6872,7 @@ DK: paralleltoneart,
 S: parallelltonart,
 FI: rinnakkaissävellaji.
 
-@ref{major} and @ref{minor} @ref{key}s with the same @ref{key signature}.
+Major and minor keys that have the same key signature.
 
 @lilypond[fragment,notime,line-width=13.0\cm]
 \set Score.automaticBars = ##f
@@ -6326,11 +6888,15 @@ FI: rinnakkaissävellaji.
 \set Score.automaticBars = ##f
 %\override Score.TextScript #'font-style = #'large
 \relative c' {
-  \key es \major
+  \key c \minor
   c1_"c minor" d es f g a! b! c \bar "||"
 }
 @end lilypond
 
+@seealso
+
+@ref{key}, @ref{key signature}, @ref{major}, @ref{minor}.
+
 
 @node repeat
 @section repeat
@@ -6352,6 +6918,10 @@ FI: toisto.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node rest
 @section rest
@@ -6401,6 +6971,10 @@ metrical unit (beat).
 
 @end itemize
 
+@seealso
+
+None yet.
+
 
 @node ritardando
 @section ritardando
@@ -6416,6 +6990,10 @@ FI: ritardando, hidastuen,
 
 Gradually slackening in speed.  Mostly abbreviated to rit.@: or ritard.
 
+@seealso
+
+None yet.
+
 
 @node ritenuto
 @section ritenuto
@@ -6431,6 +7009,10 @@ FI: ritenuto, hidastaen.
 
 Immediate reduction of speed.
 
+@seealso
+
+None yet.
+
 
 @node scale
 @section scale
@@ -6495,7 +7077,7 @@ DK: ?,
 S: ?,
 FI: ?.
 
-[From Italian, @emph{scordare}, @q{to mistune}.]  Unconventional
+[Italian: @emph{scordare}, @q{to mistune}.]  Unconventional
 tuning of stringed instruments, particularly lutes or violins.  Used
 to:
 
@@ -6519,6 +7101,10 @@ available on open strings
 Tunings that could be called @var{scordatura} first appeared early in
 the 16th Century and became commonplace in the 17th.
 
+@seealso
+
+None yet.
+
 
 @node score
 @section score
@@ -6536,6 +7122,10 @@ A copy of orchestral, choral, or chamber music showing what each
 instrument is to play, each voice to sing, having each part arranged
 one underneath the other on different staves @ref{staff}.
 
+@seealso
+
+None yet.
+
 
 @node second
 @section second
@@ -6554,6 +7144,10 @@ The @ref{interval} between two neigbouring tones of a scale.  A
 @ref{whole tone}s, hence the size of a se@-cond depends on the scale
 degrees in question.
 
+@seealso
+
+None yet.
+
 
 @node semitone
 @section semitone
@@ -6661,7 +7255,7 @@ DK: ?,
 S: ?,
 FI: ?.
 
-[From It, @q{in the same manner}] Performance direction: the music thus marked
+[Italian: @q{in the same manner}.] Performance direction: the music thus marked
 is to be played in the same manner (i.e. with the same articulations, dynamics,
 etc.) as the music that precedes it.
 
@@ -6699,7 +7293,7 @@ that does not include triplet subdivision of the beat.
 @item I: semicroma
 @item F: double croche
 @item D: Sechzehntel, Sechzehntelnote
-@item NL: zes@-ti@-ende noot
+@item NL: zestiende noot
 @item DK: sekstendedelsnode
 @item S: sextondelsnot
 @item FI: kuudestoistaosanuotti
@@ -6811,6 +7405,10 @@ A slur above or below a group of notes indicates that they are to be
 played @ref{legato}, e.g., with one stroke of the violin bow or with
 one breath in singing.
 
+@seealso
+
+None yet.
+
 
 @node solmization
 @section solmization
@@ -6825,11 +7423,13 @@ S: solmisation,
 FI: suhteelliset laulunimet.
 
 General term for systems of designating the degrees of the
-@ref{scale}, not by letters, but by syllables (@emph{do} (@emph{ut}),
+@notation{scale}, not by letters, but by syllables (@emph{do} (@emph{ut}),
 @emph{re}, @emph{mi}, @emph{fa}, @emph{sol}, @emph{la}, @emph{si}
 (@emph{ti})).
 
-@ref{scale degree}.
+@seealso
+
+@ref{scale}, @ref{scale degree}.
 
 
 @node sonata
@@ -6849,6 +7449,10 @@ composition for piano or for some other instrument with piano
 accompaniment, which consists of three or four independant pieces,
 called movements.
 
+@seealso
+
+None yet.
+
 
 @node sonata form
 @section sonata form
@@ -6862,19 +7466,23 @@ DK: sonateform,
 S: sonatform,
 FI: sonaattimuoto.
 
-A form used frequently for single movements of the @ref{sonata},
-@ref{symphony}, quartet, etc.  A movement written in sonata form falls
-into three sections called @emph{exposition}, @emph{development} and
-@emph{recapitulation}.  In the exposition the composer introduces some
-musical ideas, consisting of a number of themes; in the development
-section the composer @q{develops} this material, and in the
-recapitulation the composer repeats the exposition, with certain
-modifications.  The exposition contains a number of themes that fall
-into two groups, often called first and second subject.  Other
-melodies occurring in each group are considered as continuations of
-these two.  The second theme is in another key, normally in the key of
-the @ref{dominant} if the @ref{tonic} is @ref{major}, and in the
-@ref{relative key} if the tonic is @ref{minor}.
+A form used frequently for single movements of the @emph{sonata},
+@emph{symphony}, quartet, etc.  A movement written in sonata form falls into
+three sections called @notation{exposition}, @notation{development} and
+@notation{recapitulation}.  In the exposition the composer introduces some
+musical ideas, consisting of a number of themes; in the development section the
+composer @emph{develops} this material, and in the recapitulation the composer
+repeats the exposition, with certain modifications.  The exposition contains a
+number of themes that fall into two groups, often called first and second
+subject.  Other melodies occurring in each group are considered as continuations
+of these two.  The second theme is in another key, normally in the key of the
+@notation{dominant} if the @notation{tonic} is @notation{major}, and in the
+@notation{relative key} if the tonic is @notation{minor}.
+
+@seealso
+
+@ref{dominant}, @ref{major}, @ref{minor}, @ref{relative key}, @ref{sonata},
+@ref{symphony}, @ref{tonic}.
 
 
 @node song texts
@@ -6899,6 +7507,10 @@ FI: sopraano, korkea naisääni.
 
 The highest female voice.
 
+@seealso
+
+None yet.
+
 
 @node staccato
 @section staccato
@@ -6925,6 +7537,10 @@ below the note head.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node staff
 @section staff
@@ -6943,6 +7559,10 @@ lines upon and between which the musical notes are written, thus
 indicating (in connection with a @ref{clef}) their pitch.  Staves for
 @ref{percussion} instruments may have fewer lines.
 
+@seealso
+
+None yet.
+
 
 @node staves
 @section staves
@@ -6981,6 +7601,10 @@ whole note.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node stringendo
 @section stringendo
@@ -6994,7 +7618,7 @@ DK: ?,
 S: ?,
 FI: ?.
 
-[It, @q{pressing}].  Pressing, urging, or hastening the time, as to a
+[Italian: @q{pressing}.]  Pressing, urging, or hastening the time, as to a
 climax.
 
 @seealso
@@ -7018,6 +7642,10 @@ A family of stringed musical instruments played with a bow.  Strings
 commonly used in a symphony orchestra are violin, viola, violoncello,
 and double bass.
 
+@seealso
+
+None yet.
+
 
 @node strong beat
 @section strong beat
@@ -7048,9 +7676,11 @@ DK: subdominant,
 S: subdominant,
 FI: subdominantti, alidominantti.
 
-The fourth @ref{scale degree}.
+The fourth @notation{scale degree}.
 
-@ref{functional harmony}.
+@seealso
+
+@ref{functional harmony}, @ref{scale degree}.
 
 
 @node submediant
@@ -7065,7 +7695,11 @@ DK: Submediant,
 S: submediant,
 FI: alikeskisävel.
 
-The sixth @ref{scale degree}.
+The sixth @notation{scale degree}.
+
+@seealso
+
+@ref{functional harmony}, @ref{scale degree}, @ref{superdominant}.
 
 
 @node subtonic
@@ -7082,6 +7716,10 @@ FI: subtoonika, alitoonika.
 
 The seventh @ref{scale degree}.
 
+@seealso
+
+@ref{functional harmony}, @ref{scale degree}.
+
 
 @node sul G
 @section sul G
@@ -7098,6 +7736,10 @@ FI: ?.
 Indicates that the indicated passage (or note) should be played on the
 G string.
 
+@seealso
+
+None yet.
+
 
 @node superdominant
 @section superdominant
@@ -7113,6 +7755,10 @@ FI: ylidominantti.
 
 The sixth @ref{scale degree}.
 
+@seealso
+
+@ref{functional harmony}, @ref{scale degree}, @ref{submediant}.
+
 
 @node supertonic
 @section supertonic
@@ -7128,6 +7774,10 @@ FI: ylitoonika.
 
 The second @ref{scale degree}.
 
+@seealso
+
+@ref{functional harmony}, @ref{scale degree}.
+
 
 @node symphony
 @section symphony
@@ -7141,7 +7791,12 @@ DK: symfoni,
 S: symfoni,
 FI: sinfonia.
 
-A symphony may be defined as a @ref{sonata} for orchestra.
+A symphony may be defined as a @emph{sonata} for orchestra.
+
+@seealso
+
+@ref{sonata}.
+
 
 
 @node syncopation
@@ -7173,6 +7828,10 @@ contradiction between the underlaying (normal) pulse and the actual
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node syntonic comma
 @section syntonic comma
@@ -7213,9 +7872,13 @@ DK: system,
 S: system,
 FI: nuottijärjestelmä.
 
-The collection of staves (@ref{staff}), two or more, as used for writing
+The collection of staves (@notation{staff}), two or more, as used for writing
 down of keyboard, chamber, choral, or orchestral music.
 
+@seealso
+
+@ref{staff}.
+
 
 @node temperament
 @section temperament
@@ -7232,6 +7895,8 @@ FI: viritysjärjestelmä.
 Systems of tuning in which the intervals deviate from the acoustically
 pure intervals.
 
+@seealso
+
 @ref{meantone temperament}, @ref{equal temperament}.
 
 
@@ -7247,10 +7912,15 @@ DK: tempobetegelse,
 S: tempobeteckning,
 FI: tempomerkintä.
 
-The rate of speed of a composition or a section thereof, ranging from
-the slowest to the quickest, as is indicated by tempo marks as
-@ref{largo}, @ref{adagio}, @ref{andante}, @ref{allegro}, and
-@ref{presto}.
+The rate of speed of a composition or a section thereof, ranging from the
+slowest to the quickest, as is indicated by tempo marks as @notation{largo},
+@notation{adagio}, @notation{andante}, @notation{allegro}, and
+@notation{presto}.
+
+@seealso
+
+@ref{adagio}, @ref{allegro}, @ref{andante}, @ref{largo}, @ref{presto}.
+
 
 
 @node tenor
@@ -7265,7 +7935,11 @@ DK: tenor,
 S: tenor,
 FI: tenori, korkea miesääni.
 
-The highest male voice (apart from @ref{countertenor}).
+The highest @q{natural} male voice (apart from @notation{countertenor}).
+
+@seealso
+
+@ref{countertenor}.
 
 
 @node tenth
@@ -7300,6 +7974,10 @@ FI: viiva, tenuto.
 An indication that a particular note should be held for the whole
 length, although this can vary depending on the composer and era.
 
+@seealso
+
+None yet.
+
 
 @node third
 @section third
@@ -7327,7 +8005,7 @@ FI: terssi.
 @item I: biscroma
 @item F: triple croche
 @item D: Zweiunddreissigstel, Zweiunddreissigstelnote
-@item NL: twee-endertig@-ste (32e) noot
+@item NL: twee@-endertig@-ste (32e) noot
 @item DK: toogtredivtedelsnode
 @item S: trettiotvåondelsnot
 @item FI: kolmaskymmeneskahdesosanuotti
@@ -7347,7 +8025,7 @@ FI: terssi.
 @item I: pausa di biscroma
 @item F: huitième de soupir
 @item D: Zweiunddreissigstel@-pause
-@item NL: twee-endertig@-ste (32e) rust
+@item NL: twee@-endertig@-ste (32e) rust
 @item DK: toogtredivtedelspause
 @item S: trettiotvåondelspaus
 @item FI: kolmaskymmeneskahdesosatauko
@@ -7435,6 +8113,10 @@ Tone is a primary building material of music.
 
 @c Music from the 20th century may be based on atonal sounds. Meh, not so much
 
+@seealso
+
+None yet.
+
 
 @node tonic
 @section tonic
@@ -7448,11 +8130,11 @@ DK: tonika,
 S: tonika,
 FI: toonika.
 
-The first @ref{scale degree}.
+The first @notation{scale degree}.
 
 @seealso
 
-@ref{functional harmony}.
+@ref{functional harmony}, @ref{scale degree}.
 
 
 @node transposing instrument
@@ -7528,6 +8210,10 @@ relative pitches.
 }
 @end lilypond
 
+@seealso
+
+None yet.
+
 
 @node treble clef
 @section treble clef
@@ -7736,6 +8422,10 @@ Playing of the same notes or the same melody by various instruments
 (voices) or by the whole orchestra (choir), either at exactly the same
 pitch or in a different octave.
 
+@seealso
+
+None yet.
+
 
 @node upbeat
 @section upbeat
@@ -7768,27 +8458,24 @@ FI: ääni, lauluääni.
 
 @itemize
 
-@item Human voices:
-
-@itemize
-
-@item @ref{soprano}
-
-@item @ref{mezzo-soprano}
-
-@item @ref{contralto}
+  @item Human voices:
 
-@item @ref{tenor}
-
-@item @ref{baritone}
+    @itemize
+      @item @ref{soprano}
+      @item @ref{mezzo-soprano}
+      @item @ref{contralto}
+      @item @ref{tenor}
+      @item @ref{baritone}
+      @item @ref{bass}
+    @end itemize
 
-@item @ref{bass}
+  @item A melodic layer or part of a polyphonic composition.
 
 @end itemize
 
-@item A melodic layer or part of a polyphonic composition.
+@seealso
 
-@end itemize
+None yet.
 
 
 @node volta
@@ -7803,9 +8490,13 @@ DK: ?,
 S: ?,
 FI: ?.
 
-[From Italian, @q{time} (instance, not duration)].  An ending, such as a first
+[Italian: @q{time} (instance, not duration).]  An ending, such as a first
 or second ending.  LilyPond extends this idea to any number, and allows any text
-(not just a number) -- to serve as the @q{volta} text.
+(not just a number) -- to serve as the @notation{volta} text.
+
+@seealso
+
+None yet.
 
 
 @node weak beat
@@ -7903,6 +8594,10 @@ instruments are actually made from metal.  The woodwind instruments
 commonly used in a symphony orchestra are flute, oboe, clarinet,
 saxophone, and bassoon.
 
+@seealso
+
+None yet.
+
 
 @node Duration names notes and rests
 @chapter Duration names notes and rests
@@ -7951,8 +8646,8 @@ saxophone, and bassoon.
   @tab brevispaus
 @item @strong{FI} @tab longa-nuotti
   @tab longa-tauko
-  @tab brevis-nuotti, kaksoiskokonuotti
-  @tab brevis-tauko, kaksoiskokotauko
+  @tab brevis-nuotti, kaksoiskoko@-nuotti
+  @tab brevis-tauko, kaksoiskoko@-tauko
 
 @end multitable
 
@@ -8047,10 +8742,10 @@ saxophone, and bassoon.
   @tab fjärdedelspaus
   @tab åttondelsnot
   @tab åttondelspaus
-@item @strong{FI} @tab neljäsosanuotti
-  @tab neljäsosatauko
-  @tab kahdeksasosanuotti
-  @tab kahdeksasosatauko
+@item @strong{FI} @tab neljäsosa@-nuotti
+  @tab neljäsosa@-tauko
+  @tab kahdeksasosa@-nuotti
+  @tab kahdeksasosa@-tauko
 
 @end multitable
 
@@ -8101,8 +8796,8 @@ the lilypond-user discussion list.
 @item @strong{DE} @tab Sechzehntelnote
   @tab Sechzehntelpause
   @tab 16tel-Note
-@item @strong{NL} @tab zestiende noot
-  @tab zestiende rust
+@item @strong{NL} @tab zes@-ti@-ende noot
+  @tab zes@-ti@-ende rust
   @tab 16e noot
 @item @strong{DK} @tab sekstendedelsnode
   @tab sekstendedelspause
@@ -8110,8 +8805,8 @@ the lilypond-user discussion list.
 @item @strong{SE} @tab sextondelsnot
   @tab sextondelspaus
   @tab -
-@item @strong{FI} @tab kuudestoistaosanuotti
-  @tab kuudestoistaosatauko
+@item @strong{FI} @tab kuudes@-toistaosa@-nuotti
+  @tab kuudes@-toistaosa@-tauko
   @tab 16-osanuotti
 
 @end multitable
@@ -8136,20 +8831,20 @@ the lilypond-user discussion list.
 @item @strong{FR} @tab triple croche
   @tab huitième de soupir
   @tab -
-@item @strong{DE} @tab Zweiunddreißigstelnote
-  @tab Zweiunddreißigstelpause
+@item @strong{DE} @tab Zweiunddreißig@-stelnote
+  @tab Zweiunddreißig@-stelpause
   @tab 32tel-Note
-@item @strong{NL} @tab tweeendertigste noot
-  @tab tweeendertigste rust
+@item @strong{NL} @tab twee@-endertigste noot
+  @tab twee@-endertigste rust
   @tab 32e noot
 @item @strong{DK} @tab toogtredivtedelsnode
   @tab toogtredivtedelspause
   @tab -
-@item @strong{SE} @tab trettiotvåondelsnot
-  @tab trettiotvåondelspaus
+@item @strong{SE} @tab trettio@-tvåondelsnot
+  @tab trettio@-tvåondelspaus
   @tab -
-@item @strong{FI} @tab kolmaskymmeneskahdesosanuotti
-  @tab kolmaskymmeneskahdesosatauko
+@item @strong{FI} @tab kolmas@-kymmenes@-kahdesosa@-nuotti
+  @tab kolmas@-kymmenes@-kahdesosa@-tauko
   @tab 32-osanuotti
 
 @end multitable
@@ -8180,14 +8875,14 @@ the lilypond-user discussion list.
 @item @strong{NL} @tab vierenzestigste noot
   @tab vierenzestigste rust
   @tab 64e noot
-@item @strong{DK} @tab fireogtredsindstyvendedelsnode
-  @tab fireogtredsindstyvendedelspause
+@item @strong{DK} @tab fireog@-tredsindstyven@-dedelsnode
+  @tab fireog@-tredsindstyven@-dedelspause
   @tab -
 @item @strong{SE} @tab sextiofjärdedelsnot
   @tab sextiofjärdedelspaus
   @tab -
-@item @strong{FI} @tab kuudeskymmenesneljäsosanuotti
-  @tab kuudeskymmenesneljäsosatauko
+@item @strong{FI} @tab kuudes@-kymmenes@-neljäsosa@-nuotti
+  @tab kuudes@-kymmenes@-neljäsosa@-tauko
   @tab 64-osanuotti
 
 @end multitable
@@ -8211,19 +8906,19 @@ the lilypond-user discussion list.
   @tab -
 @item @strong{FR} @tab quintuple croche
   @tab trente-deuxième de soupir  @tab -
-@item @strong{DE} @tab Hundertundachtundzwanzigstel
-  @tab Hundertundachtundzwanzigstel  @tab 128tel-Note
-@item @strong{NL} @tab honderdachtentwintigste noot
-  @tab honderdachtentwintigste rust
+@item @strong{DE} @tab Hundert@-achtundzwanzigstel@-note
+  @tab Hundert@-achtundzwanzigstel@-pause  @tab 128tel-Note
+@item @strong{NL} @tab honderd@-acht@-en@-twintigste noot
+  @tab honderd@-acht@-en@-twintigste rust
   @tab 128e noot
-@item @strong{DK} @tab hundredeotteogtyvendedelsnode
-  @tab hundredeotteogtyvendedelspause
+@item @strong{DK} @tab hundrede@-otte@-og@-tyvendedels@-node
+  @tab hundrede@-otte@-og@-tyvendedels@-pause
   @tab -
 @item @strong{SE} @tab hundratjugoåttondelsnot
   @tab hundratjugoåttondelspaus
   @tab -
-@item @strong{FI} @tab sadaskahdeskymmeneskahdeksasosanuotti
-  @tab sadaskahdeskymmeneskahdeksasosatauko
+@item @strong{FI} @tab sadas@-kahdes@-kymmenes@-kahdeksasosa@-nuotti
+  @tab sadas@-kahdes@-kymmenes@-kahdeksasosa@-tauko
   @tab 128-osanuotti
 
 @end multitable
@@ -8246,19 +8941,19 @@ the lilypond-user discussion list.
   @tab -
 @item @strong{FR} @tab sextuple croche
   @tab soixante-quatrième de soupir  @tab -
-@item @strong{DE} @tab Zweihundertundsechsundfünfzigstelnote
-  @tab Zweihundertundsechsundfünfzigstel  @tab 256tel-Note
-@item @strong{NL} @tab tweehonderdzesenvijftigste noot
-  @tab tweehonderdzesenvijftigste rust
+@item @strong{DE} @tab Zweihundert@-sechsundfünfzigstel@-note
+  @tab Zweihundert@-sechsundfünfzigstelpause  @tab 256tel-Note
+@item @strong{NL} @tab tweehonderd@-zesenvijftigste noot
+  @tab tweehonderd@-zesenvijftigste rust
   @tab 256e noot
-@item @strong{DK} @tab tohundredeseksoghalvtredsendedelsnode
-  @tab tohundredeseksoghalvtredsendedelspause
+@item @strong{DK} @tab tohundrede@-seks@-og@-halvtredsendedels@-node
+  @tab tohundrede@-seks@-og@-halvtredsendedels@-pause
   @tab -
-@item @strong{SE} @tab tvåhundrafemtiosjättedelsnot
-  @tab tvåhundrafemtiosjättedelspaus
+@item @strong{SE} @tab tvåhundra@-femtiosjättedelsnot
+  @tab tvåhundra@-femtiosjättedelspaus
   @tab -
-@item @strong{FI} @tab kahdessadasviideskymmeneskuudesosanuotti
-  @tab kahdessadasviideskymmeneskuudesosatauko
+@item @strong{FI} @tab kahdes@-sadas@-viides@-kymmenes@-kuudesosa@-nuotti
+  @tab kahdes@-sadas@-viides@-kymmenes@-kuudesosa@-tauko
   @tab 256-osanuotti
 
 @end multitable
@@ -8276,7 +8971,7 @@ the lilypond-user discussion list.
 @c -iss/-ess endings for Swedish per Mats Bengtsson
 @c @columnfractions .105 .145 .125 .125 .125 .125 .125 .125 -->
 
-@multitable {@strong{e-sharp} = f} {sol sostenido} {sol bemolle} {sol bémol} {Gis} {gis} {gis} {giss} {gis}
+@multitable {g-sharp} {sol sostenido} {sol diesis} {sol dièse} {Gis} {gis} {gis} {giss} {gis}
 @headitem EN
   @tab ES @tab I @tab F @tab D
   @tab NL @tab DK @tab S @tab FI
@@ -8340,17 +9035,17 @@ WSOY, 1976.
 @item Leuchtmann, Horst, ed. @cite{Polyglottes Wörterbuch der musikalischen
 Terminologie}. Kassel, 1980.
 
-@item Randall, Don, ed. @cite{The New Harvard Dictionary of Music}.
-Cambridge: Belknap Press (Harvard University Press), 1986.
-
-@item Riemann, Hugo. @cite{Musik-lexicon}. Berlin, 1929.
-
 @item Hornby, Albert Sydney. @cite{Oxford Advanced Learner's Dictionary of
 Current English}, 3rd ed. London: Oxford University Press, 1974.
 
 @item Porter, Noah. @cite{Webster's Revised Unabridged Dictionary}.
 Springfield, Massachusetts: G. & C. Merriam Company, 1913.
 
+@item Randall, Don, ed. @cite{The New Harvard Dictionary of Music}.
+Cambridge: Belknap Press (Harvard University Press), 1986.
+
+@item Riemann, Hugo. @cite{Musik-lexicon}. Berlin, 1929.
+
 @end itemize
 
 @bye
index efd842df2531bdea894218ae78ea19d89f7dff18..ba9fdc95e56b8e235a7767ef3153af738f4b9857 100644 (file)
@@ -51,8 +51,8 @@ code is easy.  The general form of these functions is
 
 @example
 function =
-#(define-music-function (parser location @var{var1} @var{var2}... )
-                        (@var{var1-type?} @var{var2-type?}...)
+#(define-music-function (parser location @var{var1} @var{var2}...@var{vari}... )
+                        (@var{var1-type?} @var{var2-type?}...@var{vari-type?}...)
   #@{
     @emph{...music...}
   #@})
@@ -62,10 +62,10 @@ function =
 where
 
 @multitable @columnfractions .33 .66
-@item @var{argi}         @tab @var{i}th variable
-@item @var{argi-type?}   @tab type of variable
+@item @var{vari}         @tab @var{i}th variable
+@item @var{vari-type?}   @tab type of @var{i}th variable
 @item @var{...music...}  @tab normal LilyPond input, using
 variables as @code{#$var1}.
variables as @code{#$var1}, etc.
 @end multitable
 
 There following input types may be used as variables
@@ -74,7 +74,7 @@ other documentation specifically about Scheme for more
 variable types.
 
 @multitable @columnfractions .33 .66
-@headitem Input type          @tab @var{argi-type?} notation
+@headitem Input type          @tab @var{vari-type?} notation
 @item Integer                 @tab @code{integer?}
 @item Float (decimal number)  @tab @code{number?}
 @item Text string             @tab @code{string?}
@@ -83,9 +83,9 @@ variable types.
 @item A pair of variables     @tab @code{pair?}
 @end multitable
 
-The @code{parser} and @code{location} argument are mandatory,
+The @code{parser} and @code{location} arguments are mandatory,
 and are used in some advanced situations.  The @code{parser}
-argument is used to access to the value of another LilyPond
+argument is used to gain access to the value of another LilyPond
 variable.  The @code{location} argument
 is used to set the @q{origin} of the music expression that is built
 by the music function, so that in case of a syntax error LilyPond
index 4ab75da163c9c77de170fc542dedeb0aab545941..f224fa479ec01e2559aa1b1b94ffc47be099d927 100644 (file)
@@ -31,6 +31,7 @@ This section discusses simultaneous notes inside the same voice.
 
 @menu
 * Chorded notes::
+* Simultaneous expressions::
 * Clusters::
 @end menu
 
@@ -40,23 +41,25 @@ This section discusses simultaneous notes inside the same voice.
 
 @cindex chords
 @cindex brackets, angle
+@cindex angle brackets
 @cindex relative pitch in chords
+
 @funindex <
 @funindex >
 @funindex <...>
 
-A chord is formed by a enclosing a set of pitches between @code{<} and
-@code{>}.  A chord may be followed by a duration and/or a set of
-articulations, just like simple notes:
+A chord is formed by enclosing a set of pitches between @code{<}
+and @code{>}.  A chord may be followed by a duration and/or a set
+of articulations, just like simple notes:
 
 @lilypond[verbatim,quote,relative=1]
 <c e g>2 <c f a>4-> <e g c>-.
 @end lilypond
 
-Relative mode can be used for pitches in chords. The octave of each                      
-pitch is chosen using the preceding pitch as a reference except in the                   
-case of the first pitch in a chord: the reference for the first pitch is                 
-the @emph{first} pitch of the preceding chord.  
+Relative mode can be used for pitches in chords. The octave of each
+pitch is chosen using the preceding pitch as a reference except in
+the case of the first pitch in a chord: the reference for the first
+pitch is the @emph{first} pitch of the preceding chord.
 
 For more information about chords, see @ref{Chord notation}.
 
@@ -74,14 +77,42 @@ Notation Reference:
 Snippets:
 @rlsr{Simultaneous notes}.
 
-@ignore
-@knownissues
+@node Simultaneous expressions
+@unnumberedsubsubsec Simultaneous expressions
 
-For some reason, music expressions like @code{<< @{ g8 e8 @} a4 >>}
-that should automatically turn into chords, appear split in two
-staves.  To avoid this, use explicit chords instead as in
-@code{<g a>8 <e a>8}.
-@end ignore
+One or more music expressions enclosed in double angle brackets are
+taken to be simultaneous.  If the first expression begins with a
+single note or if the whole simultaneous expression appears
+explicitly within a single voice, the whole expression is placed on
+a single staff; otherwise the elements of the simultaneous
+expression are placed on separate staves.
+
+The following examples show simultaneous expressions on one staff:
+
+@lilypond[quote,verbatim,relative=2]
+\new Voice {  % explicit single voice
+  << {a4 b g2} {d4 g c,2} >>
+}
+@end lilypond
+
+@lilypond[quote,verbatim,relative=2]
+% single first note
+a << {a4 b g}  {d4 g c,} >>
+@end lilypond
+
+This can be useful if the simultaneous sections have identical
+rhythms, but attempts to attach notes with different durations
+to the same stem will cause errors.
+
+The following example shows how simultaneous expressions can
+generate multiple staves implicitly:
+
+@lilypond[quote,verbatim,relative=2]
+% no single first note
+<< {a4 b g2}  {d4 g2 c,4} >>
+@end lilypond
+
+Here different rhythms cause no problems.
 
 
 @node Clusters
@@ -89,13 +120,14 @@ staves.  To avoid this, use explicit chords instead as in
 
 @cindex cluster
 @cindex note cluster
+
 @funindex \makeClusters
 @funindex makeClusters
 
-A cluster indicates a continuous range of pitches to be played.  They
-can be denoted as the envelope of a set of notes.  They are entered by
-applying the function @code{\makeClusters} to a sequence of chords,
-e.g.,
+A cluster indicates a continuous range of pitches to be played.
+They can be denoted as the envelope of a set of notes.  They are
+entered by applying the function @code{\makeClusters} to a sequence
+of chords, e.g.,
 
 @lilypond[quote,relative=2,verbatim]
 \makeClusters { <g b>2 <c g'> }
@@ -124,10 +156,11 @@ Clusters look good only if they span at least two chords; otherwise
 they appear too narrow.
 
 Clusters do not have a stem and cannot indicate durations by
-themselves.  Separate clusters would need a separating rest between
-them.
+themselves, but the length of the printed cluster is determined by
+the durations of the defining chords.  Separate clusters need a
+separating rest between them.
 
-Clusters do not produce MIDI output.  
+Clusters do not produce MIDI output.
 
 @node Multiple voices
 @subsection Multiple voices
@@ -151,6 +184,7 @@ multiple staves.
 @cindex polyphony, single-staff
 @cindex voice
 @cindex lyrics assigned to one voice
+
 @funindex \voiceOne
 @funindex voiceOne
 @funindex \voiceOne ... \voiceFour
@@ -158,7 +192,9 @@ multiple staves.
 @funindex \oneVoice
 @funindex oneVoice
 
-The basic structure of code needed to achieve multiple, independent
+@strong{@i{Explicitly instantiating voices}}
+
+The basic structure needed to achieve multiple independent
 voices in a single staff is illustrated in the following example:
 
 @lilypond[quote,relative=3,verbatim]
@@ -170,27 +206,33 @@ voices in a single staff is illustrated in the following example:
 >>
 @end lilypond
 
-Here, voices are instantiated explicitly and are given a name. The
-@code{\voiceOne} ... @code{\voiceFour} commands set up the voices so
-that first and third voices get stems up, second and fourth voices get
-stems down, third and fourth voice note heads are horizontally
-shifted, and rests in the respective voices are automatically moved to
-avoid collisions.  Using the @code{\oneVoice} command, all the voice
-settings are put back to the neutral directions typical of a
-single-voice passage.
-
-We can make a voice to be in the same @code{Voice} context before
-and after a temporary polyphonic passage.  For example, the following
-construct keeps a voice alive throughout the polyphonic section.  Said
-voice is the first one inside of the two-voice section, and the extra
-voice is the second one.
+Here, voices are instantiated explicitly and are given names. The
+@code{\voiceOne} ... @code{\voiceFour} commands set up the voices
+so that first and third voices get stems up, second and fourth
+voices get stems down, third and fourth voice note heads are
+horizontally shifted, and rests in the respective voices are
+automatically moved to avoid collisions.  The @code{\oneVoice}
+command returns all the voice settings to the neutral default
+directions.
+
+@strong{@i{Temporary polyphonic passages}}
+
+A temporary polyphonic passage can be created with the following
+construct:
 
 @example
-<< @{ \voiceOne ... @} \new Voice @{ \voiceTwo ... @} >> \oneVoice
+<< @{ \voiceOne ... @}
+  \new Voice @{ \voiceTwo ... @}
+>> \oneVoice
 @end example
 
-Using the name given when created, this allows lyrics to be assigned
-to one consistent voice.
+Here, the first expression within a temporary polyphonic passage is
+placed into the @code{Voice} context which was in use immediately
+before the polyphonic passage, and that same @code{Voice} context
+continues after the temporary section.  Other expressions within
+the angle brackets are assigned to distinct temporary voices.
+This allows lyrics to be assigned to one continuing voice before,
+during and after a polyphonic section:
 
 @lilypond[quote, verbatim, relative=2]
 <<
@@ -203,11 +245,11 @@ to one consistent voice.
       }
       \new Voice {
         \voiceTwo
-        e d
+        d2
       }
     >>
     \oneVoice
-    e
+    e4
   }
   \new Lyrics \lyricsto "melody" {
   This is my song.
@@ -215,13 +257,20 @@ to one consistent voice.
 >>
 @end lilypond
 
-Here, the @code{\voiceOne} and @code{\voiceTwo} commands help to make clear what
-settings does each voice receive.
+Here, the @code{\voiceOne} and @code{\voiceTwo} commands are
+required to define the settings of each voice.
+
+@strong{@i{The double backslash construct}}
 
-The @code{<<@{...@} \\ @{...@}>>} construction, where the two (or
-more) voices are separated by double backslashes, can be used as a
-simplified method to print multiple voices in a single staff.  Our
-first example could be typeset as follows:
+The @code{<< @{...@} \\ @{...@} >>} construct, where the two (or
+more) expressions are separated by double backslashes, behaves
+differently to the similar construct without the double backslashes:
+@emph{all} the expressions within this contruct are assigned
+to new @code{Voice} contexts.  These new @code{Voice} contexts
+are created implicitly and are given the fixed names @code{"1"},
+@code{"2"}, etc.
+
+The first example could be typeset as follows:
 
 @lilypond[quote,relative=3,verbatim]
 <<
@@ -231,38 +280,37 @@ first example could be typeset as follows:
 >>
 @end lilypond
 
-This syntax is simpler and can be used where it does not matter that
-temporary voices are created and then discarded.  These implicitly
-created voices are given the settings equivalent to the effect of the
-@code{\voiceOne} ... @code{\voiceFour} commands, in the order in which
-they appear in the code.  In the following example, the intermediate
-voice has stems up, therefore we enter it in the third place, so it
-becomes voice three which has the stems up as desired.
+This syntax can be used where it does not matter that temporary
+voices are created and then discarded.  These implicitly created
+voices are given the settings equivalent to the effect of the
+@code{\voiceOne} ... @code{\voiceFour} commands, in the order in
+which they appear in the code.
+
+In the following example, the intermediate voice has stems up,
+therefore we enter it in the third place, so it becomes voice
+three, which has the stems up as desired.  Spacer rests are
+used to avoid printing doubled rests.
 
 @lilypond[quote,relative=3,verbatim]
 <<
-  { r8 g g  g g f16 es f8 d }
+  { r8 g g  g g f16 ees f8 d }
   \\
-  { es,8 r es r d r d r }
+  { ees,8 r ees r d r d r }
   \\
   { d'8 s c s bes s a s }
 >>
 @end lilypond
 
-@noindent
-Spacer rests are often used to avoid having too many rests, as seen in the
-example above.
-
-In all but simplest works it is advisable to create explicit
-@code{Voice} contexts using the @code{\new} and @code{\context}
-commands as it is explained in @rlearning{Contexts and engravers} and
+In all but the simplest works it is advisable to create explicit
+@code{Voice} contexts as explained in @rlearning{Contexts and engravers} and
 @rlearning{Explicitly instantiating voices}.
 
+@strong{@i{Identical rhythms}}
+
 In the special case that we want to typeset parallel pieces of music
 that have the same rhythm, we can combine them into a single
 @code{Voice} context, thus forming chords.  To achieve this, enclose
-them in a simple simultaneous music construction and make it to be an
-explicit voice:
+them in a simple simultaneous music construct within an explicit voice:
 
 @lilypond[quote,relative=2,verbatim]
 \new Voice <<
@@ -323,8 +371,8 @@ easily identified:
 >>
 @end lilypond
 
-To revert the standard presentation, the @code{\voiceNeutralstyle}
-command is used.
+The @code{\voiceNeutralstyle} command is used to revert to the
+standard presentation.
 
 @predefined
 
@@ -376,9 +424,11 @@ Snippets:
 @funindex \mergeDifferentlyHeadedOff
 @funindex mergeDifferentlyHeadedOff
 
-Note heads with equal durations are automatically merged, while
-note heads with unequal durations are not merged.  Rests opposite
-a stem are shifted vertically.
+The note heads of notes in different voices with the same pitch,
+same note head and opposite stem direction are automatically
+merged, but notes with different note heads or the same stem
+direction are not.  Rests opposite a stem in a different voice
+are shifted vertically.
 
 @lilypond[quote,verbatim,relative=2]
 <<
@@ -396,7 +446,7 @@ a stem are shifted vertically.
 >>
 @end lilypond
 
-Note heads with different note heads may be merged, with the
+Notes with different note heads may be merged, with the
 exception of half-note heads and quarter-note heads:
 
 @lilypond[quote,verbatim,relative=2]
@@ -437,14 +487,14 @@ Note heads with different dots may be merged:
 @end lilypond
 
 
-The collision on the second measure happens because
-@code{\mergeDifferentlyHeadedOn} cannot successfully complete the
-merge when three or more notes line up in the same column -- in
-fact, you will obtain a warning for this reason.  To allow the
-merge to work properly, apply a @code{\shift} to the note that
-should not be merged.  Here, @code{\shiftOn} is applied to move
-the top @code{g} out of the column, and
-@code{\mergeDifferentlyHeadedOn} works properly.
+The half note and eighth note at the start of the second measure
+are incorrectly merged because @code{\mergeDifferentlyHeadedOn}
+cannot successfully complete the merge when three or more notes
+line up in the same column, and in this case a warning is given.
+To allow the merge to work properly a @code{\shift} must be applied
+to the note that should not be merged.  Here, @code{\shiftOn} is
+applied to move the top @notation{g} out of the column, and
+@code{\mergeDifferentlyHeadedOn} then works properly.
 
 @lilypond[quote,relative=2,verbatim]
 <<
@@ -522,9 +572,11 @@ or a shorter note, and a downstem half note, the eighth note stem
 gets a slightly wrong offset because of the different width of the
 half note head symbol.
 
-@c investigate! Sometimes it works, sometimes not. --FV
+@ignore
+@c TODO investigate! Sometimes it works, sometimes not. --FV
 The requirements for successfully merging different note heads that
 are at the same time differently dotted are not clear.
+@end ignore
 
 There is no support for chords where the same note occurs with
 different accidentals in the same chord.  In this case, it is
index cef1fafc8aa47984248f01cfb85a8745682f5c4f..2ed5914aa98eb89f4d388d56b586db0f1b7bc1c8 100644 (file)
@@ -877,31 +877,11 @@ d4 g e c
 
 @c perhaps also an example of how to move it horizontally?
 
-@c TODO add snippet when ready
-@c @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-@c {changing-the-tempo-without-a-visible-metronome-mark.ly}
-
-To change the tempo in the MIDI output without printing anything,
-make the metronome marking invisible
-
-@example
-\once \override Score.MetronomeMark #'transparent = ##t
-@end example
-
-@c TODO add snippet when ready
-@c @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
-@c {creating-metronome-marks-in-markup-mode.ly}
-
-To print other metronome markings, use these markup commands
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{changing-the-tempo-without-a-metronome-mark.ly}
 
-@lilypond[verbatim,quote,relative=1]
-c4^\markup {
-  (
-  \smaller \general-align #Y #DOWN \note #"16." #1
-  =
-  \smaller \general-align #Y #DOWN \note #"8" #1
-  ) }
-@end lilypond
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{creating-metronome-marks-in-markup-mode.ly}
 
 For more details, see @ref{Formatting text}.
 
@@ -1258,7 +1238,7 @@ The name of the cued instrument can be printed by setting the
 oboe = \relative c''' {
   g4 r8 e16 f e4 d
 }
-\addQuote oboe { \oboe }
+\addQuote "oboe" { \oboe }
 
 \new Staff \relative c'' <<
   \new CueVoice \with {
@@ -1286,7 +1266,7 @@ from a part but may be restored at a later time.
 flute = \relative c''' {
   r2 cis2 r2 dis2
 }
-\addQuote flute { \flute }
+\addQuote "flute" { \flute }
 
 \new Voice \relative c'' {
   \killCues {
index 0fc7585abc0a8ca5764a52b3aca90e8825fe6ff7..cf563d0ee274c9906bc98266afab97334dca404d 100644 (file)
@@ -81,20 +81,38 @@ Snippets:
 
 @funindex \upbow
 @funindex \downbow
+@funindex \open
 
 @cindex bowing indications
 @cindex up bow indication
 @cindex down bow indication
+@cindex open string indication
+@cindex string, indicating open
 
 Bowing indications are created as articulations, which are
-described in @ref{Articulations and ornamentations}.  The
-bowing commands, @code{\upbow} and @code{\downbow}, are used with
-slurs as follows:
+described in @ref{Articulations and ornamentations}.
+
+The bowing commands, @code{\upbow} and @code{\downbow}, are used
+with slurs as follows:
 
 @lilypond[verbatim,quote,relative=2]
 c4(\downbow d) e(\upbow f)
 @end lilypond
 
+@noindent
+and the following example shows three ways in which an open A
+string on a violin might be indicated:
+
+@lilypond[verbatim,quote,relative=2]
+a4 \open 
+a^\markup { \teeny "II" } 
+a2^\markup { \small "sul A" }
+@end lilypond
+
+@predefined
+@code{\downbow},
+@code{\upbow},
+@code{\open}.
 
 @seealso
 
index 0ab25a2d9ccc9b626c01d45be23eee37aa61b3aa..d9fedf2c5538036a9edfd2abdc66c238bb72384a 100644 (file)
@@ -17,12 +17,120 @@ This section explains how to typeset vocal music, and make sure
 that the lyrics will be aligned with the notes of their melody.
 
 @menu
+* Common notation for vocal music::
 * Entering lyrics::
 * Aligning lyrics to a melody::
 * Specific uses of lyrics::
 * Stanzas::
 @end menu
 
+
+@node Common notation for vocal music
+@subsection Common notation for vocal music
+
+This section discusses issues related to vocal music in general, and
+to some particular styles of vocal music.
+
+@menu
+* References for vocal music and lyrics::
+* Opera::
+* Song books::
+* Chants::
+* Spoken music::
+* Ancient vocal music::
+@end menu
+
+
+@node References for vocal music and lyrics
+@unnumberedsubsubsec References for vocal music and lyrics
+
+@c TODO: split this section in two parts? -vv
+
+Various issues may arise when engraving vocal music.  Some of these
+are discussed in this section, while others are explained elsewhere:
+
+@itemize
+@item
+Most styles of vocal music use written text as lyrics.  An introduction
+to this notation is to be found in @rlearning{Setting simple songs}.
+
+@item
+Vocal music is likely to require the use of @code{markup} mode, either
+for lyrics of for other text elements (character's names, etc.).
+This syntax is described in @ref{Text markup introduction}.
+
+@item
+Lead sheets may be printed by combining vocal parts and @q{chord mode};
+this syntax is explained in @ref{Chord notation}.
+
+@item
+@q{Ambitus} may be added at the beginning of vocal staves, as explained
+in @ref{Ambitus}.
+
+@item
+Vocal parts may be printed using traditional clefs, as shown in @ref{Clef}.
+
+@item
+Ancient vocal music is supported, as explained in @ref{Ancient notation}.
+@end itemize
+
+
+@node Opera
+@unnumberedsubsubsec Opera
+
+@c TODO
+TBC
+
+@c add characters names snippet -vv
+
+@node Song books
+@unnumberedsubsubsec Song books
+
+@c TODO
+TBC
+
+@snippets
+@lilypondfile[verbatim,lilyquote,ragged-right,texidoc,doctitle]
+{simple-lead-sheet.ly}
+
+@seealso
+Notation Reference:
+@ref{Chord notation}.
+
+@node Spoken music
+@unnumberedsubsubsec Spoken music
+@cindex parlato
+@cindex Sprechgesang
+Such effects as @q{parlato} or @q{Sprechgesang} require perfomers to speak
+without pitch but still with rhythm; these are notated by cross
+note heads, as demonstrated in @ref{Special note heads}.
+
+@c TODO add "marking-notes-on-spoken-parts" snippet -vv
+@c add "showing the rhythm of a melody" snip
+@c add "one staff-line notation"
+@c add "improvisation" ref
+@c add "lyrics independents of notes" ref
+
+@node Chants
+@unnumberedsubsubsec Chants
+
+@c TODO Add text from lsr and -user
+TBC
+
+@node Ancient vocal music
+@unnumberedsubsubsec Ancient vocal music
+
+@c TODO
+TBC
+
+@c Add "Printing both the ancient and the modern clef in vocal music" snippet,
+@c and "Transcription of Ancient music with incipit" snippet. -vv
+
+@seealso
+Notation Reference:
+@ref{Ancient notation}.
+
+
 @node Entering lyrics
 @subsection Entering lyrics
 
@@ -32,7 +140,6 @@ that the lyrics will be aligned with the notes of their melody.
 * Lyrics explained::
 * Setting simple songs::
 * Working with lyrics and variables::
-* References for vocal music::
 @end menu
 
 
@@ -190,7 +297,7 @@ Internals Reference:
 @rinternals{LyricText},
 @rinternals{LyricSpace}.
 
-
+@c FIXME: this title has to be changed (possible confusion with LM) -vv
 @node Setting simple songs
 @unnumberedsubsubsec Setting simple songs
 
@@ -323,20 +430,6 @@ Internals Reference:
 @rinternals{Lyrics}.
 
 
-@node References for vocal music
-@unnumberedsubsubsec References for vocal music
-
-TBC
-@c TODO Add @refs
-
-@c Nope -- this section is to be removed.
-@c With a vengeance :-) -vv
-
-@q{Parlato} is spoken without pitch but still with rhythm; it is
-notated by cross note heads.  This is demonstrated in
-@ref{Special note heads}.
-
-
 @node Aligning lyrics to a melody
 @subsection Aligning lyrics to a melody
 
@@ -687,7 +780,6 @@ differing ways.  Such variations can still be captured with
 @menu
 * Divisi lyrics::
 * Lyrics independent of notes::
-* Chants::
 * Spacing out syllables::
 * Centering lyrics between staves::
 @end menu
@@ -781,13 +873,6 @@ the implicit melismata get ignored.
 
 @c this clarifies http://code.google.com/p/lilypond/issues/detail?id=248
 
-
-@node Chants
-@unnumberedsubsubsec Chants
-
-@c TODO Add text from lsr and -user
-TBC
-
 @node Spacing out syllables
 @unnumberedsubsubsec Spacing out syllables
 
diff --git a/VERSION b/VERSION
index f546b0c90349ad6700c3c5d99db5b79bbfba4a81..579d2ca4979926504a20696218feaf2f268464bd 100644 (file)
--- a/VERSION
+++ b/VERSION
@@ -1,6 +1,6 @@
 PACKAGE_NAME=LilyPond
 MAJOR_VERSION=2
 MINOR_VERSION=11
-PATCH_LEVEL=62
+PATCH_LEVEL=63
 MY_PATCH_LEVEL=
 
index 5f49914f84e5c86267e79c690ff133230702c327..089e4db8728ec3646bd280a028c4c2c2a975c78e 100644 (file)
@@ -6,7 +6,7 @@
   line-width=17\cm
   indent=0\cm
 }
+
 \layout {
   \context { \Score
     \override PaperColumn #'keep-inside-line = ##t
 \layout {
    \context {
       \Score
-      \override SpacingSpanner #'base-shortest-duration = 
-         #(ly:make-moment 1 18) 
+      \override SpacingSpanner #'base-shortest-duration =
+         #(ly:make-moment 1 18)
       \override NonMusicalPaperColumn #'line-break-system-details =
          #'((alignment-offsets . (0 -12)))
    }
 }
 
-trillflat = 
+trillflat =
   \once \override TrillSpanner #'bound-details #'left #'text =
     #(markup #:translate-scaled '(-0.05 . -1)
              #:concat (#:musicglyph "scripts.trill"
@@ -85,6 +85,7 @@ trillflat =
          af''8. ]
 
          |
+         \break
 
          \trillflat
          af''4. \startTrillSpan
@@ -118,9 +119,9 @@ trillflat =
 
          \key ef \major
          c'''8. [
-         cs'''8. \f ] \stopTrillSpan 
+         cs'''8. \f ] \stopTrillSpan
          r8.
-         
+
       }
 
       % RH voice 2
index e4715160c04c28b426ed8e2e1c896cd506ff4db1..326bed2c442c2eee7aaf7190e2bb8d83b23616c7 100644 (file)
@@ -22,7 +22,7 @@
 
 
 \version "2.11.61"
-
+#(set-global-staff-size 15)
 
 %%%
 %%% Abreviations
@@ -38,8 +38,8 @@ udbetc     = \markup { \line { \musicglyph #"scripts.upbow" " " \musicglyph #"sc
 
 fermaTa    = \markup \musicglyph #"scripts.ufermata"
 
-accel   = \markup \tiny \italic \bold "accel. ..."
-ritar   = \markup \tiny \italic \bold "ritar. ..."
+accel   = \markup \tiny \italic \bold "accel..."
+ritar   = \markup \tiny \italic \bold "ritar..."
 
 ignore     = \override NoteColumn #'ignore-collision = ##t
 
@@ -102,27 +102,6 @@ noflag         = \once \override Stem #'flag-style = #'no-flag
       (reverse args))))))
 
 
-%%%
-%%% Paper
-%%%
-
-#(set-global-staff-size 20)
-%#(set-default-paper-size "a4" 'landscape)
-
-\paper {
-  between-system-padding = 9
-}
-
-
-%%%
-%%% Header
-%%%
-
-\header {
-  meter       = "lentement"
-}
-
-
 %%%
 %%% Instruments
 %%%
@@ -138,9 +117,9 @@ ViolinSolo = \relative c' {
 
 
   %% Measure 1
-  \time 11/4
+  \time 25/8
   \mark \default
-  r2 ^\markup \colmark { \italic "fatigué" } r4
+  r2 ^\markup \colmark { \italic "fatigué" " " \bold "lentement"} r4 r r8
   <<
     { \shift d2 \glissando ^\markup \colmark { \quatre \dubetc \svib } \shifta e1 } \\
     { d2 \open \mf \< ~ \aniente d1  \! \> r4 r ^\markup \colmark { " " \fermaTa } \! }
@@ -163,7 +142,7 @@ ViolinSolo = \relative c' {
     { \shift d2 \glissando ^\markup \colmark { \quatre \dubetc \pvib \norm } \shifta e1 \glissando d2 } \\
     { d2 \open \mf \< ~ d1 ~ d2 \ff  ~ d1 \> ~ d2 ^\markup \colmark { " " " " \svib } ~ d4 \pp}
   >>
-
+  \break
 
   %% Measure 4
   \time 4/4
@@ -171,15 +150,15 @@ ViolinSolo = \relative c' {
   \tupletDown
   \times 2/3 { d4 ^\markup \colmark { \quatre \db \accel } d d }
   \times 2/3 { d4 ^\markup \colmark { " " \db " " \sulp } d d }
-  \break
+
 
 
   %% Measure 5
   \time 5/4
-  \tupletbp \times 2/3 { d8 \mf \< ^\markup \colmark { \quatre \db " " \norm } d _\open d }
-  \tupletbp \times 2/3 { d8 ^\markup \colmark { " " \db " "\sulp } d _\open d }
-  \tupletbp \times 2/3 { d16 ^\markup \colmark { " " \db " " \norm } d _\open d d d _\open d }
-  d2 \ff ^\markup \colmark { " " " " \pvib } \>
+  \tupletbp \times 2/3 { d8 \mf \< ^\markup \colmark { \quatre \db \norm } d _\open d }
+  \tupletbp \times 2/3 { d8 ^\markup \colmark { " " \db \sulp } d _\open d }
+  \tupletbp \times 2/3 { d16 ^\markup \colmark { " " \db \norm } d _\open d d d _\open d }
+  d2 \ff ^\markup \colmark { " " \pvib } \>
 
 
   %% Measure 6
@@ -188,6 +167,7 @@ ViolinSolo = \relative c' {
   { d16 \staccato
     [ d \staccato d \staccato d \staccato d \staccato d \staccato d \staccato d \staccato d \staccato d \staccato]
   }
+  \break
 
 
   %% Measure 7
@@ -206,7 +186,6 @@ ViolinSolo = \relative c' {
 
   %% Measure 9
   <<
-    %% \override Glissando #'style = #'trill
     { \shift d2 \glissando ^\markup \colmark { \quatre } \shifta e1 } \\
     { d2 \open ~ d1  ^\markup \colmark { " " " " \mvib } }
   >>
@@ -222,23 +201,20 @@ ViolinSolo = \relative c' {
 \score {
 
   <<
-    \relative c' <<
-      \new Staff {
-        \set Staff.midiInstrument = "violin"
-        \ViolinSolo
-      }
+    \relative <<
+      \new Staff \ViolinSolo
     >>
+
     \override Score.Rest #'transparent = ##t
     \set Score.defaultBarType          = "empty"
   >>
 
   \layout  {
-    indent = 0.0
+    indent       = 0.0
     \context {
       \Staff
       \remove "Time_signature_engraver"
       \remove "Bar_number_engraver"
     }
   }
-  \midi { }
 }
diff --git a/input/manual/unfretted-strings-headword.ly b/input/manual/unfretted-strings-headword.ly
deleted file mode 100644 (file)
index 45320c9..0000000
+++ /dev/null
@@ -1,244 +0,0 @@
-%******************************************************
-% Inspirational header for Unfretted Strings section  %
-% of Lilypond Documentation.  This passage is taken   %
-% from Ravel's String Quartet.                       %
-% ****************************************************%
-
-%\version "2.11.61"
-
-#(set-global-staff-size 15)
-\paper{
- ragged-end=##t
- line-width=17\cm
- indent=0\cm
-}
-
-\layout {
- \context { \Score
-   \remove "Bar_number_engraver"
-   \override PaperColumn #'keep-inside-line = ##t
-   \override NonMusicalPaperColumn #'keep-inside-line = ##t
- }
-}
-
-%*************** MACROS ******************%
-
-#(define (octave-up m t)
- (let* ((octave (1- t))
-      (new-note (ly:music-deep-copy m))
-      (new-pitch (ly:make-pitch
-        octave
-        (ly:pitch-notename (ly:music-property m 'pitch))
-        (ly:pitch-alteration (ly:music-property m 'pitch)))))
-  (set! (ly:music-property new-note 'pitch) new-pitch)
-  new-note))
-
-#(define (octavize-chord elements t)
- (cond ((null? elements) elements)
-     ((eq? (ly:music-property (car elements) 'name) 'NoteEvent)
-       (cons (car elements)
-             (cons (octave-up (car elements) t)
-                   (octavize-chord (cdr elements) t))))
-     (else (cons (car elements) (octavize-chord (cdr elements ) t)))))
-
-#(define (octavize music t)
- (if (eq? (ly:music-property music 'name) 'EventChord)
-       (ly:music-set-property! music 'elements (octavize-chord
-(ly:music-property music 'elements) t)))
- music)
-
-octaves = #(define-music-function (parser location arg mus) (integer? ly:music?)
- (music-map (lambda (x) (octavize x arg)) mus))
-
-%\relative c' { d e \octaves #-1 { \times 2/3 {f g c }}} % this is an example of the macro in practice
-
-%*********************************************************************
-% This is a sweet macro by Mark Polesky to make the 4th-string
-% indication look like it did in the original score
-%********************************************************************
-#(define-markup-command (No layout props n) (string?)
-  (define (format-char c)
-    (let ((s (string c)))
-      (if (number? (string->number s))
-          (markup #:hspace 0.125 #:number s #:hspace 0.125)
-          (markup #:hspace 0 #:fontsize 2 s))))
-  (define (format-string s i)
-    (let ((n (string-length s)))
-      (if (= n 0)
-          (markup #:null)
-          (markup (format-char (string-ref s i))
-                  (if (= (+ i 1) n)
-                      (markup #:null)
-                      (format-string s (+ i 1)))))))
-  (let ((i (string-length n)))
-    (interpret-markup layout props
-      (markup
-        #:concat (
-          #:concat (
-            #:fontsize 3 "4"
-            #:hspace 0.5
-            #:override '(baseline-skip . 0.825)
-            #:override '(direction . 1)
-            #:dir-column (
-              #:fontsize 2 #:center-align "."
-              #:fontsize 1 #:center-align "e"
-            )
-          )
-          #:hspace 0.75
-          #:concat (
-            (format-string n 0)
-            #:fontsize 2 ""
-          )
-        )
-      )
-    )
-  )
-)
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%5
-
-
-poco = \markup { \italic { \fontsize #+2.0 "poco" }}
-apoco = \markup { \italic { \fontsize #+2.0 "a" }}
-menovivo = \markup { \bold { \fontsize #+3.0 { "Poco meno vivo"} } }
-pocorit = \markup { \bold { \fontsize #+3.0 { "poco rit."} } }
-pocodim = \markup { \italic { \fontsize #+2.0 "un poco dim." }}
-
-vlnOne = \relative c''' {
-  \key f \major
-  \time 4/4
-  \set Staff.midiInstrument = "violin"
-%  \override TupletNumber #'stencil = ##f
-  \override TupletBracket #'bracket-visibility = ##f
-  \set tupletSpannerDuration = #(ly:make-moment 1 4)
-
-  \once \override TextScript #'extra-offset = #'( -3.8 . 0.5 )
-  es4^\apoco
-  \once \override TextScript #'extra-offset = #'( -1.0 . -0.8 )
-  \times 2/3 { c8(^\poco d es) } es4 \times 2/3 { c8( d es) } |        % 1
-  es4\ff\< \times 2/3 { c8( d es) } es4 \times 2/3 { c8( d es)\! }  |  % 2
-  \grace { a,,8[( a'\fff]^\menovivo } a'4) g8( a) d,4 c8( d) |         % 3
-  a4 g8( a) d,4 c8( d) |               % 4
-  a4 g8( a) d,8^\pocorit r8 r4 |       % 5
-  ais16(\p\< e' ais e') e16(\f\> ais, e ais,)\! ais8 r r4 |    % 6
-}
-
-vlnTwo = \relative c' {
-  \key f \major
-  \time 4/4
-  \set Staff.midiInstrument = "violin"
-%  \override TupletNumber #'stencil = ##f
-  \override TupletBracket #'bracket-visibility = ##f
-  \set tupletSpannerDuration = #(ly:make-moment 1 4)
-  \times 2/3 { \octaves #1 {fis8 fis fis fis fis fis fis fis fis fis fis fis }} |      % 1
-  \times 2/3 { \octaves #1 {fis8\ff\< fis fis fis fis fis fis fis fis fis fis fis\! }} |% 2
-  <ais, e' ais e'>16\fff( ais' e ais,) ais16( e' ais e') e16( ais, e ais,) ais16( e' ais e') | % 3
-  e16( ais, e ais,) ais16( e' ais e') e16( ais, e ais,) ais16( e' ais e') |    % 4
-  e16( ais, e ais,)
-  \set subdivideBeams = ##t
-  \set Score.beatLength = #(ly:make-moment 1 8)
-    ais16( e') e( ais,)
-    d4^\markup \No #"Corde"
-  \once \override TextScript #'extra-offset = #'( -5.5 . 4.4 )
-    c8(_\markup { \italic { \fontsize #+1.0 "vibrato" }} d) |  % 5
-  \set subdivideBeams = ##f
-  a2 ~ a8 g( c d)                      % 6
-}
-vlnTwoDyn = {
-  s1*4
-  s2 s4\f\< s8. s16\! |
-  s16 s16\> s8 s2 s8 s16 s32 s32\!
-
-}
-
-vla = \relative c'' {
-  \key f \major
-  \time 4/4
-  \clef "alto"
-  \set Staff.midiInstrument = "viola"
-  \override Stem #'length = #9.5
-  bes4:32 a4:32 gis4:32 a4:32 | % 1
-  bes4:32 a4:32 gis4:32 a4:32\! | % 2
-\tweak #'extra-offset #'(-1.3 . -0.0)
-%  \clef "treble"
-  \revert Stem #'length
-  \acciaccatura { a8 } a'4\fff g8( a) d,4 c8( d)  \clef "alto" | %3
-  a4 g8( a) d,4 c8( d) |       % 4
-  a4 g8 a <e ais>2:32 |                % 5
-  <e ais>1:32          |       % 6
-}
-
-vlaDyn = {
-  s1 | s2\ff\< s4 s8 s16\! s32 s64 \clef "treble" s64 |
-  s1*2 | s2 s4\f\< s8 s16 s32 s32\! |  % 3-5
-  s16 s16\> s8 s2 s8 s16 s32 s32\! | %6
-
-}
-
-vc = \relative c' {
-  \key f \major
-  \time 4/4
-  \clef "bass"
-  \set Staff.midiInstrument = "cello"
-  \override Stem #'length = #9.5
-  c4:32 d4:32 es4:32 d4:32 |           % 1
-  c4:32 d4:32 es4:32 d4:32\! | % 2
-  \revert Stem #'length
-  \set subdivideBeams = ##t
-  \set Score.beatLength = #(ly:make-moment 1 8)
-  <fis,, cis'>16\fff( <cis' ais'>) <cis ais'>( <fis, cis'>) % 3
-    <fis cis'>16( <cis' ais'>) <cis ais'>( <fis, cis'>)        % 3
-    <fis c'>16( <c' ais'>) <c ais'>( <fis, c'>)        % 3
-    <fis c'>16( <c' ais'>) <c ais'>( <fis, c'>) |      % 3
-  <fis cis'>16( <cis' ais'>) <cis ais'>( <fis, cis'>)  % 4
-    <fis cis'>16( <cis' ais'>) <cis ais'>( <fis, cis'>)        % 4
-    <fis c'>16( <c' ais'>) <c ais'>( <fis, c'>)        % 4
-    <fis c'>16( <c' ais'>) <c ais'>( <fis, c'>) |      % 4
-  <fis cis'>16( <cis' ais'>) <cis ais'>( <fis, cis'>)  % 5
-    <fis cis'>16( <cis' ais'>) <cis ais'>( <fis, cis'>)        fis2^\( ~ | % 5
-  fis4 g c,\) r4       % 6
-}
-vcDyn = {
-  s1 | s2\ff\< s4 s8. s16\! |  % 1-2
-  s1*2 % 3-4
-  s2 s4\f\< s8 s16 s32 s32\! | % 5
-  s4\> s4 s4\! s4           |  % 6
-}
-
-
-%%%%%%%%%%%%%%%% Score Block %%%%%%%%%%%%%%%%%%%%%%
-
-\score {
-
-  << % creates new grand staff
-    \new StaffGroup = "strings" <<
-      \context Staff = "violinOne" \vlnOne
-      \context Staff = "violinTwo" <<
-        \context Voice = "violin 2" { \vlnTwo }
-        \context Voice = "violin 2 dynamics" { \vlnTwoDyn }
-      >>
-      \new Staff = "viola" <<
-        \context Voice = "viola" { \vla }
-        \context Voice = "viola dynamics" { \vlaDyn }
-      >>
-      \new Staff = "cello" <<
-        \context Voice = "cello" { \vc }
-        \context Voice = "cello dynamics" { \vcDyn }
-      >>
-    >> % end of "strings" staffgroup
-
-  >> % end of grand staff
-
-  \layout {
-    \context {
-      \Score
-      \override TimeSignature #'stencil = ##f
-      \override BarNumber #'padding = #3
-      \override RehearsalMark #'padding = #2
-        skipBars = ##t
-    } % context \Score \overrides end
-  } % layout end
-
-  \midi { }
-
-} % score end
-
index bac0726023e778e036fca6e0adbce67f92e8d204..ecd58dad0c8061fe69c279ba4b6910703d91eb7b 100644 (file)
@@ -3,7 +3,7 @@
 % Load plain if necessary, i.e., if running under initex.
 \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
 %
-\def\texinfoversion{2008-04-18.10}
+\def\texinfoversion{2008-10-12.17}
 %
 % Copyright (C) 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
 % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
@@ -3874,11 +3874,11 @@ end
 \def\dosynindex#1#2#3{%
   % Only do \closeout if we haven't already done it, else we'll end up
   % closing the target index.
-  \expandafter \ifx\csname donesynindex#2\endcsname \undefined
+  \expandafter \ifx\csname donesynindex#2\endcsname \relax
     % The \closeout helps reduce unnecessary open files; the limit on the
     % Acorn RISC OS is a mere 16 files.
     \expandafter\closeout\csname#2indfile\endcsname
-    \expandafter\let\csname\donesynindex#2\endcsname = 1
+    \expandafter\let\csname donesynindex#2\endcsname = 1
   \fi
   % redefine \fooindfile:
   \expandafter\let\expandafter\temp\expandafter=\csname#3indfile\endcsname
@@ -7747,10 +7747,9 @@ end
 
 \message{localization,}
 
-% @documentlanguage is usually given very early, just after
-% @setfilename.  If done too late, it may not override everything
-% properly.  Single argument is the language (de) or locale (de_DE)
-% abbreviation.  It would be nice if we could set up a hyphenation file.
+% For single-language documents, @documentlanguage is usually given very
+% early, just after @documentencoding.  Single argument is the language
+% (de) or locale (de_DE) abbreviation.
 %
 {
   \catcode`\_ = \active
@@ -7785,9 +7784,36 @@ end
 }
 %
 \newhelp\nolanghelp{The given language definition file cannot be found or
-is empty.  Maybe you need to install it?  In the current directory
-should work if nowhere else does.}
+is empty.  Maybe you need to install it?  Putting it in the current
+directory should work if nowhere else does.}
 
+% This macro is called from txi-??.tex files; the first argument is the
+% \language name to set (without the "\lang@" prefix), the second and
+% third args are \{left,right}hyphenmin.
+% 
+% The language names to pass are determined when the format is built.
+% See the etex.log file created at that time, e.g.,
+% /usr/local/texlive/2008/texmf-var/web2c/pdftex/etex.log.
+% 
+% With TeX Live 2008, etex now includes hyphenation patterns for all
+% available languages.  This means we can support hyphenation in
+% Texinfo, at least to some extent.  (This still doesn't solve the
+% accented characters problem.)
+% 
+\catcode`@=11
+\def\txisetlanguage#1#2#3{%
+  % do not set the language if the name is undefined in the current TeX.
+  \expandafter\ifx\csname lang@#1\endcsname \relax
+    \message{no patterns for #1}%
+  \else
+    \global\language = \csname lang@#1\endcsname
+  \fi
+  % but there is no harm in adjusting the hyphenmin values regardless.
+  \global\lefthyphenmin = #2\relax
+  \global\righthyphenmin = #3\relax
+}
+
+% Helpers for encodings.
 % Set the catcode of characters 128 through 255 to the specified number.
 %
 \def\setnonasciicharscatcode#1{%
diff --git a/tex/txi-de.tex b/tex/txi-de.tex
new file mode 100644 (file)
index 0000000..b0eeeae
--- /dev/null
@@ -0,0 +1,80 @@
+% $Id: txi-de.tex,v 1.8 2008/10/12 22:18:39 karl Exp $
+% txi-de.tex -- German translations for texinfo.tex.
+%
+% Copyright 1999, 2007, 2008 Free Software Foundation, Inc.
+% 
+% This program is free software; you can redistribute it and/or modify
+% it under the terms of the GNU General Public License as published by
+% the Free Software Foundation; either version 3 of the license, or (at
+% your option) any later version.
+%
+% This program is distributed in the hope that it will be useful,
+% but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+% GNU General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License
+% along with this program.  If not, see <http://www.gnu.org/licenses/>.
+%
+% Written by Karl Heinz Marbaise, 18. January 1999, <kama@hippo.fido.de>
+
+\txisetlanguage{ngerman}{2}{2}
+
+% german translation of the used words.
+% Don't use checking because if it is our turn they have
+% been defined.
+\gdef\putwordAppendix{Anhang}
+\gdef\putwordChapter{Kapitel}
+\gdef\putwordfile{Datei}
+\gdef\putwordin{in}
+\gdef\putwordInfo{Info}
+\gdef\putwordMethodon{Methode von}
+\gdef\putwordon{auf}
+\gdef\putwordof{von}
+\gdef\putwordpage{Seite}
+\gdef\putwordsection{Abschnitt}
+\gdef\putwordSection{Abschnitt}
+\gdef\putwordsee{siehe}
+\gdef\putwordSee{Siehe}
+\gdef\putwordShortTOC{Kurzverzeichnis}
+\gdef\putwordTOC{Inhaltsverzeichnis}
+%%
+\gdef\putwordNoTitle{Kein Titel}
+%%
+%% New defintion for the output of months.
+\gdef\putwordMJan{Januar}
+\gdef\putwordMFeb{Februar}
+\gdef\putwordMMar{M\"arz}
+\gdef\putwordMApr{April}
+\gdef\putwordMMai{Mai}
+\gdef\putwordMJun{Juni}
+\gdef\putwordMJul{Juli}
+\gdef\putwordMAug{August}
+\gdef\putwordMSep{September}
+\gdef\putwordMOct{Oktober}
+\gdef\putwordMNov{November}
+\gdef\putwordMDec{Dezember}
+%%
+%% some hyphenation for german language. Might be changed.
+\hyphenation{An-hang}
+%%\hyphenation{mini-buf-fer mini-buf-fers}
+%%\hyphenation{eshell}
+%%\hyphenation{white-space}
+%%
+%% Index handling should also work correct in german
+\gdef\putwordIndexNonexistent{(Index ist nicht vorhanden)}
+\gdef\putwordIndexIsEmpty{(Der Index ist leer)}
+%%
+%% \defmac
+\gdef\putwordDefmac{Makro}
+%% \defspec
+\gdef\putwordDefspec{Spezial Form}
+%% \defivar
+\gdef\putwordDefivar{exemplar Variable}
+%% \defvar leave unchanged because no difference in
+%%         writing but in phonectics.
+\gdef\putwordDefvar{Variable}
+%% \defopt
+\gdef\putwordDefopt{Benutzer Option}
+%% \deffun
+\gdef\putwordDeffunc{Funktion}
diff --git a/tex/txi-en.tex b/tex/txi-en.tex
new file mode 100644 (file)
index 0000000..8fbd54e
--- /dev/null
@@ -0,0 +1,71 @@
+% $Id: txi-en.tex,v 1.6 2008/10/12 22:18:39 karl Exp $
+% txi.en.tex -- English non-translations for texinfo.tex.  This is read
+% when a source document says @documentlanguage en (which might happen
+% after another @documentlanguage).  The actual values are the same as
+% the defaults.
+% 
+% Copyright 1999, 2007, 2008 Free Software Foundation.
+%
+% This program is free software; you can redistribute it and/or modify
+% it under the terms of the GNU General Public License as published by
+% the Free Software Foundation; either version 3 of the License, or
+% (at your option) any later version.
+%
+% This program is distributed in the hope that it will be useful,
+% but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+% GNU General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License
+% along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+\txisetlanguage{USenglish}{2}{3}
+
+\gdef\putwordAppendix{Appendix}
+\gdef\putwordChapter{Chapter}
+\gdef\putwordfile{file}
+\gdef\putwordin{in}
+\gdef\putwordIndexIsEmpty{(Index is empty)}
+\gdef\putwordIndexNonexistent{(Index is nonexistent)}
+\gdef\putwordInfo{Info}
+\gdef\putwordInstanceVariableof{Instance Variable of}
+\gdef\putwordMethodon{Method on}
+\gdef\putwordNoTitle{No Title}
+\gdef\putwordof{of}
+\gdef\putwordon{on}
+\gdef\putwordpage{page}
+\gdef\putwordsection{section}
+\gdef\putwordSection{Section}
+\gdef\putwordsee{see}
+\gdef\putwordSee{See}
+\gdef\putwordShortTOC{Short Contents}
+\gdef\putwordTOC{Table of Contents}
+%
+\gdef\putwordMJan{January}
+\gdef\putwordMFeb{February}
+\gdef\putwordMMar{March}
+\gdef\putwordMApr{April}
+\gdef\putwordMMay{May}
+\gdef\putwordMJun{June}
+\gdef\putwordMJul{July}
+\gdef\putwordMAug{August}
+\gdef\putwordMSep{September}
+\gdef\putwordMOct{October}
+\gdef\putwordMNov{November}
+\gdef\putwordMDec{December}
+%
+\gdef\putwordDefmac{Macro}
+\gdef\putwordDefspec{Special Form}
+\gdef\putwordDefvar{Variable}
+\gdef\putwordDefopt{User Option}
+\gdef\putwordDeffunc{Function}
+
+% Produces Day Month Year style of output.
+\def\today{%
+  \number\day\space
+  \ifcase\month
+  \or\putwordMJan\or\putwordMFeb\or\putwordMMar\or\putwordMApr
+  \or\putwordMMay\or\putwordMJun\or\putwordMJul\or\putwordMAug
+  \or\putwordMSep\or\putwordMOct\or\putwordMNov\or\putwordMDec
+  \fi
+  \space\number\year}
diff --git a/tex/txi-es.tex b/tex/txi-es.tex
new file mode 100644 (file)
index 0000000..43b3c27
--- /dev/null
@@ -0,0 +1,61 @@
+% $Id: txi-es.tex,v 1.5 2008/10/12 22:18:39 karl Exp $
+% txi-es.tex -- Spanish translations for texinfo.tex.
+%
+% Copyright (C) 1999, 2007, 2008 by Adrian Perez Jorge.
+% 
+% This txi-es.tex file is free software; you can redistribute it and/or
+% modify it under the terms of the GNU General Public License as
+% published by the Free Software Foundation; either version 3 of the
+% License, or (at your option) any later version.
+%
+% This txi-es.tex file is distributed in the hope that it will be
+% useful, but WITHOUT ANY WARRANTY; without even the implied warranty
+% of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+% General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License
+% along with this program.  If not, see <http://www.gnu.org/licenses/>.
+%
+% Set up fixed words for Spanish.
+
+\txisetlanguage{spanish}{2}{2}
+
+\gdef\putwordAppendix{Ap\'endice}
+\gdef\putwordChapter{Cap\'{\char16{}}tulo}
+\gdef\putwordfile{archivo}
+\gdef\putwordIndexIsEmpty{(El \'Indice est\'a vac\'{\char16{}}o)}
+\gdef\putwordIndexNonexistent{(No existe el \'Indice)}
+\gdef\putwordInfo{Info}
+\gdef\putwordMethodon{M\'etodo de}
+\gdef\putwordNoTitle{Sin T\'{\char{16}}tulo}
+\gdef\putwordof{de}
+\gdef\putwordon{de}
+\gdef\putwordpage{p\'agina}
+\gdef\putwordsection{secci\'on}
+\gdef\putwordSection{Secci\'on}
+\gdef\putwordsee{v\'ease}
+\gdef\putwordSee{V\'ease}
+\gdef\putwordShortTOC{Resumen del Contenido}
+\gdef\putwordTOC{\'Indice General}
+%
+\gdef\putwordMJan{enero}
+\gdef\putwordMFeb{febrero}
+\gdef\putwordMMar{marzo}
+\gdef\putwordMApr{abril}
+\gdef\putwordMMay{mayo}
+\gdef\putwordMJun{junio}
+\gdef\putwordMJul{julio}
+\gdef\putwordMAug{agosto}
+\gdef\putwordMSep{septiembre}
+\gdef\putwordMOct{octubre}
+\gdef\putwordMNov{noviembre}
+\gdef\putwordMDec{diciembre}
+%
+\gdef\putwordDefmac{Macro}
+\gdef\putwordDefspec{Forma Especial}
+\gdef\putwordDefivar{Variable de Instancia}
+\gdef\putwordDefvar{Variable}
+\gdef\putwordDefopt{Opci\'on de Usuario}
+\gdef\putwordDeffunc{Funci\'on}
+
+\endinput
diff --git a/tex/txi-fr.tex b/tex/txi-fr.tex
new file mode 100644 (file)
index 0000000..f8dae38
--- /dev/null
@@ -0,0 +1,74 @@
+% $Id: txi-fr.tex,v 1.6 2008/10/12 22:18:39 karl Exp $
+% txi-fr.tex -- French translations for texinfo.tex.
+%
+% Copyright (C) 1999, 2007, 2008 Free Software Foundation.
+%
+% This program is free software; you can redistribute it and/or modify
+% it under the terms of the GNU General Public License as published by
+% the Free Software Foundation; either version 3 of the License, or
+% (at your option) any later version.
+%
+% This program is distributed in the hope that it will be useful,
+% but WITHOUT ANY WARRANTY; without even the implied warranty of
+% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+% GNU General Public License for more details.
+%
+% You should have received a copy of the GNU General Public License
+% along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+% Set up fixed words for French.
+% Translated by Laurent Bourbeau <bourbeau@progiciels-bpi.ca>
+% Translation date: le 10 décembre 1999.
+% Transmitted to: Karl Berry <karl@cs.umb.edu>
+
+\txisetlanguage{french}{2}{2}
+
+\gdef\putwordAppendix{Annexe}
+\gdef\putwordChapter{Chapitre}
+\gdef\putwordfile{fichier}
+\gdef\putwordin{dans}
+\gdef\putwordIndexIsEmpty{(Index est vide)}
+\gdef\putwordIndexNonexistent{(Index n'existe pas)}
+\gdef\putwordInfo{Info}
+\gdef\putwordInstanceVariableof{Variable d'instance de}
+\gdef\putwordMethodon{M\'ethode sur}
+\gdef\putwordNoTitle{Sans Titre}
+\gdef\putwordof{de}
+\gdef\putwordon{sur}
+\gdef\putwordpage{page}
+\gdef\putwordsection{section}
+\gdef\putwordSection{Section}
+\gdef\putwordsee{voir}
+\gdef\putwordSee{Voir}
+\gdef\putwordShortTOC{Sommaire}
+\gdef\putwordTOC{Table des mati\`eres}
+%
+\gdef\putwordMJan{janvier}
+\gdef\putwordMFeb{f\'evrier}
+\gdef\putwordMMar{mars}
+\gdef\putwordMApr{avril}
+\gdef\putwordMMay{mai}
+\gdef\putwordMJun{juin}
+\gdef\putwordMJul{juillet}
+\gdef\putwordMAug{ao\^ut}
+\gdef\putwordMSep{septembre}
+\gdef\putwordMOct{octobre}
+\gdef\putwordMNov{novembre}
+\gdef\putwordMDec{d\'ecembre}
+%
+\gdef\putwordDefmac{Macro}
+\gdef\putwordDefspec{Forme Sp\'eciale}
+\gdef\putwordDefvar{Variable}
+\gdef\putwordDefopt{Option de l'usager}
+\gdef\putwordDeffunc{Fonction}
+
+% Produces Day Month Year style of output.
+% French datation - for instance: 10 janvier 2000.
+\def\today{%
+  \number\day\space
+  \ifcase\month
+  \or\putwordMJan\or\putwordMFeb\or\putwordMMar\or\putwordMApr
+  \or\putwordMMay\or\putwordMJun\or\putwordMJul\or\putwordMAug
+  \or\putwordMSep\or\putwordMOct\or\putwordMNov\or\putwordMDec
+  \fi
+  \space\number\year}