[PATCH] Issue 1046

[Marc Hohl]

I stumbled across Issue 1046 and tried to add some lines and
a short example, see the attached patch.

I have to say that I am not very familiar with texinfo; doing

make all; make doc

fails after a considerable amount of time:

(/home/marc/git/lilypond/Documentation/out/notation/fretted-strings.texi
/home/marc/git/lilypond/Documentation/out/notation/fretted-strings.texi:32: 
I c
an't find file `c6/lily-4f6e19ca-systems.texi'.
@temp ->@input c6/lily-4f6e19ca-systems.texi
                                           
@includezzz ...and @input #1 address@hidden address@hidden
                                                 @popthisfilestack
l.32 @include c6/lily-4f6e19ca-systems.texi
                                         
Please type another input file name
/home/marc/git/lilypond/Documentation/out/notation/fretted-strings.texi:32: 
Eme
rgency stop.
@temp ->@input c6/lily-4f6e19ca-systems.texi
                                           
@includezzz ...and @input #1 address@hidden address@hidden
                                                 @popthisfilestack
l.32 @include c6/lily-4f6e19ca-systems.texi
                                         
/home/marc/git/lilypond/Documentation/out/notation/fretted-strings.texi:32:  
==
> Fatal error occurred, no output PDF file produced!
Transcript written on notation.log.
/usr/bin/texi2dvi: pdfetex exited with bad status, quitting.
make[2]: *** [out-www/notation.pdf] Error 1
rm out-www/weblinks.itexi
make[2]: Leaving directory `/home/marc/git/lilypond/Documentation'
make[1]: *** [WWW-1] Error 2
make[1]: Leaving directory `/home/marc/git/lilypond'
make: *** [doc-stage-1] Fehler 2

Any hints are appreciated.

Marc


From 61a8189322260d04426c5fb1bd45e45f38ad0040 Mon Sep 17 00:00:00 2001
From: Marc Hohl <address@hidden>
Date: Tue, 30 Mar 2010 22:41:10 +0200
Subject: [PATCH] Issue 1046: Documenting \deadNote|\deadNotesOn|\deadNotesOff

---
 Documentation/notation/fretted-strings.itely |   23 +++++++++++++++++++++--
 Documentation/notation/pitches.itely         |    7 ++++++-
 2 files changed, 27 insertions(+), 3 deletions(-)

diff --git a/Documentation/notation/fretted-strings.itely 
b/Documentation/notation/fretted-strings.itely
index 0ef0d10..3e7fb52 100644
--- a/Documentation/notation/fretted-strings.itely
+++ b/Documentation/notation/fretted-strings.itely
@@ -1470,13 +1470,32 @@ text markup.
 @lilypond[quote,ragged-right,verbatim]
 \relative c' {
   \clef "treble_8"
-  \override Staff.NoteHead #'style = #'cross
-  g8 a b c b4
   \override Staff.NoteHead #'style = #'harmonic-mixed
   d^\markup { \italic { \fontsize #-2 { "harm. 12" }}} <g b>1
 }
 @end lilypond
 
+Dampened notes (also called @notation{dead notes}) are supported
+within normal and tablature staves:
+
address@hidden,ragged-right,verbatim]
+music = \relative c' {
+  < a\3 \deadNote c\2 a'\1 >4
+  < b\3 \deadNote d\2 b'\1 >4
+  < c\3 \deadNote e\2 c'\1 >8
+  \deadNotesOn \times 2/3 { g16\3 \b\2 e\1 } \deadNotesOff
+  < a,\3 c\2 e\1 >1
+}
+\new StaffGroup <<
+  \new Staff {
+    \clef "treble_8"
+    \music
+  }
+  \new TabStaff {
+    \music
+  }
+>>
address@hidden lilypond
 
 @seealso
 Snippets:
diff --git a/Documentation/notation/pitches.itely 
b/Documentation/notation/pitches.itely
index 8bb544a..31af761 100644
--- a/Documentation/notation/pitches.itely
+++ b/Documentation/notation/pitches.itely
@@ -2574,6 +2574,10 @@ c4 b
 c b < g \xNote c f > b
 @end lilypond
 
+As synonyms for @code{\xNote}, @code{\xNotesOn} and @code{\xNotesOff},
address@hidden, @code{\deadNotesOn} and @code{\deadNotesOff} can
+be used.  The term @notation{dead note} is commonly used by guitarists.
+
 There is also a shorthand for diamond shapes which can be used
 only inside chords:
 
@@ -2594,7 +2598,8 @@ Snippets:
 
 Notation Reference:
 @ref{Note head styles},
address@hidden notes}.
address@hidden notes},
address@hidden harmonics and dampened notes}.
 
 Internals Reference:
 @rinternals{note-event},
-- 
1.5.4.3