From 6ec87d3ce7fd4e373f687a3fa6347edf7011d381 Mon Sep 17 00:00:00 2001
From: Sebastian Bazley <sebb@apache.org>
Date: Wed, 8 Dec 2010 16:53:46 +0000
Subject: [PATCH] Clarify URI content in Execution Context

git-svn-id: https://svn.apache.org/repos/asf/httpcomponents/httpclient/trunk@1043518 13f79535-47bb-0310-9956-ffa450edef68
---
 src/docbkx/fundamentals.xml | 6 +++++-
 src/docbkx/httpagent.xml    | 5 ++++-
 2 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/src/docbkx/fundamentals.xml b/src/docbkx/fundamentals.xml
index 6d3b2ebe9..e6846f41a 100644
--- a/src/docbkx/fundamentals.xml
+++ b/src/docbkx/fundamentals.xml
@@ -543,7 +543,11 @@ byte[] response = httpclient.execute(httpget, handler);
                 <formalpara>
                     <title><constant>ExecutionContext.HTTP_REQUEST</constant>='http.request':</title>
                     <para><interfacename>HttpRequest</interfacename> instance representing the
-                        actual HTTP request.</para>
+                        actual HTTP request.
+                        The final HttpRequest object in the execution context always represents
+                        the state of the message _exactly_ as it was sent to the target server.
+                        Per default HTTP/1.0 and HTTP/1.1 use relative request URIs.
+                    </para>
                 </formalpara>
             </listitem>
             <listitem>
diff --git a/src/docbkx/httpagent.xml b/src/docbkx/httpagent.xml
index c4632ad9c..5d2377cee 100644
--- a/src/docbkx/httpagent.xml
+++ b/src/docbkx/httpagent.xml
@@ -185,6 +185,9 @@ httpclient.getConnectionManager().shutdown();
             updated depending on the execution context. Therefore the final request properties such
             as the target host and request URI can be determined by examining the content of the
             local HTTP context after the request has been executed.</para>
+        <para>The final HttpRequest object in the execution context always represents
+            the state of the message _exactly_ as it was sent to the target server.
+            Per default HTTP/1.0 and HTTP/1.1 use relative request URIs.</para>
         <programlisting><![CDATA[
 DefaultHttpClient httpclient = new DefaultHttpClient();
 
@@ -197,7 +200,7 @@ HttpUriRequest req = (HttpUriRequest) localContext.getAttribute(
         ExecutionContext.HTTP_REQUEST);
 
 System.out.println("Target host: " + target);
-System.out.println("Final request URI: " + req.getURI());
+System.out.println("Final request URI: " + req.getURI()); // relative URI
 System.out.println("Final request method: " + req.getMethod());
 ]]></programlisting>
     </section>