From: Graham Percival <graham@percival-music.ca>
Date: Fri, 12 Oct 2007 20:54:20 +0000 (-0700)
Subject: Add warning about \ -> \\ in macros.
X-Git-Tag: release/2.11.35-1~46^2~50
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=7a6022dc356146881de540fb11f91473701b7e80;p=lilypond.git

Add warning about \ -> \\ in macros.
---

diff --git a/Documentation/user/macros.itexi b/Documentation/user/macros.itexi
index ee7bf4b8c8..803e261bcf 100644
--- a/Documentation/user/macros.itexi
+++ b/Documentation/user/macros.itexi
@@ -31,6 +31,7 @@
 @end quotation
 @end macro
 
+@c TODO: define different output for info
 @macro notation{TEXT}
 @var{\TEXT\}
 @end macro
diff --git a/Documentation/user/policy.txt b/Documentation/user/policy.txt
index 57acddda6b..31038a2ae1 100644
--- a/Documentation/user/policy.txt
+++ b/Documentation/user/policy.txt
@@ -183,6 +183,12 @@ main docs
 
     @code{}: actual lilypond code or property/context names.
     @samp{}: ditto, for single-letter code.
+
+
+      ** Any `\' used inside the commands below must be       **
+      ** written as `\\'.  Even if they are inside a @code{}. **
+            ( this should only affect @warning{} )
+
 	@notation{}: refers to pieces of notation, such as
 	  "@notation{crescendo} is often abbreviated as
       @notation{cresc.}"  This should also be used to refer to
@@ -191,8 +197,8 @@ main docs
       languages).
 	@qq{}: only for actual quotes -- i.e. "he said" or "she
       wrote".
-
-* @warning{} produces a "Note: " box.  Use for important messages.
+	@warning{}: produces a "Note: " box.  Use for important
+      messages.
 
 
 %%%%% READABILITY