From 606cd1a223e49b75faa4b07a2cc71bbdcf488bb2 Mon Sep 17 00:00:00 2001
From: yggverse <yggverse@project>
Date: Wed, 11 Sep 2024 00:48:56 +0300
Subject: [PATCH] add comments

---
 src/app/browser/main/tab.hpp      | 19 +++++++++++++++----
 src/app/browser/main/tab/page.hpp | 19 +++++++++++++++----
 2 files changed, 30 insertions(+), 8 deletions(-)

diff --git a/src/app/browser/main/tab.hpp b/src/app/browser/main/tab.hpp
index 11dcdadc..297ded05 100644
--- a/src/app/browser/main/tab.hpp
+++ b/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(
diff --git a/src/app/browser/main/tab/page.hpp b/src/app/browser/main/tab/page.hpp
index b48889fc..9b6d2635 100644
--- a/src/app/browser/main/tab/page.hpp
+++ b/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(