ZF-10923: Add note to manual pages about fully-qualified base URLs

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

documentation/manual/en/module_specs/Zend_Controller-FrontController.xml

@@ -336,6 +336,19 @@ Zend_Controller_Front::run('../application/controllers');
                     retrieve the current value. The value is provided to the
                     request object just prior to routing.
                 </para>
+
+                <note>
+                    <title>Fully-Qualified URL is not supported</title>
+                    <para>
+                        Passing a fully-qualified URL (ie: http://example.com/) to the
+                        <methodname>setBaseUrl</methodname> method is not supported, and 
+                        will cause issues when using the URL view helper. See ticket 
+                        <ulink url="http://framework.zend.com/issues/browse/ZF-10923">
+                            ZF-10923
+                        </ulink> for more details.
+                    </para>
+                </note>
+
             </listitem>
 
             <listitem>

documentation/manual/en/module_specs/Zend_Controller-Request.xml

@@ -264,6 +264,20 @@ $controller->setControllerDirectory('./application/controllers')
            ->setBaseUrl('/projects/myapp'); // set the base url!
 $response   = $controller->dispatch();
 ]]></programlisting>
+
+            <note>
+                <title>Fully-Qualified URL is not supported</title>
+                <para>
+                    Passing a fully-qualified URL (ie: http://example.com/) to the
+                    <methodname>setBaseUrl</methodname> method is not supported, and 
+                    will cause issues for both the usage describe above and when using
+                    the URL view helper. See ticket 
+                    <ulink url="http://framework.zend.com/issues/browse/ZF-10923">
+                        ZF-10923
+                    </ulink> for more details.
+                </para>
+            </note>
+
         </sect3>
 
         <sect3 id="zend.controller.request.http.method">