jsdever 2003/01/26 08:36:25 Modified: httpclient project.xml httpclient/xdocs applications.xml downloads.xml features.xml index.xml logging.xml navigation.xml news.xml overview.xml proposal.xml releases.xml status.xml Log: Added some more projects, formatting alignments of the xml files. Revision Changes Path 1.27 +5 -1 jakarta-commons/httpclient/project.xml Index: project.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/project.xml,v retrieving revision 1.26 retrieving revision 1.27 diff -u -r1.26 -r1.27 --- project.xml 26 Jan 2003 14:54:13 -0000 1.26 +++ project.xml 26 Jan 2003 16:36:24 -0000 1.27 @@ -75,7 +75,7 @@ <email>[EMAIL PROTECTED]</email> <organization>Independent consultant</organization> <roles> - <role>Release Prime</role> + <role>2.0 Release Prime</role> <role>Java Developer</role> </roles> </developer> @@ -145,6 +145,10 @@ </contributor> <contributor> <name>Ola Berg</name> + <email></email> + </contributor> + <contributor> + <name>Mike Bowler</name> <email></email> </contributor> <contributor> 1.6 +56 -36 jakarta-commons/httpclient/xdocs/applications.xml Index: applications.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/applications.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- applications.xml 26 Jan 2003 07:01:01 -0000 1.5 +++ applications.xml 26 Jan 2003 16:36:24 -0000 1.6 @@ -1,38 +1,58 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="ISO-8859-1"?> + <document> - <properties> - <title>HttpClient Applications</title> - <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> - <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> - <author email="[EMAIL PROTECTED]">Jeff Dever</author> - <revision>$Id$</revision> - </properties> - - <body> - <section name="HttpClient Powered"> - <p> - The following projects and applications use the <em>HttpClient</em> - component. - </p> - <dl> - <dt><a href="http://jakarta.apache.org/slide">Jakarta Slide</a></dt> - <dd> - An open source Web-DAV client. <em>HttpClient</em> was originally - created by the Slide team. - </dd> - <dt><a href="http://jakarta.apache.org/commons/latka">Jakarta Commons: Latka</a></dt> - <dd> - An open source functional testing tool. - </dd> - <dt>Operator Simulation Tool</dt> - <dd> - An internal client operator simulation tool by <a href="http://www.nortelnetworks.com">Nortel Networks</a>. - </dd> - </dl> - <p> - To have your application listed, write to - <a href="mailto:[EMAIL PROTECTED]?subject=[httpclient]%20HTTP%20Client%20Powered">[EMAIL PROTECTED]</a>. - </p> - </section> - </body> + + <properties> + <title>HttpClient Applications</title> + <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> + <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> + <author email="[EMAIL PROTECTED]">Jeff Dever</author> + <revision>$Id$</revision> + </properties> + + <body> + + <section name="HttpClient Powered"> + <p> + The following projects and applications use <em>HttpClient</em>. + </p> + + <dl> + + <dt><a href="http://jakarta.apache.org/slide">Jakarta Slide</a></dt> + <dd> + An open source Web-DAV client. + </dd> + + <dt><a href="http://jakarta.apache.org/commons/latka">Jakarta Commons Latka</a></dt> + <dd> + An open source functional testing tool. + </dd> + + <dt>Operator Simulation Tool</dt> + <dd> + A testing tool for server side performance and scalability used internally by + <a href="http://www.nortelnetworks.com">Nortel Networks</a> inc. + </dd> + + <dt><a href="http://htmlunit.sourceforge.net/">HtmlUnit</a></dt> + <dd> + A testing tool for web based applications. + </dd> + + <dt><a href="http://jakarta.apache.org/cactus/">Jakarta Cactus</a></dt> + <dd> + A framework for unit testing server-side java code. + </dd> + + </dl> + + <p> + To have your application listed, write to + <a href="mailto:[EMAIL PROTECTED]?subject=[httpclient]%20HTTP%20Client%20Powered">[EMAIL PROTECTED]</a>. + </p> + </section> + + </body> + </document> 1.12 +6 -2 jakarta-commons/httpclient/xdocs/downloads.xml Index: downloads.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/downloads.xml,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- downloads.xml 26 Jan 2003 14:54:14 -0000 1.11 +++ downloads.xml 26 Jan 2003 16:36:24 -0000 1.12 @@ -1,5 +1,6 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="ISO-8859-1"?> <document> + <properties> <title>HttpClient Downloads</title> <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> @@ -9,6 +10,7 @@ </properties> <body> + <section name="Downloads"> <p> The following releases are available for download: @@ -32,5 +34,7 @@ <a href="http://jakarta.apache.org/site/cvsindex.html">CVS client</a>. </p> </section> + </body> + </document> 1.6 +58 -54 jakarta-commons/httpclient/xdocs/features.xml Index: features.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/features.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- features.xml 26 Jan 2003 14:54:14 -0000 1.5 +++ features.xml 26 Jan 2003 16:36:24 -0000 1.6 @@ -1,57 +1,61 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="ISO-8859-1"?> <document> - <properties> - <title>HttpClient Features</title> - <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> - <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> - <author email="[EMAIL PROTECTED]">Jeff Dever</author> - <revision>$Id$</revision> - </properties> - <body> - <section name="Features"> - <p> - <em>HttpClient</em> provides... - </p> - <ul> - <li> - an extensible framework for implementing HTTP-based methods, - including built-in support for the GET, POST, PUT, DELETE, HEAD, - and OPTIONS methods. - </li> - <br/>  - <li> - unconditional suppport for the client side of the HTTP/1.0 protocol, as defined in - <a href="http://www.w3.org/Protocols/rfc1945/rfc1945.txt">RFC 1945 - (<i>Hypertext Transfer Protocol - HTTP/1.0</i>)</a>. - </li> - <br/>  - <li> - unconditional suppport for the client side of the HTTP/1.1 protocol, as defined in - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616 - (<i>Hypertext Transfer Protocol - HTTP/1.1</i>)</a>. - </li> - <br/>  - <li> - support for HTTP Cookies, as defined in - <a href="http://www.w3.org/Protocols/rfc2109/rfc2109.txt">RFC 2109 - (<i>HTTP State Management System</i>)</a>. - </li> - <br/>  - <li> - support for Basic Digest and NTLM authentication, as defined in - <a href="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617 - (<i>HTTP Authentication: Basic and Digest Access Authentication</i>)</a>. - </li> - <br/>  - <li> - support for HTTPS (HTTP over SSL). - </li> - <br/>  - <li> - support for HTTP proxies. - </li> - </ul> - </section> - </body> + <properties> + <title>HttpClient Features</title> + <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> + <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> + <author email="[EMAIL PROTECTED]">Jeff Dever</author> + <revision>$Id$</revision> + </properties> + + <body> + + <section name="Features"> + <p> + <em>HttpClient</em> provides... + </p> + <ul> + <li> + an extensible framework for implementing HTTP-based methods, + including built-in support for the GET, POST, PUT, DELETE, HEAD, + and OPTIONS methods. + </li> + <br/>  + <li> + unconditional suppport for the client side of the HTTP/1.0 protocol, as defined in + <a href="http://www.w3.org/Protocols/rfc1945/rfc1945.txt">RFC 1945 + (<i>Hypertext Transfer Protocol - HTTP/1.0</i>)</a>. + </li> + <br/>  + <li> + unconditional suppport for the client side of the HTTP/1.1 protocol, as defined in + <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616 + (<i>Hypertext Transfer Protocol - HTTP/1.1</i>)</a>. + </li> + <br/>  + <li> + support for HTTP Cookies, as defined in + <a href="http://www.w3.org/Protocols/rfc2109/rfc2109.txt">RFC 2109 + (<i>HTTP State Management System</i>)</a>. + </li> + <br/>  + <li> + support for Basic Digest and NTLM authentication, as defined in + <a href="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617 + (<i>HTTP Authentication: Basic and Digest Access Authentication</i>)</a>. + </li> + <br/>  + <li> + support for HTTPS (HTTP over SSL). + </li> + <br/>  + <li> + support for HTTP proxies. + </li> + </ul> + </section> + + </body> + </document> 1.6 +65 -39 jakarta-commons/httpclient/xdocs/index.xml Index: index.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/index.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- index.xml 13 Oct 2002 18:55:02 -0000 1.5 +++ index.xml 26 Jan 2003 16:36:24 -0000 1.6 @@ -1,41 +1,67 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="ISO-8859-1"?> + <document> - <properties> - <title>HttpClient Home</title> - <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> - <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> - <author email="[EMAIL PROTECTED]">Jeff Dever</author> - <revision>$Id$</revision> - </properties> - - <body> - <section name="The HttpClient Component"> - <p> - The Hyper-Text Transfer Protocol (HTTP) is perhaps the most - significant protocol used on the Internet today. - Web services, network-enabled appliances and the growth - of network computing continue to expand the role of the HTTP - protocol beyond user-driven web browsers, and increase the - number of applications that may require HTTP support. - </p> - <p> - Although the - <tt><a href="http://java.sun.com/j2se/1.4.1/docs/api/java/net/package-summary.html">java.net</a></tt> - package provides basic support for accessing resources via HTTP, - it doesn't provide the full flexibility or functionality needed - by many applications. - The Jakarta Commons <em>HttpClient</em> component seeks to fill this void - by providing an efficient, up-to-date, and feature-rich package - implementing the client side of the most recent HTTP standards - and recommendations. - </p> - <p> - Designed for extension while providing robust support for the - base HTTP protocol, the <em>HttpClient</em> component may be of interest - to anyone building HTTP-aware client applications such as web - browsers, web service clients, or systems that leverage or extend - the HTTP protocol for distributed communication. - </p> - </section> - </body> + + <properties> + <title>HttpClient Home</title> + <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> + <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> + <author email="[EMAIL PROTECTED]">Jeff Dever</author> + <revision>$Id$</revision> + </properties> + + <body> + <section name="Introduction"> + <p> + The scope of the <em>HttpClient</em> component is a pure java + implementation of the HTTP protocol as defined by the following + and related specifications: + <ul> + <li><a href="http://www.ietf.org/rfc/rfc1945.txt">RFC1945</a> + Hypertext Transfer Protocol -- HTTP/1.0 + </li> + <li><a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a> + Hypertext Transfer Protocol -- HTTP/1.1 + </li> + <li><a href="http://www.ietf.org/rfc/rfc2617.txt">RFC2617</a> + HTTP Authentication: Basic and Digest Access Authentication + </li> + <li><a href="http://www.ietf.org/rfc/rfc2109.txt">RFC2109</a> + HTTP State Management Mechanism + </li> + </ul> + </p> + <p> The original source was donated by the Jakarta Slide project. </p> + </section> + + <section name="The HttpClient Component"> + <p> + The Hyper-Text Transfer Protocol (HTTP) is perhaps the most + significant protocol used on the Internet today. + Web services, network-enabled appliances and the growth + of network computing continue to expand the role of the HTTP + protocol beyond user-driven web browsers, and increase the + number of applications that may require HTTP support. + </p> + <p> + Although the + <tt><a href="http://java.sun.com/j2se/1.4.1/docs/api/java/net/package-summary.html">java.net</a></tt> + package provides basic support for accessing resources via HTTP, + it doesn't provide the full flexibility or functionality needed + by many applications. The Jakarta Commons <em>HttpClient</em> component seeks to fill this void + by providing an efficient, up-to-date, and feature-rich package + implementing the client side of the most recent HTTP standards + and recommendations. + </p> + <p> + Designed for extension while providing robust support for the + base HTTP protocol, the <em>HttpClient</em> component may be of interest + to anyone building HTTP-aware client applications such as web + browsers, web service clients, or systems that leverage or extend + the HTTP protocol for distributed communication. + </p> + </section> + + </body> + </document> 1.9 +7 -3 jakarta-commons/httpclient/xdocs/logging.xml Index: logging.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/logging.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- logging.xml 17 Dec 2002 01:07:59 -0000 1.8 +++ logging.xml 26 Jan 2003 16:36:24 -0000 1.9 @@ -1,5 +1,7 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="ISO-8859-1"?> + <document> + <properties> <title>HttpClient Logging Practices</title> <author email="[EMAIL PROTECTED]">Jeff Dever</author> @@ -7,6 +9,7 @@ </properties> <body> + <section name="Logging Practices"> <p> <em>HttpClient</em> utilizes the logging interface provided by the @@ -57,7 +60,8 @@ System.setProperty("org.apache.commons.logging.simplelog.log.org.apache.commons.httpclient", "trace");<br /> </blockquote> </p> - </section> + </body> + </document> 1.2 +7 -1 jakarta-commons/httpclient/xdocs/navigation.xml Index: navigation.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/navigation.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- navigation.xml 26 Jan 2003 14:54:14 -0000 1.1 +++ navigation.xml 26 Jan 2003 16:36:24 -0000 1.2 @@ -1,7 +1,12 @@ <?xml version="1.0" encoding="ISO-8859-1"?> + <project name="HttpClient"> - <title>HttpClient</title> + <properties> + <title>HttpClient</title> + <author email="[EMAIL PROTECTED]">Jeff Dever</author> + <revision>$Id$</revision> + </properties> <body> <menu name="Overview"> @@ -14,4 +19,5 @@ <item name="Release Process" href="/releases.html"/> </menu> </body> + </project> 1.13 +99 -98 jakarta-commons/httpclient/xdocs/news.xml Index: news.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/news.xml,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- news.xml 26 Jan 2003 07:01:01 -0000 1.12 +++ news.xml 26 Jan 2003 16:36:24 -0000 1.13 @@ -1,100 +1,101 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="ISO-8859-1"?> <document> - <properties> - <title>HttpClient News</title> - <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> - <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> - <author email="[EMAIL PROTECTED]">Jeff Dever</author> - <revision>$Id$</revision> - </properties> - - <body> - - <section name="25 January 2003 - HttpClient 2.0 Alpha 2 released"> - <p>After many months and a great resurgence of developers, the new build - of <em>HttpClient</em> is finally here. The new group of developers has done - extensive refactoring to move the project along the new vision. - The code base has reached a significant level of maturity and we - expect that the beta builds will come quickly and that the - final release of 2.0 is not far away!</p> - - <p>Also check out the new <em>HttpClient</em> logo on the maven generated - <a href="http://jakarta.apache.org/commons/httpclient/">website</a>! - </p> - </section> - - <section name="21 December, 2002 - Welcome new committer Oleg (Olegolas) Kalnichevski"> - <p>Oleg is the first committer to be voted in on the dedicated httpclient - mailing list. Welcome to the fellowship Oleg! - </p> - </section> - - <section name="3 December, 2002 - HttpClient/HttpMultiClient merger"> - <p>The initial merger of the top level classes HttpClient and HttpMultiClient - is complete. Thanks for the patches and hard work from everyone - particularly to Michale Becke for supplying the primary patch. - </p> - </section> - - <section name="3 October, 2002 - commons-httpclient-dev mailing list"> - <p>The mailing list was renamed to be <b>commons-httpclient-dev</b>. - Sorry for the confusion. - </p> - <p> - If you wish to subscribe to this new mailing list, you can send mail to - <a href="mailto:[EMAIL PROTECTED]"> - [EMAIL PROTECTED]</a> - </p> - </section> - - <section name="2 October, 2002 - httpclient-dev mailing list created"> - <p>There has been so much traffic on the commons-dev mailing list - specific to HttpClient, that a new mailing list was created - to partition the traffic. - </p> - </section> - - <section name="12 July, 2002 - HttpClient 2.0 Release Planning"> - <p>The <em>HttpClient</em> project has go through some very active - development leading up to Alpha 1 last year, but unfortunately - lost momentum shortly after that. There is now renewed interest - and greatly increased activity on the dev-commons mailing list. - The committers and contributors are working on a new release plan - for 2.0. - </p> - <p>The 2.0 release plan is expected to be posted to the mailing list for - review by July 22, 2002. - </p> - </section> - - <section name="5 October, 2001 - HttpClient 2.0 Alpha 1 Released"> - <p> - The <em>HttpClient</em> revision 2.0 alpha 1 is - available at - <a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-httpclient/v2.0/"> - http://jakarta.apache.org/builds/jakarta-commons/release/commons-httpclient/v2.0/</a>. - </p> - </section> - - <section name="25 April, 2001 - HttpClient Proposal Accepted"> - <p> - The <em>HttpClient</em> <a href="proposal.html">proposal</a> - has been accepted by the - <a href="http://jakarta.apache.org/commons">Jakarta Commons</a> - team and the source has been moved into the - <a href="http://cvs.apache.org/viewcvs/jakarta-commons/httpclient/">CVS repository</a>. - </p> - </section> - - <section name="18 April, 2001 - HttpClient Proposed"> - <p> - <em>HttpClient</em>, originally developed by the - <a href="http://jakarta.apache.org/slide">Jakarta Slide</a> - team, has been - <a href="http://www.mail-archive.com/jakarta-commons@jakarta.apache.org/msg01153.html">proposed</a> - as a <a href="http://jakarta.apache.org/commons">Jakarta Commons</a> - component. - </p> - </section> - </body> + + <properties> + <title>HttpClient News</title> + <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> + <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> + <author email="[EMAIL PROTECTED]">Jeff Dever</author> + <revision>$Id$</revision> + </properties> + + <body> + + <section name="25 January 2003 - HttpClient 2.0 Alpha 2 released"> + <p>After many months and a great resurgence of developers, the new build + of <em>HttpClient</em> is finally here. The new group of developers has done + extensive refactoring to move the project along the new vision. + The code base has reached a significant level of maturity and we + expect that the beta builds will come quickly and that the + final release of 2.0 is not far away!</p> + + <p>Also check out the new <em>HttpClient</em> logo on the maven generated + <a href="http://jakarta.apache.org/commons/httpclient/">website</a>! + </p> + </section> + + <section name="21 December, 2002 - Welcome new committer Oleg (Olegolas) Kalnichevski"> + <p>Oleg is the first committer to be voted in on the dedicated httpclient + mailing list. Welcome to the fellowship Oleg! + </p> + </section> + + <section name="3 December, 2002 - HttpClient/HttpMultiClient merger"> + <p>The initial merger of the top level classes HttpClient and HttpMultiClient + is complete. Thanks for the patches and hard work from everyone + particularly to Michale Becke for supplying the primary patch. + </p> + </section> + + <section name="3 October, 2002 - commons-httpclient-dev mailing list"> + <p>The mailing list was renamed to be <b>commons-httpclient-dev</b>. + Sorry for the confusion. + </p> + <p> + If you wish to subscribe to this new mailing list, you can send mail to + <a href="mailto:[EMAIL PROTECTED]"> + [EMAIL PROTECTED]</a> + </p> + </section> + + <section name="2 October, 2002 - httpclient-dev mailing list created"> + <p>There has been so much traffic on the commons-dev mailing list + specific to HttpClient, that a new mailing list was created + to partition the traffic. + </p> + </section> + + <section name="12 July, 2002 - HttpClient 2.0 Release Planning"> + <p>The <em>HttpClient</em> project has go through some very active + development leading up to Alpha 1 last year, but unfortunately + lost momentum shortly after that. There is now renewed interest + and greatly increased activity on the dev-commons mailing list. + The committers and contributors are working on a new release plan + for 2.0. + </p> + <p>The 2.0 release plan is expected to be posted to the mailing list for + review by July 22, 2002. + </p> + </section> + + <section name="5 October, 2001 - HttpClient 2.0 Alpha 1 Released"> + <p> + The <em>HttpClient</em> revision 2.0 alpha 1 is + available at + <a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-httpclient/v2.0/"> + http://jakarta.apache.org/builds/jakarta-commons/release/commons-httpclient/v2.0/</a>. + </p> + </section> + + <section name="25 April, 2001 - HttpClient Proposal Accepted"> + <p> + The <em>HttpClient</em> <a href="proposal.html">proposal</a> + has been accepted by the + <a href="http://jakarta.apache.org/commons">Jakarta Commons</a> + team and the source has been moved into the + <a href="http://cvs.apache.org/viewcvs/jakarta-commons/httpclient/">CVS repository</a>. + </p> + </section> + + <section name="18 April, 2001 - HttpClient Proposed"> + <p> + <em>HttpClient</em>, originally developed by the + <a href="http://jakarta.apache.org/slide">Jakarta Slide</a> + team, has been + <a href="http://www.mail-archive.com/jakarta-commons@jakarta.apache.org/msg01153.html">proposed</a> + as a <a href="http://jakarta.apache.org/commons">Jakarta Commons</a> + component. + </p> + </section> + </body> </document> 1.9 +127 -122 jakarta-commons/httpclient/xdocs/overview.xml Index: overview.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/overview.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- overview.xml 21 Nov 2002 09:58:20 -0000 1.8 +++ overview.xml 26 Jan 2003 16:36:24 -0000 1.9 @@ -1,126 +1,131 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="ISO-8859-1"?> + <document> - <properties> - <title>Overview</title> - <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> - <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> - <author email="[EMAIL PROTECTED]">Jeff Dever</author> - <revision>$Id$</revision> - </properties> - - <body> - <section name="Scope"> - <p> - The <em>HttpClient</em> component supports the client-side of - <a href="http://www.w3.org/Protocols/rfc1945/rfc1945.txt">RFC 1945 (HTTP/1.0)</a> and - <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616 (HTTP/1.1)</a>, - several related specifications - (<a href="http://www.w3.org/Protocols/rfc2109/rfc2109.txt">RFC 2109 (Cookies)</a>, - <a href="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617 (HTTP Authentication)</a>, - etc.), and provides a framework by which new request types (methods) or HTTP - extensions can be created easily. - </p> - </section> - <section name="The org.apache.commons.httpclient Package"> - <p> - The basis for the abstraction is provided by three primary - types: - </p> - <ul><dl> - <dt><a href="./api/org/apache/commons/httpclient/HttpConnection.html">HttpConnection</a></dt> - <dd> - represents a network connection to some HTTP host. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/HttpMethod.html">HttpMethod</a></dt> - <dd> - represents a request to be made over some - <tt>HttpConnection</tt> and contains the server's response. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/HttpState.html">HttpState</a></dt> - <dd> - contains the HTTP attributes that may persist from - request to request, such as cookies and authentication - credentials. - </dd> - </dl></ul> - <p> - and several simple bean-style classes: - </p> - <ul><dl> - <dt><a href="./api/org/apache/commons/httpclient/Cookie.html">Cookie</a></dt> - <dd> - represents HTTP cookie. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/Credentials.html">Credentials</a></dt> - <dd> - an interface representing a set of authentication credentials. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/Header.html">Header</a></dt> - <dd> - represents an HTTP request or response header. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/HeaderElement.html">HeaderElement</a></dt> - <dd> - represents a single element of a multi-part header. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/UsernamePasswordCredentials.html">UsernamePasswordCredentials</a></dt> - <dd> - a username and password pair. - </dd> - </dl></ul> - <p> - <a href="./api/org/apache/commons/httpclient/HttpClient.html">HttpClient</a> - provides a simple "user-agent" implementation that will suffice for many - applications, but whose use is not required. - </p> - <p> - <em>HttpClient</em> also provides several utilities that may be - useful when extending the framework: - </p> - <ul><dl> - <dt><a href="./api/org/apache/commons/httpclient/HttpMethodBase.html">HttpMethodBase</a></dt> - <dd> - an abstract base implementation of <tt>HttpMethod</tt>, - which may be extended to create new method types or - to support additional HTTP protocol features. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/HttpStatus.html">HttpStatus</a></dt> - <dd> - an enumeration of HttpStatus codes. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/RequestOutputStream.html">RequestOutputStream</a></dt> - <dd> - an <tt>OutputStream</tt> wrapper supporting the "chunked" - transfer encoding. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/ResponseInputStream.html">ResponseInputStream</a></dt> - <dd> - an <tt>InputStream</tt> wrapper supporting the "chunked" - transfer encoding. - </dd> - <dt><a href="./api/org/apache/commons/httpclient/URIUtil.html">URIUtil</a></dt> - <dd> - provides utilities for encoding and decoding URI's in the - <tt>%HH</tt> format. - </dd> - </dl></ul> - </section> - <section name="The org.apache.commons.httpclient.methods Package"> - <p> - The - <a href="./api/org/apache/commons/httpclient/methods/package-summary.html">org.apache.commons.httpclient.methods</a> - package provides <tt>HttpMethod</tt> implementations of the most - commonly used HTTP methods, including - <a href="./api/org/apache/commons/httpclient/methods/GetMethod.html">GET</a>, - <a href="./api/org/apache/commons/httpclient/methods/PostMethod.html">POST</a>, - <a href="./api/org/apache/commons/httpclient/methods/PutMethod.html">PUT</a>, - <a href="./api/org/apache/commons/httpclient/methods/OptionsMethod.html">OPTIONS</a>, - <a href="./api/org/apache/commons/httpclient/methods/HeadMethod.html">HEAD</a> - and - <a href="./api/org/apache/commons/httpclient/methods/DeleteMethod.html">DELETE</a>. - </p> - </section> - </body> + + <properties> + <title>Overview</title> + <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> + <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> + <author email="[EMAIL PROTECTED]">Jeff Dever</author> + <revision>$Id$</revision> + </properties> + + <body> + + <section name="Scope"> + <p> + The <em>HttpClient</em> component supports the client-side of + <a href="http://www.w3.org/Protocols/rfc1945/rfc1945.txt">RFC 1945 (HTTP/1.0)</a> and + <a href="http://www.w3.org/Protocols/rfc2616/rfc2616.txt">RFC 2616 (HTTP/1.1)</a>, + several related specifications + (<a href="http://www.w3.org/Protocols/rfc2109/rfc2109.txt">RFC 2109 (Cookies)</a>, + <a href="http://www.ietf.org/rfc/rfc2617.txt">RFC 2617 (HTTP Authentication)</a>, + etc.), and provides a framework by which new request types (methods) or HTTP + extensions can be created easily. + </p> + </section> + <section name="The org.apache.commons.httpclient Package"> + <p> + The basis for the abstraction is provided by three primary + types: + </p> + <ul><dl> + <dt><a href="./api/org/apache/commons/httpclient/HttpConnection.html">HttpConnection</a></dt> + <dd> + represents a network connection to some HTTP host. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/HttpMethod.html">HttpMethod</a></dt> + <dd> + represents a request to be made over some + <tt>HttpConnection</tt> and contains the server's response. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/HttpState.html">HttpState</a></dt> + <dd> + contains the HTTP attributes that may persist from + request to request, such as cookies and authentication + credentials. + </dd> + </dl></ul> + <p> + and several simple bean-style classes: + </p> + <ul><dl> + <dt><a href="./api/org/apache/commons/httpclient/Cookie.html">Cookie</a></dt> + <dd> + represents HTTP cookie. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/Credentials.html">Credentials</a></dt> + <dd> + an interface representing a set of authentication credentials. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/Header.html">Header</a></dt> + <dd> + represents an HTTP request or response header. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/HeaderElement.html">HeaderElement</a></dt> + <dd> + represents a single element of a multi-part header. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/UsernamePasswordCredentials.html">UsernamePasswordCredentials</a></dt> + <dd> + a username and password pair. + </dd> + </dl></ul> + <p> + <a href="./api/org/apache/commons/httpclient/HttpClient.html">HttpClient</a> + provides a simple "user-agent" implementation that will suffice for many + applications, but whose use is not required. + </p> + <p> + <em>HttpClient</em> also provides several utilities that may be + useful when extending the framework: + </p> + <ul><dl> + <dt><a href="./api/org/apache/commons/httpclient/HttpMethodBase.html">HttpMethodBase</a></dt> + <dd> + an abstract base implementation of <tt>HttpMethod</tt>, + which may be extended to create new method types or + to support additional HTTP protocol features. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/HttpStatus.html">HttpStatus</a></dt> + <dd> + an enumeration of HttpStatus codes. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/RequestOutputStream.html">RequestOutputStream</a></dt> + <dd> + an <tt>OutputStream</tt> wrapper supporting the "chunked" + transfer encoding. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/ResponseInputStream.html">ResponseInputStream</a></dt> + <dd> + an <tt>InputStream</tt> wrapper supporting the "chunked" + transfer encoding. + </dd> + <dt><a href="./api/org/apache/commons/httpclient/URIUtil.html">URIUtil</a></dt> + <dd> + provides utilities for encoding and decoding URI's in the + <tt>%HH</tt> format. + </dd> + </dl></ul> + </section> + <section name="The org.apache.commons.httpclient.methods Package"> + <p> + The + <a href="./api/org/apache/commons/httpclient/methods/package-summary.html">org.apache.commons.httpclient.methods</a> + package provides <tt>HttpMethod</tt> implementations of the most + commonly used HTTP methods, including + <a href="./api/org/apache/commons/httpclient/methods/GetMethod.html">GET</a>, + <a href="./api/org/apache/commons/httpclient/methods/PostMethod.html">POST</a>, + <a href="./api/org/apache/commons/httpclient/methods/PutMethod.html">PUT</a>, + <a href="./api/org/apache/commons/httpclient/methods/OptionsMethod.html">OPTIONS</a>, + <a href="./api/org/apache/commons/httpclient/methods/HeadMethod.html">HEAD</a> + and + <a href="./api/org/apache/commons/httpclient/methods/DeleteMethod.html">DELETE</a>. + </p> + </section> + + </body> + </document> 1.5 +112 -108 jakarta-commons/httpclient/xdocs/proposal.xml Index: proposal.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/proposal.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- proposal.xml 19 Jul 2002 22:32:45 -0000 1.4 +++ proposal.xml 26 Jan 2003 16:36:24 -0000 1.5 @@ -1,110 +1,114 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="ISO-8859-1"?> + <document> - <properties> - <title>Proposal</title> - <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> - <author email="[EMAIL PROTECTED]">Remy Maucherat</author> - <author email="[EMAIL PROTECTED]">Jeff Dever</author> - <revision>$Id$</revision> - </properties> - -<body> - -<section name="Rationale"> -<p>HTTP is the main protocol used today on the internet. Although the JDK -includes basic support for building HTTP-aware client applications, it -doesn't provide the flexibility or ease of use needed for many projects. -</p> - -<p>A Commons package would give committers an opportunity to coordinate -their efforts to create and maintain a efficient, feature-rich package -under the ASF license.</p> -</section> - -<section name="Scope of the Package"> -<p>The package shall create and maintain a Java library implementing the client -side of the HTTP/1.1 protocol, as defined in RFC 2616 and RFC 2617. -</p> - -<p> -The package should : -<ul> -<li>Have an API which should be as simple to use as possible</li> -<li>Be as easy to extend as possible</li> -<li>Provide unconditional support for HTTP/1.1</li> -</ul> -The package is quite different from the HTTP client provided as part of the JDK -(java.net.HttpURLConnection), as it focuses on the HTTP methods being sent -(instead of making that transparent to the user), and generally allows more -interaction with the lower level connection. The JDK client is also not very -intuitive to use. -</p> - -<p> -The package is used by the Slide project to build a WebDAV client -library supporting WebDAV level 2. -</p> -</section> - -<section name="Interaction With Other Packages"> -<p><em>HttpClient</em> relies on: -</p> - -<ul> - <li>Java Development Kit (Version 1.1 or later; 1.3 or later recommended) - </li> -</ul> -</section> - -<section name="Initial Source of the Package"> -<p>The initial codebase exists in the jakarta-slide cvs tree under the -org.apache.webdav.lib package. It would be moved to commons under -the http subdirectory. -</p> - -<p>The proposed package name for the new component is -org.apache.commons.httpclient. -</p> -</section> - -<section name="Required Jakarta-Commons Resources"> -<ul> - -<li>CVS Repository - New directory <code>httpclient</code> in the -<code>jakarta-commons</code> CVS repository.</li> - -<li>Initial Committers - The list is provided below. Some of the proposed -committers are not currently jakarta-commons committers, but are committers -on the jakarta-slide project, and contributed to this component.</li> - -<li>Mailing List - Discussions will take place on the general -<em>[EMAIL PROTECTED]</em> mailing list. To help list -subscribers identify messages of interest, it is suggested that the -message subject of messages about this component be prefixed with -[httpclient].</li> - -<li>Bugzilla - New component "HttpClient" under the "Commons" product -category, with appropriate version identifiers as needed.</li> - -<li>Jyve FAQ - New category "commons-httpclient" (when available).</li> -</ul> -</section> - -<section name="Initial Committers"> -<p>The initial committers on the <em>HttpClient</em> component shall be:</p> - -<ul> - <li>Remy Maucherat.</li> - <li>B.C.Holmes</li> - <li>Sung-Gu Park</li> - <li>Juergen Pill</li> - <li>Costin Manolache</li> -</ul> -</section> -<section name="Proposal ChangeLog"> - <p>2002/07/19 - Replace uses of <em>HTTP Client</em> with <em>HttpClient</em> - for consistency. - </p> -</section> -</body> + + <properties> + <title>Proposal</title> + <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> + <author email="[EMAIL PROTECTED]">Remy Maucherat</author> + <author email="[EMAIL PROTECTED]">Jeff Dever</author> + <revision>$Id$</revision> + </properties> + + <body> + + <section name="Rationale"> + <p>HTTP is the main protocol used today on the internet. Although the JDK + includes basic support for building HTTP-aware client applications, it + doesn't provide the flexibility or ease of use needed for many projects. + </p> + + <p>A Commons package would give committers an opportunity to coordinate + their efforts to create and maintain a efficient, feature-rich package + under the ASF license.</p> + </section> + + <section name="Scope of the Package"> + <p>The package shall create and maintain a Java library implementing the client + side of the HTTP/1.1 protocol, as defined in RFC 2616 and RFC 2617. + </p> + + <p> + The package should : + <ul> + <li>Have an API which should be as simple to use as possible</li> + <li>Be as easy to extend as possible</li> + <li>Provide unconditional support for HTTP/1.1</li> + </ul> + The package is quite different from the HTTP client provided as part of the JDK + (java.net.HttpURLConnection), as it focuses on the HTTP methods being sent + (instead of making that transparent to the user), and generally allows more + interaction with the lower level connection. The JDK client is also not very + intuitive to use. + </p> + + <p> + The package is used by the Slide project to build a WebDAV client + library supporting WebDAV level 2. + </p> + </section> + + <section name="Interaction With Other Packages"> + <p><em>HttpClient</em> relies on: + </p> + + <ul> + <li>Java Development Kit (Version 1.1 or later; 1.3 or later recommended) + </li> + </ul> + </section> + + <section name="Initial Source of the Package"> + <p>The initial codebase exists in the jakarta-slide cvs tree under the + org.apache.webdav.lib package. It would be moved to commons under + the http subdirectory. + </p> + + <p>The proposed package name for the new component is + org.apache.commons.httpclient. + </p> + </section> + + <section name="Required Jakarta-Commons Resources"> + <ul> + + <li>CVS Repository - New directory <code>httpclient</code> in the + <code>jakarta-commons</code> CVS repository.</li> + + <li>Initial Committers - The list is provided below. Some of the proposed + committers are not currently jakarta-commons committers, but are committers + on the jakarta-slide project, and contributed to this component.</li> + + <li>Mailing List - Discussions will take place on the general + <em>[EMAIL PROTECTED]</em> mailing list. To help list + subscribers identify messages of interest, it is suggested that the + message subject of messages about this component be prefixed with + [httpclient].</li> + + <li>Bugzilla - New component "HttpClient" under the "Commons" product + category, with appropriate version identifiers as needed.</li> + + <li>Jyve FAQ - New category "commons-httpclient" (when available).</li> + </ul> + </section> + + <section name="Initial Committers"> + <p>The initial committers on the <em>HttpClient</em> component shall be:</p> + + <ul> + <li>Remy Maucherat</li> + <li>B.C.Holmes</li> + <li>Sung-Gu Park</li> + <li>Juergen Pill</li> + <li>Costin Manolache</li> + </ul> + </section> + <section name="Proposal ChangeLog"> + <p>2002/07/19 - Replace uses of <em>HTTP Client</em> with <em>HttpClient</em> + for consistency. + </p> + </section> + + </body> + </document> 1.3 +2 -1 jakarta-commons/httpclient/xdocs/releases.xml Index: releases.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/releases.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- releases.xml 25 Jan 2003 20:46:18 -0000 1.2 +++ releases.xml 26 Jan 2003 16:36:24 -0000 1.3 @@ -1,4 +1,4 @@ -<?xml version="1.0"?> +<?xml version="1.0" encoding="ISO-8859-1"?> <document> @@ -6,6 +6,7 @@ <title>Creating HttpClient Package Releases</title> <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> <author email="[EMAIL PROTECTED]">Jeff Dever</author> + <revision>$Id$</revision> </properties> <body> 1.17 +56 -90 jakarta-commons/httpclient/xdocs/status.xml Index: status.xml =================================================================== RCS file: /home/cvs/jakarta-commons/httpclient/xdocs/status.xml,v retrieving revision 1.16 retrieving revision 1.17 diff -u -r1.16 -r1.17 --- status.xml 25 Jan 2003 06:48:53 -0000 1.16 +++ status.xml 26 Jan 2003 16:36:24 -0000 1.17 @@ -1,95 +1,61 @@ <?xml version="1.0" encoding="ISO-8859-1"?> + <document> - <properties> - <title>Status</title> - <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> - <author email="[EMAIL PROTECTED]">Remy Maucherat</author> - <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> - <author email="[EMAIL PROTECTED]">Jeff Dever</author> - <revision>$Id$</revision> - </properties> - - <body> - <section name="Introduction"> - <p> - The scope of the <em>HttpClient</em> component is a pure java - implementation of the HTTP protocol as defined by the following - and related specifications: - <ul> - <li><a href="http://www.ietf.org/rfc/rfc1945.txt">RFC1945</a> - Hypertext Transfer Protocol -- HTTP/1.0 - </li> - <li><a href="http://www.ietf.org/rfc/rfc2616.txt">RFC2616</a> - Hypertext Transfer Protocol -- HTTP/1.1 - </li> - <li><a href="http://www.ietf.org/rfc/rfc2617.txt">RFC2617</a> - HTTP Authentication: Basic and Digest Access Authentication - </li> - <li><a href="http://www.ietf.org/rfc/rfc2109.txt">RFC2109</a> - HTTP State Management Mechanism - </li> - </ul> - </p> - <p> - The original source was donated by the Jakarta Slide project. - </p> - </section> - - <section name="Dependencies"> - <p> - <em>HttpClient</em> is dependent upon the following - external components for run-time use: - </p> - <dl> - <dt><a href="http://java.sun.com/j2se">Java Development Kit</a></dt> - <dd> - (Version 1.2 or later. Note that the "external" interface of - <em>HttpClient</em> is JDK 1.1 compatible, hence a JDK 1.1 compatible - distribution could be created.) - </dd> - <dt><a href="http://jakarta.apache.org/commons/logging.html">Commons-Logging</a></dt> - <dd><em>HttpClient</em> supports Jakarta-Commons logging.</dd> - </dl> - - <p> - The following external components <b>may</b> be used with <em>HttpClient</em> - to support certain optional features: - </p> - <dl> - <dt><a href="http://java.sun.com/products/jsse">Java Secure Socket Extension</a></dt> - <dd>(Version 1.0.2 or later)<br/>Only needed if you're using HTTPS.</dd> - </dl> - <p> - The following tools are recommended for those who wish to develop the - <em>HttpClient</em> component:</p> - <dl> - <dt><a href="http://jakarta.apache.org/ant">Jakarta Ant</a></dt> - <dd>(Version 1.5 or later)<br/>To run the provided build scripts.</dd> - <dt><a href="http://www.junit.org/">JUnit Unit Testing Framework</a></dt> - <dd>(Version 3.8.1 or later)<br/>To run the provided unit tests.</dd> - <dt><a href="http://jakarta.apache.org/maven/">Maven Project Management</a></dt> - <dd>(Version 1.0 beta 7 or later)<br/>To automate some project tasks.</dd> - </dl> - </section> - - <section name="Release Info"> - <p>Current Release: <a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-httpclient/v2.0/">Release 2.0 Alpha 2</a></p> - <p>Planned Next Release: 2.0 Beta 1</p> - </section> - - <section name="Action Items"> - <p>Like to help? There are a number of action items to work on. - We make extensive use of <a href="http://issues.apache.org/bugzilla/"> - Bugzilla</a> where <em>HttpClient</em> can be found as a *component* - of the <b>Commons</b> *program*. We also mark <tt>//TODO</tt> - and <tt>//FIXME</tt> comments in the source files, so they can be - easily found by grep or by the <a href="checkstyle-report.html">Checkstyle report</a></p> - <p>To volunteer for a task, send an email to - <a href="mailto:[EMAIL PROTECTED]"> - [EMAIL PROTECTED]</a>. - </p> - </section> + <properties> + <title>Status</title> + <author email="[EMAIL PROTECTED]">Commons Documentation Team</author> + <author email="[EMAIL PROTECTED]">Remy Maucherat</author> + <author email="[EMAIL PROTECTED]">Rodney Waldhoff</author> + <author email="[EMAIL PROTECTED]">Jeff Dever</author> + <revision>$Id$</revision> + </properties> + + <body> + + <section name="Current Status"> + <p>For all current contributors and anyone wishing to contribute to HttpClient, + we are now in the Beta 1 development stage.</p> + + <p>There is currently a rather complete list of bugs in + <a href="http://nagoya.apache.org/bugzilla/">bugzilla</a> now. To find + them, do a query for the *Commons* project, *HttpClient* component, and + target milestone *2.0 Beta 1*.</p> + + <p>There are some + <a href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=16416">strightforward</a> tasks, some + <a href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=10807">complex</a> tasks, and some + <a href="http://nagoya.apache.org/bugzilla/show_bug.cgi?id=16429">long and tedious</a> tasks + somthing for everyone. All of the bugs that are marked for milestone Beta 1 will have to be + closed before a Beta 1 drop can be released.</p> + + <p>If you are interested in working on any task, please reassign the bug to yourself and add the + list address to the cc field ([EMAIL PROTECTED]). When you have a + patch, it can be attached directly to the bug. Any discussion can take place on the mailing list.</p> + + <p>While the Alpha 2 release was done just yesterday, it was 14 months from the previous Alpha 1 release. + While there were many reasons for the previous delay, none of those obstacles are in our way for the i + Beta 1 drop, which I think many of us would like to see within the month of February.</p> + </section> + + <section name="Release Info"> + <p>Current Release: <a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-httpclient/v2.0/"> + Release 2.0 Alpha 2</a></p> + <p>Planned Next Release: 2.0 Beta 1</p> + </section> + + <section name="Action Items"> + <p>Like to help? There are a number of action items to work on. + We make extensive use of <a href="http://issues.apache.org/bugzilla/"> Bugzilla</a> + where <em>HttpClient</em> can be found as a *component* of the <b>Commons</b> *program*. + We also mark <tt>//TODO</tt> and <tt>//FIXME</tt> comments in the source files, so they can be + easily found by grep or by the <a href="checkstyle-report.html">Checkstyle report</a></p> + <p>To volunteer for a task, send an email to + <a href="mailto:[EMAIL PROTECTED]"> + [EMAIL PROTECTED]</a>. + </p> + </section> + + </body> - </body> </document>
-- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>