Doc: Fix Issue 1027 -- new snippet showing Lyrics spacing adjustment

diff --git a/Documentation/snippets/new/adjusting-lyrics-vertical-spacing.ly b/Documentation/snippets/new/adjusting-lyrics-vertical-spacing.ly
new file mode 100644 (file)
index 0000000..9f010b3
--- /dev/null
+++ b/Documentation/snippets/new/adjusting-lyrics-vertical-spacing.ly
@@ -0,0 +1,35 @@
+%% This file is in the public domain.
+\version "2.13.16"
+
+\header {
+  lsrtags = "text, vocal-music, spacing"
+  texidoc = "
+This snippet shows how to bring the lyrics line closer to the staff.
+
+"
+  doctitle = "Adjusting lyrics vertical spacing"
+}
+
+% Default layout:
+<<
+  \new Staff \new Voice = melody \relative c' {
+    c4 d e f
+    g4 f e d
+    c1
+  }
+  \new Lyrics \lyricsto melody { aa aa aa aa aa aa aa aa aa }
+
+% Reducing the minimum space below the staff and above the lyrics:
+  \new Staff  {
+    \new Voice = melody \relative c' {
+      c4 d e f
+      g4 f e d
+      c1
+    }
+  }
+  \new Lyrics \with {
+    \override VerticalAxisGroup #'staff-affinity = #UP
+    \override VerticalAxisGroup #'inter-staff-spacing = #'((space . 1)) }
+    \lyricsto melody { aa aa aa aa aa aa aa aa aa }
+>>
+