@@ -5,7 +5,22 @@ HTTP Client API
55General
66-------
77
8- .. FIXME describe the general API for the HTTP Clients
8+ :mod: `cpp-netlib ` includes and implements a number of HTTP clients that you can
9+ use and embed in your own applications. All of the HTTP client implementations:
10+
11+ * Cannot be copied. This means you may have to store instances of the clients in
12+ dynamic memory.
13+ * Assume that requests made are independent of each other. There currently is no
14+ cookie or session management system built-in to cpp-netlib's HTTP client
15+ implementations.
16+ * Are header-only and are compiled-into your application. Future releases in
17+ case you want to upgrade the implementation you are using in your application
18+ will be distributed as header-only implementations, which means you have to
19+ re-compile your application to use a newer version of the implementations.
20+
21+ The HTTP clients all share the same API, but the internals are documented in
22+ terms of what is different and what to expect with the different
23+ implementations.
924
1025Implementations
1126---------------