diff --git a/ChangeLog b/ChangeLog
index 640a89b214..4bc811f4a1 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2006-02-01  Stefan Kost  <ensonic@users.sf.net>
+
+	* docs/manual/README:
+          uncover a nasty detail of the docs build
+
 2006-01-31  Wim Taymans  <wim@fluendo.com>
 
 	* gst/gstbin.c: (bin_remove_messages), (bin_query_duration_done):
diff --git a/docs/manual/README b/docs/manual/README
index 2a6eed0712..508c65f11d 100644
--- a/docs/manual/README
+++ b/docs/manual/README
@@ -25,6 +25,11 @@ Thomas's new comments on the doc building :
 * eps files in images/ should be generated from the makefile.  You need to 
   have fig2dev installed for that.
 
+Ensonic's comments on the doc build system :
+--------------------------------------------
+In case you like to share files between the manual and the pwg - its not trivial.
+Before anything is done, the build-system copies all xml files into the build
+subdir and this breaks including shared docs via entities.
 
 Wtay's original comments :
 --------------------------