Zend_Cache_Frontend_Page: Added note to documentation that it requires Zend_Controller's output buffering to be disabled in order to function correctly.

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@20712 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/en/module_specs/Zend_Cache-Frontends.xml

@@ -591,6 +591,20 @@ $result = $cache->foobar2('1', '2');
                 <acronym>HTTP</acronym> 304 Not Modified if the cache is hit and if the browser
                 has already the good version).
             </para>
+            <note>
+                <para>
+                    This frontend operates by registering a callback function to be called
+                    when the output buffering it uses is cleaned. In order for this to operate
+                    correctly, it must be the final output buffer in the request. To guarantee
+                    this, the output buffering used by the Dispatcher needs to be disabled by
+                    calling <classname>Zend_Controller_Front<classname>'s <methodname>setParam()
+                    <methodname> method, for example, $front->setParam('disableOutputBuffering',
+                    true)</classname> or adding
+                    "resources.frontcontroller.params.disableOutputBuffering = true"
+                    to your bootstrap configuration file (assumed INI) if using
+                    </classname>Zend_Application</classname>.
+                </para>
+            <note>
         </sect3>
         <sect3 id="zend.cache.frontends.page.options">
             <title>Available Options</title>