Minor comment style cleanups

include/SQLiteCpp/Backup.h

@@ -130,7 +130,7 @@ private:
     /// @}
 
 private:
-    sqlite3_backup* mpSQLiteBackup;   //!< Pointer to SQLite Database Backup Handle
+    sqlite3_backup* mpSQLiteBackup;   ///< Pointer to SQLite Database Backup Handle
 };
 
 }  // namespace SQLite

include/SQLiteCpp/Column.h

@@ -239,8 +239,8 @@ public:
 #endif
 
 private:
-    Statement::Ptr  mStmtPtr;   //!< Shared Pointer to the prepared SQLite Statement Object
+    Statement::Ptr  mStmtPtr;   ///< Shared Pointer to the prepared SQLite Statement Object
-    int             mIndex;     //!< Index of the column in the row of result, starting at 0
+    int             mIndex;     ///< Index of the column in the row of result, starting at 0
 };
 
 /**

include/SQLiteCpp/Database.h

@@ -278,7 +278,7 @@ public:
      * @brief Return raw pointer to SQLite Database Connection Handle.
      *
      * This is often needed to mix this wrapper with other libraries or for advance usage not supported by SQLiteCpp.
-    */
+     */
     inline sqlite3* getHandle() const noexcept // nothrow
     {
         return mpSQLite;
@@ -379,8 +379,8 @@ private:
     }
 
 private:
-    sqlite3*    mpSQLite;   //!< Pointer to SQLite Database Connection Handle
+    sqlite3*    mpSQLite;   ///< Pointer to SQLite Database Connection Handle
-    std::string mFilename;  //!< UTF-8 filename used to open the database
+    std::string mFilename;  ///< UTF-8 filename used to open the database
 };
 
 

include/SQLiteCpp/Statement.h

@@ -463,14 +463,14 @@ public:
 
 #ifdef SQLITE_ENABLE_COLUMN_METADATA
     /**
-    * @brief Return a pointer to the table column name that is the origin of the specified result column
+     * @brief Return a pointer to the table column name that is the origin of the specified result column
-    *
+     *
-    *  Require definition of the SQLITE_ENABLE_COLUMN_METADATA preprocessor macro :
+     *  Require definition of the SQLITE_ENABLE_COLUMN_METADATA preprocessor macro :
-    * - when building the SQLite library itself (which is the case for the Debian libsqlite3 binary for instance),
+     * - when building the SQLite library itself (which is the case for the Debian libsqlite3 binary for instance),
-    * - and also when compiling this wrapper.
+     * - and also when compiling this wrapper.
-    *
+     *
-    *  Throw an exception if the specified index is out of the [0, getColumnCount()) range.
+     *  Throw an exception if the specified index is out of the [0, getColumnCount()) range.
-    */
+     */
     const char* getColumnOriginName(const int aIndex) const;
 #endif
 
@@ -546,7 +546,7 @@ private:
         }
 
     private:
-        /// @{ Unused/forbidden copy operator
+        /// @{ Unused/forbidden copy/assignment operator
         Ptr& operator=(const Ptr& aPtr);
         /// @}
 
@@ -588,8 +588,8 @@ private:
     }
 
     /**
-    * @brief Check if there is a Column index is in the range of columns in the result.
+     * @brief Check if there is a Column index is in the range of columns in the result.
-    */
+     */
     inline void checkIndex(const int aIndex) const
     {
         if ((aIndex < 0) || (aIndex >= mColumnCount))
@@ -599,6 +599,7 @@ private:
     }
 
 private:
+    /// Map of columns index by name (mutable so getColumnIndex can be const)
     typedef std::map<std::string, int> TColumnNames;
 
 private:

include/SQLiteCpp/Transaction.h

@@ -69,8 +69,8 @@ private:
     /// @}
 
 private:
-    Database&   mDatabase;  //!< Reference to the SQLite Database Connection
+    Database&   mDatabase;  ///< Reference to the SQLite Database Connection
-    bool        mbCommited; //!< True when commit has been called
+    bool        mbCommited; ///< True when commit has been called
 };