X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Fwind.itely;h=65071975540e0fb5a6ca9abe98c100a5462ed4df;hb=b97565a9af1c13369ac7e7e9ea80c2638dbc0e51;hp=640e6a8355b0c0ba9c63b2e8ddf56856d0e238c4;hpb=a39b477add008f856609134655b9972c7350db23;p=lilypond.git

diff --git a/Documentation/user/wind.itely b/Documentation/user/wind.itely
index 640e6a8355..6507197554 100644
--- a/Documentation/user/wind.itely
+++ b/Documentation/user/wind.itely
@@ -6,30 +6,129 @@
     version that you are working on.  See TRANSLATION for details.
 @end ignore
 
-@c \version "2.11.38"
+@c \version "2.12.0"
 
 @node Wind instruments
 @section Wind instruments
-@c @node Bagpipes
-@c @section Bagpipes
 
-This section includes extra information for writing for bagpipes.
+@lilypondfile[quote]{wind-headword.ly}
+
+This section includes some elements of music notation that arise when
+writing for winds.
+
+@menu
+* Common notation for wind instruments::
+* Bagpipes::
+@end menu
+
+@node Common notation for wind instruments
+@subsection Common notation for wind instruments
+
+This section discusses some issues common to most wind instruments.
 
 @menu
-* Bagpipe sections::            
+* References for wind instruments::
+* Fingerings::
 @end menu
 
+@node References for wind instruments
+@unnumberedsubsubsec References for wind instruments
+
+@cindex wind instruments
+
+Many notation issues for wind instruments pertain to breathing and
+tonguing:
+
+@itemize
+@item Breathing can be specified by rests or @ref{Breath marks}.
+@item Legato playing is indicated by @ref{Slurs}.
+@item Different types of tonguings, ranging from legato to non-legato to
+stacatto are usually shown by articulation marks, sometimes combined
+with slurs, see @ref{Articulations and ornamentations} and @ref{List of
+articulations}.
+@item Flutter tonguing is usually indicated by placing a tremolo mark
+and a text markup on the note. See @ref{Tremolo repeats}.
+@end itemize
+
+There are also other aspects of musical notation that can apply to wind
+instruments:
+
+@itemize
+@item Many wind instruments are transposing intruments, see
+@ref{Instrument transpositions}.
+@item The slide glissando are characteristic of the trombone, but other
+winds may perform keyed or valved glissandi. See @ref{Glissando}.
+@item Harmonic series glissandi, which are possible on all brass
+instruments but common for French Horns, are usually written out as
+@ref{Grace notes}.
+@item Pitch inflections at the end of a note are discussed in @ref{Falls
+and doits}.
+@item Key slaps or valve slaps are often shown by the @code{cross} style
+of @ref{Special note heads}.
+@item Woodwinds can overblow low notes to sound harmonics. These are
+shown by the @code{flageolet} articulation. See @ref{List of articulations}.
+@item The use of brass mutes is usually indicated by a text markup, but
+where there are many rapid changes it is better to use the
+@code{stopped} and @code{open} articulations. See @ref{Articulations and
+ornamentations} and @ref{List of articulations}.
+@item Stopped horns are indicated by the @code{stopped} articulation.
+See @ref{Articulations and ornamentations}.
+@end itemize
+
+@snippets
+
+@lilypondfile[verbatim,lilyquote,texidoc,doctitle]
+{changing--flageolet-mark-size.ly}
+
+
+@seealso
+Notation Reference:
+@ref{Breath marks},
+@ref{Slurs},
+@ref{Articulations and ornamentations},
+@ref{List of articulations},
+@ref{Tremolo repeats},
+@ref{Instrument transpositions},
+@ref{Glissando},
+@ref{Grace notes},
+@ref{Falls and doits},
+@ref{Special note heads},
+
+Snippets:
+@rlsr{Winds}
+
+
+@node Fingerings
+@unnumberedsubsubsec Fingerings
+@c TODO add link to LSR snippet by Libero Mureddo once he has added
+@c it (after August 15th).
+All wind instruments other than the trombone require the use of several
+fingers to produce each pitch.
+
+TBC
+
+@node Bagpipes
+@subsection Bagpipes
 
-@node Bagpipe sections
-@subsection Bagpipe sections
+This section includes extra information for writing for bagpipes.
 
 @menu
-* Bagpipe definitions::         
-* Bagpipe example::             
+* Bagpipe definitions::
+* Bagpipe example::
 @end menu
 
 @node Bagpipe definitions
-@subsubsection Bagpipe definitions
+@unnumberedsubsubsec Bagpipe definitions
+
+@cindex bagpipe
+@cindex Scottish highland bagpipe
+@cindex grace notes
+@funindex \taor
+@funindex taor
+@funindex \hideKeySignature
+@funindex hideKeySignature
+@funindex \showKeySignature
+@funindex showKeySignature
 
 LilyPond contains special definitions for music for the Scottish
 highland bagpipe; to use them, add
@@ -69,8 +168,15 @@ piobaireachd high g can be written @code{gflat} when it occurs in light
 music.
 
 
+@seealso
+@rlsr{Winds}
+
+
 @node Bagpipe example
-@subsubsection Bagpipe example
+@unnumberedsubsubsec Bagpipe example
+
+@cindex bagpipe example
+@cindex Amazing Grace bagpipe example
 
 This is what the well known tune Amazing Grace looks like in bagpipe
 notation.
@@ -113,6 +219,5 @@ notation.
 @end lilypond
 
 
-
-
-
+@seealso
+@rlsr{Winds}