From: James Lowe <james.lowe@datacore.com>
Date: Thu, 20 May 2010 21:08:42 +0000 (+0100)
Subject: Doc: CG updated rules for {} usage in ly examples
X-Git-Tag: release/2.13.22-1~7
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=8d1567711264d16761174d60d1f5eba7b377203c;p=lilypond.git

Doc: CG updated rules for {} usage in ly examples

Added new guidelines and improved example of previous one.
---

diff --git a/Documentation/contributor/doc-work.itexi b/Documentation/contributor/doc-work.itexi
index cdd06f29c9..bf0e316066 100644
--- a/Documentation/contributor/doc-work.itexi
+++ b/Documentation/contributor/doc-work.itexi
@@ -359,10 +359,32 @@ Comments should go on their own line, and be placed before
 the line(s) to which they refer.
 
 @item
-Add extra spaces around @{ @} marks; ie
+For clarity, always use @{ @} marks even if they are not technically
+required; ie
 
 @example
-not:          \chordmode @{c e g@}
+not:
+
+\context Voice \repeat unfold 2 \relative c' @{
+  c2 d
+@}
+
+but instead:
+
+\context Voice @{
+  \repeat unfold 2 @{
+    \relative c' @{
+      c2 d
+    @}
+  @}
+@}
+@end example
+
+@item
+Add a space around @{ @} marks; ie
+
+@example
+not:          \chordmode@{c e g@}
 but instead:  \chordmode @{ c e g @}
 @end example