From: James Lowe <pkx166h@gmail.com>
Date: Mon, 7 Jan 2013 16:14:40 +0000 (+0000)
Subject: Doc: Add draw-dashed/dotted line cmds to changes
X-Git-Tag: release/2.17.10-1~2
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=031d7e70b553ea0b8319a33063cf49dd3c683187;p=lilypond.git

Doc: Add draw-dashed/dotted line cmds to changes

Example taken from reg test in Issue 3071
---

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index 630dad3bcb..19c93c2a59 100644
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -61,6 +61,38 @@ which scares away people.
 
 @end ignore
 
+@item
+Introducing two new markup-commands; @code{\draw-dashed-line} and
+@code{\draw-dotted-line}.
+
+@noindent
+The dashed-line extends to the whole length given by @var{dest}, if
+@code{full-length} is set to @code{#t} (this is the default) without any
+space at the beginning or end.  @code{off} will then be altered to fit.
+To insist on the given (or default) values of @code{on}, @code{off} use
+@code{\override #'(full-length . #f)}.  Manual settings for @code{on},
+@code{off} and @code{phase} are possible.
+
+@noindent
+The dotted-line always extends to the whole length given by @var{dest},
+without any space at the beginning or end.  Manual settings for
+@code{off} are possible to get larger or smaller space between the dots.
+The given (or default) value of @code{off} will be altered to fit the
+line-length.
+
+@lilypond[verbatim,quote]
+\markup {
+  \draw-dashed-line #'(5.1 . 2.3)
+  \override #'(on . 0.3)
+  \override #'(off . 0.5)
+  \draw-dashed-line #'(5.1 . 2.3)
+  \draw-dotted-line #'(5.1 . 2.3)
+  \override #'(thickness . 2)
+  \override #'(off . 0.2)
+  \draw-dotted-line #'(5.1 . 2.3)
+}
+@end lilypond
+
 @item
 Starting with version@tie{}2.17.10, error messages or the
 @code{textedit} @acronym{URI} used for point-and-click