Revert "update fret diagrams regression test"
[lilypond/csorensen.git] / Documentation / user / wind.itely
blob4f9bc4ba1f76b9a54ac57542f9e871be1aaffcc7
1 @c -*- coding: utf-8; mode: texinfo; -*-
2 @ignore
3     Translation of GIT committish: FILL-IN-HEAD-COMMITTISH
5     When revising a translation, copy the HEAD committish of the
6     version that you are working on.  See TRANSLATION for details.
7 @end ignore
9 @c \version "2.11.38"
11 @node Wind instruments
12 @section Wind instruments
14 This section includes extra information for writing for bagpipes.
16 @menu
17 * Common notation for wind instruments::
18 * Bagpipes::
19 @end menu
21 @node Common notation for wind instruments
22 @subsection Common notation for wind instruments
24 @menu
25 * References for wind instruments::
26 * Half-holes::
27 @end menu
29 @node References for wind instruments
30 @subsubsection References for wind instruments
32 @c TODO Add refs
33 TBC
35 @node Half-holes
36 @subsubsection Half-holes
37 @c TODO Add text; search -user
38 TBC
40 @node Bagpipes
41 @subsection Bagpipes
43 @menu
44 * Bagpipe definitions::
45 * Bagpipe example::
46 @end menu
48 @node Bagpipe definitions
49 @subsubsection Bagpipe definitions
51 LilyPond contains special definitions for music for the Scottish
52 highland bagpipe; to use them, add
54 @example
55 \include "bagpipe.ly"
56 @end example
58 @noindent
59 at the top of your input file.  This lets you add the special grace notes
60 common to bagpipe music with short commands.  For example, you could
61 write @code{\taor} instead of
63 @example
64 \grace @{ \small G32[ d G e] @}
65 @end example
67 @code{bagpipe.ly} also contains pitch definitions for the bagpipe
68 notes in the appropriate octaves, so you do not need to worry about
69 @code{\relative} or @code{\transpose}.
71 @lilypond[ragged-right,verbatim,quote,notime]
72 \include "bagpipe.ly"
73 { \grg G4 \grg a \grg b \grg c \grg d \grg e \grg f \grA g A }
74 @end lilypond
76 Bagpipe music nominally uses the key of D Major (even though that
77 isn't really true).  However, since that is the only key that can be used,
78 the key signature is normally not written out.  To set this up correctly,
79 always start your music with @code{\hideKeySignature}.  If you for some
80 reason want to show the key signature, you can use @code{\showKeySignature}
81 instead.
83 Some modern music use cross fingering on c and f to flatten those notes.
84 This can be indicated by @code{cflat} or @code{fflat}.  Similarly, the
85 piobaireachd high g can be written @code{gflat} when it occurs in light
86 music.
89 @node Bagpipe example
90 @subsubsection Bagpipe example
92 This is what the well known tune Amazing Grace looks like in bagpipe
93 notation.
95 @lilypond[verbatim,quote]
96 \include "bagpipe.ly"
97 \layout {
98   indent = 0.0\cm
99   \context { \Score \remove "Bar_number_engraver" }
102 \header {
103   title = "Amazing Grace"
104   meter = "Hymn"
105   arranger = "Trad. arr."
109   \hideKeySignature
110   \time 3/4
111   \grg \partial 4 a8. d16
112   \slurd d2 \grg f8[ e32 d16.]
113   \grg f2 \grg f8 e
114   \thrwd d2 \grg b4
115   \grG a2 \grg a8. d16
116   \slurd d2 \grg f8[ e32 d16.]
117   \grg f2 \grg e8. f16
118   \dblA A2 \grg A4
119   \grg A2 f8. A16
120   \grg A2 \hdblf f8[ e32 d16.]
121   \grg f2 \grg f8 e
122   \thrwd d2 \grg b4
123   \grG a2 \grg a8. d16
124   \slurd d2 \grg f8[ e32 d16.]
125   \grg f2 e4
126   \thrwd d2.
127   \slurd d2
128   \bar "|."
130 @end lilypond