Added comments

diff --git a/src/facebookservice/facebookauthentication.h b/src/facebookservice/facebookauthentication.h
index 8648ee5..2ccf229 100644 (file)
--- a/src/facebookservice/facebookauthentication.h
+++ b/src/facebookservice/facebookauthentication.h
@@ -131,6 +131,11 @@ signals:
     */
     void loginFailure();
 
+    /**
+    * @brief This signal is emitted always when login is called. At first  the application tries
+    *        to login using saved cookies
+    *
+    */
     void loginUsingCookies();
 
     /**
@@ -140,6 +145,10 @@ signals:
     */
     void newLoginRequest(const QUrl &url);
 
+    /**
+    * @brief This signal is emitted when new cookies need to be saved.
+    *
+    */
     void saveCookiesRequest();
 
 /*******************************************************************************

diff --git a/src/ui/mainwindow.cpp b/src/ui/mainwindow.cpp
index b57c3ac..c0847e9 100644 (file)
--- a/src/ui/mainwindow.cpp
+++ b/src/ui/mainwindow.cpp
@@ -237,7 +237,6 @@ void MainWindow::buildWebView()
     qDebug() << __PRETTY_FUNCTION__;
 
     if(!m_webView) {
-        qDebug() << "create webview";
         m_webView = new QWebView;
 
         connectWebViewSignals(true);

diff --git a/src/ui/mainwindow.h b/src/ui/mainwindow.h
index a753d20..e63c02d 100644 (file)
--- a/src/ui/mainwindow.h
+++ b/src/ui/mainwindow.h
@@ -137,6 +137,10 @@ public slots:
     */
     void loginFailed();
 
+    /**
+    * @brief Slot to intercept signal when login with cookies is requested
+    *
+    */
     void loginUsingCookies();
 
     /**
@@ -179,6 +183,10 @@ private:
       */
     void buildFriendListPanel();
 
+    /**
+    * @brief Build login dialog and connect slots
+    *
+    */
     void buildLoginDialog();
 
     /**
@@ -201,6 +209,10 @@ private:
       */
     void buildUserInfoPanel();
 
+    /**
+    * @brief Build webview and connect slots
+    *
+    */
     void buildWebView();
 
     /**
@@ -208,8 +220,17 @@ private:
       */
     void buildZoomButtonPanel();
 
+    /**
+    * @brief Clears cookie jar
+    *
+    */
     void clearCookieJar();
 
+    /**
+    * @brief connect/disconnect webview signals
+    *
+    * @param connectSignals true = connect, false = disconnect
+    */
     void connectWebViewSignals(bool connectSignals);
 
     /**
@@ -261,6 +282,10 @@ private slots:
     */
     void gpsTimeout();
 
+    /**
+    * @brief Slot to load cookies from settings
+    *
+    */
     void loadCookies();
 
     /**
@@ -270,6 +295,10 @@ private slots:
     */
     void loadDone(bool done);
 
+    /**
+    * @brief Slot to save cookies to settings
+    *
+    */
     void saveCookies();
 
     /**
@@ -459,7 +488,7 @@ private:
     FriendListPanel *m_friendsListPanel;    ///< Instance of friends list panel
     LoginDialog *m_loginDialog;             ///< Login dialog
     MapView *m_mapView;                     ///< Instance of the map view
-    NetworkCookieJar *m_cookieJar;
+    NetworkCookieJar *m_cookieJar;          ///< Placeholder for QNetworkCookies
     PanelSideBar *m_userPanelSidebar;       ///< User panel side bar
     PanelSideBar *m_friendsListPanelSidebar;///< Friends panel side bar
     UserInfoPanel *m_userPanel;             ///< Instance of the user information panel