From: David Kastrup <dak@gnu.org>
Date: Thu, 2 Aug 2012 10:20:10 +0000 (+0200)
Subject: Explain issue 2702 in changes.tely
X-Git-Tag: release/2.15.95-1~24
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=23c3488226827238ec04a089b9b71e709501c807;p=lilypond.git

Explain issue 2702 in changes.tely
---

diff --git a/Documentation/changes.tely b/Documentation/changes.tely
index 912800a3a1..9e7c59be99 100644
--- a/Documentation/changes.tely
+++ b/Documentation/changes.tely
@@ -60,6 +60,27 @@ which scares away people.
 * only show user-visible changes.
 
 @end ignore
+@item
+The syntax of words (character sequences recognized without enclosing
+quotes) and commands (now always a backslash @samp{\} followed by a
+word) has been unified across all modes: it now consists of alphabetic
+characters, possibly enclosing isolated dashes @samp{-} and underlines
+@samp{_}.
+
+As one consequence, using unquoted text scripts like (literally!)
+@example
+@{ c-script c\f_script @}
+@end example
+will now tend to result in invalid music.  Omitting quote marks
+for arbitrary text rather than keywords has never been good practice or
+even documented, and it is unlikely to have seen significant use.
+
+Staying with established conventions (like not using dashes or
+underlines for command names intended to be used inside of music)
+remains advisable.  The reason for this change is more robust
+recognition of LilyPond's lexical units for LilyPond itself as well as
+external tools interpreting its syntax.
+
 @item
 Support for Kievan square notation:
 @lilypond[quote,relative=1,verbatim]