SH-3185 Fill in some FIXME/TODO cases

Also added some comments and changed the callback userdata argument
to be an HttpOpRequest rather than a libcurl handle.  Less code,
less clutter.

1 files changed, 12 insertions, 0 deletions

diff --git a/indra/llcorehttp/_httpoprequest.h b/indra/llcorehttp/_httpoprequest.h
index 5d2417466c..a4c5fbb3c2 100644
--- a/indra/llcorehttp/_httpoprequest.h
+++ b/indra/llcorehttp/_httpoprequest.h
@@ -49,6 +49,16 @@ class HttpOptions;
 
 /// HttpOpRequest requests a supported HTTP method invocation with
 /// option and header overrides.
+///
+/// Essentially an RPC to get an HTTP GET, POST or PUT executed
+/// asynchronously with options to override behaviors and HTTP
+/// headers.
+///
+/// Constructor creates a raw object incapable of useful work.
+/// A subsequent call to one of the setupXXX() methods provides
+/// the information needed to make a working request which can
+/// then be enqueued to a request queue.
+///
 
 class HttpOpRequest : public HttpOperation
 {
@@ -177,6 +187,8 @@ public:
 // Free functions
 // ---------------------------------------
 
+// Internal function to append the contents of an HttpHeaders
+// instance to a curl_slist object.
 curl_slist * append_headers_to_slist(const HttpHeaders *, curl_slist * slist);
 
 }   // end namespace LLCore