Add warning about \ -> \\ in macros.

diff --git a/Documentation/user/macros.itexi b/Documentation/user/macros.itexi
index ee7bf4b8c8f75cfc67fddfebc1d6bd8387843a4a..803e261bcf87ec45f353de9cde7178b75c39983a 100644 (file)
--- 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 57acddda6bae062b5537893a76a93be07fc489a3..31038a2ae1875460ad01f8787cab76ed1244ca75 100644 (file)
--- 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