rwaldhoff    01/08/20 10:26:45

  Modified:    httpclient Tag: rlwrefactoring build.properties.sample
                        build.xml README.txt STATUS.html
  Added:       httpclient/xdocs/images Tag: rlwrefactoring jakarta-logo.gif
                        logo.jpg
               httpclient/xdocs Tag: rlwrefactoring applications.xml
                        contributors.xml downloads.xml features.xml
                        index.xml news.xml proposal.xml status.xml
               httpclient/docs Tag: rlwrefactoring BUILDING.txt TESTING.txt
                        USING_HTTPS.txt
               httpclient/xdocs/stylesheets Tag: rlwrefactoring project.xml
                        temp.xsl
  Log:
  * New and updated documentation (anakia based until something better comes along)
  * Added xdoc task to build.xml to generate documentation
  * Added anakia related properties to build.props.sample
  * Rearranged build.xml to clean up where bits and pieces had been added all over the 
place
  
  Revision  Changes    Path
  No                   revision
  
  
  No                   revision
  
  
  1.1.2.1   +51 -0     jakarta-commons/httpclient/xdocs/images/Attic/jakarta-logo.gif
  
        <<Binary file>>
  
  
  1.1.2.1   +38 -0     jakarta-commons/httpclient/xdocs/images/Attic/logo.jpg
  
        <<Binary file>>
  
  
  No                   revision
  
  
  No                   revision
  
  
  1.1.2.1   +33 -0     jakarta-commons/httpclient/xdocs/Attic/applications.xml
  
  
  
  
  1.1.2.1   +28 -0     jakarta-commons/httpclient/xdocs/Attic/contributors.xml
  
  
  
  
  1.1.2.1   +23 -0     jakarta-commons/httpclient/xdocs/Attic/downloads.xml
  
  
  
  
  1.1.2.1   +47 -0     jakarta-commons/httpclient/xdocs/Attic/features.xml
  
  
  
  
  1.1.2.1   +40 -0     jakarta-commons/httpclient/xdocs/Attic/index.xml
  
  
  
  
  1.1.2.1   +29 -0     jakarta-commons/httpclient/xdocs/Attic/news.xml
  
  
  
  
  1.1.2.1   +104 -0    jakarta-commons/httpclient/xdocs/Attic/proposal.xml
  
  
  
  
  1.1.2.1   +142 -0    jakarta-commons/httpclient/xdocs/Attic/status.xml
  
  
  
  
  No                   revision
  
  
  No                   revision
  
  
  1.4.2.2   +12 -2     jakarta-commons/httpclient/build.properties.sample
  
  Index: build.properties.sample
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/httpclient/build.properties.sample,v
  retrieving revision 1.4.2.1
  retrieving revision 1.4.2.2
  diff -u -r1.4.2.1 -r1.4.2.2
  --- build.properties.sample   2001/08/13 16:05:15     1.4.2.1
  +++ build.properties.sample   2001/08/20 17:26:45     1.4.2.2
  @@ -4,7 +4,7 @@
   # Make a copy this file named "build.properties",
   # and customize it to your environment and preferences.
   #
  -# $Id: build.properties.sample,v 1.4.2.1 2001/08/13 16:05:15 rwaldhoff Exp $
  +# $Id: build.properties.sample,v 1.4.2.2 2001/08/20 17:26:45 rwaldhoff Exp $
   # ===================================================================
   
   # ===================================================================
  @@ -64,4 +64,14 @@
   
   # where to build the test-webapp to
   #test-webapp.dest=${dist.home}
  -#test-webapp.dest=/java/jakarta-tomcat-4.0-b7/webapps
  \ No newline at end of file
  +#test-webapp.dest=/java/jakarta-tomcat-4.0-b7/webapps
  +
  +
  +# ===================================================================
  +# Anakia Properties (used by the xdoc target)
  +# ===================================================================
  +velocity.jar=/cvs/jakarta/jakarta-site2/lib/velocity-1.0.1.jar
  +jdom.jar=/cvs/jakarta/jakarta-site2/lib/jdom-b6.jar
  +xerces.jar=/cvs/jakarta/jakarta-site2/lib/xerces-1.3.0.jar
  +# set this property to keep xdoc from fetching .vsl file from cvs
  +#localstylesheet=true
  
  
  
  1.6.2.2   +198 -118  jakarta-commons/httpclient/build.xml
  
  Index: build.xml
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/httpclient/build.xml,v
  retrieving revision 1.6.2.1
  retrieving revision 1.6.2.2
  diff -u -r1.6.2.1 -r1.6.2.2
  --- build.xml 2001/08/13 16:05:15     1.6.2.1
  +++ build.xml 2001/08/20 17:26:45     1.6.2.2
  @@ -1,36 +1,24 @@
   <project name="HTTP Client" default="compile" basedir=".">
  -
  -
   <!--
           "HTTP Client" component of the Jakarta Commons Subproject
  -        $Id: build.xml,v 1.6.2.1 2001/08/13 16:05:15 rwaldhoff Exp $
  +        $Id: build.xml,v 1.6.2.2 2001/08/20 17:26:45 rwaldhoff Exp $
   -->
  -
   
  -<!-- ========== Initialize Properties ===================================== -->
  +<!-- ========== Properties: Property Files  =============================== -->
   
  -
  -  <property file="build.properties"/>                <!-- Component local   -->
  -  <property file="../build.properties"/>             <!-- Commons local     -->
  +  <property file="${basedir}/build.properties"/>     <!-- Component local   -->
  +  <property file="${basedir}/../build.properties"/>  <!-- Commons local     -->
     <property file="${user.home}/build.properties"/>   <!-- User local        -->
  -
   
  -<!-- ========== External Dependencies ===================================== -->
  +<!-- ========== Properties: External Dependencies ========================= -->
   
  -
  -  <!-- The directories corresponding to your necessary dependencies -->
     <property name="junit.home"              value="/usr/local/junit3.5"/>
  -
  -
  -<!-- ========== Derived Values ============================================ -->
   
  +<!-- ========== Properties: Derived Values ================================ -->
   
  -  <!-- The locations of necessary jar files -->
     <property name="junit.jar"               value="${junit.home}/junit.jar"/>
  -
  -
  -<!-- ========== Component Declarations ==================================== -->
   
  +<!-- ========== Properties: Component Declarations ======================== -->
   
     <!-- The name of this component -->
     <property name="component.name"          value="httpclient"/>
  @@ -41,30 +29,39 @@
     <!-- The current version number of this component -->
     <property name="component.version"       value="1.0-dev"/>
   
  -  <!-- The base directory for compilation targets -->
  -  <property name="build.home"              value="target"/>
  +<!-- ========== Properties: Source Directories ============================ -->
   
     <!-- The base directory for component configuration files -->
     <property name="conf.home"               value="src/conf"/>
   
  -  <!-- The base directory for distribution targets -->
  -  <property name="dist.home"               value="dist"/>
  -
     <!-- The base directory for component sources -->
     <property name="source.home"             value="src/java"/>
   
  +  <!-- The base directory for documenation -->
  +  <property name="docs.home"               value="docs"/>
  +
     <!-- The base directory for unit test sources -->
     <property name="test.home"               value="src/test"/>
  -
   
  +  <!-- The base directory for test webapp sources -->
     <property name="test-webapp.source.home"       value="src/test-webapp/src"/>
  +
  +  <!-- The base directory for test webapp configuration files -->
     <property name="test-webapp.conf.home"         value="src/test-webapp/conf"/>
  -  <property name="httpclient.test.webappContext" value="httpclienttest"/>
  -  <property name="test-webapp.dest"              value="${dist.home}"/>
   
  -<!-- ========== Compiler Defaults ========================================= -->
  +<!-- ========== Properties: Destination Directories ======================= -->
  +
  +  <!-- The base directory for compilation targets -->
  +  <property name="build.home"              value="target"/>
  +
  +  <!-- The base directory for distribution targets -->
  +  <property name="dist.home"               value="dist"/>
   
  +  <!-- The build destination for the test webapp -->
  +  <property name="test-webapp.dest"        value="${build.home}"/>
   
  +<!-- ========== Compiler Defaults ========================================= -->
  +
     <!-- Should Java compilations set the 'debug' compiler option? -->
     <property name="compile.debug"           value="true"/>
   
  @@ -83,10 +80,8 @@
       <pathelement location="${log4j.jar}"/>
     </path>
   
  -
   <!-- ========== Test Execution Defaults =================================== -->
   
  -
     <!-- Construct unit test classpath -->
     <path id="test.classpath">
       <pathelement location="${build.home}/classes"/>
  @@ -101,14 +96,14 @@
     </path>
   
     <!-- Should all tests fail if one does? -->
  -  <property name="test.failonerror"        value="true"/>
  +  <property name="test.failonerror"    value="true"/>
   
  -  <!-- The test runner to execute -->
  -  <property name="test.runner"             value="junit.textui.TestRunner"/>
  -  <property name="test.entry" value="org.apache.commons.httpclient.TestAll"/>
  -  <property name="test-local.entry" 
value="org.apache.commons.httpclient.TestAllLocal"/>
  +  <!-- The root test to execute -->
  +  <property name="test.runner"         value="junit.textui.TestRunner"/>
  +  <property name="test.entry"          
value="org.apache.commons.httpclient.TestAll"/>
  +  <property name="test-local.entry"    
value="org.apache.commons.httpclient.TestAllLocal"/>
     <property name="test-external.entry" 
value="org.apache.commons.httpclient.TestAllExternal"/>
  -  <property name="test-nohost.entry" 
value="org.apache.commons.httpclient.TestNoHost"/>
  +  <property name="test-nohost.entry"   
value="org.apache.commons.httpclient.TestNoHost"/>
   
     <!-- HTTPS protocol handler, needed for HTTPS unit tests -->
     <property name="java.protocol.handler.pkgs" 
value="com.sun.net.ssl.internal.www.protocol"/>
  @@ -116,20 +111,22 @@
     <!-- log type to use -->
     <property name="httpclient.log" 
value="org.apache.commons.httpclient.log.NoOpLog"/>
   
  +  <!-- The default context name for the test webapp -->
  +  <property name="httpclient.test.webappContext" value="httpclienttest"/>
   
  -<!-- ========== Executable Targets ======================================== -->
  +<!-- ========== Targets =================================================== -->
   
  +<!-- ========== Targets: "Internal" Targets =============================== -->
   
     <target name="init"
  -   description="Initialize and evaluate conditionals">
  +          description="Initialize and evaluate conditionals">
       <echo message="-------- ${component.title} ${component.version} --------"/>
  -    <filter  token="name"                  value="${component.name}"/>
  -    <filter  token="version"               value="${component.version}"/>
  +    <filter token="name"    value="${component.name}"/>
  +    <filter token="version" value="${component.version}"/>
     </target>
   
  -
     <target name="prepare" depends="init"
  -   description="Prepare build directory">
  +          description="Prepare build directory">
       <mkdir dir="${build.home}"/>
       <mkdir dir="${build.home}/classes"/>
       <mkdir dir="${build.home}/conf"/>
  @@ -142,112 +139,97 @@
       <mkdir 
dir="${test-webapp.dest}/${httpclient.test.webappContext}/WEB-INF/classes"/>
     </target>
   
  -
     <target name="static" depends="prepare"
  -   description="Copy static files to build directory">
  +          description="Copy static files to build directory">
       <tstamp/>
  -    <copy  todir="${build.home}/conf" filtering="on">
  +    <copy todir="${build.home}/conf" filtering="on">
         <fileset dir="${conf.home}" includes="*.MF"/>
         <fileset dir="${conf.home}" includes="*.properties"/>
       </copy>
     </target>
   
  +<!-- ========== Targets: "External" Targets =============================== -->
  +
  +  <target name="dist" depends="compile,doc"
  +          description="Create binary distribution">
  +    <mkdir dir="${dist.home}"/>
  +    <copy file="../LICENSE" todir="${dist.home}"/>
  +    <copy file="README.txt" todir="${dist.home}"/>
  +    <jar jarfile  ="${dist.home}/commons-${component.name}.jar"
  +         basedir  ="${build.home}/classes"
  +         manifest ="${build.home}/conf/MANIFEST.MF"/>
  +    <mkdir dir="${dist.home}/src"/>
  +    <copy todir="${dist.home}/src" filtering="on">
  +      <fileset dir="${source.home}"/>
  +    </copy>
  +  </target>
  +
  +<!-- ========== Targets: "External" Targets: Clean-up ===================== -->
  +
  +  <target name="clean"
  +          description="Clean build and distribution directories">
  +    <delete dir="${build.home}"/>
  +    <delete dir="${dist.home}"/>
  +  </target>
  +
  +  <target name="all" depends="clean,compile"
  +          description="Clean and compile all components"/>
  +
  +  <target name="clean.test-webapp"
  +          description="Clean test web app directories">
  +    <delete dir="${test-webapp.dest}/${httpclient.test.webappContext}"/>
  +  </target>
  +
  +<!-- ========== Targets: "External" Targets: Compilation ================== -->
   
     <target name="compile" depends="static"
  -   description="Compile shareable components">
  -    <javac  srcdir="${source.home}"
  -           destdir="${build.home}/classes"
  -             debug="${compile.debug}"
  -       deprecation="${compile.deprecation}"
  -          optimize="${compile.optimize}">
  +          description="Compile shareable components">
  +    <javac srcdir      ="${source.home}"
  +           destdir     ="${build.home}/classes"
  +           debug       ="${compile.debug}"
  +           deprecation ="${compile.deprecation}"
  +           optimize    ="${compile.optimize}">
         <classpath refid="compile.classpath"/>
       </javac>
  -    <copy    todir="${build.home}/classes" filtering="on">
  +    <copy todir="${build.home}/classes" filtering="on">
         <fileset dir="${source.home}" excludes="**/*.java"/>
       </copy>
     </target>
   
  -
     <target name="compile.tests" depends="compile"
  -   description="Compile unit test cases">
  -    <javac  srcdir="${test.home}"
  -           destdir="${build.home}/tests"
  -             debug="${compile.debug}"
  -       deprecation="${compile.deprecation}"
  -          optimize="${compile.optimize}">
  +          description="Compile unit test cases">
  +    <javac srcdir      ="${test.home}"
  +           destdir     ="${build.home}/tests"
  +           debug       ="${compile.debug}"
  +           deprecation ="${compile.deprecation}"
  +           optimize    ="${compile.optimize}">
         <classpath refid="test.classpath"/>
       </javac>
  -    <copy    todir="${build.home}/tests" filtering="on">
  +    <copy todir="${build.home}/tests" filtering="on">
         <fileset dir="${test.home}" excludes="**/*.java"/>
       </copy>
     </target>
   
  -  <target name="compile.test-webapp" depends="static"
  -   description="Compile test webapp used by unit tests">
  -    <javac  srcdir="${test-webapp.source.home}"
  -           
destdir="${test-webapp.dest}/${httpclient.test.webappContext}/WEB-INF/classes"
  -             debug="${compile.debug}"
  -       deprecation="${compile.deprecation}"
  -          optimize="${compile.optimize}">
  +  <target name="compile.test-webapp"
  +          description="Compile test webapp used by unit tests">
  +    <javac srcdir      ="${test-webapp.source.home}"
  +           destdir     
="${test-webapp.dest}/${httpclient.test.webappContext}/WEB-INF/classes"
  +           debug       ="${compile.debug}"
  +           deprecation ="${compile.deprecation}"
  +           optimize    ="${compile.optimize}">
         <classpath refid="test.classpath"/>
       </javac>
  -    <copy 
todir="${test-webapp.dest}/${httpclient.test.webappContext}/WEB-INF/classes" 
filtering="on">
  +    <copy 
todir="${test-webapp.dest}/${httpclient.test.webappContext}/WEB-INF/classes"
  +          filtering="off">
         <fileset dir="${test-webapp.source.home}" excludes="**/*.java"/>
       </copy>
  -    <copy todir="${test-webapp.dest}/${httpclient.test.webappContext}/WEB-INF/" 
filtering="on">
  +    <copy todir="${test-webapp.dest}/${httpclient.test.webappContext}/WEB-INF/"
  +          filtering="off">
         <fileset dir="${test-webapp.conf.home}"/>
       </copy>
     </target>
  -
  -
  -  <target name="clean"
  -   description="Clean build and distribution directories">
  -    <delete    dir="${build.home}"/>
  -    <delete    dir="${dist.home}"/>
  -  </target>
  -
  -
  -  <target name="all" depends="clean,compile"
  -   description="Clean and compile all components"/>
  -
  -
  -  <target name="javadoc" depends="compile"
  -   description="Create component Javadoc documentation">
  -    <mkdir      dir="${dist.home}"/>
  -    <mkdir      dir="${dist.home}/docs"/>
  -    <mkdir      dir="${dist.home}/docs/api"/>
  -    <javadoc sourcepath="${source.home}"
  -                destdir="${dist.home}/docs/api"
  -           packagenames="org.apache.commons.*"
  -                 author="true"
  -                private="true"
  -                version="true"
  -               doctitle="&lt;h1&gt;${component.title}&lt;/h1&gt;"
  -            windowtitle="${component.title} (Version ${component.version})"
  -                 bottom="Copyright (c) 2001 - Apache Software Foundation">
  -      <classpath refid="test.classpath"/>
  -    </javadoc>
  -  </target>
  -
  -
  -  <target name="dist" depends="compile,javadoc"
  -   description="Create binary distribution">
  -    <!-- TODO: top level files like LICENSE and README -->
  -    <mkdir      dir="${dist.home}"/>
  -    <copy      file="../LICENSE"
  -              todir="${dist.home}"/>
  -    <jar    jarfile="${dist.home}/commons-${component.name}.jar"
  -            basedir="${build.home}/classes"
  -           manifest="${build.home}/conf/MANIFEST.MF"/>
  -    <mkdir      dir="${dist.home}/src"/>
  -    <copy     todir="${dist.home}/src" filtering="on">
  -      <fileset  dir="${source.home}"/>
  -    </copy>
  -  </target>
  -
  -
  -<!-- ========== Unit Test Targets ========================================= -->
   
  +<!-- ========== Targets: "External" Targets: Testing ====================== -->
   
     <target name="test" depends="compile.tests" if="test.entry"
             description="Run all unit test cases">
  @@ -287,6 +269,104 @@
           <arg value="${test-external.entry}"/>
           <classpath refid="test.classpath"/>
         </java>
  +  </target>
  +
  +<!-- ========== Targets: "External" Targets: Documenation ================= -->
  +
  +  <target name="doc" depends="javadoc"
  +          description="Create component documentation.">
  +    <mkdir dir="${dist.home}"/>
  +    <mkdir dir="${dist.home}/docs"/>
  +    <copy todir="${dist.home}/docs" filtering="off">
  +      <fileset dir="docs"/>
  +    </copy>
  +  </target>
  +
  +  <target name="javadoc" depends="compile"
  +          description="Create component Javadoc documentation">
  +    <mkdir dir="${dist.home}"/>
  +    <mkdir dir="${dist.home}/docs"/>
  +    <mkdir dir="${dist.home}/docs/api"/>
  +    <javadoc sourcepath   ="${source.home}"
  +             destdir      ="${dist.home}/docs/api"
  +             packagenames ="org.apache.commons.*"
  +             author       ="true"
  +             private      ="true"
  +             version      ="true"
  +             doctitle     ="&lt;h1&gt;${component.title}&lt;/h1&gt;"
  +             windowtitle  ="${component.title} (Version ${component.version})"
  +             bottom       ="Copyright (c) 2001 - Apache Software Foundation">
  +      <classpath refid="test.classpath"/>
  +    </javadoc>
  +  </target>
  +
  +  <target name="xdoc.fetch-stylesheet" unless="localstylesheet">
  +      <echo>
  +       ####################################################################
  +       #
  +       #  Fetching the latest stylesheet from jakarta-site2
  +       #
  +       #  NOTE : As this build target is meant for developers, this requires
  +       #    a properly setup CVS.  But you are encouraged to use this to
  +       #    experiment with Anakia - if the fetch fails, it may be because
  +       #    you haven't yet logged into CVS. The way to do it, assuming you
  +       #    have a resonable CVS client setup is
  +       #
  +       #  $ cvs -d :pserver:[EMAIL PROTECTED]:/home/cvspublic login
  +       #  password: anoncvs
  +       #
  +       #  and that should solve it.
  +       #
  +       #  See http://jakarta.apache.org/site/cvsindex.html for more
  +       #      information, or http://www.cvshome.org/
  +       #
  +       #  Ant really is the bee's knees. http://jakarta.apache.org/ant/
  +       #
  +       ######################################################################
  +       </echo>
  +
  +      <cvs cvsRoot=":pserver:[EMAIL PROTECTED]:/home/cvspublic"
  +          command="checkout -p jakarta-site2/xdocs/stylesheets/site.vsl"
  +          output="${docs.src}/stylesheets/site.vsl"
  +      />
  +     </target>
  +
  +  <target name="xdoc" depends="xdoc.fetch-stylesheet"
  +          description="Generates HTML documentation from XML source">
  +      <property name="docs.src" value="./xdocs"/>
  +      <property name="docs.dest" value="./docs"/>
  +      <taskdef name="anakia"
  +               classname="org.apache.velocity.anakia.AnakiaTask">
  +          <classpath location="${velocity.jar}"/>
  +          <classpath location="${jdom.jar}"/>
  +          <classpath location="${xerces.jar}"/>
  +      </taskdef>
  +
  +      <echo>
  +       #######################################################
  +       #
  +       #  Now using Anakia to transform our XML documentation
  +       #  to HTML.
  +       #
  +       #######################################################
  +       </echo>
  +
  +      <anakia basedir="${docs.src}" destdir="${docs.dest}/"
  +           extension=".html" style="./site.vsl"
  +           projectFile="stylesheets/project.xml"
  +           excludes="**/stylesheets/** empty.xml"
  +           includes="**/*.xml"
  +           lastModifiedCheck="true"
  +           templatePath="xdocs/stylesheets">
  +      </anakia>
  +
  +      <copy todir="${docs.dest}/images" filtering="no">
  +          <fileset dir="${docs.src}/images">
  +              <include name="**/*.gif"/>
  +              <include name="**/*.jpeg"/>
  +              <include name="**/*.jpg"/>
  +          </fileset>
  +      </copy>
     </target>
   
   </project>
  
  
  
  1.3.2.1   +8 -125    jakarta-commons/httpclient/README.txt
  
  Index: README.txt
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/httpclient/README.txt,v
  retrieving revision 1.3
  retrieving revision 1.3.2.1
  diff -u -r1.3 -r1.3.2.1
  --- README.txt        2001/07/27 22:54:08     1.3
  +++ README.txt        2001/08/20 17:26:45     1.3.2.1
  @@ -1,129 +1,12 @@
   Jakarta Commons HTTP Client
   ===========================
  -
  -Welcome to the httpclient component of the Jakarta Commons
  +Welcome to the HTTP Client component of the Jakarta Commons
   project.
  -
  -BUILDING
  ---------
  -
  -To compile the source, you'll want the excellent Ant utility.
  -It can be found here :
  -
  -  http://jakarta.apache.org/ant/
  -
  -You'll also need:
  - * an implementation of the Java Secure Socket Extension,
  -   a standard Java extension available from:
  -     http://java.sun.com/products/jsse
  -
  - * the log4j logging component, available from:
  -     http://jakarta.apache.org/log4j
  -
  -To help the build and test targets find these classes,
  -you must make a copy of the build.properties.sample file,
  -rename to build.properties, and modify it to reflect the
  -location of jsse.jar, jnet.jar, jcert.jar and log4j.jar
  -on your computer.
  -
  -Once you have Ant, JSSE and log4j properly installed, and
  -your build.properties file properly configured, you are ready
  -to build the component:
  -
  -To build a jar :
  -
  -$ ant dist
  -
  -To build the API documentation :
  -
  -$ ant javadoc
  -
  -To build the jar and API doc at once :
  -
  -$ ant dist
  -
  -Run ant -projecthelp to see a list of all available targets.
  -
  -
  -TESTING
  --------
  -
  -For testing the project, you will need JUnit:
  -
  -  http://www.junit.org/
  -
  -To let the test process find JUnit, you may make a
  -copy of the build.properties.sample file, rename to
  -build.properties,  and modify it to reflect
  -the location of the junit.jar on your computer.
  -
  -(Note that JUnit is only needed to build and execute
  -the unit tests.  It is not needed to build the
  -"regular" classes, nor is it needed at runtime.)
  -
  -To compile and test the component :
  -
  -$ ant test
  -
  -
  -LOGGING
  --------
  -
  -HTTPClient uses log4j for logging.  You'll need a copy of
  -log4j.jar (available from http://jakarta.apache.org/log4j)
  -in order to compile and run httpclient.
  -
  -To configure logging, add a file named "log4j.properties"
  -to your classpath. (The first one found will be used.)
  -There is an example log4j.properties file in the
  -/src/conf directory.
  -
  -
  -HTTPS SUPPORT
  --------------
  -
  -To support the HTTPS protocol, httpclient uses an
  -implementation of the Java Secure Socket Extension.
  -
  -Note that JSSE is only needed at runtime if you want
  -to use the HTTPS protocol.  You will need it to
  -build from source, however.
  -
  -You'll need to set up the JSSE within your Java
  -security configuration. You can do this by configuring
  -your JRE installation, or you may do this in code.
  -
  -To configure JSSE within your JRE, edit the java.security file
  -(typically in [JAVA-HOME]/jre/lib/security) and add the line:
  -
  -   security.provider.<n>=com.sun.net.ssl.internal.ssl.Provider
  -
  -where <n> is one greater than the existing security.provider.*
  -properties.
  -
  -NOTE: You may have multiple copies of the JRE installation.
  -If you're having trouble, you may not have modified the
  -right file. Search for "java.security" to find additional copies.
  -
  -You will also need to set the Java system property:
  -
  -   java.protocol.handler.pkgs
  -
  -to include your JSSE provider. For Sun's implementation of
  -JSSE, this is:
  -
  -   com.sun.net.ssl.internal.www.protocol
  -
  -For example:
  -
  -   -Djava.protocol.handler.pkgs=com.sun.net.ssl.internal.www.protocol
  -
  -
  -Alternatively, you may configure the JSSE support in your code, by
  -invoking the following lines:
   
  -      // add the provider
  -      Security.addProvider(new com.sun.net.ssl.internal.ssl.Provider());
  -      // set the property
  -      System.setProperty("java.protocol.handler.pkgs",
  -                         "com.sun.net.ssl.internal.www.protocol");
  +See the docs directory, or visit us online at
  +   http://jakarta.apache.org/commons/httpclient
  +for more information.
  +
  +See docs/status.html, or
  +   http://jakarta.apache.org/commons/httpclient/status.html
  +for the status of the project.
  \ No newline at end of file
  
  
  
  1.4.2.1   +2 -104    jakarta-commons/httpclient/STATUS.html
  
  Index: STATUS.html
  ===================================================================
  RCS file: /home/cvs/jakarta-commons/httpclient/STATUS.html,v
  retrieving revision 1.4
  retrieving revision 1.4.2.1
  diff -u -r1.4 -r1.4.2.1
  --- STATUS.html       2001/05/18 00:05:14     1.4
  +++ STATUS.html       2001/08/20 17:26:45     1.4.2.1
  @@ -3,109 +3,7 @@
   <title>Status File for Jakarta Commons "HTTP Client" Component</title>
   <head>
   <body bgcolor="white">
  -
  -
  -<div align="center">
  -<h1>The Jakarta Commons <em>HTTP Client</em> Component</h1>
  -$Id: STATUS.html,v 1.4 2001/05/18 00:05:14 rwaldhoff Exp $<br>
  -<a href="#Introduction">[Introduction]</a>
  -<a href="#Dependencies">[Dependencies]</a>
  -<a href="#Release Info">[Release Info]</a>
  -<a href="#Committers">[Committers]</a>
  -<a href="#Action Items">[Action Items]</a>
  -<br><br>
  -</div>
  -
  -
  -<a name="Introduction"></a>
  -<h3>1.  INTRODUCTION</h3>
  -
  - <p>
  -  This scope of the <em>HTTP Client</em> component is an implementation of the
  -  HTTP protocol, as defined in RFC 2616 and RFC 2617.
  - </p>
  -
  - <p>
  -  The original source was donated by the Jakarta Slide project.
  - </p>
  -
  -
  -<a name="Dependencies"></a>
  -<h3>2.  DEPENDENCIES</h3>
  -
  -<p>The <em>HTTP Client</em> component is dependent upon the following
  -external components for development and use:</p>
  -<ul>
  -<li><a href="http://java.sun.com/j2se";>Java Development Kit</a>
  -    (Version 1.2 or later)</li>
  -<li><a href="http://java.sun.com/products/jsse";>Java Secure Socket Extension</a>
  -    (Version 1.0.2 or later)
  -    (Required for compilation/testing. Only needed at runtime if
  -    you're using HTTPS URLs.)</li>
  -</ul>
  -
  -
  -<a name="Release Info"></a>
  -<h3>3.  RELEASE INFO</h3>
  -
  -<p>Current Release:  <strong>Unreleased, CVS Repository Only</strong></p>
  -<p>Planned Next Release: N/A</p>
  -
  -
  -<a name="Committers"></a>
  -<h3>4.  COMMITTERS</h3>
  -
  -<p>The following individuals are the primary developers and maintainers of this
  -component.  Developers who plan to use the <em>HTTP Client</em> in their own
  -projects are encouraged to collaborate on the future development of this
  -component to ensure that it continues to meet a variety of needs.</p>
  -<ul>
  -<li>Remy Maucherat</li>
  -<li>B.C Holmes</li>
  -<li>Sung-Gu Park</li>
  -<li>Juergen Pill</li>
  -<li>Costin Manolache</li>
  -<li>Morgan Delagrange</li>
  -<li>Rodney Waldhoff</li>
  -</ul>
  -
  -<a name="Action Items"></a>
  -<h3>5.  ACTION ITEMS</h3>
  -
  -<p>The following action items need to be completed prior to a Version 1.0
  -release of this component:</p>
  -
  -<table border="1">
  -
  -  <tr>
  -    <th width="80%">Action Item</th>
  -    <th width="20%">Volunteer</th>
  -  </tr>
  -
  -  <tr>
  -    <td><strong>Unit Tests</strong>.  Create unit tests for some of the
  -        included classes, whenever possible.</td>
  -    <td align="center">&nbsp;</td>
  -  </tr>
  -
  -  <tr>
  -    <td><strong>Developer Documentation</strong>.  Create simple Developer's
  -        Guide documentation for this component.</td>
  -    <td align="center">&nbsp;</td>
  -  </tr>
  -
  -  <tr>
  -    <td><strong>DIGEST Authentication Support</strong>.</td>
  -    <td align="center">&nbsp;</td>
  -  </tr>
  -
  -  <tr>
  -    <td><strong>Developer Documentation</strong>.  Create simple Developer's
  -        Guide documentation for this component.</td>
  -    <td align="center">&nbsp;</td>
  -  </tr>
  -
  -</table>
  -
  +See <a href="./docs/status.html">./docs/status.html</a> and/or
  +<a href="./xdocs/status.xml">./xdocs/status.xml</a>.
   </body>
   </html>
  
  
  
  No                   revision
  
  
  No                   revision
  
  
  1.1.2.1   +42 -0     jakarta-commons/httpclient/docs/Attic/BUILDING.txt
  
  
  
  
  1.1.2.1   +90 -0     jakarta-commons/httpclient/docs/Attic/TESTING.txt
  
  
  
  
  1.1.2.1   +60 -0     jakarta-commons/httpclient/docs/Attic/USING_HTTPS.txt
  
  
  
  
  No                   revision
  
  
  No                   revision
  
  
  1.1.2.1   +32 -0     jakarta-commons/httpclient/xdocs/stylesheets/Attic/project.xml
  
  
  
  
  1.1.2.1   +181 -0    jakarta-commons/httpclient/xdocs/stylesheets/Attic/temp.xsl
  
  
  
  

Reply via email to