Clean and order documentation in source files. Source ready to beta 2 release
authorMarcin Kaźmierczak <marcin@marcin-desktop.(none)>
Thu, 25 Nov 2010 15:03:59 +0000 (16:03 +0100)
committerMarcin Kaźmierczak <marcin@marcin-desktop.(none)>
Thu, 25 Nov 2010 15:03:59 +0000 (16:03 +0100)
93 files changed:
debian/changelog
src/desktopWidget/MainWidget.cpp
src/desktopWidget/MainWidget.h
src/desktopWidget/main.cpp
src/include/AccentsNormalizer.h
src/include/DictDialog.h
src/include/GUIInterface.h
src/include/History.h
src/include/Notify.h
src/mdictionary/backbone/Bookmarks.cpp
src/mdictionary/backbone/History.cpp
src/mdictionary/gui/AboutWidget.cpp
src/mdictionary/gui/AboutWidget.h
src/mdictionary/gui/BookmarksWidget.cpp
src/mdictionary/gui/BookmarksWidget.h
src/mdictionary/gui/DBusAdapter.cpp
src/mdictionary/gui/DBusAdapter.h
src/mdictionary/gui/DictManagerWidget.cpp
src/mdictionary/gui/DictManagerWidget.h
src/mdictionary/gui/DictTypeSelectDialog.cpp
src/mdictionary/gui/DictTypeSelectDialog.h
src/mdictionary/gui/HistoryListDialog.cpp
src/mdictionary/gui/HistoryListDialog.h
src/mdictionary/gui/MainWindow.cpp
src/mdictionary/gui/MainWindow.h
src/mdictionary/gui/MenuTabWidget.cpp
src/mdictionary/gui/MenuTabWidget.h
src/mdictionary/gui/MenuWidget.cpp
src/mdictionary/gui/MenuWidget.h
src/mdictionary/gui/NotifyManager.cpp
src/mdictionary/gui/NotifyManager.h
src/mdictionary/gui/SearchBarWidget.cpp
src/mdictionary/gui/SearchBarWidget.h
src/mdictionary/gui/SettingsWidget.cpp
src/mdictionary/gui/SettingsWidget.h
src/mdictionary/gui/SpinBox.cpp
src/mdictionary/gui/SpinBox.h
src/mdictionary/gui/TranslationView.cpp
src/mdictionary/gui/TranslationView.h
src/mdictionary/gui/TranslationWidget.cpp
src/mdictionary/gui/TranslationWidget.h
src/mdictionary/gui/WelcomeScreenWidget.cpp
src/mdictionary/gui/WelcomeScreenWidget.h
src/mdictionary/gui/WordListProxyStyle.cpp
src/mdictionary/gui/WordListProxyStyle.h
src/mdictionary/gui/WordListWidget.cpp
src/mdictionary/gui/WordListWidget.h
src/mdictionary/gui/main.cpp
src/plugins/google/GoogleDialog.cpp
src/plugins/google/GoogleDialog.h
src/plugins/google/GoogleDictDialog.cpp
src/plugins/google/GoogleDictDialog.h
src/plugins/google/GooglePlugin.cpp
src/plugins/google/GooglePlugin.h
src/plugins/google/TranslationGoogle.cpp
src/plugins/google/TranslationGoogle.h
src/plugins/stardict/CompressedReader.cpp
src/plugins/stardict/CompressedReader.h
src/plugins/stardict/StarDialog.cpp
src/plugins/stardict/StarDialog.h
src/plugins/stardict/StarDictDialog.cpp
src/plugins/stardict/StarDictDialog.h
src/plugins/stardict/StarDictPlugin.cpp
src/plugins/stardict/StarDictPlugin.h
src/plugins/stardict/StarDictReader.h
src/plugins/stardict/StarDictReaderFactory.cpp
src/plugins/stardict/StarDictReaderFactory.h
src/plugins/stardict/TranslationStarDict.cpp
src/plugins/stardict/TranslationStarDict.h
src/plugins/stardict/UncompressedReader.cpp
src/plugins/stardict/UncompressedReader.h
src/plugins/xdxf/DictsModel.cpp
src/plugins/xdxf/DictsModel.h
src/plugins/xdxf/DictsProxyModel.h
src/plugins/xdxf/DownloadDict.h
src/plugins/xdxf/HttpDownloader.cpp
src/plugins/xdxf/HttpDownloader.h
src/plugins/xdxf/TranslationXdxf.cpp
src/plugins/xdxf/TranslationXdxf.h
src/plugins/xdxf/XdxfCachingDialog.cpp
src/plugins/xdxf/XdxfCachingDialog.h
src/plugins/xdxf/XdxfDialog.cpp
src/plugins/xdxf/XdxfDialog.h
src/plugins/xdxf/XdxfDictDialog.cpp
src/plugins/xdxf/XdxfDictDialog.h
src/plugins/xdxf/XdxfDictDownloadProgressDialog.cpp
src/plugins/xdxf/XdxfDictDownloadProgressDialog.h
src/plugins/xdxf/XdxfDictDownloader.cpp
src/plugins/xdxf/XdxfDictDownloader.h
src/plugins/xdxf/XdxfDictSelectDialog.cpp
src/plugins/xdxf/XdxfDictSelectDialog.h
src/plugins/xdxf/xdxfplugin.cpp
src/plugins/xdxf/xdxfplugin.h

index 56fe512..e265eac 100644 (file)
@@ -1,3 +1,9 @@
+mdictionary (2.0.0beta2) stable; urgency=low
+  * beta 2 release
+  * added stardict plugin
+  * added feature of browse, download and add xdxf dictionaries from http://xdxf.revdanica.com/down/ direct in mdictionary
+  * fixed some bugs
+ -- Marcin Kaźmierczak <marcin.kazmierczak@comarch.pl>  Thu, 25 Nov 2010 15:49:20 +0100
 mdictionary (2.0.0beta) stable; urgency=low
   * beta release
   * mdictionary 2.0.0 beta is a qt version of mdictionary
index 64240c1..3f79481 100644 (file)
 
 *******************************************************************************/
 
-//Created by Mateusz Półrola
+/*! \file MainWidget.cpp
+    \brief Implements widget for maemo that allows user to search quickly right from home screen using mdictionary.
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "MainWidget.h"
 
index 7f4cc14..79f6ba5 100644 (file)
 
 *******************************************************************************/
 
-//! \file MainWidget.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file MainWidget.h
+    \brief Implements widget for maemo that allows user to search quickly right from home screen using mdictionary.
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef MAINWIDGET_H
 #define MAINWIDGET_H
@@ -30,7 +33,6 @@
 #include <QtDBus/QDBusConnection>
 #include <QPushButton>
 
-//! Implements widget for maemo that allows user to search quickly right from home screen using mdictionary.
 /*!
   Shows tool button with logo of mDictionary which can start application.
   In line edit user inputs word, and after using button next to it or pressing enter, widget runs mDictionary which immediately starts searching for a given word.
index cfe07d6..0196c61 100644 (file)
 
 *******************************************************************************/
 
-//Created by Mateusz Półrola
+/*! \file main.cpp
+    \brief Desktop widget's main file
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "MainWidget.h"
 #include <QtGui/QApplication>
index 9246901..8f09a75 100644 (file)
@@ -19,8 +19,9 @@
 
 *******************************************************************************/
 
-/*! /file AccentsNormalizer.h
+/*! \file AccentsNormalizer.h
 \brief Common functionality for all classes that need to remove accents from strings
+
 \author Bartosz Szatkowski <bulislaw@linux.com>
 */
 
index 206cf3c..f17e26f 100644 (file)
@@ -21,6 +21,7 @@
 
 /*! \file DictDialog.h
     \brief Interface for plugin dialog provider
+
     \author Mateusz Półrola <mateusz.polrola@comarch.com>
 */
 
index 47decc2..1b86f86 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file GUIInterface.h
-//! \brief Defines interface for GUI
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file GUIInterface.h
+    \brief Defines interface for GUI
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 
 
index 133b3ad..e28de73 100644 (file)
 
 *******************************************************************************/
 
-//Created by Mateusz Półrola
+/*! \file History.h
+    \brief Object with search history
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef HISTORY_H
 #define HISTORY_H
index a5266e9..3bc4f94 100644 (file)
@@ -19,7 +19,7 @@
 
 *******************************************************************************/
 
-/*! /file Notify.h
+/*! \file Notify.h
 \brief Declaration of common notify subsystem (NotifyType for now)
 
 \author Bartosz Szatkowski <bulislaw@linux.com>
index 645e9ad..5a5faf5 100644 (file)
@@ -1,3 +1,32 @@
+/*******************************************************************************
+
+    This file is part of mDictionary.
+
+    mDictionary is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    mDictionary is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with mDictionary.  If not, see <http://www.gnu.org/licenses/>.
+
+    Copyright 2010 Comarch S.A.
+
+*******************************************************************************/
+
+/*!
+    \file Bookmarks.cpp
+    \brief Bookmarks functionality - marking words as favorite, managing marked
+    words, searching in marked words (with cached translations)
+
+    \author Bartosz Szatkowski <bulislaw@linux.com>
+*/
+
 #include "Bookmarks.h"
 #include "BookmarkTranslations.h"
 #include <QThread>
index 154abfa..4188e73 100644 (file)
 
 *******************************************************************************/
 
-//Created by Mateusz Półrola
+/*! \file History.cpp
+    \brief Object with search history
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "../../include/History.h"
 #include <QDebug>
index f287932..72eb839 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file AboutWidget.cpp
-//! \brief Simple "about" widget - product, company, license info
-//! \author Bartosz Szatkowski <bulislaw@linux.com>
+/*! \file AboutWidget.cpp
+    \brief Simple "about" widget - product, company, license info
+
+    \author Bartosz Szatkowski <bulislaw@linux.com>
+*/
 
 #include "AboutWidget.h"
 
+
 AboutWidget::AboutWidget(GUIInterface *parent): QDialog(parent)
 {
     setModal(true);
index 972b3f7..02eb383 100644 (file)
 
 *******************************************************************************/
 
-//! \file AboutWidget.h
-//! \brief Simple "about" widget - product, company, license info
-//! \author Bartosz Szatkowski <bulislaw@linux.com>
+/*! \file AboutWidget.h
+    \brief Simple "about" widget - product, company, license info
+
+    \author Bartosz Szatkowski <bulislaw@linux.com>
+*/
 
 
 #ifndef ABOUTWIDGET_H
index 58ede20..3801620 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file BookmarksWidget.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file BookmarksWidget.cpp
+    \brief Implements bookmarks management widget. Allows user to show all
+           or remove all bookmarks
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "BookmarksWidget.h"
 
index c5188fa..03bff8a 100644 (file)
 
 *******************************************************************************/
 
-//! \file BookmarksWidget.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file BookmarksWidget.h
+    \brief Implements bookmarks management widget. Allows user to show all
+           or remove all bookmarks
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef BOOKMARKSWIDGET_H
 #define BOOKMARKSWIDGET_H
 #include <QtGui>
 #include "../../include/GUIInterface.h"
 
-//! Implements bookmarks management widget
-/*!
-  Allows user to show all or remove all bookmarks
-*/
 class BookmarksWidget : public QDialog
 {
     Q_OBJECT
index 198ba56..073437f 100644 (file)
 
 *******************************************************************************/
 
-//! \file DBusAdapter.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file DBusAdapter.cpp
+    \brief Implements dbus adapter which defines dbus interface for an application.
+    Other application can use this interface to call mdictionary methods.
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "DBusAdapter.h"
 #include <QDebug>
index 358c333..587f3e4 100644 (file)
 
 *******************************************************************************/
 
-//! \file DBusAdapter.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file DBusAdapter.h
+    \brief Implements dbus adapter which defines dbus interface for an application.
+    Other application can use this interface to call mdictionary methods.
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef DBUSADAPTER_H
 #define DBUSADAPTER_H
index 04aad2f..8519c93 100644 (file)
 
 *******************************************************************************/
 
-//! \file DictManagerWidget.cpp
-//! \brief Dictionaries management widget
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file DictManagerWidget.cpp
+    \brief Implements dictionaries management widget
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "DictManagerWidget.h"
 #include "DictTypeSelectDialog.h"
index ab7c9cc..3e7e4d7 100644 (file)
 
 *******************************************************************************/
 
-//! \file DictManagerWidget.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file DictManagerWidget.h
+    \brief Implements dictionaries management widget
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef DICTMANAGERWIDGET_H
 #define DICTMANAGERWIDGET_H
@@ -31,7 +34,6 @@
 #include "MenuWidget.h"
 
 
-//! Implements dictionaries management widget
 /*!
   Shows list of loaded dictionaries and their states (active/inactive).
   It allows to change dicts states, add a new dict, remove selected one or
index ae79df1..62c7f42 100644 (file)
 
 *******************************************************************************/
 
-//! \file DictTypeSelectDialog.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file DictTypeSelectDialog.cpp
+    \brief Implements plugin selection dialog
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "DictTypeSelectDialog.h"
 
index fdfea02..34b0847 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file DictTypeSelectDialog.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file DictTypeSelectDialog.h
+    \brief Implements plugin selection dialog
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef DICTTYPESELECTDIALOG_H
 #define DICTTYPESELECTDIALOG_H
@@ -32,7 +35,6 @@
 #define PLUGIN_ROW_ROLE 99      //TODO remove this
 
 
-//! Implements plugin selection dialog
 /*!
   Shows a list of loaded dictionaries plugins.
   Static function addNewdict will return selected plugin.
index 7e58372..0074181 100644 (file)
 
 *******************************************************************************/
 
-//! \file HistoryListDialog.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file HistoryListDialog.cpp
+    \brief Implements history list dialog
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "HistoryListDialog.h"
 
index 5d3c78c..a4de93a 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file HistoryListDialog.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file HistoryListDialog.h
+    \brief Implements history list dialog
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef HISTORYLISTDIALOG_H
 #define HISTORYLISTDIALOG_H
@@ -30,7 +33,6 @@
 #include <QtGui>
 
 
-//! Implements history list dialog
 /*!
   Shows a history list and allows user to select one word of it.
   On desktop it is shown as a popup.
index 51384d6..915cf2d 100644 (file)
 
 *******************************************************************************/
 
-//! \file MainWindow.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file MainWindow.cpp
+    \brief Implements interface for GUI
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "MainWindow.h"
 #include <QtGui>
index 06e24e1..c42482d 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file MainWindow.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file MainWindow.h
+    \brief Implements interface for GUI
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef MAINWINDOW_H
 #define MAINWINDOW_H
@@ -41,7 +44,6 @@
 #include "NotifyManager.h"
 
 
-//! Implements interface for GUI
 /*!
   Creates all of GUI subcomponents, and connects all GUI interface signals
   with suitable backbone signals and slots.
index d9be263..fedb7d0 100644 (file)
 
 *******************************************************************************/
 
-//! \file MenuTabWidget.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file MenuTabWidget.cpp
+    \brief Menu's main widget
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "MenuTabWidget.h"
 #include <QDebug>
index 464a2ec..cc54e95 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file MenuTabWidget.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file MenuTabWidget.h
+    \brief Menu's main widget
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef MENUTABWIDGET_H
 #define MENUTABWIDGET_H
index be3e2af..0464608 100644 (file)
 
 *******************************************************************************/
 
-//! \file MenuWidget.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file MenuWidget.cpp
+    \brief Displays custom menu with tab widget containing all submenus.
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "MenuWidget.h"
 #include <QDebug>
index aa31fc3..e78c384 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file MenuWidget.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file MenuWidget.h
+    \brief Displays custom menu with tab widget containing all submenus.
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef MENUWIDGET_H
 #define MENUWIDGET_H
index 6a780f8..bd6ded2 100644 (file)
 
 *******************************************************************************/
 
-//! \file NotifyManager.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file NotifyManager.cpp
+    \brief Manages notifications in applications
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "NotifyManager.h"
 #include <QMessageBox>
index edfb5a6..b42a2ea 100644 (file)
 
 *******************************************************************************/
 
-//! \file NotifyManager.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file NotifyManager.h
+    \brief Manages notifications in applications
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef NOTIFYMANAGER_H
 #define NOTIFYMANAGER_H
@@ -32,7 +35,6 @@
 #include "../../include/Notify.h"
 #include "MenuWidget.h"
 
-//! Manages notifications in applications
 /*!
     Shows notifications to user, assures that a couple of the same notifications
     will not be displayed at the same time. It automatically deletes
index 2300018..78b1f35 100644 (file)
 
 *******************************************************************************/
 
-//! \file SearchBarWidget.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file SearchBarWidget.cpp
+    \brief Displays search bar
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 
 #include "SearchBarWidget.h"
index af7c1b3..afef2f5 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file SearchBarWidget.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file SearchBarWidget.h
+    \brief Displays search bar
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 
 #ifndef SEARCHBARWIDGET_H
@@ -30,7 +33,6 @@
 #include "../backbone/backbone.h"
 #include "../../include/History.h"
 
-//! Displays search bar
 /*!
     Contains line edit field to input word which user would like to find
     and buttons to start/stop search and browse search history.
index 68bafaf..06226a9 100644 (file)
 
 *******************************************************************************/
 
-//! \file SettingsWidget.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file DictManagerWidget.cpp
+    \brief Implements applications settings widget
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "SettingsWidget.h"
 #include <QDebug>
index b8d8bd3..f6ada01 100644 (file)
 
 *******************************************************************************/
 
-//! \file DictManagerWidget.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file DictManagerWidget.h
+    \brief Implements applications settings widget
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef SETTINGSWIDGET_H
 #define SETTINGSWIDGET_H
@@ -32,7 +34,6 @@
 #include "../../include/settings.h"
 #include "SpinBox.h"
 
-//! Implements applications settings widget
 /*!
   Shows settings that user can change.
   It allows to change limit of searches and limit of history.
index 5f21c1a..91403c4 100644 (file)
 
 *******************************************************************************/
 
-//Created by Mateusz Półrola
+/*! \file SpinBox.cpp
+    \brief Spin box
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "SpinBox.h"
 
index 7b4f3ed..531ef59 100644 (file)
 
 *******************************************************************************/
 
-//Created by Mateusz Półrola
+/*! \file SpinBox.h
+    \brief Spin box
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef SPINBOX_H
 #define SPINBOX_H
index 79a6c14..7e9cd8c 100644 (file)
 
 *******************************************************************************/
 
-//! \file TranslationView.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file TranslationView.cpp
+    \brief Web view with translations
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include <QtGui>
 #include "TranslationView.h"
index 1ea9d12..c3768dc 100644 (file)
 
 *******************************************************************************/
 
-//! \file TranslationView.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file TranslationView.h
+    \brief Web view with translations
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef TRANSLATIONVIEW_H
 #define TRANSLATIONVIEW_H
index ca4356f..5cc4762 100644 (file)
 
 *******************************************************************************/
 
-//! \file TranslationWidget.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file TranslationWidget.cpp
+    \brief Displays translation of a word found in dictionaries
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "TranslationWidget.h"
 #include <QDebug>
index b0e4f7c..cb4f13b 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file TranslationWidget.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file TranslationWidget.h
+    \brief Displays translation of a word found in dictionaries
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef TRANSLATIONWIDGET_H
 #define TRANSLATIONWIDGET_H
@@ -34,7 +37,6 @@
 #include <QPropertyAnimation>
 #include "../../include/GUIInterface.h"
 
-//! Displays translation of a word found in dictionaries
 /*!
     Displays many translations of word, formatted as xml.
 */
index ee4d286..43efb09 100644 (file)
 
 *******************************************************************************/
 
-//! \file WelcomeScreenWidget.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file WelcomeScreenWidget.cpp
+    \brief Implements widget that displays welcome screen to user
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "WelcomeScreenWidget.h"
 
index a8d1ff6..449570c 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file WelcomeScreenWidget.h
-//! \brief Implements widget that displays welcome screen to user
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file WelcomeScreenWidget.h
+    \brief Implements widget that displays welcome screen to user
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef WELCOMESCREENWIDGET_H
 #define WELCOMESCREENWIDGET_H
index af9d65a..f1e1391 100644 (file)
 
 *******************************************************************************/
 
-//! \file WordListProxyStyle.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file WordListProxyStyle.cpp
+    \brief Custom proxy style that draws checkboxes as stars.
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "WordListProxyStyle.h"
 
index 7965a96..46ca7bf 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file WordListProxyStyle.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file WordListProxyStyle.h
+    \brief Custom proxy style that draws checkboxes as stars.
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef WORDLISTPROXYSTYLE_H
 #define WORDLISTPROXYSTYLE_H
 #include <QProxyStyle>
 #include <QtGui>
 
-//! Custom proxy style that draws checkboxes as stars.
-//! It will automatically wrap set style and change only
-//! checkboxes drawing.
+/*! Custom proxy style that draws checkboxes as stars.
+    It will automatically wrap set style and change only
+    checkboxes drawing.
+*/
 class WordListProxyStyle : public QProxyStyle
 {
 public:
index 5d278dd..d568fb7 100644 (file)
 
 *******************************************************************************/
 
-//! \file WordListWidget.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file WordListwidget.cpp
+    \brief Displays list of words found in dictionaries
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include "WordListWidget.h"
 #include "WordListProxyStyle.h"
index 8a0b17c..9f7c3a2 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-//! \file WordListwidget.h
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file WordListwidget.h
+    \brief Displays list of words found in dictionaries
+
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #ifndef WORDLISTWIDGET_H
 #define WORDLISTWIDGET_H
@@ -29,7 +32,6 @@
 #include "../backbone/backbone.h"
 #include "WordListProxyStyle.h"
 
-//! Displays list of words found in dictionaries
 /*!
     It allows user to select word to see its translation or to mark or unmark
     it as "star" (add/remove from bookmarks). It inherits from QTreeView
index ab77e42..5196f8a 100644 (file)
 
 *******************************************************************************/
 
-//! \file main.cpp
-//! \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+/*! \file main.cpp
+    \brief mDictionary's main file
+    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
+*/
 
 #include <QtGui/QApplication>
 #include "MainWindow.h"
index 45bf724..657640a 100644 (file)
@@ -19,7 +19,9 @@
 
 *******************************************************************************/
 /*!
-    \file GoogleSettingsDialog.cpp
+    \file GoogleDialog.cpp
+    \brief Implementation of google plugin's dialogs.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index e935583..dfb798d 100644 (file)
@@ -19,7 +19,9 @@
 
 *******************************************************************************/
 /*!
-    \file GoogleDialog.cpp
+    \file GoogleDialog.h
+    \brief Implementation of google plugin's dialogs.
+
     \author Mateusz Półrola <mateusz.polrola@gmail.com>
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
@@ -32,7 +34,6 @@
 #include <QtGui>
 #include "GooglePlugin.h"
 
-//! Implementation of google plugin's dialogs.
 /*!
     This class can create dialogs for adding a new dictionary or changing settings
      of an existing one, based on dialog type passed to constructor.
index 6c7c0c3..63465d9 100644 (file)
     Copyright 2010 Comarch S.A.
 
 *******************************************************************************/
-/*!
-    \file GoogleDictDialog.cpp
+/*! \file GoogleDictDialog.cpp
+    \brief Class launches dialog which generates a new dictionary, or changes
+    settings
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index d3aa406..5c0baf0 100644 (file)
@@ -21,6 +21,7 @@
 /*! \file GoogleDictDialog.h
     \brief Class launches dialog which generates a new dictionary, or changes
     settings
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index ee25c53..be60c32 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file GooglePlugin.cpp
+    \brief Implementation of google plugin's main class.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index cfc2ebf..2808195 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file GooglePlugin.h
+    \brief Implementation of google plugin's main class.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index fa6e35d..f290018 100644 (file)
 
 *******************************************************************************/
 
-/*! \file TranslationGoogle.cpp
+/*!
+    \file TranslationGoogle.cpp
+    \brief Implementation of google plugin's translation.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index 187262a..d3b70bb 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file TranslationGoogle.h
+    \brief Implementation of google plugin's translation.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index a8db470..4943056 100644 (file)
@@ -20,6 +20,9 @@
 *******************************************************************************/
 /*!
     \file CompressedReader.cpp
+    \brief Class implementing StarDictReader interface and handling reading from compressed
+    files like .gz or .dz
+
     \author Mateusz Półrola
 */
 
index 0b0c68e..fc99384 100644 (file)
 
 *******************************************************************************/
 /*!
-    \file CompressedReader.cpp
+    \file CompressedReader.h
+    \brief Class implementing StarDictReader interface and handling reading from compressed
+    files like .gz or .dz
+
     \author Mateusz Półrola
 */
 
@@ -33,7 +36,7 @@
 #include "StarDictReader.h"
 
 /*!
-    Class implementing StarDictReader interface and handling rading from compressed
+    Class implementing StarDictReader interface and handling reading from compressed
     files like .gz or .dz, using zlib
 */
 class CompressedReader : public StarDictReader
index 79018fd..9936646 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file StarDialog.cpp
+    \brief Implementation of stardict plugin's dialogs.
+
     \author Mateusz Półrola <mateusz.polrola@gmail.com>
 */
 
index aef9986..3153491 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file StarDialog.h
+    \brief Implementation of stardict plugin's dialogs.
+
     \author Mateusz Półrola <mateusz.polrola@gmail.com>
 */
 
@@ -32,7 +34,6 @@
 #include "StarDictPlugin.h"
 
 
-//! Implementation of stardict plugin's dialogs.
 /*!
     This class can create dialogs for adding a new dictionary or changing settings
     of an existing one, based on dialog type passed to contructor.
index 9e16f61..fba7ed9 100644 (file)
@@ -20,6 +20,9 @@
 *******************************************************************************/
 /*!
     \file StarDictDialog.cpp
+    \brief Class launches dialog which generates a new dictionary, or changes
+    settings
+
     \author Mateusz Półrola
 */
 
index 2f0ab7f..5344243 100644 (file)
@@ -20,6 +20,9 @@
 *******************************************************************************/
 /*!
     \file StarDictDialog.h
+    \brief Class launches dialog which generates a new dictionary, or changes
+    settings
+
     \author Mateusz Półrola
 */
 
@@ -31,7 +34,6 @@
 class StarDictPlugin;
 
 
-//! Implementation of DictDialog interface for starDict plugin
 class StarDictDialog : public DictDialog {
     Q_OBJECT
 public:
index 4c78fe3..67e2db3 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
      \file StarDictPlugin.cpp
+     \brief Implementation of stardict plugin's main class.
+
      \author Jakub Jaszczynski
 */
 
index 6fd5d03..5937b3a 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
      \file StarDictPlugin.h
+     \brief Implementation of stardict plugin's main class.
+
      \author Jakub Jaszczynski
 */
 
index cb267a4..f21f5c6 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file StarDictReader.h
+    \brief Abstract class used for reading stardict dict and idx files.
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
  */
 
index 4e3d5ed..afb56c3 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file StarDictReaderFactory.cpp
+    \brief Class used to creating StarDictReader objects, based on filename it creates
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
  */
 
index f052c59..81d69da 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file StarDictReaderFactory.h
+    \brief Class used to creating StarDictReader objects, based on filename it creates
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
  */
 
index 0867e2c..828c277 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file TranslationStarDict.cpp
+    \brief Implementation of stardict plugin's translation.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index 95309ff..5e4329b 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file TranslationStarDict.h
+    \brief Implementation of stardict plugin's translation.
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
  */
 
index 6c79b9b..6b75e90 100644 (file)
@@ -20,6 +20,9 @@
 *******************************************************************************/
 /*!
     \file UncompressedReader.cpp
+    \brief Class implementing StarDictReader interface and handling
+  reading from uncompressed files
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
  */
 
index d247cdb..e28241e 100644 (file)
@@ -20,6 +20,9 @@
 *******************************************************************************/
 /*!
     \file UncompressedReader.h
+    \brief Class implementing StarDictReader interface and handling
+  reading from uncompressed files
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
  */
 
@@ -35,7 +38,7 @@
 
 /*!
   Class implementing StarDictReader interface and handling
-  rading from uncompressed files
+  reading from uncompressed files
 */
 class UncompressedReader : public StarDictReader
 {
index 4841a83..0b08e63 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file DictsModel.cpp
+    \brief Item model for informations about xdxf dictionaries.
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
 */
 
index 93757c0..241b042 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
    \file DictsModel.h
+   \brief Item model for informations about xdxf dictionaries.
+
    \author Mateusz Półrola <mateusz.polrola@comarch.pl>
 */
 
index 06a35c8..11fe398 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file DictsProxyModel.h
+    \brief roxy model used for filtering and sorting informations about xdxf dictionaries.
+
     \author Mateusz Półrola <mateusz.polrola@gmail.com>
 */
 
index 172d71b..bf50c17 100644 (file)
@@ -22,6 +22,7 @@
 /*!
     \file DownloadDict.h
     \brief Represenation of dictionary html entry on XDXF webpage
+
     \author Bartosz Szatkowski <bulislaw@linux.com>
 */
 
index 753124f..3e23c96 100644 (file)
@@ -19,7 +19,9 @@
 
 *******************************************************************************/
 /*!
-    \file HttpDownloader.h
+    \file HttpDownloader.cpp
+    \brief Downloader for xdxf dictionaries
+
     \author Bartosz Szatkowski <bulislaw@linux.com>
  */
 
index ac52acf..1e0cf49 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file HttpDownloader.h
+    \brief Downloader for xdxf dictionaries
+
     \author Bartosz Szatkowski <bulislaw@linux.com>
  */
 
index 584114f..e6974c6 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file TranslationXdxf.cpp
+    \brief Implementation of xdxf plugin's translation.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index 3bb6d0b..beae3e4 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file TranslationXdxf.h
+    \brief Implementation of xdxf plugin's translation.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 #ifndef TRANSLATIONXDXF_H
index a0db9a3..bc73a32 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file XdxfCachingDialog.cpp
+    \brief Shows dialog with progress of dictionary caching
+
     \author Mateusz Półrola
 */
 
index b519291..61b9d36 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file XdxfCachingDialog.h
+    \brief Shows dialog with progress of dictionary caching
+
     \author Mateusz Półrola <mateusz.polrola@gmail.com>
 */
 
@@ -33,7 +35,6 @@
 
 class XdxfPlugin;
 
-//! Shows dialog with progress of dictionary caching
 /*!
     Displays progress bar and estimated time left of caching
 */
index 070a0bf..c0d8bac 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file XdxfDialog.cpp
+    \brief Implementation of xdxf plugin's dialogs.
+
     \author Mateusz Półrola <mateusz.polrola@gmail.com>
 */
 
index aa63a1e..8e031f6 100644 (file)
@@ -21,6 +21,8 @@
 
 /*!
     \file XdxfDialog.h
+    \brief Implementation of xdxf plugin's dialogs.
+
     \author Mateusz Półrola <mateusz.polrola@gmail.com>
 */
 
@@ -33,7 +35,6 @@
 #include "xdxfplugin.h"
 
 
-//! Implementation of xdxf plugin's dialogs.
 /*!
     This class can create dialogs for adding a new dictionary or changing settings
      of an existing one, based on dialog type passed to contructor.
index 6557d85..919e72f 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file XdxfDictDialog.cpp
+    \brief Implementation of DictDialog interface for xdxf plugin
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
 */
 
index 6719d9e..22e5228 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file XdxfDictDialog.h
+    \brief Implementation of DictDialog interface for xdxf plugin
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
 */
 
@@ -30,7 +32,6 @@
 
 class XdxfPlugin;
 
-//! Implementation of DictDialog interface for xdxf plugin
 class XdxfDictDialog : public DictDialog {
     Q_OBJECT
 public:
index c969f03..8f89199 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file XdxfDictDownloadProgressDialog.cpp
+    \brief Shows downloading progress bar.
+
     \author Mateusz Półrola <mateusz.polrola@comarch.com>
 */
 
index 9e715d3..2a1efc3 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file XdxfDictDownloadProgressDialog.h
+    \brief Shows downloading progress bar.
+
     \author Mateusz Półrola <mateusz.polrola@comarch.com>
 */
 
index f212d71..60f01bf 100644 (file)
@@ -20,6 +20,9 @@
 *******************************************************************************/
 /*!
     \file XdxfDictDownloader.cpp
+    \brief XdxfDictDownloader is responsible for getting dict list from XDXF website
+    and other actions necessary to download and add dictionary
+
     \author Mateusz Półrola <mateusz.polrola@comarch.com>
 */
 
index 7b12e80..ebd048d 100644 (file)
@@ -20,6 +20,9 @@
 *******************************************************************************/
 /*!
     \file XdxfDictDownloader.h
+    \brief XdxfDictDownloader is responsible for getting dict list from XDXF website
+    and other actions necessary to download and add dictionary
+
     \author Mateusz Półrola <mateusz.polrola@comarch.pl>
 */
 
index 4b4a066..fdb7cdd 100644 (file)
@@ -20,6 +20,9 @@
 *******************************************************************************/
 /*!
     \file XdxfDictSelectDialog.cpp
+    \brief Shows dialog with list of dictionaries allowing user
+  to select one of them.
+
     \author Mateusz Półrola <mateusz.polrola@comarch.com>
 */
 
index 9f19eda..7ac546d 100644 (file)
@@ -20,6 +20,9 @@
 *******************************************************************************/
 /*!
     \file XdxfDictSelectDialog.h
+    \brief Shows dialog with list of dictionaries allowing user
+  to select one of them.
+
     \author Mateusz Półrola <mateusz.polrola@comarch.com>
  */
 
index e0ca9de..17e8eca 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file xdxfplugin.cpp
+    \brief Implementation of xdxf plugin's main class.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */
 
index 03babce..858fd49 100644 (file)
@@ -20,6 +20,8 @@
 *******************************************************************************/
 /*!
     \file xdxfplugin.h
+    \brief Implementation of xdxf plugin's main class.
+
     \author Jakub Jaszczynski <j.j.jaszczynski@gmail.com>
 */