add comments

src/app/browser/main/tab.hpp

@@ -20,6 +20,11 @@ namespace app::browser::main
     {
         public:
 
+            /*
+             * Class database
+             *
+             * Allowed parental access to enums and relationship methods
+             */
             struct DB
             {
                 struct APP_BROWSER_MAIN_TAB__SESSION
@@ -31,26 +36,29 @@ namespace app::browser::main
                         PAGE_NUMBER,
                         IS_CURRENT,
                         LABEL_TEXT
-                    };
+                    }; // table fields index
 
                     static int init(
                         sqlite3 * db
-                    );
+                    ); // return SQLite status code
 
                     static int clean(
                         sqlite3 * db
-                    );
+                    ); // return SQLite status code
 
                     static sqlite3_int64 add(
                         sqlite3 * db,
                         const int & PAGE_NUMBER,
                         const bool & IS_CURRENT,
                         const Glib::ustring & LABEL_TEXT
-                    );
+                    ); // return last insert ID
 
                 };
             };
 
+        /*
+         * Internal members
+         */
         private:
 
             // Database
@@ -68,6 +76,9 @@ namespace app::browser::main
             const bool REORDERABLE = true;
             const bool SCROLLABLE = true;
 
+        /*
+         * Class API
+         */
         public:
 
             Tab(

src/app/browser/main/tab/page.hpp

@@ -35,6 +35,11 @@ namespace app::browser::main::tab
                 UNDEFINED
             };
 
+            /*
+             * Class database
+             *
+             * Allowed parental access to enums and relationship methods
+             */
             struct DB
             {
                 struct APP_BROWSER_MAIN_TAB_PAGE__SESSION
@@ -46,16 +51,16 @@ namespace app::browser::main::tab
                         MIME,
                         TITLE,
                         DESCRIPTION
-                    };
+                    }; // table fields index
 
                     static int init(
                         sqlite3 * db
-                    );
+                    ); // return SQLite status code
 
                     static int clean(
                         sqlite3 * db,
                         const int & DB__APP_BROWSER_MAIN_TAB__SESSION_ID
-                    );
+                    ); // return SQLite status code
 
                     static sqlite3_int64 add(
                         sqlite3 * db,
@@ -63,10 +68,13 @@ namespace app::browser::main::tab
                         const Page::MIME & MIME,
                         const Glib::ustring & TITLE,
                         const Glib::ustring & DESCRIPTION
-                    );
+                    ); // return last insert ID
                 };
             };
 
+        /*
+         * Internal members
+         */
         private:
 
             // Meta
@@ -91,6 +99,9 @@ namespace app::browser::main::tab
             page::Content * pageContent;
             page::Navigation * pageNavigation;
 
+        /*
+         * Class API
+         */
         public:
 
             Page(