- Include examples in documentation

- Provide a better place for the examples

diff --git a/ext/spl/doxygen.cfg b/ext/spl/doxygen.cfg
index 1d79e40465f3f813cd7595f27943b69b7bf33138..d58017a6ad8a0621c85c143d0a2dd609e55fbcae 100755 (executable)
--- a/ext/spl/doxygen.cfg
+++ b/ext/spl/doxygen.cfg
@@ -87,8 +87,8 @@ FILTER_SOURCE_FILES    = NO
 #---------------------------------------------------------------------------
 # configuration options related to source browsing
 #---------------------------------------------------------------------------
-SOURCE_BROWSER         = NO
-INLINE_SOURCES         = NO
+SOURCE_BROWSER         = YES
+INLINE_SOURCES         = YES
 STRIP_CODE_COMMENTS    = YES
 REFERENCED_BY_RELATION = YES
 REFERENCES_RELATION    = YES

diff --git a/ext/spl/spl.php b/ext/spl/spl.php
index c1dfb0ba09cbb8cfcf7de9042c6aeba7fe16d2de..8ad3d197d24de9d4fa0a16b8ee997940b4120977 100755 (executable)
--- a/ext/spl/spl.php
+++ b/ext/spl/spl.php
@@ -102,8 +102,14 @@
  * - interface SplObserver
  * - interface SplSubject
  * - class SplObjectStorage
+ *
+ * 8) @ref Examples
+ *
+ * The classes and interfaces in this group are contained as PHP code in the 
+ * examples subdirectory of ext/SPL. Sooner or later they will be moved to
+ * c-code.
  * 
- * Some articles about SPL:
+ * 9) Some articles about SPL:
  * - <a href="http://www.sitepoint.com/article/php5-standard-library/1">Introducing PHP 5's Standard Library</a>
  * - <a href="http://www.ramikayyali.com/archives/2005/02/25/iterators">Iterators in PHP5</a>
  * - <a href="http://www.phpriot.com/d/articles/php/oop/oop-with-spl-php-5-1/index.html">Advanced OOP with SPL in PHP 5</a>
@@ -112,7 +118,7 @@
  * - <a href="http://www.wiki.cc/php/SPL">SPL on PHP Wiki</a>
  * - <a href="http://www.professionelle-softwareentwicklung-mit-php5.de/erste_auflage/oop.iterators.spl.html">Die Standard PHP Library (SPL) [german]</a>
  *
- * Talks on SPL:
+ * 10) Talks on SPL:
  * - SPL for the masses <a href="http://somabo.de/talks/200504_php_quebec_spl_for_the_masses.pps">[pps]</a>, <a href="http://somabo.de/talks/200504_php_quebec_spl_for_the_masses.pdf">[pdf]</a>
  * - From engine overloading to SPL <a href="http://somabo.de/talks/200505_cancun_from_engine_overloading_to_spl.pps">[pps]</a>, <a href="http://somabo.de/talks/200505_cancun_from_engine_overloading_to_spl.pdf">[pdf]</a>
  * - Happy SPLing <a href="http://somabo.de/talks/200509_toronto_happy_spling.pps">[pps]</a>, <a href="http://somabo.de/talks/200509_toronto_happy_spling.pdf">[pdf]</a>