[Httpunit-commit] CVS: httpunit/doc faq.html,1.19,1.20 release_notes.txt,1.192,1.193 todo.txt,1.37,1.38

[Russell G. <rus...@us...>]

Update of /cvsroot/httpunit/httpunit/doc
In directory usw-pr-cvs1:/tmp/cvs-serv25444/doc

Modified Files:
	faq.html release_notes.txt todo.txt 
Log Message:
Added support for proxy servers

Index: faq.html
===================================================================
RCS file: /cvsroot/httpunit/httpunit/doc/faq.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- faq.html	2 Oct 2002 13:16:38 -0000	1.19
+++ faq.html	14 Oct 2002 12:40:04 -0000	1.20
@@ -38,8 +38,7 @@
 
 <A NAME="org.xml.sax"><h3>What is the org.xml.sax package?</h3></A>
 You may be getting compile or runtime errors asking for the org.xml.sax package.
-This package is found in <a href="http://www.sf.net/projects/jtidy">JTidy</a>, the HTML parser used
-by HttpUnit. It is included in the download.
+You need to have xerces or another XML parser in your classpath. Xerces is included in the download.
 
 <A NAME="#reload"><h3>Why do I get java.lang.IllegalAccessError when calling getResponse()?</h3></A>
 <p>This happens when you use HttpUnit and certain versions of JTidy with one of the JUnit graphical test runners, which reloads
@@ -58,9 +57,8 @@
 <h2>Server Issues</h2>
 
 <A NAME="proxy"><h3>Can I use HttpUnit through a proxy server?</h3></A>
-Yes. HttpUnit uses java.net.HttpURLConnection, so the
-<A HREF="http://www.javaworld.com/javaworld/javatips/jw-javatip42.html">normal Java way to use
-proxies</A> will work. At some point HttpUnit may support this more directly, but for now, you will need to set the system properties yourself.
+Yes. Call <code>WebClient.setProxyServer( host, port )</code> before sending your request.
+This feature is available in the <a href="http://www.httpunit.org/prerelease">latest pre-release build.</a>
 
 <A NAME="charset"><h3>Why isn't HttpUnit handling my non-English pages?</h3></A>
 Older versions of HttpUnit (through 1.2) incorrectly assumed that all pages were in the default character set for the client platform.
@@ -92,10 +90,14 @@
 
 <A NAME="buttons"><h3>HttpUnit is not finding the buttons and parameters in my forms. What is wrong?</h3></A>
 This often happens when your HTML is not valid. Most browsers are extremely forgiving of bad HTML; however,
-JTidy (the HTML parser used by HttpUnit) is not. It expects tags to be nested according to the HTML specification and
-will reject any that are not. JTidy can display error messages to tell you what is wrong. To see them,
+JTidy (the HTML parser originally used by HttpUnit) is not. It expects tags to be nested according to the HTML
+specification and will reject any that are not. JTidy can display error messages to tell you what is wrong. To see them,
 call <code>HttpUnitOptions.setParserWarningsEnabled( true )</code> before retrieving your HTML page.
 Once you have corrected any errors, HttpUnit should see your form buttons and parameters.
+
+The <a href="http://www.httpunit.org/prerelease">latest pre-release build</a> supports
+<a href="http://www.apache.org/~andyc/neko/doc/html/">NekoHTML</a>, a much more forgiving parser.
+It is strongly recommended that you use it in preference to JTidy, as it should correct problems like this.
 
 <A NAME="#badPost"><h3>Why doesn't my servlet see parameters on a POST request?</h3></A>
 Some older servlet engines, such as Tomcat 3.1, get confused when they see a charset attribute on the Content-Type

Index: release_notes.txt
===================================================================
RCS file: /cvsroot/httpunit/httpunit/doc/release_notes.txt,v
retrieving revision 1.192
retrieving revision 1.193
diff -u -r1.192 -r1.193
--- release_notes.txt	14 Oct 2002 04:19:05 -0000	1.192
+++ release_notes.txt	14 Oct 2002 12:40:04 -0000	1.193
@@ -10,6 +10,13 @@
 
 
 Revision History:
+14-Oct-2002
+Acknowledgements:
+    Thanks to Stefan Renz for describing the correct way to set up proxy servers in Java 2 and later.
+Additions:
+    1. The proxy server may now be specified by calling WebClient.setProxyServer. This should also ensure that the
+       correct authorization header is sent.
+
 13-Oct-2002
 Notes:
     1. The NekoHTML parser is now supported. If it is present in the classpath, it will be used in preference to JTidy.

Index: todo.txt
===================================================================
RCS file: /cvsroot/httpunit/httpunit/doc/todo.txt,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- todo.txt	11 Oct 2002 01:26:22 -0000	1.37
+++ todo.txt	14 Oct 2002 12:40:05 -0000	1.38
@@ -1,14 +1,10 @@
-High priority:
-o better support for use with proxy server
-
 Medium priority:
-o replace JTidy with a simpler custom parser or NekoHTML
 o Support optional tags which hide their contents (as in IFRAME, OBJECT, etc.)
 o Check conformance with RFC 2109 - not currently sending $Version=1 string
 o Documentation, Documentation
 
 JavaScript priorities:
-o Document.write - will require replacing JTidy
+o Document.write - some more parser work is needed for this to work
 
 
 Possibles: