<?xml version="1.0" encoding="ISO-8859-1"?>

<document>

  <properties>
    <title>HttpClient User Guide</title>
    <author email="dev@hc.apache.org">HttpComponents Team</author>
    <author email="adrian@ephox.com">Adrian Sutton</author>
    <revision>$Id$</revision>
  </properties>

  <body>
    <section name="End of life">
      <p>
      The Commons HttpClient project is now end of life, and is no longer being developed. 
      It has been replaced by the <a href="../">Apache HttpComponents</a> project
      in its <a href="../httpcomponents-client-ga">HttpClient</a> and <a href="../httpcomponents-core-ga/">HttpCore</a> modules,
      which offer better performance and more flexibility.
      </p>
    </section>

    <section name="User Guide">
      <p>The HttpClient user guide is designed to help developers use
      HttpClient in their applications.  While the concept of a user guide
      being for developers may seem strange, the term developer is
      already in use for people helping to develop HttpClient.</p>

      <p>If you are new to HttpClient, make sure to work through the
         <a href="tutorial.html">Tutorial</a> and have a look at the
<a href="http://svn.apache.org/viewvc/httpcomponents/oac.hc3x/trunk/src/examples/">Sample Code</a>.
         Before reporting problems, read about
         <a href="troubleshooting.html">Trouble Shooting</a>
      </p>
    </section>

    <section name="Overview">
      <table>
        <tr>
          <th>Document</th>
          <th>Description</th>
        </tr>
        <tr>
          <td><a href="authentication.html">Authentication Guide</a></td>
          <td>This document describes the authentication schemes supported by
          HttpClient and how to use them.</td>
        </tr>
        <tr>
          <td><a href="charencodings.html">Character Encodings</a></td>
          <td>Guidelines for correctly detecting the
          character encoding to use when sending and receiving data with
          HttpClient.</td>
        </tr>
        <tr>
          <td><a href="redirects.html">Redirects Handling</a></td>
          <td>Provide sample code for custom redirects handling.</td>
        </tr>
        <tr>
          <td><a href="exception-handling.html">Exception Handling</a></td>
          <td>This document outlines common types of errors that the users may
              encounter and describes the exception handling framework used
              by HttpClient.</td>
        </tr>
        <tr>
          <td><a href="logging.html">Logging Guide</a></td>
          <td>This document describes the logging mechanism used by HttpClient
          and how to control what it outputs.</td>
        </tr>
        <tr>
          <td><a href="methods.html">Methods</a></td>
          <td>This document describes the various methods
          that are provided by HttpClient and how to use them.</td>
        </tr>
        <tr>
          <td><a href="performance.html">Optimization Guide</a></td>
          <td>This document outlines HttpClient performance optimization techniques.</td>
        </tr>
        <tr>
          <td><a href="preference-api.html">Preference Architecture</a></td>
          <td>This document explains the preference architecture used by HttpClient
             and enumerates standard HttpClient parameters.</td>
        </tr>
        <tr>
          <td><a href="http://svn.apache.org/viewvc/httpcomponents/oac.hc3x/trunk/src/examples/">Sample Code</a></td>
          <td>This is a link to the sample code for using HttpClient that is
          stored in the Subversion repository and is available in source releases
          of HttpClient.</td>
        </tr>
        <tr>
          <td><a href="troubleshooting.html">Trouble Shooting</a></td>
          <td>This document provides hints and tips for debugging problems with
          HttpClient.</td>
        </tr>
        <tr>
          <td><a href="tutorial.html">Tutorial</a></td>
          <td>This document provides a simple introductory tutorial for new users
          of HttpClient.</td>
        </tr>
      </table>
    </section>
  </body>
</document>
