>From c81d0f975bb6f27e2679f8f711b367aa0a27a72a Mon Sep 17 00:00:00 2001
From: Patrick L. Schmidt <address@hidden>
Date: Sun, 13 Feb 2011 14:37:46 +0100
Subject: [PATCH 1/3] harmonics-and-slides-III

Revision of old patch
---
 Documentation/notation/fretted-strings.itely |   76 +++++++++++++++++++++++---
 1 files changed, 68 insertions(+), 8 deletions(-)

diff --git a/Documentation/notation/fretted-strings.itely b/Documentation/notation/fretted-strings.itely
index 98de6e3..f46b003 100644
--- a/Documentation/notation/fretted-strings.itely
+++ b/Documentation/notation/fretted-strings.itely
@@ -363,15 +363,61 @@ ties = \relative c' {
 @cindex tablature and harmonic indications
 @cindex slides in tablature notation
 @cindex tablature and slides
address@hidden chord glissandi
address@hidden \harmonic
address@hidden \harmonicByFret
address@hidden \harmonicByRatio
address@hidden \chordGlissando
+
+Harmonic indications can be added to tablature notation as sounding pitches:
+
address@hidden,quote]
+firstHarmonic = {
+  \ottava #1
+  <d'\4\harmonic>4
+  <g'\3\harmonic>4
+  <b'\2\harmonic>2
+}
+\score {
+  <<
+    \new Staff { \clef "treble_8" \firstHarmonic }
+    \new TabStaff { \firstHarmonic }
+  >>
+}
address@hidden lilypond
 
-Harmonic indications and slides can be added to tablature
-notation.
+Please note that the command @code{\harmonic} must always be defined inside a chord construct. It only makes sense for open-string harmonics in the 12th fret. All other harmonics should be calculated by LilyPond. This can be achieved by indicating the fret where a finger of the fretting hand should touch a string.
 
address@hidden, quote, relative=1]
-\new TabStaff {
-  \new TabVoice {
-    <c g'\harmonic>4 d\2\glissando e\2
-  }
address@hidden,quote]
+fretHarmonics = {
+  \ottava #1
+  \harmonicByFret #5 d16\4
+  \harmonicByFret #4 d16\4
+  \harmonicByFret #3 d8\4
+  \harmonicByFret #5 <g\3 b\2>2.
+}
+\score {
+  <<
+    \new Staff { \clef "treble_8" \fretHarmonics }
+    \new TabStaff { \fretHarmonics }
+  >>
+}
address@hidden lilypond
+
+Alternatively, harmonics can be computed by defining the ratio of string lengths above and below the harmonic fingering.
+
address@hidden,quote]
+ratioHarmonics = {
+  \ottava #1
+  \harmonicByRatio #1/2 <g\3 b\2 e'\1>4
+  \harmonicByRatio #1/3 <g\3 b\2 e'\1>4
+  \harmonicByRatio #1/4 { g8\3 b8\2 e'4\1 }
+}
+\score {
+  <<
+    \new Staff { \clef "treble_8" \ratioHarmonics }
+    \new TabStaff { \ratioHarmonics }
+  >>
 }
 @end lilypond
 
@@ -384,10 +430,24 @@ notation.
 @lilypondfile[verbatim,lilyquote,texidoc,doctitle]
 {polyphony-in-tablature.ly}
 
address@hidden,lilyquote,texidoc,doctitle]
+{tablature-open-string-harmonics.ly}
+
address@hidden,lilyquote,texidoc,doctitle]
+{tablature-fretted-string-harmonics.ly}
+
address@hidden,lilyquote,texidoc,doctitle]
+{tablature-slides.ly}
+
address@hidden,lilyquote,texidoc,doctitle]
+{tablature-chord-glissando.ly}
+
 
 @seealso
 Notation Reference:
address@hidden
address@hidden,
address@hidden,
address@hidden
 
 Snippets:
 @rlsr{Fretted strings}.
-- 
1.7.0.4