Added submitblock and commented Json_rpc_http_server.

src/rpc/json_rpc_http_server.cpp

@@ -1,7 +1,16 @@
+/*!
+ * \file json_rpc_http_server.h
+ * \brief Header for Json_rpc_http_server class
+ */
+
 #include "json_rpc_http_server.h"
 
 #include <iostream>
 
+/*!
+ * \namespace RPC
+ * \brief RPC related utilities
+ */
 namespace RPC
 {
   int Json_rpc_http_server::parse_error = -32700;
@@ -9,6 +18,12 @@ namespace RPC
   int Json_rpc_http_server::invalid_params = -32602;
   int Json_rpc_http_server::internal_error = -32603;
 
+  /**
+   * \brief Constructor
+   * \param ip IP address to bind
+   * \param port Port number to bind
+   * \param ev_handler Event handler function pointer
+   */
   Json_rpc_http_server::Json_rpc_http_server(const std::string &ip, const std::string &port,
     void (*ev_handler)(struct ns_connection *nc, int ev, void *ev_data))
   {
@@ -18,11 +33,18 @@ namespace RPC
     m_ev_handler = ev_handler;
   }
 
+  /**
+   * \brief Destructor
+   */
   Json_rpc_http_server::~Json_rpc_http_server()
   {
     stop();
   }
 
+  /*!
+   * \brief Starts the server
+   * \return True if start was successful
+   */
   bool Json_rpc_http_server::start()
   {
     m_is_running = true;
@@ -33,17 +55,25 @@ namespace RPC
       return false;
     }
     ns_set_protocol_http_websocket(nc);
+    // Start a new thread so it doesn't block.
     server_thread = new boost::thread(&Json_rpc_http_server::poll, this);
     return true;
   }
 
+  /*!
+   * \brief Repeated loops processing requests if any.
+   */
   void Json_rpc_http_server::poll()
   {
+    // Loop until the server is running and poll.
     while (m_is_running) {
       ns_mgr_poll(&mgr, 1000);
     }
   }
 
+  /*!
+   * \brief Stops the server
+   */
   void Json_rpc_http_server::stop()
   {
     m_is_running = false;