From 638959a429edecd277c1f4217971d42ee1b523c5 Mon Sep 17 00:00:00 2001
From: John Mandereau <john.mandereau@gmail.com>
Date: Thu, 24 Dec 2009 14:24:50 +0100
Subject: [PATCH] Docs: move macro definition that contains translatable text

Add guideline for this issue BTW.
---
 Documentation/common-macros.itexi | 24 ++++--------------------
 Documentation/macros.itexi        | 31 +++++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+), 20 deletions(-)

diff --git a/Documentation/common-macros.itexi b/Documentation/common-macros.itexi
index 688b2728e4..d014af5713 100644
--- a/Documentation/common-macros.itexi
+++ b/Documentation/common-macros.itexi
@@ -1,6 +1,10 @@
 @c -*- coding: utf-8; mode: texinfo; -*-
 
 
+@c ***********************************************
+@c SEE MACRO DEFINITION GUIDELINES IN macros.itexi
+@c ***********************************************
+
 @c Don't replace quotes with directed quotes.
 
 @set txicodequoteundirected
@@ -176,26 +180,6 @@ UNTRANSLATED NODE: IGNORE ME
 @end html
 @end macro
 
-@macro exampleImage{IMAGE-FILE}
-@html
-<div class="float-center">
-  <a class="clickable" href="examples/\IMAGE-FILE\.png">
-    <img src="examples/\IMAGE-FILE\-small.png" alt="\IMAGE-FILE\">
-  </a>
-  <p style="text-align: center">
-    (click to enlarge)
-  </p>
-</div>
-@end html
-@iftex
-@image{examples/\IMAGE-FILE\-small,,,\IMAGE-FILE\,png}
-@end iftex
-@ifinfo
-@image{lilypond/examples/\IMAGE-FILE\,,,\IMAGE-FILE\,png}
-@end ifinfo
-@end macro
-
-
 
 @macro imageClickable{IMAGE-FILE, EXT, MORE-TEXT, CLICK-FILE, CLICK-EXT, POSITION}
 @html
diff --git a/Documentation/macros.itexi b/Documentation/macros.itexi
index 68e76c37db..0ad98443a3 100644
--- a/Documentation/macros.itexi
+++ b/Documentation/macros.itexi
@@ -10,6 +10,18 @@
 @include version.itexi
 @include common-macros.itexi
 
+@ignore
+****************************
+MACRO DEFINITIONS GUIDELINES
+****************************
+
+This file should contain macro defintions which are common to all
+languages, i.e. all macro definitions which do not contain text that
+should be translated (namely text visible in the output).
+
+Macro definitions which contain text that should be translated in
+translations should be in macros.itexi.
+@end ignore
 
 @c   ***** Displaying text *****
 
@@ -685,6 +697,25 @@ For LilyPond version @version{}
 
 @ifset web
 
+@macro exampleImage{IMAGE-FILE}
+@html
+<div class="float-center">
+  <a class="clickable" href="examples/\IMAGE-FILE\.png">
+    <img src="examples/\IMAGE-FILE\-small.png" alt="\IMAGE-FILE\">
+  </a>
+  <p style="text-align: center">
+    (click to enlarge)
+  </p>
+</div>
+@end html
+@iftex
+@image{examples/\IMAGE-FILE\-small,,,\IMAGE-FILE\,png}
+@end iftex
+@ifinfo
+@image{lilypond/examples/\IMAGE-FILE\,,,\IMAGE-FILE\,png}
+@end ifinfo
+@end macro
+
 @c LEGALESE
 
 @macro logoLegalLinux
-- 
2.39.2