[65-libyang-generic] Addressed comments

doc/devel/mainpage.dox

@@ -107,7 +107,6 @@
  *
  * @section libraries Kea libraries
  * - @subpage libcc
- * - @subpage libyang
  * - @subpage libdhcp
  *   - @subpage libdhcpIntro
  *   - @subpage libdhcpRelay
@@ -130,6 +129,7 @@
  * - @subpage libprocess
  *   - @subpage cpl
  *   - @subpage cplSignals
+ * - @subpage libyang
  *
  * @section miscellaneousTopics Miscellaneous Topics
  * - @subpage terminology

src/lib/yang/sysrepo_connection.cc

@@ -18,7 +18,7 @@ SysrepoConnection::~SysrepoConnection() {
         session_->unlock_datastore();
         session_->session_stop();
 
-      // how to call disconnect?
+        // @todo: how to call disconnect?
     }
 }
 

src/lib/yang/sysrepo_connection.h

@@ -13,21 +13,30 @@
 namespace isc {
 namespace yang {
 
+/// @brief Exception from the sysrepo library for connection.
 class SysrepoConnectionError : public Exception {
 public:
     SysrepoConnectionError(const char* file, size_t line, const char* what) :
         isc::Exception(file, line, what) {}
 };
 
+/// @brief Connection to the sysrepo library. Provision, i.e. currently unused.
 class SysrepoConnection {
 public:
+    // @brief Constructor.
     SysrepoConnection();
+
+    // @brief Destructor.
     virtual ~SysrepoConnection();
+
+    // @brief Get a connection and a session.
     void connect();
 
+    // @brief Commit a session.
     void commit();
 
  private:
+    // @brief The session.
     S_Session session_;
 };