From 4afb06c6aa504ef69bea644887b20fd9a947f616 Mon Sep 17 00:00:00 2001
From: Francisco Vila <francisco.vila@hispalinux.es>
Date: Mon, 1 Mar 2010 20:52:51 +0100
Subject: [PATCH] Doc: add warning in README file for issue on included/

---
 Documentation/included/README | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/Documentation/included/README b/Documentation/included/README
index 5c46262b20..6252de2399 100644
--- a/Documentation/included/README
+++ b/Documentation/included/README
@@ -7,3 +7,7 @@ direction and listed here.
 - simple.ly isn't large, but it's included from
   scm/define-markup-commands.scm and should not be removed.
 
+Do not use @ref{} in files in Documentation/included/;
+cross-references should be made with specific macros such as
+@rcontrib{}, @rextend{}, etc.  See Documentation/macros.itexi for a
+complete list.
\ No newline at end of file
-- 
2.39.5