From 51941ca7ccaa6675edba570b75f7ba6bddf3eac4 Mon Sep 17 00:00:00 2001 From: Emmanuel Lepage <emmanuel.lepage@savoirfairelinux.com> Date: Thu, 14 Jun 2012 16:16:35 -0400 Subject: [PATCH] [ #12352 ] Fix doxygen (1/3) --- kde/src/AccountListModel.h | 2 +- kde/src/AccountView.h | 2 +- kde/src/ActionSetAccountFirst.h | 2 +- kde/src/CallView.cpp | 2 +- kde/src/CallView.h | 4 ++-- kde/src/Codec.h | 2 +- kde/src/SFLPhoneAccessibility.cpp | 8 +++++++- kde/src/SFLPhoneAccessibility.h | 1 + kde/src/SFLPhoneView.cpp | 18 +----------------- kde/src/SFLPhoneView.h | 8 -------- kde/src/SFLPhoneapplication.h | 2 +- kde/src/conf/ConfigAccountList.h | 2 +- kde/src/conf/dlgaccessibility.h | 2 +- kde/src/conf/dlgaccounts.h | 4 ++-- kde/src/conf/dlgvideo.h | 2 +- kde/src/klib/AkonadiBackend.cpp | 2 +- kde/src/klib/AkonadiBackend.h | 2 +- kde/src/klib/HelperFunctions.h | 2 +- kde/src/klib/SortableDockCommon.h | 4 ++-- kde/src/klib/dataengine/sflphonEngine.h | 1 + kde/src/klib/dataengine/sflphoneService.h | 14 +++++++------- kde/src/lib/Account.h | 2 +- kde/src/lib/AccountList.cpp | 4 ++-- kde/src/lib/AccountList.h | 2 +- kde/src/lib/CallModel.h | 4 ++-- kde/src/lib/Contact.h | 2 +- kde/src/lib/ContactBackend.h | 2 +- kde/src/lib/HistoryModel.cpp | 1 + kde/src/lib/HistoryModel.h | 2 +- kde/src/lib/VideoCodec.h | 2 +- kde/src/lib/VideoDevice.h | 2 +- kde/src/lib/VideoModel.h | 2 +- kde/src/widgets/AccountItemWidget.h | 2 +- kde/src/widgets/BookmarkDock.cpp | 2 +- kde/src/widgets/BookmarkDock.h | 2 +- kde/src/widgets/CallTreeItem.h | 2 +- kde/src/widgets/CategorizedTreeWidget.h | 1 + kde/src/widgets/CategoryDrawer.h | 1 + kde/src/widgets/ContactDock.cpp | 2 +- kde/src/widgets/ContactDock.h | 6 +++--- kde/src/widgets/ContactItemWidget.h | 2 +- kde/src/widgets/Dialpad.h | 4 ++-- kde/src/widgets/HistoryDock.cpp | 2 +- kde/src/widgets/HistoryDock.h | 6 +++--- kde/src/widgets/HistoryTreeItem.cpp | 1 + kde/src/widgets/HistoryTreeItem.h | 2 +- kde/src/widgets/SFLPhoneTray.h | 2 +- kde/src/widgets/TranslucentButtons.h | 2 +- kde/src/widgets/VideoWidget.h | 1 + 49 files changed, 70 insertions(+), 81 deletions(-) diff --git a/kde/src/AccountListModel.h b/kde/src/AccountListModel.h index 7d5546362f..08e9d4117a 100755 --- a/kde/src/AccountListModel.h +++ b/kde/src/AccountListModel.h @@ -26,7 +26,7 @@ //SFLPhone class ConfigAccountList; -///@class AccountListModel Model for the account list widget +/// AccountListModel Model for the account list widget class AccountListModel : public QAbstractListModel { Q_OBJECT diff --git a/kde/src/AccountView.h b/kde/src/AccountView.h index 5f29748cef..c7e562e25d 100644 --- a/kde/src/AccountView.h +++ b/kde/src/AccountView.h @@ -30,7 +30,7 @@ class QListWidgetItem; //SFLPhone class AccountItemWidget; -///@class AccountView List widgets displaying accounts +///AccountView: List widgets displaying accounts class AccountView : public Account, public Item<AccountItemWidget> { public: //Constructor diff --git a/kde/src/ActionSetAccountFirst.h b/kde/src/ActionSetAccountFirst.h index 07e044c02c..f3e1f6c02c 100755 --- a/kde/src/ActionSetAccountFirst.h +++ b/kde/src/ActionSetAccountFirst.h @@ -26,7 +26,7 @@ #include "lib/Account.h" -///@class ActionSetAccountFirst Set an account to be the first +///ActionSetAccountFirst Set an account to be the first class ActionSetAccountFirst : public QAction { Q_OBJECT diff --git a/kde/src/CallView.cpp b/kde/src/CallView.cpp index ec0e988822..d43e6792ad 100644 --- a/kde/src/CallView.cpp +++ b/kde/src/CallView.cpp @@ -48,7 +48,7 @@ #include "klib/ConfigurationSkeleton.h" #include "SFLPhoneAccessibility.h" -///@class CallTreeItemDelegate Delegates for CallTreeItem +///CallTreeItemDelegate: Delegates for CallTreeItem class CallTreeItemDelegate : public QStyledItemDelegate { public: diff --git a/kde/src/CallView.h b/kde/src/CallView.h index 6da609f112..ebde9c1973 100644 --- a/kde/src/CallView.h +++ b/kde/src/CallView.h @@ -40,7 +40,7 @@ class CallTreeItemDelegate; //Typedef typedef CallModel<CallTreeItem*,QTreeWidgetItem*> TreeWidgetCallModel; -///@class CallViewOverlay Display overlay on top of the call tree +///CallViewOverlay: Display overlay on top of the call tree class CallViewOverlay : public QWidget { Q_OBJECT @@ -70,7 +70,7 @@ private slots: void changeVisibility(); }; -///@class CallView Central tree widget managing active calls +///CallView: Central tree widget managing active calls class CallView : public QTreeWidget { Q_OBJECT friend class CallTreeItemDelegate; diff --git a/kde/src/Codec.h b/kde/src/Codec.h index d577f63914..ef1bf2b54e 100755 --- a/kde/src/Codec.h +++ b/kde/src/Codec.h @@ -26,7 +26,7 @@ //Qt class QString; -///@class Codec A SIP codec +///Codec: A SIP codec class Codec : public QObject { Q_OBJECT diff --git a/kde/src/SFLPhoneAccessibility.cpp b/kde/src/SFLPhoneAccessibility.cpp index 033ff986b0..ce81b89c4d 100644 --- a/kde/src/SFLPhoneAccessibility.cpp +++ b/kde/src/SFLPhoneAccessibility.cpp @@ -24,8 +24,9 @@ #include <KLocale> #include "SFLPhone.h" -SFLPhoneAccessibility* SFLPhoneAccessibility::m_pInstance=0; +SFLPhoneAccessibility* SFLPhoneAccessibility::m_pInstance=nullptr; +///Constructor SFLPhoneAccessibility::SFLPhoneAccessibility() : QObject(0),QList<KAction*>() { KAction* action = new KAction(0); @@ -45,6 +46,7 @@ SFLPhoneAccessibility::SFLPhoneAccessibility() : QObject(0),QList<KAction*>() connect(action,SIGNAL(triggered(bool)),this,SLOT(currentCallDetails())); } +///Signleton SFLPhoneAccessibility* SFLPhoneAccessibility::getInstance() { if (not m_pInstance) { @@ -53,6 +55,7 @@ SFLPhoneAccessibility* SFLPhoneAccessibility::getInstance() return m_pInstance; } +///Use the speech daemon to read details about the current calls void SFLPhoneAccessibility::listCall() { if (SFLPhone::model()->getCallList().size()>0) { @@ -66,6 +69,7 @@ void SFLPhoneAccessibility::listCall() } } +///Convert number to digit so the speech daemon say "one two three" instead of "one hundred and twenty three" QString SFLPhoneAccessibility::numberToDigit(QString number) { QString toReturn; @@ -78,6 +82,7 @@ QString SFLPhoneAccessibility::numberToDigit(QString number) return toReturn; } +///Use the speech daemon to read the current call details void SFLPhoneAccessibility::currentCallDetails() { foreach (Call* call,SFLPhone::model()->getCallList()) { @@ -99,6 +104,7 @@ void SFLPhoneAccessibility::currentCallDetails() } } +///Helper function is make code shorter void SFLPhoneAccessibility::say(QString message) { KSpeechInterfaceSingleton::getInstance()->say(message, KSpeech::soPlainText); diff --git a/kde/src/SFLPhoneAccessibility.h b/kde/src/SFLPhoneAccessibility.h index c9442dbaef..411bde9a7d 100644 --- a/kde/src/SFLPhoneAccessibility.h +++ b/kde/src/SFLPhoneAccessibility.h @@ -23,6 +23,7 @@ #include <QtCore/QList> #include <KAction> +///SFLPhoneAccessibility: Functions to improve accessibility for disabled peoples class SFLPhoneAccessibility : public QObject, public QList<KAction*> { Q_OBJECT diff --git a/kde/src/SFLPhoneView.cpp b/kde/src/SFLPhoneView.cpp index a826334eb2..964497ce38 100755 --- a/kde/src/SFLPhoneView.cpp +++ b/kde/src/SFLPhoneView.cpp @@ -686,22 +686,6 @@ void SFLPhoneView::contextMenuEvent(QContextMenuEvent *event) menu.exec(event->globalPos()); } -/// -void SFLPhoneView::editBeforeCall() -{ - QString name; - QString number; - - bool ok; - QString newNumber = QInputDialog::getText(this, i18n("Edit before call"), QString(), QLineEdit::Normal, number, &ok); - if(ok) { - Call* call = SFLPhone::model()->addDialingCall(name); - call->appendText(newNumber); - //callView->selectItem(addCallToCallList(call)); - action(call, CALL_ACTION_ACCEPT); - } -} - ///Pick the default account and load it void SFLPhoneView::setAccountFirst(Account * account) { @@ -729,7 +713,7 @@ void SFLPhoneView::configureSflPhone() configDialog->show(); } -///Show the accoutn creation wizard +///Show the account creation wizard void SFLPhoneView::accountCreationWizard() { if (!wizard) { diff --git a/kde/src/SFLPhoneView.h b/kde/src/SFLPhoneView.h index e611fa2552..82ba5cfa52 100755 --- a/kde/src/SFLPhoneView.h +++ b/kde/src/SFLPhoneView.h @@ -142,14 +142,6 @@ private slots: */ void enter(); - /** - * Displays a message window with editable text of the selected - * phone number in history or address book. - * Once the user accepts, place a call with the chosen phone number. - * Keeps the peer name of the contact or past call. - */ - void editBeforeCall(); - /** * Updates the history's search bar's display according to the current * text searched. diff --git a/kde/src/SFLPhoneapplication.h b/kde/src/SFLPhoneapplication.h index 129a3b8e5e..b7bd24697c 100755 --- a/kde/src/SFLPhoneapplication.h +++ b/kde/src/SFLPhoneapplication.h @@ -28,7 +28,7 @@ //SFLPhone class SFLPhone; -///@class SFLPhoneApplication Main application +///SFLPhoneApplication: Main application class SFLPhoneApplication : public KApplication { Q_OBJECT diff --git a/kde/src/conf/ConfigAccountList.h b/kde/src/conf/ConfigAccountList.h index d1ac987410..74a832329a 100644 --- a/kde/src/conf/ConfigAccountList.h +++ b/kde/src/conf/ConfigAccountList.h @@ -24,7 +24,7 @@ #include "../lib/AccountList.h" #include "../AccountView.h" -///@class ConfigAccountList Account list model +///ConfigAccountList: Account list model class ConfigAccountList : public QObject { Q_OBJECT public: diff --git a/kde/src/conf/dlgaccessibility.h b/kde/src/conf/dlgaccessibility.h index 8d3c3ea318..0b4810d3f3 100644 --- a/kde/src/conf/dlgaccessibility.h +++ b/kde/src/conf/dlgaccessibility.h @@ -24,7 +24,7 @@ #include "ui_dlgaccessibility.h" -///@class DlgAccessibility Display option for the visually impaired +///DlgAccessibility: Display option for the visually impaired class DlgAccessibility : public QWidget, public Ui_DlgAccessibility { Q_OBJECT diff --git a/kde/src/conf/dlgaccounts.h b/kde/src/conf/dlgaccounts.h index 4aa58039d0..574e6d451c 100755 --- a/kde/src/conf/dlgaccounts.h +++ b/kde/src/conf/dlgaccounts.h @@ -47,7 +47,7 @@ typedef QHash<QString, QString> StringHash; //Needed to typedef QHash<QListWidgetItem*, CredentialData> QListWidgetItemHash; //Needed to fix a Qt foreach macro argument parsing bug typedef QList<CredentialData> CredentialList; -///@class Private_AddCodecDialog Little dialog to add codec to the list +///Private_AddCodecDialog: Little dialog to add codec to the list class Private_AddCodecDialog : public KDialog { Q_OBJECT public: @@ -63,7 +63,7 @@ class Private_AddCodecDialog : public KDialog { void addCodec(QString alias); }; -///@class RingToneListItem Ringtone list widget +///RingToneListItem: Ringtone list widget class RingToneListItem : public QWidget { Q_OBJECT diff --git a/kde/src/conf/dlgvideo.h b/kde/src/conf/dlgvideo.h index df463d62cb..8a30dc1372 100644 --- a/kde/src/conf/dlgvideo.h +++ b/kde/src/conf/dlgvideo.h @@ -26,7 +26,7 @@ class VideoDevice; -///@class DlgVideo video preferences for sflphone +///DlgVideo: video preferences for sflphone class DlgVideo : public QWidget, public Ui_DlgVideoBase { Q_OBJECT diff --git a/kde/src/klib/AkonadiBackend.cpp b/kde/src/klib/AkonadiBackend.cpp index 32d6e4f159..5014f3907b 100644 --- a/kde/src/klib/AkonadiBackend.cpp +++ b/kde/src/klib/AkonadiBackend.cpp @@ -96,7 +96,7 @@ ContactBackend* AkonadiBackend::getInstance() return m_pInstance; } -///Find contact using a phone number, +///Find contact using a phone number ///@param resolveDNS check if the DNS is used by an account, then assume contact with that phone number / extension is the same as the caller Contact* AkonadiBackend::getContactByPhone(const QString& phoneNumber,bool resolveDNS) { diff --git a/kde/src/klib/AkonadiBackend.h b/kde/src/klib/AkonadiBackend.h index b6ca9cf4ba..1ddebe16ec 100644 --- a/kde/src/klib/AkonadiBackend.h +++ b/kde/src/klib/AkonadiBackend.h @@ -44,7 +44,7 @@ namespace Akonadi { //SFLPhone class Contact; -///@class AkonadiBackend Implement a backend for Akonadi +///AkonadiBackend: Implement a backend for Akonadi class LIB_EXPORT AkonadiBackend : public ContactBackend { Q_OBJECT public: diff --git a/kde/src/klib/HelperFunctions.h b/kde/src/klib/HelperFunctions.h index 9eeef93c7c..8f6f99f081 100644 --- a/kde/src/klib/HelperFunctions.h +++ b/kde/src/klib/HelperFunctions.h @@ -33,7 +33,7 @@ //Typedef typedef QHash<QString,QHash<QString,QVariant> > ContactHash; -///@class HelperFunctions little visitor not belonging to libqtsflphone +///HelperFunctions: little visitor not belonging to libqtsflphone ///Ramdom mix of dynamic property and transtypping class LIB_EXPORT HelperFunctions { public: diff --git a/kde/src/klib/SortableDockCommon.h b/kde/src/klib/SortableDockCommon.h index 32e2e75bf7..a86af26ec7 100644 --- a/kde/src/klib/SortableDockCommon.h +++ b/kde/src/klib/SortableDockCommon.h @@ -56,7 +56,7 @@ enum HistorySortingMode { Length = 3, }; -///@class SortableDockCommon Common code for filtering +///SortableDockCommon: Common code for filtering template <typename CallWidget = QWidget*, typename Index = QModelIndex*> class LIB_EXPORT SortableDockCommon { public: @@ -111,7 +111,7 @@ class LIB_EXPORT SortableDockCommon { }; -///@class StaticEventHandler "cron jobs" for static member; +///StaticEventHandler: "cron jobs" for static member; class LIB_EXPORT StaticEventHandler : public QObject { Q_OBJECT diff --git a/kde/src/klib/dataengine/sflphonEngine.h b/kde/src/klib/dataengine/sflphonEngine.h index bf510b6c6d..e13f42f696 100644 --- a/kde/src/klib/dataengine/sflphonEngine.h +++ b/kde/src/klib/dataengine/sflphonEngine.h @@ -41,6 +41,7 @@ typedef QHash<QString,QVariant> HashStringString; typedef QHash<QString,QHash<QString,QVariant> > ContactHash ; class Call; +///SFLPhoneEngine: SFLPhone KDE plasma dataengine class SFLPhoneEngine : public Plasma::DataEngine,public SortableDockCommon<> { Q_OBJECT diff --git a/kde/src/klib/dataengine/sflphoneService.h b/kde/src/klib/dataengine/sflphoneService.h index b5004f863d..bc65bd7195 100644 --- a/kde/src/klib/dataengine/sflphoneService.h +++ b/kde/src/klib/dataengine/sflphoneService.h @@ -33,7 +33,7 @@ using namespace Plasma; class Account; -///@class SFLPhoneService RPC between the plasmoid and the library +///SFLPhoneService: RPC between the plasmoid and the library class SFLPhoneService : public Plasma::Service { Q_OBJECT @@ -46,7 +46,7 @@ private: SFLPhoneEngine *m_engine; }; -///@class CallJob Call using and account and a number +///CallJob: Call using and account and a number class CallJob : public Plasma::ServiceJob { Q_OBJECT @@ -60,7 +60,7 @@ private: QString m_Number ; }; -///@class DTMFJob Play a sound when called +///DTMFJob: Play a sound when called class DTMFJob : public Plasma::ServiceJob { Q_OBJECT @@ -72,7 +72,7 @@ private: QString m_mStr; }; -///@class HangUpJob Hang up a call using an id +///HangUpJob: Hang up a call using an id class HangUpJob : public Plasma::ServiceJob { Q_OBJECT @@ -84,7 +84,7 @@ private: QString m_CallId; }; -///@class TransferJob Transfer a call +///TransferJob: Transfer a call class TransferJob : public Plasma::ServiceJob { Q_OBJECT @@ -97,7 +97,7 @@ private: QString m_transferNumber; }; -///@class HoldJob Put or remove a call from hold mode +///HoldJob: Put or remove a call from hold mode class HoldJob : public Plasma::ServiceJob { Q_OBJECT @@ -109,7 +109,7 @@ private: QString m_CallId; }; -///@class RecordJob Record a call +///RecordJob: Record a call class RecordJob : public Plasma::ServiceJob { Q_OBJECT diff --git a/kde/src/lib/Account.h b/kde/src/lib/Account.h index 408e0819bc..acd98458cd 100644 --- a/kde/src/lib/Account.h +++ b/kde/src/lib/Account.h @@ -33,7 +33,7 @@ class QString; const QString& account_state_name(const QString& s); -///@class Account a daemon account (SIP or AIX) +///Account: a daemon account (SIP or AIX) class LIB_EXPORT Account : public QObject { Q_OBJECT diff --git a/kde/src/lib/AccountList.cpp b/kde/src/lib/AccountList.cpp index 833b0244b5..33ac61aff7 100644 --- a/kde/src/lib/AccountList.cpp +++ b/kde/src/lib/AccountList.cpp @@ -219,13 +219,13 @@ void AccountList::removeAccount(Account* account) * * ****************************************************************************/ -///Get the accoutn from its index +///Get the account from its index const Account* AccountList::operator[] (int i) const { return (*m_pAccounts)[i]; } -///Get the accoutn from its index +///Get the account from its index Account* AccountList::operator[] (int i) { return (*m_pAccounts)[i]; diff --git a/kde/src/lib/AccountList.h b/kde/src/lib/AccountList.h index e0c5aac0a2..16bca59d9b 100644 --- a/kde/src/lib/AccountList.h +++ b/kde/src/lib/AccountList.h @@ -27,7 +27,7 @@ #include "Account.h" #include "typedefs.h" -///@class AccountList List of all daemon accounts +///AccountList: List of all daemon accounts class LIB_EXPORT AccountList : public QObject{ Q_OBJECT diff --git a/kde/src/lib/CallModel.h b/kde/src/lib/CallModel.h index 0cca16f49e..a30e8b5fa4 100644 --- a/kde/src/lib/CallModel.h +++ b/kde/src/lib/CallModel.h @@ -44,7 +44,7 @@ class HistoryModel; typedef QMap<QString, Call*> CallMap; typedef QList<Call*> CallList; -///@class CallModelBase Base class for the central model/frontend +///CallModelBase: Base class for the central model/frontend ///This class need to exist because template classes can't have signals and ///slots because Qt MOC generator can't guess the type at precompilation class LIB_EXPORT CallModelBase : public QObject @@ -103,7 +103,7 @@ signals: * Using QAbstractModel resulted in a failure. Managing all corner case bloated the code to the point of no * return. This frontend may not be cleaner from a design point of view, but it is from a code point of view */ -///@class CallModel Central model/frontend to deal with sflphoned +///CallModel: Central model/frontend to deal with sflphoned template <typename CallWidget = QWidget*, typename Index = QModelIndex*> class LIB_EXPORT CallModel : public CallModelBase { public: diff --git a/kde/src/lib/Contact.h b/kde/src/lib/Contact.h index bad7467bd0..83c119b83b 100644 --- a/kde/src/lib/Contact.h +++ b/kde/src/lib/Contact.h @@ -38,7 +38,7 @@ namespace KABC { #include "typedefs.h" -///@class Contact Abstract version of a contact +///Contact: Abstract version of a contact class LIB_EXPORT Contact : public QObject{ Q_OBJECT public: diff --git a/kde/src/lib/ContactBackend.h b/kde/src/lib/ContactBackend.h index d46a281bf0..c62c3fb990 100644 --- a/kde/src/lib/ContactBackend.h +++ b/kde/src/lib/ContactBackend.h @@ -35,7 +35,7 @@ class Contact; //Typedef typedef QList<Contact*> ContactList; -///@class ContactBackend Allow different way to handle contact without poluting the library +///ContactBackend: Allow different way to handle contact without poluting the library class LIB_EXPORT ContactBackend : public QObject { Q_OBJECT public: diff --git a/kde/src/lib/HistoryModel.cpp b/kde/src/lib/HistoryModel.cpp index cdfc4bfc63..05be16fcb0 100644 --- a/kde/src/lib/HistoryModel.cpp +++ b/kde/src/lib/HistoryModel.cpp @@ -27,6 +27,7 @@ * Private classes * * * ****************************************************************************/ +///SortableCallSource: helper class to make sorting possible class SortableCallSource { public: SortableCallSource(Call* call=0) : count(0),callInfo(call) {} diff --git a/kde/src/lib/HistoryModel.h b/kde/src/lib/HistoryModel.h index f26a0c6c22..8d3cd7be1f 100644 --- a/kde/src/lib/HistoryModel.h +++ b/kde/src/lib/HistoryModel.h @@ -33,7 +33,7 @@ class Call; typedef QMap<QString, Call*> CallMap; typedef QList<Call*> CallList; -///@class HistoryModel History call manager +///HistoryModel: History call manager class LIB_EXPORT HistoryModel : public QObject { Q_OBJECT public: diff --git a/kde/src/lib/VideoCodec.h b/kde/src/lib/VideoCodec.h index 792a1eb992..c693006af4 100644 --- a/kde/src/lib/VideoCodec.h +++ b/kde/src/lib/VideoCodec.h @@ -32,7 +32,7 @@ class Account; class VideoCodec; typedef QHash<QString,VideoCodec*> CodecHash; -///@class VideoCodec Codecs used for video calls +///VideoCodec: Codecs used for video calls class LIB_EXPORT VideoCodec { public: diff --git a/kde/src/lib/VideoDevice.h b/kde/src/lib/VideoDevice.h index 768990f3c4..18322baf55 100644 --- a/kde/src/lib/VideoDevice.h +++ b/kde/src/lib/VideoDevice.h @@ -51,7 +51,7 @@ struct LIB_EXPORT Resolution { } }; -///@class VideoDevice V4L devices used to record video for video call +///VideoDevice: V4L devices used to record video for video call class LIB_EXPORT VideoDevice { public: //Singleton diff --git a/kde/src/lib/VideoModel.h b/kde/src/lib/VideoModel.h index 1b6b647386..3cb03a25ed 100644 --- a/kde/src/lib/VideoModel.h +++ b/kde/src/lib/VideoModel.h @@ -29,7 +29,7 @@ class QTimer; //SFLPhone #include "VideoDevice.h" -///@class VideoModel Video event dispatcher +///VideoModel: Video event dispatcher class LIB_EXPORT VideoModel : public QObject { Q_OBJECT public: diff --git a/kde/src/widgets/AccountItemWidget.h b/kde/src/widgets/AccountItemWidget.h index 3c76f74ddd..5bbc583a21 100755 --- a/kde/src/widgets/AccountItemWidget.h +++ b/kde/src/widgets/AccountItemWidget.h @@ -30,7 +30,7 @@ class QCheckBox; class QLabel; -///@class AccountItemWidget Widget for the config dialog account list +///AccountItemWidget: Widget for the config dialog account list class AccountItemWidget : public QWidget { Q_OBJECT diff --git a/kde/src/widgets/BookmarkDock.cpp b/kde/src/widgets/BookmarkDock.cpp index de96add744..61774fee17 100644 --- a/kde/src/widgets/BookmarkDock.cpp +++ b/kde/src/widgets/BookmarkDock.cpp @@ -44,7 +44,7 @@ #include "klib/HelperFunctions.h" #include "lib/HistoryModel.h" -///@class QNumericTreeWidgetItem : Tree widget with different sorting criterias +///QNumericTreeWidgetItem : Tree widget with different sorting criterias class QNumericTreeWidgetItem : public QTreeWidgetItem { public: QNumericTreeWidgetItem(QTreeWidget* parent):QTreeWidgetItem(parent),widget(0),weight(-1){} diff --git a/kde/src/widgets/BookmarkDock.h b/kde/src/widgets/BookmarkDock.h index 30f58298d2..d9ecb2e1cc 100644 --- a/kde/src/widgets/BookmarkDock.h +++ b/kde/src/widgets/BookmarkDock.h @@ -39,7 +39,7 @@ class CategorizedTreeWidget; //Typedef typedef QList<HistoryTreeItem*> BookmarkList; -///@class BookmarkDock Dock for managing favorite contacts +///BookmarkDock: Dock for managing favorite contacts class BookmarkDock : public QDockWidget { Q_OBJECT public: diff --git a/kde/src/widgets/CallTreeItem.h b/kde/src/widgets/CallTreeItem.h index 43cc1041dd..5c7669331d 100644 --- a/kde/src/widgets/CallTreeItem.h +++ b/kde/src/widgets/CallTreeItem.h @@ -41,7 +41,7 @@ class Call; class TranslucentButtons; class Contact; -///@class CallTreeItem Widget for the central call treeview +///CallTreeItem: Widget for the central call treeview class CallTreeItem : public QWidget { Q_OBJECT diff --git a/kde/src/widgets/CategorizedTreeWidget.h b/kde/src/widgets/CategorizedTreeWidget.h index 0652281e64..f486bd28fe 100644 --- a/kde/src/widgets/CategorizedTreeWidget.h +++ b/kde/src/widgets/CategorizedTreeWidget.h @@ -28,6 +28,7 @@ class KConfigGroup; class KateColorTreeItem; class QTreeWidgetItem; +///CategorizedTreeWidget: A better looking widget than the plain QListWidget class CategorizedTreeWidget : public QTreeWidget { Q_OBJECT diff --git a/kde/src/widgets/CategoryDrawer.h b/kde/src/widgets/CategoryDrawer.h index 4973491f61..ae8e07b340 100644 --- a/kde/src/widgets/CategoryDrawer.h +++ b/kde/src/widgets/CategoryDrawer.h @@ -29,6 +29,7 @@ class QPainter; class QModelIndex; class QStyleOption; +///CategoryDrawer: A better looking widget than the plain QListWidget class CategoryDrawer : public KCategoryDrawerV2 { public: diff --git a/kde/src/widgets/ContactDock.cpp b/kde/src/widgets/ContactDock.cpp index 8b2f677c76..32b33be495 100644 --- a/kde/src/widgets/ContactDock.cpp +++ b/kde/src/widgets/ContactDock.cpp @@ -54,7 +54,7 @@ #define CURRENT_SORTING_MODE m_pSortByCBB->currentIndex() -///@class QNumericTreeWidgetItem_hist TreeWidget using different sorting criterias +///QNumericTreeWidgetItem_hist: TreeWidget using different sorting criterias class QNumericTreeWidgetItem_hist : public QTreeWidgetItem { public: QNumericTreeWidgetItem_hist(QTreeWidget* parent):QTreeWidgetItem(parent),widget(0),weight(-1){} diff --git a/kde/src/widgets/ContactDock.h b/kde/src/widgets/ContactDock.h index 902edbe9d0..38f5b64f5a 100644 --- a/kde/src/widgets/ContactDock.h +++ b/kde/src/widgets/ContactDock.h @@ -58,7 +58,7 @@ class ContactItemWidget; class StaticEventHandler; class Contact; -///@class ContactDock Dock to access contacts +///ContactDock: Dock to access contacts class ContactDock : public QDockWidget, public SortableDockCommon<CallTreeItem*,QTreeWidgetItem*> { Q_OBJECT @@ -88,7 +88,7 @@ private slots: void reloadHistoryConst ( ); }; -///@class ContactTree tree view with additinal drag and drop +///ContactTree: tree view with additinal drag and drop class ContactTree : public CategorizedTreeWidget { Q_OBJECT public: @@ -97,7 +97,7 @@ public: bool dropMimeData(QTreeWidgetItem *parent, int index, const QMimeData *data, Qt::DropAction action); }; -///@class KeyPressEaterC keygrabber +///KeyPressEaterC: keygrabber class KeyPressEaterC : public QObject { Q_OBJECT diff --git a/kde/src/widgets/ContactItemWidget.h b/kde/src/widgets/ContactItemWidget.h index dfa356fe84..3e6c8aed47 100644 --- a/kde/src/widgets/ContactItemWidget.h +++ b/kde/src/widgets/ContactItemWidget.h @@ -42,7 +42,7 @@ namespace KABC { class Contact; class TranslucentButtons; -///@class ContactItemWidget Item for the contact tree +///ContactItemWidget: Item for the contact tree class ContactItemWidget : public QWidget { Q_OBJECT diff --git a/kde/src/widgets/Dialpad.h b/kde/src/widgets/Dialpad.h index 5dd1784a98..576f341ddd 100755 --- a/kde/src/widgets/Dialpad.h +++ b/kde/src/widgets/Dialpad.h @@ -27,7 +27,7 @@ //Qt class QGridLayout; -///@class DialpadButton the 12 button of the dialpad +///DialpadButton: the 12 button of the dialpad class DialpadButton : public QPushButton { Q_OBJECT @@ -44,7 +44,7 @@ signals: }; -///@class Dialpad A widget that representing a phone dialpad with associated numbers and letters +///Dialpad: A widget that representing a phone dialpad with associated numbers and letters class Dialpad : public QWidget { Q_OBJECT diff --git a/kde/src/widgets/HistoryDock.cpp b/kde/src/widgets/HistoryDock.cpp index c6e989f976..44690af501 100644 --- a/kde/src/widgets/HistoryDock.cpp +++ b/kde/src/widgets/HistoryDock.cpp @@ -52,7 +52,7 @@ #define CURRENT_SORTING_MODE m_pSortByCBB->currentIndex() -///@class QNumericTreeWidgetItem Qt lack official functional sorting algo, so this hack around it +///QNumericTreeWidgetItem: Qt lack official functional sorting algo, so this hack around it class QNumericTreeWidgetItem : public QTreeWidgetItem { public: QNumericTreeWidgetItem(QTreeWidget* parent=0):QTreeWidgetItem(parent),widget(0),weight(-1){} diff --git a/kde/src/widgets/HistoryDock.h b/kde/src/widgets/HistoryDock.h index 1b0755caab..c0aade1564 100644 --- a/kde/src/widgets/HistoryDock.h +++ b/kde/src/widgets/HistoryDock.h @@ -52,7 +52,7 @@ class QNumericTreeWidgetItem; typedef QList<HistoryTreeItem*> HistoryList; typedef QHash<QString,QNumericTreeWidgetItem*> GroupHash; -///@class HistoryDock Dock to see the previous SFLPhone calls +///HistoryDock: Dock to see the previous SFLPhone calls class HistoryDock : public QDockWidget, public SortableDockCommon<CallTreeItem*,QTreeWidgetItem*> { Q_OBJECT @@ -99,7 +99,7 @@ private slots: }; -///@class HistoryTree Simple tree view with additional keybpard filter +///HistoryTree: Simple tree view with additional keybpard filter class HistoryTree : public CategorizedTreeWidget { Q_OBJECT public: @@ -108,7 +108,7 @@ public: bool dropMimeData(QTreeWidgetItem *parent, int index, const QMimeData *data, Qt::DropAction action); }; -///@class KeyPressEater Intercept each keypress to manage it globally +///KeyPressEater: Intercept each keypress to manage it globally class KeyPressEater : public QObject { Q_OBJECT diff --git a/kde/src/widgets/HistoryTreeItem.cpp b/kde/src/widgets/HistoryTreeItem.cpp index a0471e4415..440b29d72c 100644 --- a/kde/src/widgets/HistoryTreeItem.cpp +++ b/kde/src/widgets/HistoryTreeItem.cpp @@ -60,6 +60,7 @@ const char * HistoryTreeItem::callStateIcons[12] = {ICON_INCOMING, ICON_RINGING, ICON_CURRENT, ICON_DIALING, ICON_HOLD, ICON_FAILURE, ICON_BUSY, ICON_TRANSFER, ICON_TRANSF_HOLD, "", "", ICON_CONFERENCE}; +///PlayerWidget: A small widget to play call recording class PlayerWidget : public QWidget { public: PlayerWidget(QWidget* parent = 0) : QWidget(parent) {} diff --git a/kde/src/widgets/HistoryTreeItem.h b/kde/src/widgets/HistoryTreeItem.h index 670301dafd..4970adea76 100644 --- a/kde/src/widgets/HistoryTreeItem.h +++ b/kde/src/widgets/HistoryTreeItem.h @@ -49,7 +49,7 @@ class QMimeData; //KDE class KAction; -///@class HistoryTreeItem Items for the history dock +///HistoryTreeItem: Items for the history dock class HistoryTreeItem : public QWidget { Q_OBJECT diff --git a/kde/src/widgets/SFLPhoneTray.h b/kde/src/widgets/SFLPhoneTray.h index bfad9dae09..9f0da19c27 100755 --- a/kde/src/widgets/SFLPhoneTray.h +++ b/kde/src/widgets/SFLPhoneTray.h @@ -31,7 +31,7 @@ class KAction; class QMenu; class QIcon; -///@class SFLPhoneTray The old system try, should be totally replaced by a plasmoid some day +///SFLPhoneTray: The old system try, should be totally replaced by a plasmoid some day class SFLPhoneTray : public KSystemTrayIcon { Q_OBJECT diff --git a/kde/src/widgets/TranslucentButtons.h b/kde/src/widgets/TranslucentButtons.h index 8176c54452..7051ff5490 100644 --- a/kde/src/widgets/TranslucentButtons.h +++ b/kde/src/widgets/TranslucentButtons.h @@ -7,7 +7,7 @@ class QTimer; class QMimeData; class QImage; -///@class TranslucentButtons Fancy buttons for the call widget +///TranslucentButtons: Fancy buttons for the call widget class TranslucentButtons : public QPushButton { Q_OBJECT diff --git a/kde/src/widgets/VideoWidget.h b/kde/src/widgets/VideoWidget.h index 1a06f6fd80..7c9e116005 100644 --- a/kde/src/widgets/VideoWidget.h +++ b/kde/src/widgets/VideoWidget.h @@ -24,6 +24,7 @@ #include "../lib/VideoModel.h" +///VideoWidget: A widget to display video from a framebuffer class VideoWidget : public QWidget { Q_OBJECT public: -- GitLab