Migrated index, download, examples, quick start content of all modules to Markdown
diff --git a/src/site/apt/httpcomponents-asyncclient-4.1.x/download.apt b/src/site/apt/httpcomponents-asyncclient-4.1.x/download.apt
deleted file mode 100644
index 8d1c10a..0000000
--- a/src/site/apt/httpcomponents-asyncclient-4.1.x/download.apt
+++ /dev/null
@@ -1,49 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpAsyncClient Download Page
- ----------
- ----------
- ----------
-
-HttpAsyncClient Downloads
-
- The latest release available for download:
-
- {{{http://hc.apache.org/downloads.cgi}Release packages}} -
- {{{http://www.apache.org/dist/httpcomponents/httpasyncclient/RELEASE_NOTES-4.1.x.txt}Release Notes}} -
- {{{http://www.apache.org/licenses/LICENSE-2.0.html}License}}
-
-{Dependency management}
-
- If you are using a dependency manager for your project such as
- {{{http://maven.apache.org}Apache Maven}} or
- {{{http://ant.apache.org/projects/ivy.html}Apache Ivy}},
- you can create a dependency on HttpClient modules by using this information:
-
- {{{./httpasyncclient/dependency-info.html}HttpAsyncClient}}
-
- {{{./httpasyncclient-cache/dependency-info.html}HttpAsyncClient Cache}}
-
diff --git a/src/site/apt/httpcomponents-asyncclient-4.1.x/examples.apt b/src/site/apt/httpcomponents-asyncclient-4.1.x/examples.apt
deleted file mode 100644
index 97ba5de..0000000
--- a/src/site/apt/httpcomponents-asyncclient-4.1.x/examples.apt
+++ /dev/null
@@ -1,106 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpAsyncClient Examples
- ----------
- ----------
- ----------
-
-HttpAsyncClient Examples
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientHttpExchange.java}
- Asynchronous HTTP exchange}}
-
- This example demonstrates a basic asynchronous HTTP request / response exchange.
- Response content is buffered in memory for simplicity.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientHttpExchangeStreaming.java}
- Asynchronous HTTP exchange with content streaming}}
-
- This example demonstrates an asynchronous HTTP request / response exchange with a full content
- streaming.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientHttpExchangeFutureCallback.java}
- Concurrent asynchronous HTTP exchanges}}
-
- This example demonstrates a fully asynchronous execution of multiple HTTP exchanges where the
- result of an individual operation is reported using a callback interface.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientPipelined.java}
- Pipelined HTTP exchanges}}
-
- This example demonstrates a pipelined execution of multiple HTTP request / response exchanges.
- Response content is buffered in memory for simplicity.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientPipelinedStreaming.java}
- Pipelined HTTP exchanges with content streaming}}
-
- This example demonstrates a pipelined execution of multiple HTTP request / response exchanges
- with a full content streaming.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientExecuteProxy.java}
- Asynchronous request via a proxy}}
-
- This example demonstrates how to send an HTTP request via a proxy.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientConfiguration.java}
- HttpAsyncClient configuration}}
-
- This example demonstrates how to customize and configure the most common aspects of HTTP request execution
- and connection management.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientCustomContext.java}
- Custom execution context}}
-
- This example demonstrates the use of a local execution context with custom context settings.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientAuthentication.java}
- Client authentication}}
-
- This example demonstrates execution of an HTTP request against a target site that requires user
- authentication.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientProxyAuthentication.java}
- Proxy authentication}}
-
- This example shows execution of an HTTP request over a secure connection tunneled through
- an authenticating proxy.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientCustomSSL.java}
- Custom SSL context}}
-
- This example demonstrates how to create secure connections with a custom SSL context.
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/ZeroCopyHttpExchange.java}
- Zero copy file upload / download}}
-
- This example demonstrates how HttpAsyncClient can be used to upload or download files without
- creating an intermediate content buffer in memory (zero copy file transfer).
-
- * {{{./httpasyncclient/examples/org/apache/http/examples/nio/client/AsyncClientEvictExpiredConnections.java}
- Connection eviction}}
-
- This example demonstrates how to evict expired and idle connections from the connection pool.
-
diff --git a/src/site/apt/httpcomponents-asyncclient-4.1.x/index.apt b/src/site/apt/httpcomponents-asyncclient-4.1.x/index.apt
deleted file mode 100644
index 90cd141..0000000
--- a/src/site/apt/httpcomponents-asyncclient-4.1.x/index.apt
+++ /dev/null
@@ -1,113 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpAsyncClient Overview
- ----------
- ----------
- ----------
-
-HttpAsyncClient Overview
-
- 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, while
- increasing the number of applications that require HTTP support.
-
- Although the java.net package provides basic functionality for accessing resources via HTTP, it
- doesn't provide the full flexibility or functionality needed by many applications.
- HttpAsyncClient 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.
-
- Designed for extension while providing robust support for the base HTTP protocol,
- HttpAsyncClient may be of interest to anyone building HTTP-aware client applications based on
- asynchronous, event driven I/O model.
-
-{Documentation}
-
- [[1]] {{{./quickstart.html}Quick Start}} - contains a simple, complete example of asynchronous
- request execution.
-
- [[1]] {{{./examples.html}HttpAsyncClient Examples}} - a set of examples demonstrating some of
- the more complex behavior.
-
- [[1]] Project reports
-
- * {{{./httpasyncclient/project-reports.html}HttpAsyncClient}}
-
- * {{{./httpasyncclient-cache/project-reports.html}HttpAsyncClient Cache}}
-
- * {{{./httpasyncclient-osgi/project-reports.html}HttpAsyncClient OSGi}}
-
-{Features}
-
- * Standards based, pure Java, implementation of HTTP versions 1.0 and 1.1
-
- * Full implementation of all HTTP methods (GET, POST, PUT, DELETE, HEAD, OPTIONS, and TRACE)
- in an extensible OO framework.
-
- * Supports encryption with HTTPS (HTTP over SSL) protocol.
-
- * Transparent connections through HTTP proxies.
-
- * Tunneled HTTPS connections through HTTP proxies, via the CONNECT method.
-
- * Connection management support concurrent request execution. Supports setting the maximum
- total connections as well as the maximum connections per host. Detects and closes expired
- connections.
-
- * Persistent connections using KeepAlive in HTTP/1.0 and persistance in HTTP/1.1
-
- * The ability to set connection timeouts.
-
- * Source code is freely available under the Apache License.
-
- * Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO and Kerberos authentication schemes.
-
- * Plug-in mechanism for custom authentication schemes.
-
- * Automatic Cookie handling for reading Set-Cookie: headers from the server and sending them
- back out in a Cookie: header when appropriate.
-
- * Plug-in mechanism for custom cookie policies.
-
- * Support for HTTP/1.1 response caching.
-
- * Support for pipelined request execution and processing.
-
-{Standards Compliance}
-
- HttpAsyncClient strives to conform to the following specifications endorsed by the Internet
- Engineering Task Force (IETF) and the internet at large:
-
- * {{{http://www.ietf.org/rfc/rfc1945.txt}RFC 1945}} Hypertext Transfer Protocol -- HTTP/1.0
-
- * {{{http://www.ietf.org/rfc/rfc2616.txt}RFC 2616}} Hypertext Transfer Protocol -- HTTP/1.1
-
- * {{{http://www.ietf.org/rfc/rfc2617.txt}RFC 2617}} HTTP Authentication: Basic and Digest Access
- Authentication
-
- * {{{http://www.ietf.org/rfc/rfc2109.txt}RFC 2109}} HTTP State Management Mechanism (Cookies)
-
- * {{{http://www.ietf.org/rfc/rfc2965.txt}RFC 2965}} HTTP State Management Mechanism (Cookies v2)
diff --git a/src/site/apt/httpcomponents-asyncclient-4.1.x/quickstart.apt b/src/site/apt/httpcomponents-asyncclient-4.1.x/quickstart.apt
deleted file mode 100644
index 8dd6030..0000000
--- a/src/site/apt/httpcomponents-asyncclient-4.1.x/quickstart.apt
+++ /dev/null
@@ -1,139 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpAsyncClient Quick Start
- ----------
- ----------
- ----------
-
-HttpAsyncClient Quick Start
-
- [[1]] Download 'Binary' package of the latest HttpAsyncClient 4.1 release or configure
- dependency on {{{./httpasyncclient/dependency-info.html}HttpAsyncClient}} module using
- a dependency manager of your choice as described {{{./download.html}here}}.
-
- [[1]] HttpAsyncClient 4.1 requires Java 1.6 or newer.
-
- [[1]] The code fragment below illustrates the most fundamental aspects of asynchronous
- request execution with HttpAsyncClient.
-
--------------
-CloseableHttpAsyncClient httpclient = HttpAsyncClients.createDefault();
-try {
- // Start the client
- httpclient.start();
-
- // Execute request
- final HttpGet request1 = new HttpGet("http://www.apache.org/");
- Future<HttpResponse> future = httpclient.execute(request1, null);
- // and wait until a response is received
- HttpResponse response1 = future.get();
- System.out.println(request1.getRequestLine() + "->" + response1.getStatusLine());
-
- // One most likely would want to use a callback for operation result
- final CountDownLatch latch1 = new CountDownLatch(1);
- final HttpGet request2 = new HttpGet("http://www.apache.org/");
- httpclient.execute(request2, new FutureCallback<HttpResponse>() {
-
- public void completed(final HttpResponse response2) {
- latch1.countDown();
- System.out.println(request2.getRequestLine() + "->" + response2.getStatusLine());
- }
-
- public void failed(final Exception ex) {
- latch1.countDown();
- System.out.println(request2.getRequestLine() + "->" + ex);
- }
-
- public void cancelled() {
- latch1.countDown();
- System.out.println(request2.getRequestLine() + " cancelled");
- }
-
- });
- latch1.await();
-
- // In real world one most likely would also want to stream
- // request and response body content
- final CountDownLatch latch2 = new CountDownLatch(1);
- final HttpGet request3 = new HttpGet("http://www.apache.org/");
- HttpAsyncRequestProducer producer3 = HttpAsyncMethods.create(request3);
- AsyncCharConsumer<HttpResponse> consumer3 = new AsyncCharConsumer<HttpResponse>() {
-
- HttpResponse response;
-
- @Override
- protected void onResponseReceived(final HttpResponse response) {
- this.response = response;
- }
-
- @Override
- protected void onCharReceived(final CharBuffer buf, final IOControl ioctrl) throws IOException {
- // Do something useful
- }
-
- @Override
- protected void releaseResources() {
- }
-
- @Override
- protected HttpResponse buildResult(final HttpContext context) {
- return this.response;
- }
-
- };
- httpclient.execute(producer3, consumer3, new FutureCallback<HttpResponse>() {
-
- public void completed(final HttpResponse response3) {
- latch2.countDown();
- System.out.println(request3.getRequestLine() + "->" + response3.getStatusLine());
- }
-
- public void failed(final Exception ex) {
- latch2.countDown();
- System.out.println(request3.getRequestLine() + "->" + ex);
- }
-
- public void cancelled() {
- latch2.countDown();
- System.out.println(request3.getRequestLine() + " cancelled");
- }
-
- });
- latch2.await();
-
-} finally {
- httpclient.close();
-}
--------------
-
- [[1]] Take a look at the {{{../httpcomponents-core-ga/tutorial/html/index.html}HttpCore
- tutorial}} for introduction to fundamentals of asynchronous HTTP communication with
- HttpComponents.
-
- [[1]] Another good way of getting started with HttpAsyncClient is by seeing it in action. Take
- a look at the samples shipped with the release package or available {{{./examples.html}online}}.
-
-
diff --git a/src/site/apt/httpcomponents-client-4.5.x/download.apt b/src/site/apt/httpcomponents-client-4.5.x/download.apt
deleted file mode 100644
index 0cbc24b..0000000
--- a/src/site/apt/httpcomponents-client-4.5.x/download.apt
+++ /dev/null
@@ -1,54 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Download Page
- ----------
- ----------
- ----------
-
-HttpClient Downloads
-
- The latest release available for download:
-
- {{{http://hc.apache.org/downloads.cgi}Release packages}} -
- {{{http://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES-4.5.x.txt}Release Notes}} -
- {{{http://www.apache.org/licenses/LICENSE-2.0.html}License}}
-
-{Dependency management}
-
- If you are using a dependency manager for your project such as
- {{{http://maven.apache.org}Apache Maven}} or
- {{{http://ant.apache.org/projects/ivy.html}Apache Ivy}},
- you can create a dependency on HttpClient modules by using this information:
-
- {{{./httpclient/dependency-info.html}HttpClient}}
-
- {{{./httpclient-cache/dependency-info.html}HttpClient Cache}}
-
- {{{./httpmime/dependency-info.html}HttpMime}}
-
- {{{./fluent-hc/dependency-info.html}Fluent HC}}
-
-
diff --git a/src/site/apt/httpcomponents-client-4.5.x/examples.apt b/src/site/apt/httpcomponents-client-4.5.x/examples.apt
deleted file mode 100644
index 29df1fb..0000000
--- a/src/site/apt/httpcomponents-client-4.5.x/examples.apt
+++ /dev/null
@@ -1,115 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Examples
- ----------
- ----------
- ----------
-
-HttpClient Examples
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientWithResponseHandler.java}Response handling}}
-
- This example demonstrates how to process HTTP responses using a response handler. This is
- the recommended way of executing HTTP requests and processing HTTP responses. This approach
- enables the caller to concentrate on the process of digesting HTTP responses and to delegate
- the task of system resource deallocation to HttpClient. The use of an HTTP response handler
- guarantees that the underlying HTTP connection will be released back to the connection manager
- automatically in all cases.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientConnectionRelease.java}Manual connection release}}
-
- This example demonstrates how to ensure the release of the underlying HTTP connection back to
- the connection manager in case of a manual processing of HTTP responses.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientConfiguration.java}HttpClient configuration}}
-
- This example demonstrates how to customize and configure the most common aspects of HTTP request execution
- and connection management.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientAbortMethod.java}Abort method}}
-
- This example demonstrates how to abort an HTTP request before its normal completion.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientAuthentication.java}Client authentication}}
-
- This example uses HttpClient to execute an HTTP request against a target site that requires user
- authentication.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientExecuteProxy.java}Request via a proxy}}
-
- This example demonstrates how to send an HTTP request via a proxy.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientProxyAuthentication.java}Proxy authentication}}
-
- A simple example showing execution of an HTTP request over a secure connection tunneled through
- an authenticating proxy.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientChunkEncodedPost.java}Chunk encoded POST}}
-
- This example shows how to stream out a request entity using chunk encoding.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientCustomContext.java}Custom execution context}}
-
- This example demonstrates the use of a local HTTP context populated custom attributes.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientFormLogin.java}Form based logon}}
-
- This example demonstrates how HttpClient can be used to perform form-based logon.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientMultiThreadedExecution.java}Threaded request execution}}
-
- An example that executes HTTP requests from multiple worker threads.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientCustomSSL.java}Custom SSL context}}
-
- This example demonstrates how to create secure connections with a custom SSL context.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientPreemptiveBasicAuthentication.java}Preemptive BASIC authentication}}
-
- This example shows how HttpClient can be customized to authenticate preemptively using BASIC
- scheme. Generally, preemptive authentication can be considered less secure than a response to
- an authentication challenge and therefore discouraged.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ClientPreemptiveDigestAuthentication.java}Preemptive DIGEST authentication}}
-
- This example shows how HttpClient can be customized to authenticate preemptively using DIGEST
- scheme. Generally, preemptive authentication can be considered less secure than a response to
- an authentication challenge and therefore discouraged.
-
- * {{{./httpclient/examples/org/apache/http/examples/client/ProxyTunnelDemo.java}Proxy tunnel}}
-
- This example shows how to use ProxyClient in order to establish a tunnel through an HTTP proxy
- for an arbitrary protocol.
-
- * {{{./httpmime/examples/org/apache/http/examples/entity/mime/ClientMultipartFormPost.java}Multipart encoded request entity}}
-
- This example shows how to execute requests enclosing a multipart encoded entity.
-
- * {{{./httpclient-win/examples/org/apache/http/examples/client/win/ClientWinAuth.java}Native Windows Negotiate/NTLM}}
-
- This example shows how to make use of Native Windows Negotiate/NTLM authentication when
- running on Windows OS.
-
diff --git a/src/site/apt/httpcomponents-client-4.5.x/index.apt b/src/site/apt/httpcomponents-client-4.5.x/index.apt
deleted file mode 100644
index 25375d1..0000000
--- a/src/site/apt/httpcomponents-client-4.5.x/index.apt
+++ /dev/null
@@ -1,136 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Overview
- ----------
- ----------
- ----------
-
-HttpClient Overview
-
- 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, while
- increasing the number of applications that require HTTP support.
-
- Although the java.net package provides basic functionality for accessing resources via HTTP, it
- doesn't provide the full flexibility or functionality needed by many applications. HttpClient
- 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.
-
- Designed for extension while providing robust support for the base HTTP protocol, HttpClient
- 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.
-
-{Documentation}
-
- [[1]] {{{./quickstart.html}Quick Start}} - contains a simple, complete example of an HTTP GET
- and POST with parameters.
-
- [[1]] {{{./tutorial/html/index.html}HttpClient Tutorial}} - gives a detailed examination of the
- HttpClient API, which was written in close accordance with the (sometimes not very intuitive)
- HTTP specification/standard. A copy is also shipped with the release.
- {{{./tutorial/pdf/httpclient-tutorial.pdf}A PDF version}} is also available
-
- [[1]] {{{./examples.html}HttpClient Examples}} - a set of examples demonstrating some of
- the more complex behavior.
-
- [[1]] {{{./primer.html}HttpClient Primer}} - explains the scope of HttpClient.
- Note that HttpClient is not a browser. It lacks the UI, HTML renderer and a JavaScript engine
- that a browser will possess.
-
- [[1]] Project reports
-
- * {{{./httpclient/project-reports.html}HttpClient}}
-
- * {{{./fluent-hc/project-reports.html}HC Fluent}}
-
- * {{{./httpmime/project-reports.html}HttpMime}}
-
- * {{{./httpclient-cache/project-reports.html}HttpClient Cache}}
-
- * {{{./httpclient-osgi/project-reports.html}HttpClient OSGi}}
-
-{Features}
-
- * Standards based, pure Java, implementation of HTTP versions 1.0 and 1.1
-
- * Full implementation of all HTTP methods (GET, POST, PUT, DELETE, HEAD, OPTIONS, and TRACE)
- in an extensible OO framework.
-
- * Supports encryption with HTTPS (HTTP over SSL) protocol.
-
- * Transparent connections through HTTP proxies.
-
- * Tunneled HTTPS connections through HTTP proxies, via the CONNECT method.
-
- * Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO, Kerberos authentication schemes.
-
- * Plug-in mechanism for custom authentication schemes.
-
- * Pluggable secure socket factories, making it easier to use third party solutions
-
- * Connection management support for use in multi-threaded applications. Supports setting the
- maximum total connections as well as the maximum connections per host. Detects and closes
- stale connections.
-
- * Automatic Cookie handling for reading Set-Cookie: headers from the server and sending them
- back out in a Cookie: header when appropriate.
-
- * Plug-in mechanism for custom cookie policies.
-
- * Request output streams to avoid buffering any content body by streaming directly to the socket
- to the server.
-
- * Response input streams to efficiently read the response body by streaming directly from the
- socket to the server.
-
- * Persistent connections using KeepAlive in HTTP/1.0 and persistance in HTTP/1.1
-
- * Direct access to the response code and headers sent by the server.
-
- * The ability to set connection timeouts.
-
- * Support for HTTP/1.1 response caching.
-
- * Source code is freely available under the Apache License.
-
-{Standards Compliance}
-
- HttpClient strives to conform to the following specifications endorsed by the Internet
- Engineering Task Force (IETF) and the internet at large:
-
- * {{{http://tools.ietf.org/html/rfc1945}RFC 1945}} - Hypertext Transfer Protocol -- HTTP/1.0
-
- * {{{http://tools.ietf.org/html/rfc2616}RFC 2616}} - Hypertext Transfer Protocol -- HTTP/1.1
-
- * {{{http://tools.ietf.org/html/rfc2617}RFC 2617}} - HTTP Authentication: Basic and Digest Access
- Authentication
-
- * {{{http://tools.ietf.org/html/rfc2396}RFC 2396}} - Uniform Resource Identifiers (URI): Generic Syntax
-
- * {{{http://tools.ietf.org/html/rfc6265}RFC 6265}} - HTTP State Management Mechanism (Cookies)
-
diff --git a/src/site/apt/httpcomponents-client-4.5.x/quickstart.apt b/src/site/apt/httpcomponents-client-4.5.x/quickstart.apt
deleted file mode 100644
index c7e3535..0000000
--- a/src/site/apt/httpcomponents-client-4.5.x/quickstart.apt
+++ /dev/null
@@ -1,114 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpClient Quick Start
- ----------
- ----------
- ----------
-
-HttpClient Quick Start
-
- [[1]] Download 'Binary' package of the latest HttpClient 4.5 release or configure
- dependency on {{{./httpclient/dependency-info.html}HttpClient}} and
- {{{./fluent-hc/dependency-info.html}Fluent HC}} modules using a dependency manager of your
- choice as described {{{./download.html}here}}.
-
- [[1]] HttpClient 4.5 requires Java 1.6 or newer.
-
- [[1]] The below code fragment illustrates the execution of HTTP GET and POST requests using
- the HttpClient native API.
-
--------------
-
-CloseableHttpClient httpclient = HttpClients.createDefault();
-HttpGet httpGet = new HttpGet("http://targethost/homepage");
-CloseableHttpResponse response1 = httpclient.execute(httpGet);
-// The underlying HTTP connection is still held by the response object
-// to allow the response content to be streamed directly from the network socket.
-// In order to ensure correct deallocation of system resources
-// the user MUST call CloseableHttpResponse#close() from a finally clause.
-// Please note that if response content is not fully consumed the underlying
-// connection cannot be safely re-used and will be shut down and discarded
-// by the connection manager.
-try {
- System.out.println(response1.getStatusLine());
- HttpEntity entity1 = response1.getEntity();
- // do something useful with the response body
- // and ensure it is fully consumed
- EntityUtils.consume(entity1);
-} finally {
- response1.close();
-}
-
-HttpPost httpPost = new HttpPost("http://targethost/login");
-List <NameValuePair> nvps = new ArrayList <NameValuePair>();
-nvps.add(new BasicNameValuePair("username", "vip"));
-nvps.add(new BasicNameValuePair("password", "secret"));
-httpPost.setEntity(new UrlEncodedFormEntity(nvps));
-CloseableHttpResponse response2 = httpclient.execute(httpPost);
-
-try {
- System.out.println(response2.getStatusLine());
- HttpEntity entity2 = response2.getEntity();
- // do something useful with the response body
- // and ensure it is fully consumed
- EntityUtils.consume(entity2);
-} finally {
- response2.close();
-}
--------------
-
- Source can be downloaded
- {{{./httpclient/examples/org/apache/http/examples/client/QuickStart.java}here}}
-
- [[1]] The same requests can be executed using a simpler, albeit less flexible, fluent API.
-
--------------
-
-// The fluent API relieves the user from having to deal with manual deallocation of system
-// resources at the cost of having to buffer response content in memory in some cases.
-
-Request.Get("http://targethost/homepage")
- .execute().returnContent();
-Request.Post("http://targethost/login")
- .bodyForm(Form.form().add("username", "vip").add("password", "secret").build())
- .execute().returnContent();
-
--------------
-
- Source can be downloaded
- {{{./fluent-hc/examples/org/apache/http/client/fluent/FluentQuickStart.java}here}}
-
- [[1]] {{{./examples.html}HttpClient Examples}} - a set of examples demonstrating some of
- the more complex behavior.
-
- [[1]] {{{./tutorial/html/index.html}HttpClient Tutorial}} - gives a detailed examination of the
- HttpClient API, which was written in close accordance with the (sometimes not very intuitive)
- HTTP specification/standard. A copy is also shipped with the release.
- {{{./tutorial/pdf/httpclient-tutorial.pdf}A PDF version}} is also available
-
- [[1]] {{{./primer.html}HttpClient Primer}} - explains the scope of HttpClient.
- Note that HttpClient is not a browser. It lacks the UI, HTML renderer and a JavaScript engine
- that a browser will possess.
diff --git a/src/site/apt/httpcomponents-client-5.0.x/download.apt b/src/site/apt/httpcomponents-client-5.0.x/download.apt
deleted file mode 100644
index 340298a..0000000
--- a/src/site/apt/httpcomponents-client-5.0.x/download.apt
+++ /dev/null
@@ -1,52 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Download Page
- ----------
- ----------
- ----------
-
-HttpClient Downloads
-
- The latest release available for download:
-
- {{{http://hc.apache.org/downloads.cgi}Release packages}} -
- {{{http://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES-5.0.x.txt}Release Notes}} -
- {{{http://www.apache.org/licenses/LICENSE-2.0.html}License}}
-
-{Dependency management}
-
- If you are using a dependency manager for your project such as
- {{{http://maven.apache.org}Apache Maven}} or
- {{{http://ant.apache.org/projects/ivy.html}Apache Ivy}},
- you can create a dependency on HttpClient modules by using this information:
-
- {{{./httpclient5/dependency-info.html}HttpClient}}
-
- {{{./httpclient5-fluent/dependency-info.html}Fluent HC}}
-
- {{{./httpclient5-cache/dependency-info.html}HttpClient Cache}}
-
-
diff --git a/src/site/apt/httpcomponents-client-5.0.x/examples-async.apt b/src/site/apt/httpcomponents-client-5.0.x/examples-async.apt
deleted file mode 100644
index 2eab500..0000000
--- a/src/site/apt/httpcomponents-client-5.0.x/examples-async.apt
+++ /dev/null
@@ -1,96 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Examples
- ----------
- ----------
- ----------
-
-HttpClient Examples (Async)
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.html}
- Asynchronous HTTP exchange}}
-
- This example demonstrates a basic asynchronous HTTP request / response exchange.
- Response content is buffered in memory for simplicity.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttpExchangeStreaming.html}
- Asynchronous HTTP exchange with content streaming}}
-
- This example demonstrates an asynchronous HTTP request / response exchange with a full content
- streaming.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientTlsAlpn.html}
- HTTP/2 ALPN support}}
-
- This example demonstrates how to avoid the illegal reflective access operation warning when running
- with Oracle JRE 9 or newer.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttp1Pipelining.html}
- Pipelined HTTP/1.1 exchanges}}
-
- This example demonstrates a pipelined execution of multiple HTTP/1.1 request / response exchanges.
- Response content is buffered in memory for simplicity.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttp2Multiplexing.html}
- Multiplexed HTTP/2 exchanges}}
-
- This example demonstrates a multiplexed execution of multiple HTTP/2 request / response exchanges.
- Response content is buffered in memory for simplicity.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientInterceptors.html}
- Request execution interceptors}}
-
- This example demonstrates how to insert custom request interceptor and an execution interceptor to the
- request execution chain.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientMessageTrailers.html}
- Message trailers}}
-
- This example demonstrates how to use a custom execution interceptor to add trailers to all
- outgoing request enclosing an entity..
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttp2ServerPush.html}
- Multiplexed HTTP/2 exchanges}}
-
- This example demonstrates handling of HTTP/2 message exchanges pushed by the server.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientAuthentication.html}
- Client authentication}}
-
- This example demonstrates execution of an HTTP request against a target site that requires user
- authentication.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientCustomSSL.html}
- Custom SSL context}}
-
- This example demonstrates how to create secure connections with a custom SSL context.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientConnectionEviction.html}
- Connection eviction}}
-
- This example demonstrates how to evict expired and idle connections from the connection pool.
-
-
diff --git a/src/site/apt/httpcomponents-client-5.0.x/examples-reactive.apt b/src/site/apt/httpcomponents-client-5.0.x/examples-reactive.apt
deleted file mode 100644
index aaf7c82..0000000
--- a/src/site/apt/httpcomponents-client-5.0.x/examples-reactive.apt
+++ /dev/null
@@ -1,36 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Examples
- ----------
- ----------
- ----------
-
-HttpClient Examples (Async)
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.html}
- HTTP exchange with Reactive Streams}}
-
- This example demonstrates a reactive, full-duplex HTTP/1.1 message exchange using RxJava.
diff --git a/src/site/apt/httpcomponents-client-5.0.x/examples.apt b/src/site/apt/httpcomponents-client-5.0.x/examples.apt
deleted file mode 100644
index 8333e90..0000000
--- a/src/site/apt/httpcomponents-client-5.0.x/examples.apt
+++ /dev/null
@@ -1,115 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Examples
- ----------
- ----------
- ----------
-
-HttpClient Examples (Classic)
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientWithResponseHandler.html}Response handling}}
-
- This example demonstrates how to process HTTP responses using a response handler. This is
- the recommended way of executing HTTP requests and processing HTTP responses. This approach
- enables the caller to concentrate on the process of digesting HTTP responses and to delegate
- the task of system resource deallocation to HttpClient. The use of an HTTP response handler
- guarantees that the underlying HTTP connection will be released back to the connection manager
- automatically in all cases.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientConnectionRelease.html}Manual connection release}}
-
- This example demonstrates how to ensure the release of the underlying HTTP connection back to
- the connection manager in case of a manual processing of HTTP responses.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientConfiguration.html}HttpClient configuration}}
-
- This example demonstrates how to customize and configure the most common aspects of HTTP request execution
- and connection management.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientInterceptors.html}Request execution interceptors}}
-
- This example demonstrates how to insert custom request interceptor and an execution interceptor to the
- request execution chain.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientAbortMethod.html}Abort method}}
-
- This example demonstrates how to abort an HTTP request before its normal completion.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientAuthentication.html}Client authentication}}
-
- This example uses HttpClient to execute an HTTP request against a target site that requires user
- authentication.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientExecuteProxy.html}Request via a proxy}}
-
- This example demonstrates how to send an HTTP request via a proxy.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientProxyAuthentication.html}Proxy authentication}}
-
- A simple example showing execution of an HTTP request over a secure connection tunneled through
- an authenticating proxy.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientChunkEncodedPost.html}Chunk encoded POST}}
-
- This example shows how to stream out a request entity using chunk encoding.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientCustomContext.html}Custom execution context}}
-
- This example demonstrates the use of a local HTTP context populated custom attributes.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientFormLogin.html}Form based logon}}
-
- This example demonstrates how HttpClient can be used to perform form-based logon.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientMultiThreadedExecution.html}Threaded request execution}}
-
- An example that executes HTTP requests from multiple worker threads.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientCustomSSL.html}Custom SSL context}}
-
- This example demonstrates how to create secure connections with a custom SSL context.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientPreemptiveBasicAuthentication.html}Preemptive BASIC authentication}}
-
- This example shows how HttpClient can be customized to authenticate preemptively using BASIC
- scheme. Generally, preemptive authentication can be considered less secure than a response to
- an authentication challenge and therefore discouraged.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientPreemptiveDigestAuthentication.html}Preemptive DIGEST authentication}}
-
- This example shows how HttpClient can be customized to authenticate preemptively using DIGEST
- scheme. Generally, preemptive authentication can be considered less secure than a response to
- an authentication challenge and therefore discouraged.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ProxyTunnelDemo.html}Proxy tunnel}}
-
- This example shows how to use ProxyClient in order to establish a tunnel through an HTTP proxy
- for an arbitrary protocol.
-
- * {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientMultipartFormPost.html}Multipart encoded request entity}}
-
- This example shows how to execute requests enclosing a multipart encoded entity.
-
diff --git a/src/site/apt/httpcomponents-client-5.0.x/index.apt b/src/site/apt/httpcomponents-client-5.0.x/index.apt
deleted file mode 100644
index 4fcbaab..0000000
--- a/src/site/apt/httpcomponents-client-5.0.x/index.apt
+++ /dev/null
@@ -1,86 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Overview
- ----------
- ----------
- ----------
-
-HttpClient Overview
-
- 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, while
- increasing the number of applications that require HTTP support.
-
- Although the java.net package provides basic functionality for accessing resources via HTTP, it
- doesn't provide the full flexibility or functionality needed by many applications. HttpClient
- 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.
-
- Designed for extension while providing robust support for the base HTTP protocol, HttpClient
- 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.
-
-{Documentation}
-
- [[1]] {{{./examples.html}HttpClient Examples}} - a set of examples demonstrating some of
- the more complex behavior.
-
- [[1]] Project reports
-
- * {{{./httpclient5/project-reports.html}HttpClient}}
-
- * {{{./httpclient5-fluent/project-reports.html}HC Fluent}}
-
- * {{{./httpclient5-cache/project-reports.html}HttpClient Cache}}
-
- * {{{./httpclient5-win/project-reports.html}HttpClient Windows extensions}}
-
-{Standards Compliance}
-
- HttpClient strives to conform to the following specifications endorsed by the Internet
- Engineering Task Force (IETF) and the internet at large:
-
- * {{{http://tools.ietf.org/html/rfc7230}RFC 7230}} - Hypertext Transfer Protocol (HTTP/1.1):
- Message Syntax and Routing
-
- * {{{http://tools.ietf.org/html/rfc7231}RFC 7231}} - Hypertext Transfer Protocol (HTTP/1.1):
- Semantics and Content
-
- * {{{http://tools.ietf.org/html/rfc7235}RFC 7235}} - Hypertext Transfer Protocol (HTTP/1.1):
- Authentication
-
- * {{{http://tools.ietf.org/html/rfc1945}RFC 1945}} - Hypertext Transfer Protocol -- HTTP/1.0
-
- * {{{http://tools.ietf.org/html/rfc2817}RFC 2817}} - Upgrading to TLS Within HTTP/1.1
-
- * {{{http://tools.ietf.org/html/rfc2818}RFC 2818}} - HTTP Over TLS
-
- * {{{http://tools.ietf.org/html/rfc6265}RFC 6265}} - HTTP State Management Mechanism (Cookies)
-
- * {{{http://tools.ietf.org/html/rfc2396}RFC 2396}} - Uniform Resource Identifiers (URI): Generic Syntax
-
diff --git a/src/site/apt/httpcomponents-client-5.0.x/quickstart.apt b/src/site/apt/httpcomponents-client-5.0.x/quickstart.apt
deleted file mode 100644
index 80f4ddb..0000000
--- a/src/site/apt/httpcomponents-client-5.0.x/quickstart.apt
+++ /dev/null
@@ -1,203 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpClient Quick Start
- ----------
- ----------
- ----------
-
-HttpClient Quick Start
-
- [[1]] Download 'Binary' package of the latest HttpClient 5.0 release or configure
- dependency on {{{./httpclient5/dependency-info.html}HttpClient}} and
- {{{./httpclient5-fluent/dependency-info.html}Fluent HC}} modules using a dependency
- manager of your choice as described {{{./download.html}here}}.
-
- [[1]] HttpClient 5.0 requires Java 1.7 or newer.
-
- [[1]] The below code fragment illustrates the execution of HTTP GET and POST requests using
- HttpClient classic API.
-
--------------
-
-try (CloseableHttpClient httpclient = HttpClients.createDefault()) {
- HttpGet httpGet = new HttpGet("http://httpbin.org/get");
- // The underlying HTTP connection is still held by the response object
- // to allow the response content to be streamed directly from the network socket.
- // In order to ensure correct deallocation of system resources
- // the user MUST call CloseableHttpResponse#close() from a finally clause.
- // Please note that if response content is not fully consumed the underlying
- // connection cannot be safely re-used and will be shut down and discarded
- // by the connection manager.
- try (CloseableHttpResponse response1 = httpclient.execute(httpGet)) {
- System.out.println(response1.getCode() + " " + response1.getReasonPhrase());
- HttpEntity entity1 = response1.getEntity();
- // do something useful with the response body
- // and ensure it is fully consumed
- EntityUtils.consume(entity1);
- }
-
- HttpPost httpPost = new HttpPost("http://httpbin.org/post");
- List<NameValuePair> nvps = new ArrayList<>();
- nvps.add(new BasicNameValuePair("username", "vip"));
- nvps.add(new BasicNameValuePair("password", "secret"));
- httpPost.setEntity(new UrlEncodedFormEntity(nvps));
-
- try (CloseableHttpResponse response2 = httpclient.execute(httpPost)) {
- System.out.println(response2.getCode() + " " + response2.getReasonPhrase());
- HttpEntity entity2 = response2.getEntity();
- // do something useful with the response body
- // and ensure it is fully consumed
- EntityUtils.consume(entity2);
- }
-}
--------------
-
- Source can be found here
- {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/QuickStart.html}here}}
-
- [[1]] The same requests can be executed using a simpler, albeit less flexible, fluent API.
-
--------------
-
-// The fluent API relieves the user from having to deal with manual deallocation of system
-// resources at the cost of having to buffer response content in memory in some cases.
-
-Request.Get("http://targethost/homepage")
- .execute().returnContent();
-Request.Post("http://targethost/login")
- .bodyForm(Form.form().add("username", "vip").add("password", "secret").build())
- .execute().returnContent();
-
--------------
-
- Source can be downloaded
- {{{./httpclient5-fluent/xref-test/org/apache/hc/client5/http/examples/fluent/FluentQuickStart.html}here}}
-
- [[1]] The below code fragment illustrates the execution of HTTP requests using
- HttpClient async API.
-
--------------
-
-try (CloseableHttpAsyncClient httpclient = HttpAsyncClients.createDefault()) {
- // Start the client
- httpclient.start();
-
- // Execute request
- SimpleHttpRequest request1 = SimpleHttpRequests.get("http://httpbin.org/get");
- Future<SimpleHttpResponse> future = httpclient.execute(request1, null);
- // and wait until response is received
- SimpleHttpResponse response1 = future.get();
- System.out.println(request1.getRequestUri() + "->" + response1.getCode());
-
- // One most likely would want to use a callback for operation result
- CountDownLatch latch1 = new CountDownLatch(1);
- SimpleHttpRequest request2 = SimpleHttpRequests.get("http://httpbin.org/get");
- httpclient.execute(request2, new FutureCallback<SimpleHttpResponse>() {
-
- @Override
- public void completed(SimpleHttpResponse response2) {
- latch1.countDown();
- System.out.println(request2.getRequestUri() + "->" + response2.getCode());
- }
-
- @Override
- public void failed(Exception ex) {
- latch1.countDown();
- System.out.println(request2.getRequestUri() + "->" + ex);
- }
-
- @Override
- public void cancelled() {
- latch1.countDown();
- System.out.println(request2.getRequestUri() + " cancelled");
- }
-
- });
- latch1.await();
-
- // In real world one most likely would want also want to stream
- // request and response body content
- CountDownLatch latch2 = new CountDownLatch(1);
- AsyncRequestProducer producer3 = AsyncRequestBuilder.get("http://httpbin.org/get").build();
- AbstractCharResponseConsumer<HttpResponse> consumer3 = new AbstractCharResponseConsumer<HttpResponse>() {
-
- HttpResponse response;
-
- @Override
- protected void start(HttpResponse response, ContentType contentType) throws HttpException, IOException {
- this.response = response;
- }
-
- @Override
- protected int capacityIncrement() {
- return Integer.MAX_VALUE;
- }
-
- @Override
- protected void data(CharBuffer data, boolean endOfStream) throws IOException {
- // Do something useful
- }
-
- @Override
- protected HttpResponse buildResult() throws IOException {
- return response;
- }
-
- @Override
- public void releaseResources() {
- }
-
- };
- httpclient.execute(producer3, consumer3, new FutureCallback<HttpResponse>() {
-
- @Override
- public void completed(HttpResponse response3) {
- latch2.countDown();
- System.out.println(request2.getRequestUri() + "->" + response3.getCode());
- }
-
- @Override
- public void failed(Exception ex) {
- latch2.countDown();
- System.out.println(request2.getRequestUri() + "->" + ex);
- }
-
- @Override
- public void cancelled() {
- latch2.countDown();
- System.out.println(request2.getRequestUri() + " cancelled");
- }
-
- });
- latch2.await();
-
-}
----
-
- Source can be downloaded
- {{{./httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncQuickStart.java}here}}
-
-
diff --git a/src/site/apt/httpcomponents-client-5.1.x/download.apt b/src/site/apt/httpcomponents-client-5.1.x/download.apt
deleted file mode 100644
index 640b664..0000000
--- a/src/site/apt/httpcomponents-client-5.1.x/download.apt
+++ /dev/null
@@ -1,54 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Download Page
- ----------
- ----------
- ----------
-
-HttpClient Downloads
-
- The latest release available for download:
-
- {{{http://hc.apache.org/downloads.cgi}Release packages}} -
- {{{http://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES-5.1.x.txt}Release Notes}} -
- {{{http://www.apache.org/licenses/LICENSE-2.0.html}License}}
-
-{Dependency management}
-
- If you are using a dependency manager for your project such as
- {{{http://maven.apache.org}Apache Maven}} or
- {{{http://ant.apache.org/projects/ivy.html}Apache Ivy}},
- you can create a dependency on HttpClient modules by using this information:
-
- {{{https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5}HttpClient}}
-
- {{{https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-fluent}Fluent HC}}
-
- {{{https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-cache}HttpClient Cache}}
-
- {{{https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-win}HttpClient Windows
- extensions}}
-
diff --git a/src/site/apt/httpcomponents-client-5.1.x/examples-async.apt b/src/site/apt/httpcomponents-client-5.1.x/examples-async.apt
deleted file mode 100644
index 1c4fa58..0000000
--- a/src/site/apt/httpcomponents-client-5.1.x/examples-async.apt
+++ /dev/null
@@ -1,96 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Examples
- ----------
- ----------
- ----------
-
-HttpClient Examples (Async)
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.html}
- Asynchronous HTTP exchange}}
-
- This example demonstrates a basic asynchronous HTTP request / response exchange.
- Response content is buffered in memory for simplicity.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttpExchangeStreaming.html}
- Asynchronous HTTP exchange with content streaming}}
-
- This example demonstrates an asynchronous HTTP request / response exchange with a full content
- streaming.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientTlsAlpn.html}
- HTTP/2 ALPN support}}
-
- This example demonstrates how to avoid the illegal reflective access operation warning when running
- with Oracle JRE 9 or newer.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttp1Pipelining.html}
- Pipelined HTTP/1.1 exchanges}}
-
- This example demonstrates a pipelined execution of multiple HTTP/1.1 request / response exchanges.
- Response content is buffered in memory for simplicity.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttp2Multiplexing.html}
- Multiplexed HTTP/2 exchanges}}
-
- This example demonstrates a multiplexed execution of multiple HTTP/2 request / response exchanges.
- Response content is buffered in memory for simplicity.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientInterceptors.html}
- Request execution interceptors}}
-
- This example demonstrates how to insert custom request interceptor and an execution interceptor to the
- request execution chain.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientMessageTrailers.html}
- Message trailers}}
-
- This example demonstrates how to use a custom execution interceptor to add trailers to all
- outgoing request enclosing an entity..
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttp2ServerPush.html}
- Multiplexed HTTP/2 exchanges}}
-
- This example demonstrates handling of HTTP/2 message exchanges pushed by the server.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientAuthentication.html}
- Client authentication}}
-
- This example demonstrates execution of an HTTP request against a target site that requires user
- authentication.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientCustomSSL.html}
- Custom SSL context}}
-
- This example demonstrates how to create secure connections with a custom SSL context.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientConnectionEviction.html}
- Connection eviction}}
-
- This example demonstrates how to evict expired and idle connections from the connection pool.
-
-
diff --git a/src/site/apt/httpcomponents-client-5.1.x/examples-reactive.apt b/src/site/apt/httpcomponents-client-5.1.x/examples-reactive.apt
deleted file mode 100644
index 781b7bd..0000000
--- a/src/site/apt/httpcomponents-client-5.1.x/examples-reactive.apt
+++ /dev/null
@@ -1,36 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Examples
- ----------
- ----------
- ----------
-
-HttpClient Examples (Async)
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.html}
- HTTP exchange with Reactive Streams}}
-
- This example demonstrates a reactive, full-duplex HTTP/1.1 message exchange using RxJava.
diff --git a/src/site/apt/httpcomponents-client-5.1.x/examples.apt b/src/site/apt/httpcomponents-client-5.1.x/examples.apt
deleted file mode 100644
index 26c1125..0000000
--- a/src/site/apt/httpcomponents-client-5.1.x/examples.apt
+++ /dev/null
@@ -1,115 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Examples
- ----------
- ----------
- ----------
-
-HttpClient Examples (Classic)
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientWithResponseHandler.html}Response handling}}
-
- This example demonstrates how to process HTTP responses using a response handler. This is
- the recommended way of executing HTTP requests and processing HTTP responses. This approach
- enables the caller to concentrate on the process of digesting HTTP responses and to delegate
- the task of system resource deallocation to HttpClient. The use of an HTTP response handler
- guarantees that the underlying HTTP connection will be released back to the connection manager
- automatically in all cases.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientConnectionRelease.html}Manual connection release}}
-
- This example demonstrates how to ensure the release of the underlying HTTP connection back to
- the connection manager in case of a manual processing of HTTP responses.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientConfiguration.html}HttpClient configuration}}
-
- This example demonstrates how to customize and configure the most common aspects of HTTP request execution
- and connection management.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientInterceptors.html}Request execution interceptors}}
-
- This example demonstrates how to insert custom request interceptor and an execution interceptor to the
- request execution chain.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientAbortMethod.html}Abort method}}
-
- This example demonstrates how to abort an HTTP request before its normal completion.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientAuthentication.html}Client authentication}}
-
- This example uses HttpClient to execute an HTTP request against a target site that requires user
- authentication.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientExecuteProxy.html}Request via a proxy}}
-
- This example demonstrates how to send an HTTP request via a proxy.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientProxyAuthentication.html}Proxy authentication}}
-
- A simple example showing execution of an HTTP request over a secure connection tunneled through
- an authenticating proxy.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientChunkEncodedPost.html}Chunk encoded POST}}
-
- This example shows how to stream out a request entity using chunk encoding.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientCustomContext.html}Custom execution context}}
-
- This example demonstrates the use of a local HTTP context populated custom attributes.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientFormLogin.html}Form based logon}}
-
- This example demonstrates how HttpClient can be used to perform form-based logon.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientMultiThreadedExecution.html}Threaded request execution}}
-
- An example that executes HTTP requests from multiple worker threads.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientCustomSSL.html}Custom SSL context}}
-
- This example demonstrates how to create secure connections with a custom SSL context.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientPreemptiveBasicAuthentication.html}Preemptive BASIC authentication}}
-
- This example shows how HttpClient can be customized to authenticate preemptively using BASIC
- scheme. Generally, preemptive authentication can be considered less secure than a response to
- an authentication challenge and therefore discouraged.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientPreemptiveDigestAuthentication.html}Preemptive DIGEST authentication}}
-
- This example shows how HttpClient can be customized to authenticate preemptively using DIGEST
- scheme. Generally, preemptive authentication can be considered less secure than a response to
- an authentication challenge and therefore discouraged.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ProxyTunnelDemo.html}Proxy tunnel}}
-
- This example shows how to use ProxyClient in order to establish a tunnel through an HTTP proxy
- for an arbitrary protocol.
-
- * {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/ClientMultipartFormPost.html}Multipart encoded request entity}}
-
- This example shows how to execute requests enclosing a multipart encoded entity.
-
diff --git a/src/site/apt/httpcomponents-client-5.1.x/index.apt b/src/site/apt/httpcomponents-client-5.1.x/index.apt
deleted file mode 100644
index bc432ef..0000000
--- a/src/site/apt/httpcomponents-client-5.1.x/index.apt
+++ /dev/null
@@ -1,105 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpClient Overview
- ----------
- ----------
- ----------
-
-HttpClient Overview
-
- 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, while
- increasing the number of applications that require HTTP support.
-
- Although the java.net package provides basic functionality for accessing resources via HTTP, it
- doesn't provide the full flexibility or functionality needed by many applications. HttpClient
- 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.
-
- Designed for extension while providing robust support for the base HTTP protocol, HttpClient
- 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.
-
-{Documentation}
-
- [[1]] Examples demonstrating some common as well as more complex use cases
-
- * {{{./examples.html}HttpClient (classic APIs)}}
-
- * {{{./examples-async.html}HttpClient (async APIs)}}
-
- * {{{./examples-reactive.html}HttpClient (reactive APIs)}}
-
- []
-
- [[1]] Javadocs
-
- * {{{./current/httpclient5/apidocs/}HttpClient}}
-
- * {{{./current/httpclient5-fluent/apidocs/}HC Fluent}}
-
- * {{{./current/httpclient5-cache/apidocs/}HttpClient Cache}}
-
- * {{{./current/httpclient5-win/apidocs/}HttpClient Windows extensions}}
-
- []
-
- [[1]] API compatibility reports
-
- * {{{./current/httpclient5/clirr-report.html}HttpClient}}
-
- * {{{./current/httpclient5-fluent/clirr-report.html}HC Fluent}}
-
- * {{{./current/httpclient5-cache/clirr-report.html}HttpClient Cache}}
-
- * {{{./current/httpclient5-win/clirr-report.html}HttpClient Windows extensions}}
-
-{Standards Compliance}
-
- HttpClient strives to conform to the following specifications endorsed by the Internet
- Engineering Task Force (IETF) and the internet at large:
-
- * {{{http://tools.ietf.org/html/rfc7230}RFC 7230}} - Hypertext Transfer Protocol (HTTP/1.1):
- Message Syntax and Routing
-
- * {{{http://tools.ietf.org/html/rfc7231}RFC 7231}} - Hypertext Transfer Protocol (HTTP/1.1):
- Semantics and Content
-
- * {{{http://tools.ietf.org/html/rfc7235}RFC 7235}} - Hypertext Transfer Protocol (HTTP/1.1):
- Authentication
-
- * {{{http://tools.ietf.org/html/rfc1945}RFC 1945}} - Hypertext Transfer Protocol -- HTTP/1.0
-
- * {{{http://tools.ietf.org/html/rfc2817}RFC 2817}} - Upgrading to TLS Within HTTP/1.1
-
- * {{{http://tools.ietf.org/html/rfc2818}RFC 2818}} - HTTP Over TLS
-
- * {{{http://tools.ietf.org/html/rfc6265}RFC 6265}} - HTTP State Management Mechanism (Cookies)
-
- * {{{http://tools.ietf.org/html/rfc3986}RFC 3986}} - Uniform Resource Identifiers (URI): Generic Syntax
-
diff --git a/src/site/apt/httpcomponents-client-5.1.x/quickstart.apt b/src/site/apt/httpcomponents-client-5.1.x/quickstart.apt
deleted file mode 100644
index 2ca05f8..0000000
--- a/src/site/apt/httpcomponents-client-5.1.x/quickstart.apt
+++ /dev/null
@@ -1,202 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpClient Quick Start
- ----------
- ----------
- ----------
-
-HttpClient Quick Start
-
- [[1]] Download 'Binary' package of the latest HttpClient 5.1 release or configure
- dependency on HttpClient and Fluent HC modules using a dependency manager of your
- choice as described {{{./download.html}here}}.
-
- [[1]] HttpClient 5.1 requires Java 1.7 or newer.
-
- [[1]] The below code fragment illustrates the execution of HTTP GET and POST requests using
- HttpClient classic API.
-
--------------
-
-try (CloseableHttpClient httpclient = HttpClients.createDefault()) {
- HttpGet httpGet = new HttpGet("http://httpbin.org/get");
- // The underlying HTTP connection is still held by the response object
- // to allow the response content to be streamed directly from the network socket.
- // In order to ensure correct deallocation of system resources
- // the user MUST call CloseableHttpResponse#close() from a finally clause.
- // Please note that if response content is not fully consumed the underlying
- // connection cannot be safely re-used and will be shut down and discarded
- // by the connection manager.
- try (CloseableHttpResponse response1 = httpclient.execute(httpGet)) {
- System.out.println(response1.getCode() + " " + response1.getReasonPhrase());
- HttpEntity entity1 = response1.getEntity();
- // do something useful with the response body
- // and ensure it is fully consumed
- EntityUtils.consume(entity1);
- }
-
- HttpPost httpPost = new HttpPost("http://httpbin.org/post");
- List<NameValuePair> nvps = new ArrayList<>();
- nvps.add(new BasicNameValuePair("username", "vip"));
- nvps.add(new BasicNameValuePair("password", "secret"));
- httpPost.setEntity(new UrlEncodedFormEntity(nvps));
-
- try (CloseableHttpResponse response2 = httpclient.execute(httpPost)) {
- System.out.println(response2.getCode() + " " + response2.getReasonPhrase());
- HttpEntity entity2 = response2.getEntity();
- // do something useful with the response body
- // and ensure it is fully consumed
- EntityUtils.consume(entity2);
- }
-}
--------------
-
- Source can be found here
- {{{./current/httpclient5/xref-test/org/apache/hc/client5/http/examples/QuickStart.html}here}}
-
- [[1]] The same requests can be executed using a simpler, albeit less flexible, fluent API.
-
--------------
-
-// The fluent API relieves the user from having to deal with manual deallocation of system
-// resources at the cost of having to buffer response content in memory in some cases.
-
-Request.Get("http://targethost/homepage")
- .execute().returnContent();
-Request.Post("http://targethost/login")
- .bodyForm(Form.form().add("username", "vip").add("password", "secret").build())
- .execute().returnContent();
-
--------------
-
- Source can be downloaded
- {{{./current/httpclient5-fluent/xref-test/org/apache/hc/client5/http/examples/fluent/FluentQuickStart.html}here}}
-
- [[1]] The below code fragment illustrates the execution of HTTP requests using
- HttpClient async API.
-
--------------
-
-try (CloseableHttpAsyncClient httpclient = HttpAsyncClients.createDefault()) {
- // Start the client
- httpclient.start();
-
- // Execute request
- SimpleHttpRequest request1 = SimpleHttpRequests.get("http://httpbin.org/get");
- Future<SimpleHttpResponse> future = httpclient.execute(request1, null);
- // and wait until response is received
- SimpleHttpResponse response1 = future.get();
- System.out.println(request1.getRequestUri() + "->" + response1.getCode());
-
- // One most likely would want to use a callback for operation result
- CountDownLatch latch1 = new CountDownLatch(1);
- SimpleHttpRequest request2 = SimpleHttpRequests.get("http://httpbin.org/get");
- httpclient.execute(request2, new FutureCallback<SimpleHttpResponse>() {
-
- @Override
- public void completed(SimpleHttpResponse response2) {
- latch1.countDown();
- System.out.println(request2.getRequestUri() + "->" + response2.getCode());
- }
-
- @Override
- public void failed(Exception ex) {
- latch1.countDown();
- System.out.println(request2.getRequestUri() + "->" + ex);
- }
-
- @Override
- public void cancelled() {
- latch1.countDown();
- System.out.println(request2.getRequestUri() + " cancelled");
- }
-
- });
- latch1.await();
-
- // In real world one most likely would want also want to stream
- // request and response body content
- CountDownLatch latch2 = new CountDownLatch(1);
- AsyncRequestProducer producer3 = AsyncRequestBuilder.get("http://httpbin.org/get").build();
- AbstractCharResponseConsumer<HttpResponse> consumer3 = new AbstractCharResponseConsumer<HttpResponse>() {
-
- HttpResponse response;
-
- @Override
- protected void start(HttpResponse response, ContentType contentType) throws HttpException, IOException {
- this.response = response;
- }
-
- @Override
- protected int capacityIncrement() {
- return Integer.MAX_VALUE;
- }
-
- @Override
- protected void data(CharBuffer data, boolean endOfStream) throws IOException {
- // Do something useful
- }
-
- @Override
- protected HttpResponse buildResult() throws IOException {
- return response;
- }
-
- @Override
- public void releaseResources() {
- }
-
- };
- httpclient.execute(producer3, consumer3, new FutureCallback<HttpResponse>() {
-
- @Override
- public void completed(HttpResponse response3) {
- latch2.countDown();
- System.out.println(request2.getRequestUri() + "->" + response3.getCode());
- }
-
- @Override
- public void failed(Exception ex) {
- latch2.countDown();
- System.out.println(request2.getRequestUri() + "->" + ex);
- }
-
- @Override
- public void cancelled() {
- latch2.countDown();
- System.out.println(request2.getRequestUri() + " cancelled");
- }
-
- });
- latch2.await();
-
-}
----
-
- Source can be downloaded
- {{{./current/org/apache/hc/client5/http/examples/AsyncQuickStart.java}here}}
-
-
diff --git a/src/site/apt/httpcomponents-core-4.4.x/download.apt b/src/site/apt/httpcomponents-core-4.4.x/download.apt
deleted file mode 100644
index bf8a0dd..0000000
--- a/src/site/apt/httpcomponents-core-4.4.x/download.apt
+++ /dev/null
@@ -1,50 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpCore Download Page
- ----------
- ----------
- ----------
-
-HttpCore Downloads
-
- The latest release available for download:
-
- {{{http://hc.apache.org/downloads.cgi}Release packages}} -
- {{{http://www.apache.org/dist/httpcomponents/httpcore/RELEASE_NOTES-4.4.x.txt}Release Notes}} -
- {{{http://www.apache.org/licenses/LICENSE-2.0.html}License}}
-
-{Dependency management}
-
- If you are using a dependency manager for your project such as
- {{{http://maven.apache.org}Apache Maven}} or
- {{{http://ant.apache.org/projects/ivy.html}Apache Ivy}},
- you can create a dependency on HttpClient modules by using this information:
-
- {{{./httpcore/dependency-info.html}HttpCore}}
-
- {{{./httpcore-nio/dependency-info.html}HttpCore NIO}}
-
-
diff --git a/src/site/apt/httpcomponents-core-4.4.x/examples.apt b/src/site/apt/httpcomponents-core-4.4.x/examples.apt
deleted file mode 100644
index 69d28f2..0000000
--- a/src/site/apt/httpcomponents-core-4.4.x/examples.apt
+++ /dev/null
@@ -1,83 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpCore Examples
- ----------
- ----------
- ----------
-
-HttpCore Examples
-
- * {{{./httpcore/examples/org/apache/http/examples/ElementalHttpGet.java} Synchronous HTTP GET
- requests}}
-
- This example demonstrates how to execute a series of synchronous (blocking) HTTP GET requests.
-
- * {{{./httpcore/examples/org/apache/http/examples/ElementalHttpPost.java} Synchronous HTTP POST
- requests}}
-
- This example demonstrates how to execute a series of synchronous (blocking) HTTP POST requests
- that enclose entity content of various types: a string, a byte array, an arbitrary input stream.
-
- * {{{./httpcore/examples/org/apache/http/examples/ElementalPoolingHttpGet.java} Synchronous
- HTTP GET requests with connection pooling}}
-
- This example demonstrates how to execute a series of synchronous (blocking) HTTP GET requests
- using a pool of perssitent connections.
-
- * {{{./httpcore/examples/org/apache/http/examples/HttpFileServer.java} Synchronous HTTP file
- server}}
-
- This is an example of an HTTP/1.1 file server based on a synchronous (blocking) I/O model.
-
- * {{{./httpcore/examples/org/apache/http/examples/ElementalReverseProxy.java} Synchronous HTTP
- reverse proxy}}
-
- This is an example of an HTTP/1.1 reverse proxy based on a synchronous (blocking) I/O model.
-
- * {{{./httpcore-nio/examples/org/apache/http/examples/nio/NHttpClient.java} Asynchronous HTTP
- GET requests}}
-
- This example demonstrates how HttpCore NIO can be used to execute multiple HTTP requests
- asynchronously.
-
- * {{{./httpcore-nio/examples/org/apache/http/examples/nio/PipeliningHttpClient.java} Pipelined
- HTTP GET requests}}
-
- This example demonstrates how HttpCore NIO can be used to execute series of pipelined HTTP
- requests.
-
- * {{{./httpcore-nio/examples/org/apache/http/examples/nio/NHttpFileServer.java} Asynchronous HTTP
- server}}
-
- This example demonstrates the use of HttpCore NIO to build an asynchronous (non-blocking)
- HTTP server capable of direct channel (zero copy) data transfer.
-
- * {{{./httpcore-nio/examples/org/apache/http/examples/nio/NHttpReverseProxy.java} Asynchronous
- HTTP reverse proxy}}
-
- This example demonstrates how HttpCore NIO can be used to build an asynchronous, fully
- streaming reverse HTTP proxy.
-
diff --git a/src/site/apt/httpcomponents-core-4.4.x/index.apt b/src/site/apt/httpcomponents-core-4.4.x/index.apt
deleted file mode 100644
index a39ce8c..0000000
--- a/src/site/apt/httpcomponents-core-4.4.x/index.apt
+++ /dev/null
@@ -1,57 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpCore Overview
- ----------
- ----------
- ----------
-
-HttpCore Overview
-
- HttpCore is a set of low level HTTP transport components that can be used to build custom
- client and server side HTTP services with a minimal footprint. HttpCore supports two I/O models:
- blocking I/O model based on the classic Java I/O and non-blocking, event driven I/O model based
- on Java NIO.
-
-{Documentation}
-
- [[1]] HttpCore Tutorial ( {{{./tutorial/html/index.html}HTML}} / {{{./tutorial/pdf/httpcore-tutorial.pdf}PDF}} )
-
- [[1]] Some examples of HttpCore components in action can be found {{{./examples.html}here}}
-
- [[1]] Project reports
-
- * {{{./httpcore/project-reports.html}HttpCore}}
-
- * {{{./httpcore-nio/project-reports.html}HttpCore NIO}}
-
-{Standards Compliance}
-
- HttpCore components strive to conform to the following specifications endorsed by the Internet
- Engineering Task Force (IETF) and the internet at large:
-
- * {{{http://tools.ietf.org/html/rfc1945}RFC 1945}} - Hypertext Transfer Protocol -- HTTP/1.0
-
- * {{{http://tools.ietf.org/html/rfc2616}RFC 2616}} - Hypertext Transfer Protocol -- HTTP/1.1
diff --git a/src/site/apt/httpcomponents-core-5.0.x/download.apt b/src/site/apt/httpcomponents-core-5.0.x/download.apt
deleted file mode 100644
index 489b84b..0000000
--- a/src/site/apt/httpcomponents-core-5.0.x/download.apt
+++ /dev/null
@@ -1,50 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpCore Download Page
- ----------
- ----------
- ----------
-
-HttpCore Downloads
-
- The latest release available for download:
-
- {{{http://hc.apache.org/downloads.cgi}Release packages}} -
- {{{http://www.apache.org/dist/httpcomponents/httpcore/RELEASE_NOTES-5.0.x.txt}Release Notes}} -
- {{{http://www.apache.org/licenses/LICENSE-2.0.html}License}}
-
-{Dependency management}
-
- If you are using a dependency manager for your project such as
- {{{http://maven.apache.org}Apache Maven}} or
- {{{http://ant.apache.org/projects/ivy.html}Apache Ivy}},
- you can create a dependency on HttpClient modules by using this information:
-
- {{{./httpcore5/dependency-info.html}HttpCore HTTP/1.1}}
- {{{./httpcore5-h2/dependency-info.html}HttpCore HTTP/2}}
- {{{./httpcore5-reactive/dependency-info.html}HttpCore Reactive Streams}}
- {{{./httpcore5-testing/dependency-info.html}HttpCore testing support}}
-
diff --git a/src/site/apt/httpcomponents-core-5.0.x/examples.apt b/src/site/apt/httpcomponents-core-5.0.x/examples.apt
deleted file mode 100644
index a2af86b..0000000
--- a/src/site/apt/httpcomponents-core-5.0.x/examples.apt
+++ /dev/null
@@ -1,122 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpCore Examples
- ----------
- ----------
- ----------
-
-HttpCore Examples
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicGetExecutionExample.html}
- Classic (blocking) HTTP/1.1 GET requests}}
-
- This example demonstrates synchronous execution of multiple HTTP/1.1 GET requests.
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicPostExecutionExample.html}
- Classic (blocking) HTTP/1.1 POST requests}}
-
- This example demonstrates synchronous execution of multiple HTTP/1.1 POST requests with enclosed
- content of various types.
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncRequestExecutionExample.html}
- Asynchronous HTTP/1.1 GET requests}}
-
- This example demonstrates asynchronous execution of multiple HTTP/1.1 requests.
-
- * {{{./httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2RequestExecutionExample.html}
- Asynchronous HTTP/2 GET requests}}
-
- This example demonstrates asynchronous execution of multiple HTTP/2 requests.
-
- * {{{./httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2TlsAlpnRequestExecutionExample.html}
- HTTP/2 requests over TLS connections with ALPN support}}
-
- This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support.
- It also explains how to avoid the illegal reflective access operation warning when running
- Java 9 or older.
-
- * {{{./httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2ConscriptRequestExecutionExample.html}
- HTTP/2 requests over TLS connections with ALPN support on Java 1.7 and Java 1.8}}
-
- This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support
- on Java 1.7 and Java 1.8.
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncPipelinedRequestExecutionExample.html}
- Asynchronous HTTP/1.1 GET requests with message pipelining}}
-
- This example demonstrates asynchronous, pipelined execution multiple HTTP/1.1 requests.
-
- * {{{./httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2MultiStreamExecutionExample.html}
- Asynchronous HTTP/2 GET requests with multiple concurrent streams}}
-
- This example demonstrates asynchronous, multistream execution of multiple HTTP/2 requests.
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicFileServerExample.html}
- Classic (blocking) HTTP/1.1 file server}}
-
- This is an example of an embedded HTTP/1.1 file server with a classic (blocking) message transport.
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicServerFilterExample.html}
- Request filters with classic (blocking) HTTP/1.1 server}}
-
- This is an example of using synchronous request filters with an embedded HTTP/1.1 server.
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncFileServerExample.html}
- Asynchronous HTTP/1.1 file server}}
-
- This is an example of an embedded HTTP/1.1 file server with an event driven, non-blocking message transport.
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncServerFilterExample.html}
- Request filters with asynchronous HTTP/1.1 server}}
-
- This is an example of using asynchronous request filters with an embedded HTTP/1.1 server.
-
- * {{{./httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2FileServerExample.html}
- Asynchronous HTTP/2 file server}}
-
- This is an example of an embedded HTTP/2 file server with an event driven, non-blocking message transport.
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicReverseProxyExample.html}
- Classic (blocking) HTTP reverse proxy}}
-
- This is an example of an embedded HTTP/1.1 reverse proxy with a classic (blocking) message transport.
-
- * {{{./httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncReverseProxyExample.html}
- Asynchronous HTTP reverse proxy}}
-
- This is an example of an embedded HTTP/1.1 reverse proxy with an event driven, non-blocking message transport.
-
-HttpCore Reactive Streams Examples
-
- * {{{./httpcore5-reactive/xref-test/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexClientExample.html}
- Client Reactive Streams}}
-
- This is an example of full-duplex HTTP/1.1 client side message exchanges using reactive streaming.
-
- * {{{./httpcore5-reactive/xref-test/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexServerExample.html}
- Server Reactive Streams}}
-
- This is an example of full-duplex HTTP/1.1 server side message exchanges using reactive streaming.
diff --git a/src/site/apt/httpcomponents-core-5.0.x/index.apt b/src/site/apt/httpcomponents-core-5.0.x/index.apt
deleted file mode 100644
index 3bf0b44..0000000
--- a/src/site/apt/httpcomponents-core-5.0.x/index.apt
+++ /dev/null
@@ -1,71 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpCore Overview
- ----------
- ----------
- ----------
-
-HttpCore Overview
-
- HttpCore is a set of low level HTTP transport components that can be used to build custom
- client and server side HTTP services with a minimal footprint. HttpCore supports two I/O models:
- blocking I/O model based on the classic Java I/O and non-blocking, event driven I/O model based
- on Java NIO.
-
-{Documentation}
-
- [[1]] Some examples of HttpCore components in action can be found {{{./examples.html}here}}
-
- [[1]] Project reports
-
- * {{{./httpcore5/project-reports.html}HttpCore HTTP/1.1}}
-
- * {{{./httpcore5-h2/project-reports.html}HttpCore HTTP/2}}
-
- * {{{./httpcore5-reactive/project-reports.html}HttpCore Reactive Streams}}
-
- * {{{./httpcore5-testing/project-reports.html}HttpCore testing support}}
-
-{Standards Compliance}
-
- HttpCore components strive to conform to the following specifications endorsed by the Internet
- Engineering Task Force (IETF) and the internet at large:
-
- * {{{http://tools.ietf.org/html/rfc7540}RFC 7540}} - Hypertext Transfer Protocol Version 2
- (HTTP/2)
-
- * {{{http://tools.ietf.org/html/rfc7541}RFC 7541}} - HPACK: Header Compression for HTTP/2
-
- * {{{http://tools.ietf.org/html/rfc7230}RFC 7230}} - Hypertext Transfer Protocol (HTTP/1.1):
- Message Syntax and Routing
-
- * {{{http://tools.ietf.org/html/rfc7231}RFC 7231}} - Hypertext Transfer Protocol (HTTP/1.1):
- Semantics and Content
-
- * {{{http://tools.ietf.org/html/rfc1945}RFC 1945}} - Hypertext Transfer Protocol -- HTTP/1.0
-
- * {{{http://tools.ietf.org/html/rfc2396}RFC 2396}} - Uniform Resource Identifiers (URI): Generic Syntax
-
diff --git a/src/site/apt/httpcomponents-core-5.1.x/download.apt b/src/site/apt/httpcomponents-core-5.1.x/download.apt
deleted file mode 100644
index 5c85bd9..0000000
--- a/src/site/apt/httpcomponents-core-5.1.x/download.apt
+++ /dev/null
@@ -1,53 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpCore Download Page
- ----------
- ----------
- ----------
-
-HttpCore Downloads
-
- The latest release available for download:
-
- {{{http://hc.apache.org/downloads.cgi}Release packages}} -
- {{{http://www.apache.org/dist/httpcomponents/httpcore/RELEASE_NOTES-5.1.x.txt}Release Notes}} -
- {{{http://www.apache.org/licenses/LICENSE-2.0.html}License}}
-
-{Dependency management}
-
- If you are using a dependency manager for your project such as
- {{{http://maven.apache.org}Apache Maven}} or
- {{{http://ant.apache.org/projects/ivy.html}Apache Ivy}},
- you can create a dependency on HttpClient modules by using this information:
-
- {{{https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5}HttpCore HTTP/1.1}}
-
- {{{https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5-h2}HttpCore HTTP/2}}
-
- {{{https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5-reactive}HttpCore Reactive Streams}}
-
- {{{https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5-testing}HttpCore testing support}}
-
diff --git a/src/site/apt/httpcomponents-core-5.1.x/examples.apt b/src/site/apt/httpcomponents-core-5.1.x/examples.apt
deleted file mode 100644
index 84e2a6f..0000000
--- a/src/site/apt/httpcomponents-core-5.1.x/examples.apt
+++ /dev/null
@@ -1,122 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpCore Examples
- ----------
- ----------
- ----------
-
-HttpCore Examples
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicGetExecutionExample.html}
- Classic (blocking) HTTP/1.1 GET requests}}
-
- This example demonstrates synchronous execution of multiple HTTP/1.1 GET requests.
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicPostExecutionExample.html}
- Classic (blocking) HTTP/1.1 POST requests}}
-
- This example demonstrates synchronous execution of multiple HTTP/1.1 POST requests with enclosed
- content of various types.
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncRequestExecutionExample.html}
- Asynchronous HTTP/1.1 GET requests}}
-
- This example demonstrates asynchronous execution of multiple HTTP/1.1 requests.
-
- * {{{./current/httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2RequestExecutionExample.html}
- Asynchronous HTTP/2 GET requests}}
-
- This example demonstrates asynchronous execution of multiple HTTP/2 requests.
-
- * {{{./current/httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2TlsAlpnRequestExecutionExample.html}
- HTTP/2 requests over TLS connections with ALPN support}}
-
- This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support.
- It also explains how to avoid the illegal reflective access operation warning when running
- Java 9 or older.
-
- * {{{./current/httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2ConscriptRequestExecutionExample.html}
- HTTP/2 requests over TLS connections with ALPN support on Java 1.7 and Java 1.8}}
-
- This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support
- on Java 1.7 and Java 1.8.
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncPipelinedRequestExecutionExample.html}
- Asynchronous HTTP/1.1 GET requests with message pipelining}}
-
- This example demonstrates asynchronous, pipelined execution multiple HTTP/1.1 requests.
-
- * {{{./current/httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2MultiStreamExecutionExample.html}
- Asynchronous HTTP/2 GET requests with multiple concurrent streams}}
-
- This example demonstrates asynchronous, multistream execution of multiple HTTP/2 requests.
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicFileServerExample.html}
- Classic (blocking) HTTP/1.1 file server}}
-
- This is an example of an embedded HTTP/1.1 file server with a classic (blocking) message transport.
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicServerFilterExample.html}
- Request filters with classic (blocking) HTTP/1.1 server}}
-
- This is an example of using synchronous request filters with an embedded HTTP/1.1 server.
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncFileServerExample.html}
- Asynchronous HTTP/1.1 file server}}
-
- This is an example of an embedded HTTP/1.1 file server with an event driven, non-blocking message transport.
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncServerFilterExample.html}
- Request filters with asynchronous HTTP/1.1 server}}
-
- This is an example of using asynchronous request filters with an embedded HTTP/1.1 server.
-
- * {{{./current/httpcore5-h2/xref-test/org/apache/hc/core5/http2/examples/H2FileServerExample.html}
- Asynchronous HTTP/2 file server}}
-
- This is an example of an embedded HTTP/2 file server with an event driven, non-blocking message transport.
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/ClassicReverseProxyExample.html}
- Classic (blocking) HTTP reverse proxy}}
-
- This is an example of an embedded HTTP/1.1 reverse proxy with a classic (blocking) message transport.
-
- * {{{./current/httpcore5/xref-test/org/apache/hc/core5/http/examples/AsyncReverseProxyExample.html}
- Asynchronous HTTP reverse proxy}}
-
- This is an example of an embedded HTTP/1.1 reverse proxy with an event driven, non-blocking message transport.
-
-HttpCore Reactive Streams Examples
-
- * {{{./current/httpcore5-reactive/xref-test/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexClientExample.html}
- Client Reactive Streams}}
-
- This is an example of full-duplex HTTP/1.1 client side message exchanges using reactive streaming.
-
- * {{{./current/httpcore5-reactive/xref-test/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexServerExample.html}
- Server Reactive Streams}}
-
- This is an example of full-duplex HTTP/1.1 server side message exchanges using reactive streaming.
diff --git a/src/site/apt/httpcomponents-core-5.1.x/index.apt b/src/site/apt/httpcomponents-core-5.1.x/index.apt
deleted file mode 100644
index fd858a2..0000000
--- a/src/site/apt/httpcomponents-core-5.1.x/index.apt
+++ /dev/null
@@ -1,83 +0,0 @@
-~~ ====================================================================
-~~ Licensed to the Apache Software Foundation (ASF) under one
-~~ or more contributor license agreements. See the NOTICE file
-~~ distributed with this work for additional information
-~~ regarding copyright ownership. The ASF licenses this file
-~~ to you under the Apache License, Version 2.0 (the
-~~ "License"); you may not use this file except in compliance
-~~ with the License. You may obtain a copy of the License at
-~~
-~~ http://www.apache.org/licenses/LICENSE-2.0
-~~
-~~ Unless required by applicable law or agreed to in writing,
-~~ software distributed under the License is distributed on an
-~~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-~~ KIND, either express or implied. See the License for the
-~~ specific language governing permissions and limitations
-~~ under the License.
-~~ ====================================================================
-~~
-~~ This software consists of voluntary contributions made by many
-~~ individuals on behalf of the Apache Software Foundation. For more
-~~ information on the Apache Software Foundation, please see
-~~ <http://www.apache.org/>.
-
- ----------
- HttpComponents HttpCore Overview
- ----------
- ----------
- ----------
-
-HttpCore Overview
-
- HttpCore is a set of low level HTTP transport components that can be used to build custom
- client and server side HTTP services with a minimal footprint. HttpCore supports two I/O models:
- blocking I/O model based on the classic Java I/O and non-blocking, event driven I/O model based
- on Java NIO.
-
-{Documentation}
-
- [[1]] Some examples of HttpCore components in action can be found {{{./examples.html}here}}
-
- [[1]] Javadocs
-
- * {{{./current/httpcore5/apidocs/}HttpCore HTTP/1.1}}
-
- * {{{./current/httpcore5-h2/apidocs/}HttpCore HTTP/2}}
-
- * {{{./current/httpcore5-reactive/apidocs/}HttpCore Reactive Streams}}
-
- * {{{./current/httpcore5-testing/apidocs/}HttpCore testing support}}
-
- []
-
- [[1]] API compatibility reports
-
- * {{{./current/httpcore5/clirr-report.html/}HttpCore HTTP/1.1}}
-
- * {{{./current/httpcore5-h2/clirr-report.html/}HttpCore HTTP/2}}
-
- * {{{./current/httpcore5-reactive/clirr-report.html/}HttpCore Reactive Streams}}
-
- * {{{./current/httpcore5-testing/clirr-report.html/}HttpCore testing support}}
-
-{Standards Compliance}
-
- HttpCore components strive to conform to the following specifications endorsed by the Internet
- Engineering Task Force (IETF) and the internet at large:
-
- * {{{http://tools.ietf.org/html/rfc7540}RFC 7540}} - Hypertext Transfer Protocol Version 2
- (HTTP/2)
-
- * {{{http://tools.ietf.org/html/rfc7541}RFC 7541}} - HPACK: Header Compression for HTTP/2
-
- * {{{http://tools.ietf.org/html/rfc7230}RFC 7230}} - Hypertext Transfer Protocol (HTTP/1.1):
- Message Syntax and Routing
-
- * {{{http://tools.ietf.org/html/rfc7231}RFC 7231}} - Hypertext Transfer Protocol (HTTP/1.1):
- Semantics and Content
-
- * {{{http://tools.ietf.org/html/rfc1945}RFC 1945}} - Hypertext Transfer Protocol -- HTTP/1.0
-
- * {{{http://tools.ietf.org/html/rfc3986}RFC 3986}} - Uniform Resource Identifier (URI): Generic
- Syntax
diff --git a/src/site/markdown/httpcomponents-asyncclient-4.1.x/download.md b/src/site/markdown/httpcomponents-asyncclient-4.1.x/download.md
new file mode 100644
index 0000000..983976d
--- /dev/null
+++ b/src/site/markdown/httpcomponents-asyncclient-4.1.x/download.md
@@ -0,0 +1,38 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpAsyncClient Downloads
+=========================
+
+The latest release available for download:
+
+[Release packages](http://hc.apache.org/downloads.cgi) -
+[Release Notes](http://www.apache.org/dist/httpcomponents/httpasyncclient/RELEASE_NOTES-4.1.x.txt) -
+[License](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+Dependency management
+---------------------
+
+If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
+[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
+HttpAsyncClient modules by using this information:
+
+- [HttpAsyncClient](https://search.maven.org/artifact/org.apache.httpcomponents/httpasyncclient)
+- [HttpAsyncClient Cache](https://search.maven.org/artifact/org.apache.httpcomponents/httpasyncclient-cache)
+
diff --git a/src/site/markdown/httpcomponents-asyncclient-4.1.x/examples.md b/src/site/markdown/httpcomponents-asyncclient-4.1.x/examples.md
new file mode 100644
index 0000000..f7f8ce8
--- /dev/null
+++ b/src/site/markdown/httpcomponents-asyncclient-4.1.x/examples.md
@@ -0,0 +1,79 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpAsyncClient Examples
+========================
+
+- [Asynchronous HTTP exchange](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientHttpExchange.java?view=markup)
+
+ This example demonstrates a basic asynchronous HTTP request / response exchange. Response content is buffered in
+ memory for simplicity.
+
+- [Asynchronous HTTP exchange with content streaming](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientHttpExchangeStreaming.java?view=markup)
+
+ This example demonstrates an asynchronous HTTP request / response exchange with a full content streaming.
+
+- [Concurrent asynchronous HTTP exchanges](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientHttpExchangeFutureCallback.java?view=markup)
+
+ This example demonstrates a fully asynchronous execution of multiple HTTP exchanges where the result of an individual
+ operation is reported using a callback interface.
+
+- [Pipelined HTTP exchanges](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientPipelined.java?view=markup)
+
+ This example demonstrates a pipelined execution of multiple HTTP request / response exchanges. Response content is
+ buffered in memory for simplicity.
+
+- [Pipelined HTTP exchanges with content streaming](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientPipelinedStreaming.java?view=markup)
+
+ This example demonstrates a pipelined execution of multiple HTTP request / response exchanges with a full content
+ streaming.
+
+- [Asynchronous request via a proxy](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientExecuteProxy.java?view=markup)
+
+ This example demonstrates how to send an HTTP request via a proxy.
+
+- [HttpAsyncClient configuration](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientConfiguration.java?view=markup)
+
+ This example demonstrates how to customize and configure the most common aspects of HTTP request execution and
+ connection management.
+
+- [Custom execution context](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientCustomContext.java?view=markup)
+
+ This example demonstrates the use of a local execution context with custom context settings.
+
+- [Client authentication](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientAuthentication.java?view=markup)
+
+ This example demonstrates execution of an HTTP request against a target site that requires user authentication.
+
+- [Proxy authentication](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientProxyAuthentication.java?view=markup)
+
+ This example shows execution of an HTTP request over a secure connection tunneled through an authenticating proxy.
+
+- [Custom SSL context](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientCustomSSL.java?view=markup)
+
+ This example demonstrates how to create secure connections with a custom SSL context.
+
+- [Zero copy file upload / download](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/ZeroCopyHttpExchange.java?view=markup)
+
+ This example demonstrates how HttpAsyncClient can be used to upload or download files without creating an intermediate
+ content buffer in memory (zero copy file transfer).
+
+- [Connection eviction](http://svn.apache.org/viewvc/httpcomponents/httpasyncclient/branches/4.1.x/httpasyncclient/src/examples/org/apache/http/examples/nio/client/AsyncClientEvictExpiredConnections.java?view=markup)
+
+ This example demonstrates how to evict expired and idle connections from the connection pool.
\ No newline at end of file
diff --git a/src/site/markdown/httpcomponents-asyncclient-4.1.x/index.md b/src/site/markdown/httpcomponents-asyncclient-4.1.x/index.md
new file mode 100644
index 0000000..b6e756e
--- /dev/null
+++ b/src/site/markdown/httpcomponents-asyncclient-4.1.x/index.md
@@ -0,0 +1,76 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpAsyncClient Overview
+========================
+
+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, while increasing the number of applications that require HTTP support.
+
+Although the java.net package provides basic functionality for accessing resources via HTTP, it doesn't provide the full
+flexibility or functionality needed by many applications. HttpAsyncClient 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.
+
+Designed for extension while providing robust support for the base HTTP protocol, HttpAsyncClient may be of interest to
+anyone building HTTP-aware client applications based on asynchronous, event driven I/O model.
+
+Documentation
+-------------
+
+1. [Quick Start](quickstart.md) - contains a simple, complete example of asynchronous request execution.
+1. [HttpAsyncClient Examples](examples.md) - a set of examples demonstrating some of the more complex use scenarios.
+1. Javadocs
+ - [HttpAsyncClient](./current/httpasyncclient/apidocs/)
+ - [HttpAsyncClient Cache](./current/httpasyncclient-cache/apidocs/)
+
+Features
+--------
+
+- Standards based, pure Java, implementation of HTTP versions 1.0 and 1.1
+- Full implementation of all HTTP methods (GET, POST, PUT, DELETE, HEAD, OPTIONS, and TRACE) in an extensible OO
+ framework.
+- Supports encryption with HTTPS (HTTP over SSL) protocol.
+- Transparent connections through HTTP proxies.
+- Tunneled HTTPS connections through HTTP proxies, via the CONNECT method.
+- Connection management support concurrent request execution. Supports setting the maximum total connections as well as
+ the maximum connections per host. Detects and closes expired connections.
+- Persistent connections using KeepAlive in HTTP/1.0 and persistence in HTTP/1.1
+- The ability to set connection timeouts.
+- Source code is freely available under the Apache License.
+- Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO and Kerberos authentication schemes.
+- Plug-in mechanism for custom authentication schemes.
+- Automatic Cookie handling for reading Set-Cookie: headers from the server and sending them back out in a `Cookie`
+ header when appropriate.
+- Plug-in mechanism for custom cookie policies.
+- Support for HTTP/1.1 response caching.
+- Support for pipelined request execution and processing.
+
+Standards Compliance
+--------------------
+
+HttpAsyncClient strives to conform to the following specifications endorsed by the Internet Engineering Task Force
+(IETF) and the internet at large:
+
+- [RFC 1945](http://www.ietf.org/rfc/rfc1945.txt) Hypertext Transfer Protocol -- HTTP/1.0
+- [RFC 2616](http://www.ietf.org/rfc/rfc2616.txt) Hypertext Transfer Protocol -- HTTP/1.1
+- [RFC 2617](http://www.ietf.org/rfc/rfc2617.txt) HTTP Authentication: Basic and Digest Access Authentication
+- [RFC 2109](http://www.ietf.org/rfc/rfc2109.txt) HTTP State Management Mechanism (Cookies)
+- [RFC 2965](http://www.ietf.org/rfc/rfc2965.txt) HTTP State Management Mechanism (Cookies v2)
diff --git a/src/site/markdown/httpcomponents-asyncclient-4.1.x/quickstart.md b/src/site/markdown/httpcomponents-asyncclient-4.1.x/quickstart.md
new file mode 100644
index 0000000..08d0745
--- /dev/null
+++ b/src/site/markdown/httpcomponents-asyncclient-4.1.x/quickstart.md
@@ -0,0 +1,127 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpAsyncClient Quick Start
+===========================
+
+- Download 'Binary' package of the latest HttpAsyncClient 4.1 release or configure dependency on
+ `HttpAsyncClient` module using a dependency manager of your choice as described [here](download.md).
+
+- HttpAsyncClient 4.1 requires Java 1.6 or newer.
+
+- The code fragment below illustrates the most fundamental aspects of asynchronous request execution with
+ HttpAsyncClient.
+
+ ```
+ CloseableHttpAsyncClient httpclient = HttpAsyncClients.createDefault();
+ try {
+ // Start the client
+ httpclient.start();
+
+ // Execute request
+ final HttpGet request1 = new HttpGet("http://www.apache.org/");
+ Future<HttpResponse> future = httpclient.execute(request1, null);
+ // and wait until a response is received
+ HttpResponse response1 = future.get();
+ System.out.println(request1.getRequestLine() + "->" + response1.getStatusLine());
+
+ // One most likely would want to use a callback for operation result
+ final CountDownLatch latch1 = new CountDownLatch(1);
+ final HttpGet request2 = new HttpGet("http://www.apache.org/");
+ httpclient.execute(request2, new FutureCallback<HttpResponse>() {
+
+ public void completed(final HttpResponse response2) {
+ latch1.countDown();
+ System.out.println(request2.getRequestLine() + "->" + response2.getStatusLine());
+ }
+
+ public void failed(final Exception ex) {
+ latch1.countDown();
+ System.out.println(request2.getRequestLine() + "->" + ex);
+ }
+
+ public void cancelled() {
+ latch1.countDown();
+ System.out.println(request2.getRequestLine() + " cancelled");
+ }
+
+ });
+ latch1.await();
+
+ // In real world one most likely would also want to stream
+ // request and response body content
+ final CountDownLatch latch2 = new CountDownLatch(1);
+ final HttpGet request3 = new HttpGet("http://www.apache.org/");
+ HttpAsyncRequestProducer producer3 = HttpAsyncMethods.create(request3);
+ AsyncCharConsumer<HttpResponse> consumer3 = new AsyncCharConsumer<HttpResponse>() {
+
+ HttpResponse response;
+
+ @Override
+ protected void onResponseReceived(final HttpResponse response) {
+ this.response = response;
+ }
+
+ @Override
+ protected void onCharReceived(final CharBuffer buf, final IOControl ioctrl) throws IOException {
+ // Do something useful
+ }
+
+ @Override
+ protected void releaseResources() {
+ }
+
+ @Override
+ protected HttpResponse buildResult(final HttpContext context) {
+ return this.response;
+ }
+
+ };
+ httpclient.execute(producer3, consumer3, new FutureCallback<HttpResponse>() {
+
+ public void completed(final HttpResponse response3) {
+ latch2.countDown();
+ System.out.println(request3.getRequestLine() + "->" + response3.getStatusLine());
+ }
+
+ public void failed(final Exception ex) {
+ latch2.countDown();
+ System.out.println(request3.getRequestLine() + "->" + ex);
+ }
+
+ public void cancelled() {
+ latch2.countDown();
+ System.out.println(request3.getRequestLine() + " cancelled");
+ }
+
+ });
+ latch2.await();
+
+ } finally {
+ httpclient.close();
+ }
+ ```
+
+- Take a look at the [HttpCore tutorial](../httpcomponents-core-4.x/tutorial/html/index.html) for introduction to
+ fundamentals of asynchronous HTTP communication with HttpComponents 4.x.
+
+- Another good way of getting started with HttpAsyncClient is by seeing it in action. Take a look at the samples shipped
+ with the release package or available [online](examples.md).
+
+
diff --git a/src/site/markdown/httpcomponents-client-4.5.x/download.md b/src/site/markdown/httpcomponents-client-4.5.x/download.md
new file mode 100644
index 0000000..ce7f99d
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-4.5.x/download.md
@@ -0,0 +1,39 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Downloads
+====================
+
+The latest release available for download:
+
+[Release packages](http://hc.apache.org/downloads.cgi) -
+[Release Notes](http://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES-4.5.x.txt) -
+[License](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+Dependency management
+---------------------
+
+If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
+[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
+HttpClient modules by using this information:
+
+- [HttpClient](https://search.maven.org/artifact/org.apache.httpcomponents/httpclient)
+- [Fluent HC](https://search.maven.org/artifact/org.apache.httpcomponents/fluent-hc)
+- [HttpMime](https://search.maven.org/artifact/org.apache.httpcomponents/httpmime)
+- [HttpClient Cache](https://search.maven.org/artifact/org.apache.httpcomponents/httpclient-cache)
diff --git a/src/site/markdown/httpcomponents-client-4.5.x/examples.md b/src/site/markdown/httpcomponents-client-4.5.x/examples.md
new file mode 100644
index 0000000..b565346
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-4.5.x/examples.md
@@ -0,0 +1,102 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Examples
+===================
+
+- [Response handling](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientWithResponseHandler.java)
+
+ This example demonstrates how to process HTTP responses using a response handler. This is the recommended way of
+ executing HTTP requests and processing HTTP responses. This approach enables the caller to concentrate on the process
+ of digesting HTTP responses and to delegate the task of system resource deallocation to HttpClient. The use of an HTTP
+ response handler guarantees that the underlying HTTP connection will be released back to the connection manager
+ automatically in all cases.
+
+- [Manual connection release](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientConnectionRelease.java)
+
+ This example demonstrates how to ensure the release of the underlying HTTP connection back to the connection manager
+ in case of a manual processing of HTTP responses.
+
+- [HttpClient configuration](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientConfiguration.java)
+
+ This example demonstrates how to customize and configure the most common aspects of HTTP request execution and
+ connection management.
+
+- [Abort method](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientAbortMethod.java)
+
+ This example demonstrates how to abort an HTTP request before its normal completion.
+
+- [Client authentication](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientAuthentication.java)
+
+ This example uses HttpClient to execute an HTTP request against a target site that requires user authentication.
+
+- [Request via a proxy](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientExecuteProxy.java)
+
+ This example demonstrates how to send an HTTP request via a proxy.
+
+- [Proxy authentication](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientProxyAuthentication.java)
+
+ A simple example showing execution of an HTTP request over a secure connection tunneled through an authenticating
+ proxy.
+
+- [Chunk encoded POST](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientChunkEncodedPost.java)
+
+ This example shows how to stream out a request entity using chunk encoding.
+
+- [Custom execution context](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientCustomContext.java)
+
+ This example demonstrates the use of a local HTTP context populated custom attributes.
+
+- [Form based logon](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientFormLogin.java)
+
+ This example demonstrates how HttpClient can be used to perform form-based logon.
+
+- [Threaded request execution](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientMultiThreadedExecution.java)
+
+ An example that executes HTTP requests from multiple worker threads.
+
+- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientCustomSSL.java)
+
+ This example demonstrates how to create secure connections with a custom SSL context.
+
+- [Preemptive BASIC authentication](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientPreemptiveBasicAuthentication.java)
+
+ This example shows how HttpClient can be customized to authenticate preemptively using BASIC scheme. Generally,
+ preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
+ discouraged.
+
+- [Preemptive DIGEST authentication](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ClientPreemptiveDigestAuthentication.java)
+
+ This example shows how HttpClient can be customized to authenticate preemptively using DIGEST scheme. Generally,
+ preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
+ discouraged.
+
+- [Proxy tunnel](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient/src/examples/org/apache/http/examples/client/ProxyTunnelDemo.java)
+
+ This example shows how to use ProxyClient in order to establish a tunnel through an HTTP proxy for an arbitrary
+ protocol.
+
+- [Multipart encoded request entity](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpmime/src/examples/org/apache/http/examples/entity/mime/ClientMultipartFormPost.java)
+
+ This example shows how to execute requests enclosing a multipart encoded entity.
+
+- [Native Windows Negotiate/NTLM](https://github.com/apache/httpcomponents-client/tree/4.5.x/httpclient-win/src/examples/org/apache/http/examples/client/win/ClientWinAuth.java)
+
+ This example shows how to make use of Native Windows Negotiate/NTLM authentication when running on Windows OS.
+
diff --git a/src/site/markdown/httpcomponents-client-4.5.x/index.md b/src/site/markdown/httpcomponents-client-4.5.x/index.md
new file mode 100644
index 0000000..40a89ce
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-4.5.x/index.md
@@ -0,0 +1,94 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Overview
+===================
+
+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, while increasing the number of applications that require HTTP support.
+
+Although the java.net package provides basic functionality for accessing resources via HTTP, it doesn't provide the full
+flexibility or functionality needed by many applications. HttpClient 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.
+
+Designed for extension while providing robust support for the base HTTP protocol, HttpClient 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.
+
+Documentation
+-------------
+
+1. [Quick Start](quickstart.md) - contains a simple, complete example of an HTTP GET and POST with parameters.
+1. HttpClient [Tutorial](./current/tutorial/html/) ([PDF](./tutorial/pdf/httpcore-tutorial.pdf))
+1. [HttpClient Examples](examples.md) - a set of examples demonstrating some of the more complex use scenarios.
+1. [HttpClient Primer](./primer.html) - explains the scope of HttpClient. Note that HttpClient is not a browser. It
+ lacks the UI, HTML renderer and a JavaScript engine that a browser will possess.
+
+1. Javadocs
+ - [HttpClient](./current/httpclient/apidocs/)
+ - [HC Fluent](./current/fluent-hc/apidocs/)
+ - [HttpMime](./current/httpmime/apidocs/)
+ - [HttpClient Cache](./current/httpclient-cache/apidocs/)
+ - [HttpClient Windows extensions](./current/httpclient-win/apidocs/)
+
+1. API compatibility reports
+ - [HttpClient](./current/httpclient/clirr-report.html)
+ - [HC Fluent](./current/fluent-hc/clirr-report.html)
+ - [HttpMime](./current/httpmime/clirr-report.html)
+ - [HttpClient Cache](./current/httpclient-cache/clirr-report.html)
+ - [HttpClient Windows extensions](./current/httpclient-win/clirr-report.html)
+
+Features
+--------
+
+- Standards based, pure Java, implementation of HTTP versions 1.0 and 1.1
+- Full implementation of all HTTP methods (GET, POST, PUT, DELETE, HEAD, OPTIONS, and TRACE)
+ in an extensible OO framework.
+- Supports encryption with HTTPS (HTTP over SSL) protocol.
+- Transparent connections through HTTP proxies.
+- Tunneled HTTPS connections through HTTP proxies, via the CONNECT method.
+- Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO, Kerberos authentication schemes.
+- Plug-in mechanism for custom authentication schemes.
+- Pluggable secure socket factories, making it easier to use third party solutions
+- Connection management support for use in multi-threaded applications. Supports setting the maximum total connections
+ as well as the maximum connections per host. Detects and closes stale connections.
+- Automatic Cookie handling for reading Set-Cookie: headers from the server and sending them back out in a `Cookie`
+ header when appropriate.
+- Plug-in mechanism for custom cookie policies.
+- Request output streams to avoid buffering any content body by streaming directly to the socket to the server.
+- Response input streams to efficiently read the response body by streaming directly from the socket to the server.
+- Persistent connections using KeepAlive in HTTP/1.0 and persistance in HTTP/1.1
+- Direct access to the response code and headers sent by the server.
+- The ability to set connection timeouts.
+- Support for HTTP/1.1 response caching.
+- Source code is freely available under the Apache License.
+
+Standards Compliance
+--------------------
+
+HttpClient strives to conform to the following specifications endorsed by the Internet Engineering Task Force (IETF) and
+the internet at large:
+
+- [RFC 1945](http://tools.ietf.org/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
+- [RFC 2616](http://tools.ietf.org/html/rfc2616) - Hypertext Transfer Protocol -- HTTP/1.1
+- [RFC 2617](http://tools.ietf.org/html/rfc2617) - HTTP Authentication: Basic and Digest Access Authentication
+- [RFC 2396](http://tools.ietf.org/html/rfc2396) - Uniform Resource Identifiers (URI): Generic Syntax
+- [RFC 6265](http://tools.ietf.org/html/rfc6265) - HTTP State Management Mechanism (Cookies)
+
diff --git a/src/site/markdown/httpcomponents-client-4.5.x/quickstart.md b/src/site/markdown/httpcomponents-client-4.5.x/quickstart.md
new file mode 100644
index 0000000..f560e06
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-4.5.x/quickstart.md
@@ -0,0 +1,96 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Quick Start
+======================
+
+- Download 'Binary' package of the latest HttpClient 4.5 release or configure dependency on `HttpClient` and `Fluent HC`
+ modules using a dependency manager of your choice as described [here](download.md).
+
+- HttpClient 4.5 requires Java 1.6 or newer.
+
+- The below code fragment illustrates the execution of HTTP GET and POST requests using the HttpClient native API.
+
+ ```
+ CloseableHttpClient httpclient = HttpClients.createDefault();
+ HttpGet httpGet = new HttpGet("http://targethost/homepage");
+ CloseableHttpResponse response1 = httpclient.execute(httpGet);
+ // The underlying HTTP connection is still held by the response object
+ // to allow the response content to be streamed directly from the network socket.
+ // In order to ensure correct deallocation of system resources
+ // the user MUST call CloseableHttpResponse#close() from a finally clause.
+ // Please note that if response content is not fully consumed the underlying
+ // connection cannot be safely re-used and will be shut down and discarded
+ // by the connection manager.
+ try {
+ System.out.println(response1.getStatusLine());
+ HttpEntity entity1 = response1.getEntity();
+ // do something useful with the response body
+ // and ensure it is fully consumed
+ EntityUtils.consume(entity1);
+ } finally {
+ response1.close();
+ }
+
+ HttpPost httpPost = new HttpPost("http://targethost/login");
+ List <NameValuePair> nvps = new ArrayList <NameValuePair>();
+ nvps.add(new BasicNameValuePair("username", "vip"));
+ nvps.add(new BasicNameValuePair("password", "secret"));
+ httpPost.setEntity(new UrlEncodedFormEntity(nvps));
+ CloseableHttpResponse response2 = httpclient.execute(httpPost);
+
+ try {
+ System.out.println(response2.getStatusLine());
+ HttpEntity entity2 = response2.getEntity();
+ // do something useful with the response body
+ // and ensure it is fully consumed
+ EntityUtils.consume(entity2);
+ } finally {
+ response2.close();
+ }
+ ```
+
+ Source can be
+ downloaded [here](https://github.com/apache/httpcomponents-client/blob/4.5.x/httpclient/src/examples/org/apache/http/examples/client/QuickStart.java)
+
+- The same requests can be executed using a simpler, albeit less flexible, fluent API.
+
+ ```
+ // The fluent API relieves the user from having to deal with manual deallocation of system
+ // resources at the cost of having to buffer response content in memory in some cases.
+
+ Request.Get("http://targethost/homepage")
+ .execute().returnContent();
+ Request.Post("http://targethost/login")
+ .bodyForm(Form.form().add("username", "vip").add("password", "secret").build())
+ .execute().returnContent();
+ ```
+
+ Source can be
+ downloaded [here](https://github.com/apache/httpcomponents-client/blob/4.5.x/fluent-hc/src/examples/org/apache/http/client/fluent/FluentQuickStart.java)
+
+- [HttpClient Examples](examples.md) - a set of examples demonstrating some of the more complex scenarios.
+
+- [HttpClient Tutorial](./current/tutorial/html/) - gives a detailed examination of the HttpClient API, which was
+ written in close accordance with the (sometimes not very intuitive)
+ HTTP specification/standard. A copy is also shipped with the release.
+ [A PDF version](./current/tutorial/pdf/httpclient-tutorial.pdf) is also available
+
+- [HttpClient Primer](./primer.html) - explains the scope of HttpClient. Note that HttpClient is not a browser. It lacks
+ the UI, HTML renderer and a JavaScript engine that a browser will possess.
diff --git a/src/site/markdown/httpcomponents-client-5.0.x/download.md b/src/site/markdown/httpcomponents-client-5.0.x/download.md
new file mode 100644
index 0000000..7d172a5
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.0.x/download.md
@@ -0,0 +1,39 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Downloads
+====================
+
+The latest release available for download:
+
+[Release packages](http://hc.apache.org/downloads.cgi) -
+[Release Notes](http://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES-5.0.x.txt) -
+[License](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+Dependency management
+---------------------
+
+If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
+[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
+HttpClient modules by using this information:
+
+- [HttpClient](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5)
+- [HttpClient Fluent](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-fluent)
+- [HttpClient Cache](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-cache)
+- [HttpClient Windows extensions](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-win)
diff --git a/src/site/markdown/httpcomponents-client-5.0.x/examples-async.md b/src/site/markdown/httpcomponents-client-5.0.x/examples-async.md
new file mode 100644
index 0000000..9a357c1
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.0.x/examples-async.md
@@ -0,0 +1,73 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Examples (Async)
+===========================
+
+- [Asynchronous HTTP exchange](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
+
+ This example demonstrates a basic asynchronous HTTP request / response exchange. Response content is buffered in
+ memory for simplicity.
+
+- [Asynchronous HTTP exchange with content streaming](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchangeStreaming.java)
+
+ This example demonstrates an asynchronous HTTP request / response exchange with a full content streaming.
+
+- [HTTP/2 ALPN support](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientTlsAlpn.java)
+
+ This example demonstrates how to avoid the illegal reflective access operation warning when running with Oracle JRE 9
+ or newer.
+
+- [Pipelined HTTP/1.1 exchanges](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp1Pipelining.java)
+
+ This example demonstrates a pipelined execution of multiple HTTP/1.1 request / response exchanges. Response content is
+ buffered in memory for simplicity.
+
+- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2Multiplexing.java)
+
+ This example demonstrates a multiplexed execution of multiple HTTP/2 request / response exchanges. Response content is
+ buffered in memory for simplicity.
+
+- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientInterceptors.java)
+
+ This example demonstrates how to insert custom request interceptor and an execution interceptor to the request
+ execution chain.
+
+- [Message trailers](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientMessageTrailers.java)
+
+ This example demonstrates how to use a custom execution interceptor to add trailers to all outgoing request enclosing
+ an entity..
+
+- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2ServerPush.java)
+
+This example demonstrates handling of HTTP/2 message exchanges pushed by the server.
+
+- [Client authentication](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientAuthentication.java)
+
+ This example demonstrates execution of an HTTP request against a target site that requires user authentication.
+
+- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientCustomSSL.java)
+
+ This example demonstrates how to create secure connections with a custom SSL context.
+
+- [Connection eviction](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientConnectionEviction.java)
+
+ This example demonstrates how to evict expired and idle connections from the connection pool.
+
+
diff --git a/src/site/markdown/httpcomponents-client-5.0.x/examples-reactive.md b/src/site/markdown/httpcomponents-client-5.0.x/examples-reactive.md
new file mode 100644
index 0000000..e88b1f8
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.0.x/examples-reactive.md
@@ -0,0 +1,25 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Examples (Async)
+===========================
+
+- [HTTP exchange with Reactive Streams](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
+
+ This example demonstrates a reactive, full-duplex HTTP/1.1 message exchange using RxJava.
diff --git a/src/site/markdown/httpcomponents-client-5.0.x/examples.md b/src/site/markdown/httpcomponents-client-5.0.x/examples.md
new file mode 100644
index 0000000..ad59a3c
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.0.x/examples.md
@@ -0,0 +1,103 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Examples (Classic)
+=============================
+
+- [Response handling](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientWithResponseHandler.java)
+
+ This example demonstrates how to process HTTP responses using a response handler. This is the recommended way of
+ executing HTTP requests and processing HTTP responses. This approach enables the caller to concentrate on the process
+ of digesting HTTP responses and to delegate the task of system resource deallocation to HttpClient. The use of an HTTP
+ response handler guarantees that the underlying HTTP connection will be released back to the connection manager
+ automatically in all cases.
+
+- [Manual connection release](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionRelease.java)
+
+ This example demonstrates how to ensure the release of the underlying HTTP connection back to the connection manager
+ in case of a manual processing of HTTP responses.
+
+- [HttpClient configuration](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConfiguration.java)
+
+ This example demonstrates how to customize and configure the most common aspects of HTTP request execution and
+ connection management.
+
+- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientInterceptors.java)
+
+ This example demonstrates how to insert custom request interceptor and an execution interceptor to the request
+ execution chain.
+
+- [Abort method](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAbortMethod.java)
+
+ This example demonstrates how to abort an HTTP request before its normal completion.
+
+- [Client authentication](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAuthentication.java)
+
+ This example uses HttpClient to execute an HTTP request against a target site that requires user authentication.
+
+- [Request via a proxy](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientExecuteProxy.java)
+
+ This example demonstrates how to send an HTTP request via a proxy.
+
+- [Proxy authentication](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientProxyAuthentication.java)
+
+ A simple example showing execution of an HTTP request over a secure connection tunneled through an authenticating
+ proxy.
+
+- [Chunk encoded POST](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientChunkEncodedPost.java)
+
+ This example shows how to stream out a request entity using chunk encoding.
+
+- [Custom execution context](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomContext.java)
+
+ This example demonstrates the use of a local HTTP context populated custom attributes.
+
+- [Form based logon](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientFormLogin.java)
+
+ This example demonstrates how HttpClient can be used to perform form-based logon.
+
+- [Threaded request execution](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultiThreadedExecution.java)
+
+ An example that executes HTTP requests from multiple worker threads.
+
+- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomSSL.java)
+
+ This example demonstrates how to create secure connections with a custom SSL context.
+
+- [Preemptive BASIC authentication](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveBasicAuthentication.java)
+
+ This example shows how HttpClient can be customized to authenticate preemptively using BASIC scheme. Generally,
+ preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
+ discouraged.
+
+- [Preemptive DIGEST authentication](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveDigestAuthentication.java)
+
+ This example shows how HttpClient can be customized to authenticate preemptively using DIGEST scheme. Generally,
+ preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
+ discouraged.
+
+- [Proxy tunnel](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ProxyTunnelDemo.java)
+
+ This example shows how to use ProxyClient in order to establish a tunnel through an HTTP proxy for an arbitrary
+ protocol.
+
+- [Multipart encoded request entity](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultipartFormPost.java)
+
+ This example shows how to execute requests enclosing a multipart encoded entity.
+
diff --git a/src/site/markdown/httpcomponents-client-5.0.x/index.md b/src/site/markdown/httpcomponents-client-5.0.x/index.md
new file mode 100644
index 0000000..ff55a54
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.0.x/index.md
@@ -0,0 +1,88 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Overview
+===================
+
+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, while increasing the number of applications that require HTTP support.
+
+Although the java.net package provides basic functionality for accessing resources via HTTP, it doesn't provide the full
+flexibility or functionality needed by many applications. HttpClient 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.
+
+Designed for extension while providing robust support for the base HTTP protocol, HttpClient 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.
+
+Documentation
+-------------
+
+1. [Quick Start](quickstart.md) - contains simple, complete examples of request execution with the classic, fluent and
+ async APIs.
+1. Examples demonstrating some common as well as more complex use cases
+
+ * [HttpClient (classic APIs)](examples.md)
+ * [HttpClient (async APIs)](examples-async.md)
+ * [HttpClient (reactive APIs)](examples-reactive.md)
+
+1. Javadocs
+
+ * [HttpClient](./current/httpclient5/apidocs/)
+ * [HC Fluent](./current/httpclient5-fluent/apidocs/)
+ * [HttpClient Cache](./current/httpclient5-cache/apidocs/)
+ * [HttpClient Windows extensions](./current/httpclient5-win/apidocs/)
+
+1. API compatibility reports
+
+ * [HttpClient](./current/httpclient5/clirr-report.html)
+ * [HC Fluent](./current/httpclient5-fluent/clirr-report.html)
+ * [HttpClient Cache](./current/httpclient5-cache/clirr-report.html)
+ * [HttpClient Windows extensions](./current/httpclient5-win/clirr-report.html)
+
+Features
+--------
+
+- Standards based, pure Java, implementation of HTTP versions 1.0, 1.1, 2.0
+- Supports encryption with HTTPS (HTTP over SSL) protocol.
+- Pluggable socket factories and TLS strategies.
+- Transparent message exchanges through HTTP/1.1 and HTTP/1.0 proxies.
+- Tunneled HTTPS connections through HTTP/1.1 and HTTP/1.0 proxies, via the CONNECT method.
+- Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO, Kerberos authentication schemes.
+- HTTP state management and cookie support.
+- Flexible connection management and pooling.
+- Support for HTTP response caching.
+- Source code is freely available under the Apache License.
+
+Standards Compliance
+--------------------
+
+HttpClient strives to conform to the following specifications endorsed by the Internet Engineering Task Force (IETF) and
+the internet at large:
+
+* [RFC 7230](http://tools.ietf.org/html/rfc7230) - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing
+* [RFC 7231](http://tools.ietf.org/html/rfc7231) - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+* [RFC 7235](http://tools.ietf.org/html/rfc7235) - Hypertext Transfer Protocol (HTTP/1.1): Authentication
+* [RFC 1945](http://tools.ietf.org/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
+* [RFC 2817](http://tools.ietf.org/html/rfc2817) - Upgrading to TLS Within HTTP/1.1
+* [RFC 2818](http://tools.ietf.org/html/rfc2818) - HTTP Over TLS
+* [RFC 6265](http://tools.ietf.org/html/rfc6265) - HTTP State Management Mechanism (Cookies)
+* [RFC 2396](http://tools.ietf.org/html/rfc2396) - Uniform Resource Identifiers (URI): Generic Syntax
+
diff --git a/src/site/markdown/httpcomponents-client-5.0.x/quickstart.md b/src/site/markdown/httpcomponents-client-5.0.x/quickstart.md
new file mode 100644
index 0000000..a7f8952
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.0.x/quickstart.md
@@ -0,0 +1,185 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Quick Start
+======================
+
+- Download 'Binary' package of the latest HttpClient 4.5 release or configure dependency on `HttpClient` and `Fluent HC`
+ modules using a dependency manager of your choice as described [here](download.md).
+
+- HttpClient 5.0 requires Java 1.7 or newer.
+
+- The below code fragment illustrates the execution of HTTP GET and POST requests using the HttpClient native API.
+
+ ```
+ try (CloseableHttpClient httpclient = HttpClients.createDefault()) {
+ HttpGet httpGet = new HttpGet("http://httpbin.org/get");
+ // The underlying HTTP connection is still held by the response object
+ // to allow the response content to be streamed directly from the network socket.
+ // In order to ensure correct deallocation of system resources
+ // the user MUST call CloseableHttpResponse#close() from a finally clause.
+ // Please note that if response content is not fully consumed the underlying
+ // connection cannot be safely re-used and will be shut down and discarded
+ // by the connection manager.
+ try (CloseableHttpResponse response1 = httpclient.execute(httpGet)) {
+ System.out.println(response1.getCode() + " " + response1.getReasonPhrase());
+ HttpEntity entity1 = response1.getEntity();
+ // do something useful with the response body
+ // and ensure it is fully consumed
+ EntityUtils.consume(entity1);
+ }
+
+ HttpPost httpPost = new HttpPost("http://httpbin.org/post");
+ List<NameValuePair> nvps = new ArrayList<>();
+ nvps.add(new BasicNameValuePair("username", "vip"));
+ nvps.add(new BasicNameValuePair("password", "secret"));
+ httpPost.setEntity(new UrlEncodedFormEntity(nvps));
+
+ try (CloseableHttpResponse response2 = httpclient.execute(httpPost)) {
+ System.out.println(response2.getCode() + " " + response2.getReasonPhrase());
+ HttpEntity entity2 = response2.getEntity();
+ // do something useful with the response body
+ // and ensure it is fully consumed
+ EntityUtils.consume(entity2);
+ }
+ }
+ ```
+
+ Source can be found here
+ [here](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/QuickStart.java)
+
+- The same requests can be executed using a simpler, albeit less flexible, fluent API.
+
+ ```
+ // The fluent API relieves the user from having to deal with manual deallocation of system
+ // resources at the cost of having to buffer response content in memory in some cases.
+
+ Request.Get("http://targethost/homepage")
+ .execute().returnContent();
+ Request.Post("http://targethost/login")
+ .bodyForm(Form.form().add("username", "vip").add("password", "secret").build())
+ .execute().returnContent();
+ ```
+
+ Source can be downloaded
+ [here](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5-fluent/src/test/java/org/apache/hc/client5/http/examples/fluent/FluentQuickStart.java)
+
+- The below code fragment illustrates the execution of HTTP requests using HttpClient async API.
+
+ ```
+ try (CloseableHttpAsyncClient httpclient = HttpAsyncClients.createDefault()) {
+ // Start the client
+ httpclient.start();
+
+ // Execute request
+ SimpleHttpRequest request1 = SimpleHttpRequests.get("http://httpbin.org/get");
+ Future<SimpleHttpResponse> future = httpclient.execute(request1, null);
+ // and wait until response is received
+ SimpleHttpResponse response1 = future.get();
+ System.out.println(request1.getRequestUri() + "->" + response1.getCode());
+
+ // One most likely would want to use a callback for operation result
+ CountDownLatch latch1 = new CountDownLatch(1);
+ SimpleHttpRequest request2 = SimpleHttpRequests.get("http://httpbin.org/get");
+ httpclient.execute(request2, new FutureCallback<SimpleHttpResponse>() {
+
+ @Override
+ public void completed(SimpleHttpResponse response2) {
+ latch1.countDown();
+ System.out.println(request2.getRequestUri() + "->" + response2.getCode());
+ }
+
+ @Override
+ public void failed(Exception ex) {
+ latch1.countDown();
+ System.out.println(request2.getRequestUri() + "->" + ex);
+ }
+
+ @Override
+ public void cancelled() {
+ latch1.countDown();
+ System.out.println(request2.getRequestUri() + " cancelled");
+ }
+
+ });
+ latch1.await();
+
+ // In real world one most likely would want also want to stream
+ // request and response body content
+ CountDownLatch latch2 = new CountDownLatch(1);
+ AsyncRequestProducer producer3 = AsyncRequestBuilder.get("http://httpbin.org/get").build();
+ AbstractCharResponseConsumer<HttpResponse> consumer3 = new AbstractCharResponseConsumer<HttpResponse>() {
+
+ HttpResponse response;
+
+ @Override
+ protected void start(HttpResponse response, ContentType contentType) throws HttpException, IOException {
+ this.response = response;
+ }
+
+ @Override
+ protected int capacityIncrement() {
+ return Integer.MAX_VALUE;
+ }
+
+ @Override
+ protected void data(CharBuffer data, boolean endOfStream) throws IOException {
+ // Do something useful
+ }
+
+ @Override
+ protected HttpResponse buildResult() throws IOException {
+ return response;
+ }
+
+ @Override
+ public void releaseResources() {
+ }
+
+ };
+ httpclient.execute(producer3, consumer3, new FutureCallback<HttpResponse>() {
+
+ @Override
+ public void completed(HttpResponse response3) {
+ latch2.countDown();
+ System.out.println(request2.getRequestUri() + "->" + response3.getCode());
+ }
+
+ @Override
+ public void failed(Exception ex) {
+ latch2.countDown();
+ System.out.println(request2.getRequestUri() + "->" + ex);
+ }
+
+ @Override
+ public void cancelled() {
+ latch2.countDown();
+ System.out.println(request2.getRequestUri() + " cancelled");
+ }
+
+ });
+ latch2.await();
+
+ }
+ ```
+
+ Source can be downloaded
+ [here](https://github.com/apache/httpcomponents-client/tree/5.0.x/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncQuickStart.java)
+
+
diff --git a/src/site/markdown/httpcomponents-client-5.1.x/download.md b/src/site/markdown/httpcomponents-client-5.1.x/download.md
new file mode 100644
index 0000000..377c594
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.1.x/download.md
@@ -0,0 +1,39 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Downloads
+====================
+
+The latest release available for download:
+
+[Release packages](http://hc.apache.org/downloads.cgi) -
+[Release Notes](http://www.apache.org/dist/httpcomponents/httpclient/RELEASE_NOTES-5.1.x.txt) -
+[License](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+Dependency management
+---------------------
+
+If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
+[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
+HttpClient modules by using this information:
+
+- [HttpClient](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5)
+- [HttpClient Fluent](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-fluent)
+- [HttpClient Cache](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-cache)
+- [HttpClient Windows extensions](https://search.maven.org/artifact/org.apache.httpcomponents.client5/httpclient5-win)
diff --git a/src/site/markdown/httpcomponents-client-5.1.x/examples-async.md b/src/site/markdown/httpcomponents-client-5.1.x/examples-async.md
new file mode 100644
index 0000000..601bfc2
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.1.x/examples-async.md
@@ -0,0 +1,73 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Examples (Async)
+===========================
+
+- [Asynchronous HTTP exchange](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
+
+ This example demonstrates a basic asynchronous HTTP request / response exchange. Response content is buffered in
+ memory for simplicity.
+
+- [Asynchronous HTTP exchange with content streaming](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchangeStreaming.java)
+
+ This example demonstrates an asynchronous HTTP request / response exchange with a full content streaming.
+
+- [HTTP/2 ALPN support](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientTlsAlpn.java)
+
+ This example demonstrates how to avoid the illegal reflective access operation warning when running with Oracle JRE 9
+ or newer.
+
+- [Pipelined HTTP/1.1 exchanges](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp1Pipelining.java)
+
+ This example demonstrates a pipelined execution of multiple HTTP/1.1 request / response exchanges. Response content is
+ buffered in memory for simplicity.
+
+- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2Multiplexing.java)
+
+ This example demonstrates a multiplexed execution of multiple HTTP/2 request / response exchanges. Response content is
+ buffered in memory for simplicity.
+
+- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientInterceptors.java)
+
+ This example demonstrates how to insert custom request interceptor and an execution interceptor to the request
+ execution chain.
+
+- [Message trailers](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientMessageTrailers.java)
+
+ This example demonstrates how to use a custom execution interceptor to add trailers to all outgoing request enclosing
+ an entity..
+
+- [Multiplexed HTTP/2 exchanges](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttp2ServerPush.java)
+
+This example demonstrates handling of HTTP/2 message exchanges pushed by the server.
+
+- [Client authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientAuthentication.java)
+
+ This example demonstrates execution of an HTTP request against a target site that requires user authentication.
+
+- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientCustomSSL.java)
+
+ This example demonstrates how to create secure connections with a custom SSL context.
+
+- [Connection eviction](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientConnectionEviction.java)
+
+ This example demonstrates how to evict expired and idle connections from the connection pool.
+
+
diff --git a/src/site/markdown/httpcomponents-client-5.1.x/examples-reactive.md b/src/site/markdown/httpcomponents-client-5.1.x/examples-reactive.md
new file mode 100644
index 0000000..dba16f0
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.1.x/examples-reactive.md
@@ -0,0 +1,25 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Examples (Async)
+===========================
+
+- [HTTP exchange with Reactive Streams](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncClientHttpExchange.java)
+
+ This example demonstrates a reactive, full-duplex HTTP/1.1 message exchange using RxJava.
diff --git a/src/site/markdown/httpcomponents-client-5.1.x/examples.md b/src/site/markdown/httpcomponents-client-5.1.x/examples.md
new file mode 100644
index 0000000..39b48f3
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.1.x/examples.md
@@ -0,0 +1,103 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Examples (Classic)
+=============================
+
+- [Response handling](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientWithResponseHandler.java)
+
+ This example demonstrates how to process HTTP responses using a response handler. This is the recommended way of
+ executing HTTP requests and processing HTTP responses. This approach enables the caller to concentrate on the process
+ of digesting HTTP responses and to delegate the task of system resource deallocation to HttpClient. The use of an HTTP
+ response handler guarantees that the underlying HTTP connection will be released back to the connection manager
+ automatically in all cases.
+
+- [Manual connection release](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConnectionRelease.java)
+
+ This example demonstrates how to ensure the release of the underlying HTTP connection back to the connection manager
+ in case of a manual processing of HTTP responses.
+
+- [HttpClient configuration](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientConfiguration.java)
+
+ This example demonstrates how to customize and configure the most common aspects of HTTP request execution and
+ connection management.
+
+- [Request execution interceptors](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientInterceptors.java)
+
+ This example demonstrates how to insert custom request interceptor and an execution interceptor to the request
+ execution chain.
+
+- [Abort method](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAbortMethod.java)
+
+ This example demonstrates how to abort an HTTP request before its normal completion.
+
+- [Client authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientAuthentication.java)
+
+ This example uses HttpClient to execute an HTTP request against a target site that requires user authentication.
+
+- [Request via a proxy](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientExecuteProxy.java)
+
+ This example demonstrates how to send an HTTP request via a proxy.
+
+- [Proxy authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientProxyAuthentication.java)
+
+ A simple example showing execution of an HTTP request over a secure connection tunneled through an authenticating
+ proxy.
+
+- [Chunk encoded POST](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientChunkEncodedPost.java)
+
+ This example shows how to stream out a request entity using chunk encoding.
+
+- [Custom execution context](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomContext.java)
+
+ This example demonstrates the use of a local HTTP context populated custom attributes.
+
+- [Form based logon](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientFormLogin.java)
+
+ This example demonstrates how HttpClient can be used to perform form-based logon.
+
+- [Threaded request execution](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultiThreadedExecution.java)
+
+ An example that executes HTTP requests from multiple worker threads.
+
+- [Custom SSL context](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientCustomSSL.java)
+
+ This example demonstrates how to create secure connections with a custom SSL context.
+
+- [Preemptive BASIC authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveBasicAuthentication.java)
+
+ This example shows how HttpClient can be customized to authenticate preemptively using BASIC scheme. Generally,
+ preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
+ discouraged.
+
+- [Preemptive DIGEST authentication](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientPreemptiveDigestAuthentication.java)
+
+ This example shows how HttpClient can be customized to authenticate preemptively using DIGEST scheme. Generally,
+ preemptive authentication can be considered less secure than a response to an authentication challenge and therefore
+ discouraged.
+
+- [Proxy tunnel](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ProxyTunnelDemo.java)
+
+ This example shows how to use ProxyClient in order to establish a tunnel through an HTTP proxy for an arbitrary
+ protocol.
+
+- [Multipart encoded request entity](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/ClientMultipartFormPost.java)
+
+ This example shows how to execute requests enclosing a multipart encoded entity.
+
diff --git a/src/site/markdown/httpcomponents-client-5.1.x/index.md b/src/site/markdown/httpcomponents-client-5.1.x/index.md
new file mode 100644
index 0000000..cb05e01
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.1.x/index.md
@@ -0,0 +1,88 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Overview
+===================
+
+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, while increasing the number of applications that require HTTP support.
+
+Although the java.net package provides basic functionality for accessing resources via HTTP, it doesn't provide the full
+flexibility or functionality needed by many applications. HttpClient 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.
+
+Designed for extension while providing robust support for the base HTTP protocol, HttpClient 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.
+
+Documentation
+-------------
+
+1. [Quick Start](quickstart.md) - contains simple, complete examples of request execution with the classic, fluent and
+ async APIs.
+1. Examples demonstrating some common as well as more complex use cases
+
+ * [HttpClient (classic APIs)](examples.md)
+ * [HttpClient (async APIs)](examples-async.md)
+ * [HttpClient (reactive APIs)](examples-reactive.md)
+
+1. Javadocs
+
+ * [HttpClient](./current/httpclient5/apidocs/)
+ * [HC Fluent](./current/httpclient5-fluent/apidocs/)
+ * [HttpClient Cache](./current/httpclient5-cache/apidocs/)
+ * [HttpClient Windows extensions](./current/httpclient5-win/apidocs/)
+
+1. API compatibility reports
+
+ * [HttpClient](./current/httpclient5/clirr-report.html)
+ * [HC Fluent](./current/httpclient5-fluent/clirr-report.html)
+ * [HttpClient Cache](./current/httpclient5-cache/clirr-report.html)
+ * [HttpClient Windows extensions](./current/httpclient5-win/clirr-report.html)
+
+Features
+--------
+
+- Standards based, pure Java, implementation of HTTP versions 1.0, 1.1, 2.0
+- Supports encryption with HTTPS (HTTP over SSL) protocol.
+- Pluggable socket factories and TLS strategies.
+- Transparent message exchanges through HTTP/1.1 and HTTP/1.0 proxies.
+- Tunneled HTTPS connections through HTTP/1.1 and HTTP/1.0 proxies, via the CONNECT method.
+- Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO, Kerberos authentication schemes.
+- HTTP state management and cookie support.
+- Flexible connection management and pooling.
+- Support for HTTP response caching.
+- Source code is freely available under the Apache License.
+
+Standards Compliance
+--------------------
+
+HttpClient strives to conform to the following specifications endorsed by the Internet Engineering Task Force (IETF) and
+the internet at large:
+
+* [RFC 7230](http://tools.ietf.org/html/rfc7230) - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing
+* [RFC 7231](http://tools.ietf.org/html/rfc7231) - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+* [RFC 7235](http://tools.ietf.org/html/rfc7235) - Hypertext Transfer Protocol (HTTP/1.1): Authentication
+* [RFC 1945](http://tools.ietf.org/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
+* [RFC 2817](http://tools.ietf.org/html/rfc2817) - Upgrading to TLS Within HTTP/1.1
+* [RFC 2818](http://tools.ietf.org/html/rfc2818) - HTTP Over TLS
+* [RFC 6265](http://tools.ietf.org/html/rfc6265) - HTTP State Management Mechanism (Cookies)
+- [RFC 3986](http://tools.ietf.org/html/rfc3986) - Uniform Resource Identifier (URI): Generic Syntax
+
diff --git a/src/site/markdown/httpcomponents-client-5.1.x/quickstart.md b/src/site/markdown/httpcomponents-client-5.1.x/quickstart.md
new file mode 100644
index 0000000..9b1d8f4
--- /dev/null
+++ b/src/site/markdown/httpcomponents-client-5.1.x/quickstart.md
@@ -0,0 +1,185 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpClient Quick Start
+======================
+
+- Download 'Binary' package of the latest HttpClient 4.5 release or configure dependency on `HttpClient` and `Fluent HC`
+ modules using a dependency manager of your choice as described [here](download.md).
+
+- HttpClient 5.0 requires Java 1.7 or newer.
+
+- The below code fragment illustrates the execution of HTTP GET and POST requests using the HttpClient native API.
+
+ ```
+ try (CloseableHttpClient httpclient = HttpClients.createDefault()) {
+ HttpGet httpGet = new HttpGet("http://httpbin.org/get");
+ // The underlying HTTP connection is still held by the response object
+ // to allow the response content to be streamed directly from the network socket.
+ // In order to ensure correct deallocation of system resources
+ // the user MUST call CloseableHttpResponse#close() from a finally clause.
+ // Please note that if response content is not fully consumed the underlying
+ // connection cannot be safely re-used and will be shut down and discarded
+ // by the connection manager.
+ try (CloseableHttpResponse response1 = httpclient.execute(httpGet)) {
+ System.out.println(response1.getCode() + " " + response1.getReasonPhrase());
+ HttpEntity entity1 = response1.getEntity();
+ // do something useful with the response body
+ // and ensure it is fully consumed
+ EntityUtils.consume(entity1);
+ }
+
+ HttpPost httpPost = new HttpPost("http://httpbin.org/post");
+ List<NameValuePair> nvps = new ArrayList<>();
+ nvps.add(new BasicNameValuePair("username", "vip"));
+ nvps.add(new BasicNameValuePair("password", "secret"));
+ httpPost.setEntity(new UrlEncodedFormEntity(nvps));
+
+ try (CloseableHttpResponse response2 = httpclient.execute(httpPost)) {
+ System.out.println(response2.getCode() + " " + response2.getReasonPhrase());
+ HttpEntity entity2 = response2.getEntity();
+ // do something useful with the response body
+ // and ensure it is fully consumed
+ EntityUtils.consume(entity2);
+ }
+ }
+ ```
+
+ Source can be found here
+ [here](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/QuickStart.java)
+
+- The same requests can be executed using a simpler, albeit less flexible, fluent API.
+
+ ```
+ // The fluent API relieves the user from having to deal with manual deallocation of system
+ // resources at the cost of having to buffer response content in memory in some cases.
+
+ Request.Get("http://targethost/homepage")
+ .execute().returnContent();
+ Request.Post("http://targethost/login")
+ .bodyForm(Form.form().add("username", "vip").add("password", "secret").build())
+ .execute().returnContent();
+ ```
+
+ Source can be downloaded
+ [here](https://github.com/apache/httpcomponents-client/tree/master/httpclient5-fluent/src/test/java/org/apache/hc/client5/http/examples/fluent/FluentQuickStart.java)
+
+- The below code fragment illustrates the execution of HTTP requests using HttpClient async API.
+
+ ```
+ try (CloseableHttpAsyncClient httpclient = HttpAsyncClients.createDefault()) {
+ // Start the client
+ httpclient.start();
+
+ // Execute request
+ SimpleHttpRequest request1 = SimpleHttpRequests.get("http://httpbin.org/get");
+ Future<SimpleHttpResponse> future = httpclient.execute(request1, null);
+ // and wait until response is received
+ SimpleHttpResponse response1 = future.get();
+ System.out.println(request1.getRequestUri() + "->" + response1.getCode());
+
+ // One most likely would want to use a callback for operation result
+ CountDownLatch latch1 = new CountDownLatch(1);
+ SimpleHttpRequest request2 = SimpleHttpRequests.get("http://httpbin.org/get");
+ httpclient.execute(request2, new FutureCallback<SimpleHttpResponse>() {
+
+ @Override
+ public void completed(SimpleHttpResponse response2) {
+ latch1.countDown();
+ System.out.println(request2.getRequestUri() + "->" + response2.getCode());
+ }
+
+ @Override
+ public void failed(Exception ex) {
+ latch1.countDown();
+ System.out.println(request2.getRequestUri() + "->" + ex);
+ }
+
+ @Override
+ public void cancelled() {
+ latch1.countDown();
+ System.out.println(request2.getRequestUri() + " cancelled");
+ }
+
+ });
+ latch1.await();
+
+ // In real world one most likely would want also want to stream
+ // request and response body content
+ CountDownLatch latch2 = new CountDownLatch(1);
+ AsyncRequestProducer producer3 = AsyncRequestBuilder.get("http://httpbin.org/get").build();
+ AbstractCharResponseConsumer<HttpResponse> consumer3 = new AbstractCharResponseConsumer<HttpResponse>() {
+
+ HttpResponse response;
+
+ @Override
+ protected void start(HttpResponse response, ContentType contentType) throws HttpException, IOException {
+ this.response = response;
+ }
+
+ @Override
+ protected int capacityIncrement() {
+ return Integer.MAX_VALUE;
+ }
+
+ @Override
+ protected void data(CharBuffer data, boolean endOfStream) throws IOException {
+ // Do something useful
+ }
+
+ @Override
+ protected HttpResponse buildResult() throws IOException {
+ return response;
+ }
+
+ @Override
+ public void releaseResources() {
+ }
+
+ };
+ httpclient.execute(producer3, consumer3, new FutureCallback<HttpResponse>() {
+
+ @Override
+ public void completed(HttpResponse response3) {
+ latch2.countDown();
+ System.out.println(request2.getRequestUri() + "->" + response3.getCode());
+ }
+
+ @Override
+ public void failed(Exception ex) {
+ latch2.countDown();
+ System.out.println(request2.getRequestUri() + "->" + ex);
+ }
+
+ @Override
+ public void cancelled() {
+ latch2.countDown();
+ System.out.println(request2.getRequestUri() + " cancelled");
+ }
+
+ });
+ latch2.await();
+
+ }
+ ```
+
+ Source can be downloaded
+ [here](https://github.com/apache/httpcomponents-client/tree/master/httpclient5/src/test/java/org/apache/hc/client5/http/examples/AsyncQuickStart.java)
+
+
diff --git a/src/site/markdown/httpcomponents-core-4.4.x/download.md b/src/site/markdown/httpcomponents-core-4.4.x/download.md
new file mode 100644
index 0000000..8c5ecf5
--- /dev/null
+++ b/src/site/markdown/httpcomponents-core-4.4.x/download.md
@@ -0,0 +1,37 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpCore Downloads
+==================
+
+The latest release available for download:
+
+[Release packages](http://hc.apache.org/downloads.cgi) -
+[Release Notes](http://www.apache.org/dist/httpcomponents/httpcore/RELEASE_NOTES-4.4.x.txt) -
+[License](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+Dependency management
+---------------------
+
+If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
+[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
+HttpCore modules by using this information:
+
+- [HttpCore](https://search.maven.org/artifact/org.apache.httpcomponents/httpcore)
+- [HttpCore NIO](https://search.maven.org/artifact/org.apache.httpcomponents/httpcore-nio)
diff --git a/src/site/markdown/httpcomponents-core-4.4.x/examples.md b/src/site/markdown/httpcomponents-core-4.4.x/examples.md
new file mode 100644
index 0000000..5eb13f0
--- /dev/null
+++ b/src/site/markdown/httpcomponents-core-4.4.x/examples.md
@@ -0,0 +1,61 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpCore Examples
+=================
+
+- [Synchronous HTTP GET requests](https://github.com/apache/httpcomponents-core/tree/4.4.x/httpcore/src/examples/org/apache/http/examples/ElementalHttpGet.java)
+
+ This example demonstrates how to execute a series of synchronous (blocking) HTTP GET requests.
+
+- [Synchronous HTTP POST requests](https://github.com/apache/httpcomponents-core/tree/4.4.x/httpcore/src/examples/org/apache/http/examples/ElementalHttpPost.java)
+
+ This example demonstrates how to execute a series of synchronous (blocking) HTTP POST requests that enclose entity
+ content of various types: a string, a byte array, an arbitrary input stream.
+
+- [Synchronous HTTP GET requests with connection pooling](https://github.com/apache/httpcomponents-core/tree/4.4.x/httpcore/src/examples/org/apache/http/examples/ElementalPoolingHttpGet.java)
+
+ This example demonstrates how to execute a series of synchronous (blocking) HTTP GET requests using a pool of
+ persistent connections.
+
+- [Synchronous HTTP file server](https://github.com/apache/httpcomponents-core/tree/4.4.x/httpcore/src/examples/org/apache/http/examples/HttpFileServer.java)
+
+ This is an example of an HTTP/1.1 file server based on a synchronous (blocking) I/O model.
+
+- [Synchronous HTTP reverse proxy](https://github.com/apache/httpcomponents-core/tree/4.4.x/httpcore/src/examples/org/apache/http/examples/ElementalReverseProxy.java)
+
+ This is an example of an HTTP/1.1 reverse proxy based on a synchronous (blocking) I/O model.
+
+- [Asynchronous HTTP GET requests](https://github.com/apache/httpcomponents-core/tree/4.4.x/httpcore-nio/src/examples/org/apache/http/examples/nio/NHttpClient.java)
+
+ This example demonstrates how HttpCore NIO can be used to execute multiple HTTP requests asynchronously.
+
+- [Pipelined HTTP GET requests](https://github.com/apache/httpcomponents-core/tree/4.4.x/httpcore-nio/src/examples/org/apache/http/examples/nio/PipeliningHttpClient.java)
+
+ This example demonstrates how HttpCore NIO can be used to execute series of pipelined HTTP requests.
+
+- [Asynchronous HTTP server](https://github.com/apache/httpcomponents-core/tree/4.4.x/httpcore-nio/src/examples/org/apache/http/examples/nio/NHttpFileServer.java)
+
+ This example demonstrates the use of HttpCore NIO to build an asynchronous (non-blocking) HTTP server capable of
+ direct channel (zero copy) data transfer.
+
+- [Asynchronous HTTP reverse proxy](https://github.com/apache/httpcomponents-core/tree/4.4.x/httpcore-nio/src/examples/org/apache/http/examples/nio/NHttpReverseProxy.java)
+
+ This example demonstrates how HttpCore NIO can be used to build an asynchronous, fully streaming reverse HTTP proxy.
+
diff --git a/src/site/markdown/httpcomponents-core-4.4.x/index.md b/src/site/markdown/httpcomponents-core-4.4.x/index.md
new file mode 100644
index 0000000..2c1100a
--- /dev/null
+++ b/src/site/markdown/httpcomponents-core-4.4.x/index.md
@@ -0,0 +1,47 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpCore Overview
+=================
+
+HttpCore is a set of low level HTTP transport components that can be used to build custom client and server side HTTP
+services with a minimal footprint. HttpCore supports two I/O models: blocking I/O model based on the classic Java I/O
+and non-blocking, event driven I/O model based on Java NIO.
+
+Documentation
+-------------
+
+1. HttpCore [Tutorial](./current/tutorial/html/) ([PDF](./tutorial/pdf/httpcore-tutorial.pdf))
+1. Examples of HttpCore components in action can be found [here](examples.md)
+1. Javadocs
+ - [HttpCore](./current/httpcore/apidocs/)
+ - [HttpCore NIO](./current/httpcore-nio/apidocs/)
+
+1. API compatibility reports
+ - [HttpCore](./current/httpcore/clirr-report.html)
+ - [HttpCore NIO](./current/httpcore-nio/clirr-report.html)
+
+Standards Compliance
+--------------------
+
+HttpCore components strive to conform to the following specifications endorsed by the Internet Engineering Task Force
+(IETF) and the internet at large:
+
+- [RFC 1945](http://tools.ietf.org/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
+- [RFC 2616](http://tools.ietf.org/html/rfc2616) - Hypertext Transfer Protocol -- HTTP/1.1
diff --git a/src/site/markdown/httpcomponents-core-5.0.x/download.md b/src/site/markdown/httpcomponents-core-5.0.x/download.md
new file mode 100644
index 0000000..b95e579
--- /dev/null
+++ b/src/site/markdown/httpcomponents-core-5.0.x/download.md
@@ -0,0 +1,38 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpCore Downloads
+==================
+
+The latest release available for download:
+
+[Release packages](http://hc.apache.org/downloads.cgi) -
+[Release Notes](http://www.apache.org/dist/httpcomponents/httpcore/RELEASE_NOTES-5.0.x.txt) -
+[License](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+Dependency management
+---------------------
+
+If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
+[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
+HttpCore modules by using this information:
+
+- [HttpCore HTTP/1.1](https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5)
+- [HttpCore HTTP/2](https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5-h2)
+- [HttpCore Reactive Streams](https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5-reactive)
\ No newline at end of file
diff --git a/src/site/markdown/httpcomponents-core-5.0.x/examples.md b/src/site/markdown/httpcomponents-core-5.0.x/examples.md
new file mode 100644
index 0000000..cc50ce7
--- /dev/null
+++ b/src/site/markdown/httpcomponents-core-5.0.x/examples.md
@@ -0,0 +1,92 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpCore Examples
+=================
+
+- [ Classic (blocking) HTTP/1.1 GET requests](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicGetExecutionExample.java)
+
+ This example demonstrates synchronous execution of multiple HTTP/1.1 GET requests.
+
+- [ Classic (blocking) HTTP/1.1 POST requests](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicPostExecutionExample.java)
+
+ This example demonstrates synchronous execution of multiple HTTP/1.1 POST requests with enclosed content of various
+ types.
+
+- [ Asynchronous HTTP/1.1 GET requests](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncRequestExecutionExample.java)
+
+ This example demonstrates asynchronous execution of multiple HTTP/1.1 requests.
+
+- [ Asynchronous HTTP/2 GET requests](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2RequestExecutionExample.java)
+
+ This example demonstrates asynchronous execution of multiple HTTP/2 requests.
+
+- [ HTTP/2 requests over TLS connections with ALPN support](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2TlsAlpnRequestExecutionExample.java)
+
+ This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support. It also explains how
+ to avoid the illegal reflective access operation warning when running Java 9 or older.
+
+- [ HTTP/2 requests over TLS connections with ALPN support on Java 1.7 and Java 1.8](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2ConscriptRequestExecutionExample.java)
+
+ This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support on Java 1.7 and Java
+ 1.8.
+
+- [ Asynchronous HTTP/1.1 GET requests with message pipelining](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncPipelinedRequestExecutionExample.java)
+
+ This example demonstrates asynchronous, pipelined execution multiple HTTP/1.1 requests.
+
+- [ Asynchronous HTTP/2 GET requests with multiple concurrent streams](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2MultiStreamExecutionExample.java)
+
+ This example demonstrates asynchronous, multistream execution of multiple HTTP/2 requests.
+
+- [ Classic (blocking) HTTP/1.1 file server](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicFileServerExample.java)
+
+ This is an example of an embedded HTTP/1.1 file server with a classic (blocking) message transport.
+
+- [ Request filters with classic (blocking) HTTP/1.1 server](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicServerFilterExample.java)
+
+ This is an example of using synchronous request filters with an embedded HTTP/1.1 server.
+
+- [ Asynchronous HTTP/1.1 file server](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncFileServerExample.java)
+
+ This is an example of an embedded HTTP/1.1 file server with an event driven, non-blocking message transport.
+
+- [ Request filters with asynchronous HTTP/1.1 server](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncServerFilterExample.java)
+
+ This is an example of using asynchronous request filters with an embedded HTTP/1.1 server.
+
+- [ Asynchronous HTTP/2 file server](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2FileServerExample.java)
+
+ This is an example of an embedded HTTP/2 file server with an event driven, non-blocking message transport.
+
+- [ Classic (blocking) HTTP reverse proxy](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicReverseProxyExample.java)
+
+ This is an example of an embedded HTTP/1.1 reverse proxy with a classic (blocking) message transport.
+
+- [ Asynchronous HTTP reverse proxy](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncReverseProxyExample.java)
+
+ This is an example of an embedded HTTP/1.1 reverse proxy with an event driven, non-blocking message transport.
+
+- [ Client Reactive Streams](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5-reactive/src/test/java/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexClientExample.java)
+
+ This is an example of full-duplex HTTP/1.1 client side message exchanges using reactive streaming.
+
+- [ Server Reactive Streams](https://github.com/apache/httpcomponents-core/tree/5.0.x/httpcore5-reactive/src/test/java/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexServerExample.java)
+
+ This is an example of full-duplex HTTP/1.1 server side message exchanges using reactive streaming.
diff --git a/src/site/markdown/httpcomponents-core-5.0.x/index.md b/src/site/markdown/httpcomponents-core-5.0.x/index.md
new file mode 100644
index 0000000..f8ee50a
--- /dev/null
+++ b/src/site/markdown/httpcomponents-core-5.0.x/index.md
@@ -0,0 +1,54 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpCore Overview
+=================
+
+HttpCore is a set of low level HTTP transport components that can be used to build custom client and server side HTTP
+services with a minimal footprint. HttpCore supports two I/O models: blocking I/O model based on the classic Java I/O
+and non-blocking, event driven I/O model based on Java NIO.
+
+Documentation
+=============
+
+1. Some examples of HttpCore components in action can be found [here](./examples.html)
+
+1. Javadocs
+ - [HttpCore HTTP/1.1](./current/httpcore5/apidocs/)
+ - [HttpCore HTTP/2](./current/httpcore5-h2/apidocs/)
+ - [HttpCore Reactive Streams](./current/httpcore5-reactive/apidocs/)
+
+1. API compatibility reports
+ - [HttpCore HTTP/1.1](./current/httpcore5/clirr-report.html)
+ - [HttpCore HTTP/2](./current/httpcore5-h2/clirr-report.html)
+ - [HttpCore Reactive Streams](./current/httpcore5-reactive/clirr-report.html)
+
+Standards Compliance
+--------------------
+
+HttpCore components strive to conform to the following specifications endorsed by the Internet Engineering Task Force
+(IETF) and the internet at large:
+
+- [RFC 7540](http://tools.ietf.org/html/rfc7540) - Hypertext Transfer Protocol Version 2 (HTTP/2)
+- [RFC 7541](http://tools.ietf.org/html/rfc7541) - HPACK: Header Compression for HTTP/2
+- [RFC 7230](http://tools.ietf.org/html/rfc7230) - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing
+- [RFC 7231](http://tools.ietf.org/html/rfc7231) - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+- [RFC 1945](http://tools.ietf.org/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
+- [RFC 2396](http://tools.ietf.org/html/rfc2396) - Uniform Resource Identifiers (URI): Generic Syntax
+
diff --git a/src/site/markdown/httpcomponents-core-5.1.x/download.md b/src/site/markdown/httpcomponents-core-5.1.x/download.md
new file mode 100644
index 0000000..89c9655
--- /dev/null
+++ b/src/site/markdown/httpcomponents-core-5.1.x/download.md
@@ -0,0 +1,38 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpCore Downloads
+==================
+
+The latest release available for download:
+
+[Release packages](http://hc.apache.org/downloads.cgi) -
+[Release Notes](http://www.apache.org/dist/httpcomponents/httpcore/RELEASE_NOTES-5.1.x.txt) -
+[License](http://www.apache.org/licenses/LICENSE-2.0.html)
+
+Dependency management
+---------------------
+
+If you are using a dependency manager for your project such as [Apache Maven](https://maven.apache.org),
+[Gradle](https://gradle.org/) or [Apache Ivy](https://ant.apache.org/projects/ivy.html), you can create a dependency on
+HttpCore modules by using this information:
+
+- [HttpCore HTTP/1.1](https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5)
+- [HttpCore HTTP/2](https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5-h2)
+- [HttpCore Reactive Streams](https://search.maven.org/artifact/org.apache.httpcomponents.core5/httpcore5-reactive)
\ No newline at end of file
diff --git a/src/site/markdown/httpcomponents-core-5.1.x/examples.md b/src/site/markdown/httpcomponents-core-5.1.x/examples.md
new file mode 100644
index 0000000..7811a03
--- /dev/null
+++ b/src/site/markdown/httpcomponents-core-5.1.x/examples.md
@@ -0,0 +1,92 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpCore Examples
+=================
+
+- [ Classic (blocking) HTTP/1.1 GET requests](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicGetExecutionExample.java)
+
+ This example demonstrates synchronous execution of multiple HTTP/1.1 GET requests.
+
+- [ Classic (blocking) HTTP/1.1 POST requests](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicPostExecutionExample.java)
+
+ This example demonstrates synchronous execution of multiple HTTP/1.1 POST requests with enclosed content of various
+ types.
+
+- [ Asynchronous HTTP/1.1 GET requests](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncRequestExecutionExample.java)
+
+ This example demonstrates asynchronous execution of multiple HTTP/1.1 requests.
+
+- [ Asynchronous HTTP/2 GET requests](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2RequestExecutionExample.java)
+
+ This example demonstrates asynchronous execution of multiple HTTP/2 requests.
+
+- [ HTTP/2 requests over TLS connections with ALPN support](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2TlsAlpnRequestExecutionExample.java)
+
+ This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support. It also explains how
+ to avoid the illegal reflective access operation warning when running Java 9 or older.
+
+- [ HTTP/2 requests over TLS connections with ALPN support on Java 1.7 and Java 1.8](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2ConscriptRequestExecutionExample.java)
+
+ This example demonstrates how to execute HTTP/2 requests over TLS connections with ALPN support on Java 1.7 and Java
+ 1.8.
+
+- [ Asynchronous HTTP/1.1 GET requests with message pipelining](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncPipelinedRequestExecutionExample.java)
+
+ This example demonstrates asynchronous, pipelined execution multiple HTTP/1.1 requests.
+
+- [ Asynchronous HTTP/2 GET requests with multiple concurrent streams](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2MultiStreamExecutionExample.java)
+
+ This example demonstrates asynchronous, multistream execution of multiple HTTP/2 requests.
+
+- [ Classic (blocking) HTTP/1.1 file server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicFileServerExample.java)
+
+ This is an example of an embedded HTTP/1.1 file server with a classic (blocking) message transport.
+
+- [ Request filters with classic (blocking) HTTP/1.1 server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicServerFilterExample.java)
+
+ This is an example of using synchronous request filters with an embedded HTTP/1.1 server.
+
+- [ Asynchronous HTTP/1.1 file server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncFileServerExample.java)
+
+ This is an example of an embedded HTTP/1.1 file server with an event driven, non-blocking message transport.
+
+- [ Request filters with asynchronous HTTP/1.1 server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncServerFilterExample.java)
+
+ This is an example of using asynchronous request filters with an embedded HTTP/1.1 server.
+
+- [ Asynchronous HTTP/2 file server](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-h2/src/test/java/org/apache/hc/core5/http2/examples/H2FileServerExample.java)
+
+ This is an example of an embedded HTTP/2 file server with an event driven, non-blocking message transport.
+
+- [ Classic (blocking) HTTP reverse proxy](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/ClassicReverseProxyExample.java)
+
+ This is an example of an embedded HTTP/1.1 reverse proxy with a classic (blocking) message transport.
+
+- [ Asynchronous HTTP reverse proxy](https://github.com/apache/httpcomponents-core/tree/master/httpcore5/src/test/java/org/apache/hc/core5/http/examples/AsyncReverseProxyExample.java)
+
+ This is an example of an embedded HTTP/1.1 reverse proxy with an event driven, non-blocking message transport.
+
+- [ Client Reactive Streams](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-reactive/src/test/java/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexClientExample.java)
+
+ This is an example of full-duplex HTTP/1.1 client side message exchanges using reactive streaming.
+
+- [ Server Reactive Streams](https://github.com/apache/httpcomponents-core/tree/master/httpcore5-reactive/src/test/java/org/apache/hc/core5/reactive/examples/ReactiveFullDuplexServerExample.java)
+
+ This is an example of full-duplex HTTP/1.1 server side message exchanges using reactive streaming.
diff --git a/src/site/markdown/httpcomponents-core-5.1.x/index.md b/src/site/markdown/httpcomponents-core-5.1.x/index.md
new file mode 100644
index 0000000..b7b8fce
--- /dev/null
+++ b/src/site/markdown/httpcomponents-core-5.1.x/index.md
@@ -0,0 +1,54 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+
+HttpCore Overview
+=================
+
+HttpCore is a set of low level HTTP transport components that can be used to build custom client and server side HTTP
+services with a minimal footprint. HttpCore supports two I/O models: blocking I/O model based on the classic Java I/O
+and non-blocking, event driven I/O model based on Java NIO.
+
+Documentation
+=============
+
+1. Some examples of HttpCore components in action can be found [here](./examples.html)
+
+1. Javadocs
+ - [HttpCore HTTP/1.1](./current/httpcore5/apidocs/)
+ - [HttpCore HTTP/2](./current/httpcore5-h2/apidocs/)
+ - [HttpCore Reactive Streams](./current/httpcore5-reactive/apidocs/)
+
+1. API compatibility reports
+ - [HttpCore HTTP/1.1](./current/httpcore5/clirr-report.html)
+ - [HttpCore HTTP/2](./current/httpcore5-h2/clirr-report.html)
+ - [HttpCore Reactive Streams](./current/httpcore5-reactive/clirr-report.html)
+
+Standards Compliance
+--------------------
+
+HttpCore components strive to conform to the following specifications endorsed by the Internet Engineering Task Force
+(IETF) and the internet at large:
+
+- [RFC 7540](http://tools.ietf.org/html/rfc7540) - Hypertext Transfer Protocol Version 2 (HTTP/2)
+- [RFC 7541](http://tools.ietf.org/html/rfc7541) - HPACK: Header Compression for HTTP/2
+- [RFC 7230](http://tools.ietf.org/html/rfc7230) - Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing
+- [RFC 7231](http://tools.ietf.org/html/rfc7231) - Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content
+- [RFC 1945](http://tools.ietf.org/html/rfc1945) - Hypertext Transfer Protocol -- HTTP/1.0
+- [RFC 3986](http://tools.ietf.org/html/rfc3986) - Uniform Resource Identifier (URI): Generic Syntax
+
diff --git a/src/site/resources/httpcomponents-asyncclient-4.1.x/documentation.links b/src/site/resources/httpcomponents-asyncclient-4.1.x/documentation.links
new file mode 100644
index 0000000..255096f
--- /dev/null
+++ b/src/site/resources/httpcomponents-asyncclient-4.1.x/documentation.links
@@ -0,0 +1,5 @@
+# links property file for Ant's symlink task in pom.xml:
+# links to components in http://hc.apache.org/components/
+
+current ../components/httpcomponents-asyncclient-4.1.x/4.1.4
+4.1.4 ../components/httpcomponents-asyncclient-4.1.x/4.1.4
diff --git a/src/site/resources/httpcomponents-client-4.5.x/documentation.links b/src/site/resources/httpcomponents-client-4.5.x/documentation.links
new file mode 100644
index 0000000..5c1084a
--- /dev/null
+++ b/src/site/resources/httpcomponents-client-4.5.x/documentation.links
@@ -0,0 +1,5 @@
+# links property file for Ant's symlink task in pom.xml:
+# links to components in http://hc.apache.org/components/
+
+current ../components/httpcomponents-client-4.5.x/4.5.13
+4.5.13 ../components/httpcomponents-client-4.5.x/4.5.13
diff --git a/src/site/resources/httpcomponents-client-5.0.x/documentation.links b/src/site/resources/httpcomponents-client-5.0.x/documentation.links
index 28d8f1b..39cabcd 100644
--- a/src/site/resources/httpcomponents-client-5.0.x/documentation.links
+++ b/src/site/resources/httpcomponents-client-5.0.x/documentation.links
@@ -1,3 +1,5 @@
# links property file for Ant's symlink task in pom.xml:
# links to components in http://hc.apache.org/components/
-LATEST ../components/httpcomponents-client-5.0.x/LATEST
+
+5.0.3 ../components/httpcomponents-client-5.0.x/5.0.3
+current ../components/httpcomponents-client-5.0.x/5.0.3
diff --git a/src/site/resources/httpcomponents-core-4.4.x/documentation.links b/src/site/resources/httpcomponents-core-4.4.x/documentation.links
new file mode 100644
index 0000000..96cc643
--- /dev/null
+++ b/src/site/resources/httpcomponents-core-4.4.x/documentation.links
@@ -0,0 +1,5 @@
+# links property file for Ant's symlink task in pom.xml:
+# links to components in http://hc.apache.org/components/
+
+current ../components/httpcomponents-core-4.4.x/4.4.14
+4.4.14 ../components/httpcomponents-core-4.4.x/4.4.14
diff --git a/src/site/resources/httpcomponents-core-5.0.x/documentation.links b/src/site/resources/httpcomponents-core-5.0.x/documentation.links
new file mode 100644
index 0000000..b770af3
--- /dev/null
+++ b/src/site/resources/httpcomponents-core-5.0.x/documentation.links
@@ -0,0 +1,5 @@
+# links property file for Ant's symlink task in pom.xml:
+# links to components in http://hc.apache.org/components/
+
+5.0.3 ../components/httpcomponents-core-5.0.x/5.0.3
+current ../components/httpcomponents-core-5.0.x/5.0.3
diff --git a/src/site/site.xml b/src/site/site.xml
index 04cfc88..0216516 100644
--- a/src/site/site.xml
+++ b/src/site/site.xml
@@ -103,7 +103,7 @@
</item>
<item name="HttpClient 4.5" collapse="true" href="httpcomponents-client-4.5.x/index.html">
<item name="Quick Start" href="httpcomponents-client-4.5.x/quickstart.html"/>
- <item name="Tutorial" href="httpcomponents-client-4.5.x/tutorial/html/index.html"/>
+ <item name="Tutorial" href="httpcomponents-client-4.5.x/current/tutorial/html/index.html"/>
<item name="Examples" href="httpcomponents-client-4.5.x/examples.html"/>
<item name="Android" href="httpcomponents-client-4.5.x/android.html"/>
<item name="Programming Primer" href="httpcomponents-client-4.5.x/primer.html"/>
@@ -112,7 +112,7 @@
<item name="Download" href="httpcomponents-client-4.5.x/download.html"/>
</item>
<item name="HttpCore 4.4" collapse="true" href="httpcomponents-core-4.4.x/index.html">
- <item name="Tutorial" href="httpcomponents-core-4.4.x/tutorial/html/index.html"/>
+ <item name="Tutorial" href="httpcomponents-core-4.4.x/current/tutorial/html/index.html"/>
<item name="Examples" href="httpcomponents-core-4.4.x/examples.html"/>
<item name="Download" href="httpcomponents-core-4.4.x/download.html"/>
</item>
