You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@hc.apache.org by ro...@apache.org on 2007/12/16 12:02:03 UTC

svn commit: r604604 - in /httpcomponents/oac.hc3x/trunk: project.properties xdocs/developerguide.xml xdocs/navigation.xml xdocs/userguide.xml

Author: rolandw
Date: Sun Dec 16 03:02:00 2007
New Revision: 604604

URL: http://svn.apache.org/viewvc?rev=604604&view=rev
Log:
updated naviagtion with ASF links, dropped developer guide, moved user guide to separate section, reference JavaDocs for 5.0 instead of 1.4.2

Removed:
    httpcomponents/oac.hc3x/trunk/xdocs/developerguide.xml
Modified:
    httpcomponents/oac.hc3x/trunk/project.properties
    httpcomponents/oac.hc3x/trunk/xdocs/navigation.xml
    httpcomponents/oac.hc3x/trunk/xdocs/userguide.xml

Modified: httpcomponents/oac.hc3x/trunk/project.properties
URL: http://svn.apache.org/viewvc/httpcomponents/oac.hc3x/trunk/project.properties?rev=604604&r1=604603&r2=604604&view=diff
==============================================================================
--- httpcomponents/oac.hc3x/trunk/project.properties (original)
+++ httpcomponents/oac.hc3x/trunk/project.properties Sun Dec 16 03:02:00 2007
@@ -11,7 +11,7 @@
 maven.checkstyle.properties=checkstyle.xml.properties
 maven.checkstyle.includes=**/*.java
 maven.checkstyle.excludes=**/*.html
-maven.javadoc.links=http://java.sun.com/j2se/1.4.2/docs/api/, http://commons.apache.org/logging/commons-logging-1.0.4/docs/apidocs/
+maven.javadoc.links=http://java.sun.com/j2se/1.5.0/docs/api/, http://commons.apache.org/logging/commons-logging-1.0.4/docs/apidocs/
 maven.changelog.factory=org.apache.maven.svnlib.SvnChangeLogFactory
 maven.repo.list=asf
 maven.repo.asf=scp://people.apache.org

Modified: httpcomponents/oac.hc3x/trunk/xdocs/navigation.xml
URL: http://svn.apache.org/viewvc/httpcomponents/oac.hc3x/trunk/xdocs/navigation.xml?rev=604604&r1=604603&r2=604604&view=diff
==============================================================================
--- httpcomponents/oac.hc3x/trunk/xdocs/navigation.xml (original)
+++ httpcomponents/oac.hc3x/trunk/xdocs/navigation.xml Sun Dec 16 03:02:00 2007
@@ -15,23 +15,24 @@
       <item name="Status" href="/status.html"/>
       <item name="Download" href="/downloads.html"/>
       <item name="Wiki" href="http://wiki.apache.org/jakarta-httpclient/"/>
-      <item name="User Guide" href="/userguide.html">
-        <item name="Authentication Guide" href="/authentication.html"/>
-        <item name="Character Encodings" href="/charencodings.html"/>
-        <item name="Cookies" href="/cookies.html"/>
-        <item name="Exception Handling" href="/exception-handling.html"/>
-        <item name="Logging Guide" href="/logging.html"/>
-        <item name="Methods" href="/methods.html"/>
-        <item name="Optimization Guide" href="/performance.html"/>
-        <item name="Preference Architecture" href="/preference-api.html"/>
-        <item name="Redirects Handling" href="/redirects.html"/>
-        <item name="Sample Code" href="http://svn.apache.org/viewvc/httpcomponents/oac.hc3x/trunk/src/examples/"/>
-        <item name="SSL Guide" href="/sslguide.html"/>
-        <item name="Threading" href="/threading.html"/>
-        <item name="Trouble Shooting" href="/troubleshooting.html"/>
-        <item name="Tutorial" href="/tutorial.html"/>
-      </item>
-      <item name="Developer Guide" href="/developerguide.html"/>
+    </menu>
+
+    <menu name="User Guide">
+      <item name="Overview" href="/userguide.html"/>
+      <item name="Authentication Guide" href="/authentication.html"/>
+      <item name="Character Encodings" href="/charencodings.html"/>
+      <item name="Cookies" href="/cookies.html"/>
+      <item name="Exception Handling" href="/exception-handling.html"/>
+      <item name="Logging Guide" href="/logging.html"/>
+      <item name="Methods" href="/methods.html"/>
+      <item name="Optimization Guide" href="/performance.html"/>
+      <item name="Preference Architecture" href="/preference-api.html"/>
+      <item name="Redirects Handling" href="/redirects.html"/>
+      <item name="Sample Code" href="http://svn.apache.org/viewvc/httpcomponents/oac.hc3x/trunk/src/examples/"/>
+      <item name="SSL Guide" href="/sslguide.html"/>
+      <item name="Threading" href="/threading.html"/>
+      <item name="Trouble Shooting" href="/troubleshooting.html"/>
+      <item name="Tutorial" href="/tutorial.html"/>
     </menu>
 
     <menu name="ASF" href="http://www.apache.org/">

Modified: httpcomponents/oac.hc3x/trunk/xdocs/userguide.xml
URL: http://svn.apache.org/viewvc/httpcomponents/oac.hc3x/trunk/xdocs/userguide.xml?rev=604604&r1=604603&r2=604604&view=diff
==============================================================================
--- httpcomponents/oac.hc3x/trunk/xdocs/userguide.xml (original)
+++ httpcomponents/oac.hc3x/trunk/xdocs/userguide.xml Sun Dec 16 03:02:00 2007
@@ -4,17 +4,24 @@
 
   <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="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 guide is
-      already in use for helping people develop HttpClient.</p>
+      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">



Re: svn commit: r604604 - in /httpcomponents/oac.hc3x/trunk: project.properties xdocs/developerguide.xml xdocs/navigation.xml xdocs/userguide.xml

Posted by Roland Weber <os...@dubioso.net>.
Hi Sebastian,

>> URL: http://svn.apache.org/viewvc?rev=604604&view=rev
>> Log:
>> ... reference JavaDocs for 5.0 instead of 1.4.2
> 
> I thought HttpClient 3.1 was supposed to support 1.4 or even earlier?

Yes, it requires only Java 1.2.2. But Sun pulled the
JavaDocs for that version at some time. JavaDocs for
1.3.1 are still up, but we were already linking to
the 1.4.2 version. Since our recent poll indicated
little interest in that, I upgraded the link to the
version that is in widespread use nowadays.

Note that this is only used as the backdrop for our
own generated JavaDocs. So if you click on the link
to "java.lang.Object" in [1], you'll be taken to the
5.0 JavaDocs instead of the 1.4.2. I don't think
that is going to confuse any users.

cheers,
  Roland

[1]
http://hc.apache.org/httpclient-3.x/apidocs/org/apache/commons/httpclient/HttpClient.html


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org


Re: svn commit: r604604 - in /httpcomponents/oac.hc3x/trunk: project.properties xdocs/developerguide.xml xdocs/navigation.xml xdocs/userguide.xml

Posted by sebb <se...@gmail.com>.
On 16/12/2007, rolandw@apache.org <ro...@apache.org> wrote:
> Author: rolandw
> Date: Sun Dec 16 03:02:00 2007
> New Revision: 604604
>
> URL: http://svn.apache.org/viewvc?rev=604604&view=rev
> Log:
> ... reference JavaDocs for 5.0 instead of 1.4.2

I thought HttpClient 3.1 was supposed to support 1.4 or even earlier?

project.properties says:

maven.compile.source=1.2
maven.compile.target=1.2

> Removed:
>    httpcomponents/oac.hc3x/trunk/xdocs/developerguide.xml
> Modified:
>    httpcomponents/oac.hc3x/trunk/project.properties
>    httpcomponents/oac.hc3x/trunk/xdocs/navigation.xml
>    httpcomponents/oac.hc3x/trunk/xdocs/userguide.xml
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@hc.apache.org
For additional commands, e-mail: dev-help@hc.apache.org