Folks,
The patch attached below includes various, mostly minor, documentation
changes suggested by the users or required as a result of user feedback.
Please review and let me know what you think. Corrections to my Russlish
are also very welcome.
Oleg
Index: xdocs/troubleshooting.xml
===================================================================
--- xdocs/troubleshooting.xml (revision 290763)
+++ xdocs/troubleshooting.xml (working copy)
@@ -32,6 +32,16 @@
<em>HttpClient</em> as described in the <a
href="tutorial.html">tutorial</a>.</li>
+ <li>Set the <code>User-Agent</code> request header to masquerade <em>HttpClient
+ </em> as a popular browser such as IE or Firefox. Certain web sites are optimized
+ to work with just one or a number of specific browser applications. These sites
+ frequently reject requests originating from user agents they do not recognize.
+ For example, setting the <code>User-Agent</code> request header to <code>
+ Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)</code> would deceive the target
+ server into believing that the request was issues by Microsoft Internet Explorer
+ 6.0 on Windows 2000.
+ </li>
+
<li>Set the <a href="logging.html">logging level</a> to debug and check
the output for the cause of the problem.</li>
Index: xdocs/tutorial.xml
===================================================================
--- xdocs/tutorial.xml (revision 290763)
+++ xdocs/tutorial.xml (working copy)
@@ -20,7 +20,7 @@
</section>
<section name="Getting Ready">
- <p>The first thing you need to do is get a copy of <em>HttpClient</em> and it's
+ <p>The first thing you need to do is get a copy of <em>HttpClient</em> and its
<a href="dependencies.html">dependencies</a>. This tutorial was
written for <em>HttpClient</em> 3.0. You will also need JDK 1.3 or above.</p>
Index: xdocs/authentication.xml
===================================================================
--- xdocs/authentication.xml (revision 290763)
+++ xdocs/authentication.xml (working copy)
@@ -252,6 +252,21 @@
<strong>Workaround:</strong> Disable stale connection check or upgrade to Java 1.4 or above.
</p>
</li>
+ <li>
+ <p>
+ <strong>Cannot authenticate with Microsoft IIS using NTLM authentication scheme</strong>
+ </p>
+ <p>
+ NT Lan Manager (NTLM) authentication is a proprietary, closed challenge/response authentication
+ protocol for Microsoft Windows. Only some details about NTLM protocol are available through
+ reverse engineering. HttpClient provides limited support for what is known as NTLMv1, the early
+ version of the NTLM protocol. HttpClient does not support NTLMv2 at all.
+ </p>
+ <p>
+ <strong>Workaround:</strong> Disable NTLMv2. For details refer to this Microsoft Support
+ <a href="http://support.microsoft.com/default.aspx?scid=KB;en-us;239869";>Article</a>
+ </p>
+ </li>
</ol>
</section>
Index: src/java/org/apache/commons/httpclient/ChunkedInputStream.java
===================================================================
--- src/java/org/apache/commons/httpclient/ChunkedInputStream.java (revision 290763)
+++ src/java/org/apache/commons/httpclient/ChunkedInputStream.java (working copy)
@@ -49,7 +49,7 @@
* not requiring the client to remember to read the entire contents of the
* response.</p>
*
- * @author Ortwin GlЭck
+ * @author Ortwin Glueck
* @author Sean C. Sullivan
* @author Martin Elwin
* @author Eric Johnson
Index: src/java/org/apache/commons/httpclient/auth/CredentialsProvider.java
===================================================================
--- src/java/org/apache/commons/httpclient/auth/CredentialsProvider.java (revision 290763)
+++ src/java/org/apache/commons/httpclient/auth/CredentialsProvider.java (working copy)
@@ -38,10 +38,22 @@
* to request authentication credentials if no credentials have been given
* or given credentials are incorrect.
* </p>
- *
+ * <p>
+ * HttpClient makes no provisions to check whether the same credentials have
+ * not been tried already. It is a responsibility of the custom credentials
+ * provider to keep track of authentication attempts and to ensure that
+ * credentials known to be invalid are not retried. HttpClient will simply
+ * store the set of credentials returned by the custom credentials provider
+ * in the [EMAIL PROTECTED] HttpState http state} object and will attempt to use these
+ * credentials for all subsequent requests with the given authentication
+ * scope.
+ * </p>
+ * <p>
* Classes implementing this interface must synchronize access to shared
* data as methods of this interfrace may be executed from multiple threads
+ * </p>
*
+ *
* @author Ortwin Glueck
* @author <a href="mailto:[EMAIL PROTECTED]">Oleg Kalnichevski</a>
*
Index: src/java/org/apache/commons/httpclient/AutoCloseInputStream.java
===================================================================
--- src/java/org/apache/commons/httpclient/AutoCloseInputStream.java (revision 290763)
+++ src/java/org/apache/commons/httpclient/AutoCloseInputStream.java (working copy)
@@ -37,7 +37,7 @@
* Closes an underlying stream as soon as the end of the stream is reached, and
* notifies a client when it has done so.
*
- * @author Ortwin GlЭck
+ * @author Ortwin Glueck
* @author Eric Johnson
* @author <a href="mailto:[EMAIL PROTECTED]">Mike Bowler</a>
*
Index: src/java/org/apache/commons/httpclient/util/TimeoutController.java
===================================================================
--- src/java/org/apache/commons/httpclient/util/TimeoutController.java (revision 290763)
+++ src/java/org/apache/commons/httpclient/util/TimeoutController.java (working copy)
@@ -33,7 +33,7 @@
* <p>
* Executes a task with a specified timeout.
* </p>
- * @author Ortwin GlЭck
+ * @author Ortwin Glueck
* @author <a href="mailto:[EMAIL PROTECTED]">Mike Bowler</a>
* @version $Revision$
* @since 2.0
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
