Gently warn/scare users that reflection isn't yet perfect because really, it isn't. Wrote this with Yawk.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@298791 c90b9560-bf6c-de11-be94-00142212c4b1

reference/reflection/book.xml

@@ -13,6 +13,13 @@
    methods and extensions. Additionally, the reflection API offers ways to
    retrieve doc comments for functions, classes and methods.
   </para>
+  <para>
+   Please note that certain parts of the internal <acronym>API</acronym>
+   are missing the necessary code to work with the Reflection extension.
+   E.g., an internal PHP class might be missing reflection data for
+   properties. These few cases are considered bugs, however, so they
+   should be discovered and fixed.
+  </para>
  </preface>
 
  &reference.reflection.setup;