From kde-commits Mon Oct 02 21:57:06 2006 From: Adriaan de Groot Date: Mon, 02 Oct 2006 21:57:06 +0000 To: kde-commits Subject: branches/KDE/3.5/kdelibs/kio Message-Id: <1159826226.922586.26255.nullmailer () svn ! kde ! org> X-MARC-Message: https://marc.info/?l=kde-commits&m=115982624612763 SVN commit 591639 by adridg: DOX: Name parameters; name them consistently; refer to them from @param. Patch by Dimitri v.H. M +2 -2 kfile/kfiletreeview.h M +1 -1 kfile/kurlrequester.cpp M +18 -18 kio/defaultprogress.h M +1 -1 kio/kscan.h M +8 -6 kio/kservice.cpp M +7 -6 kio/slavebase.cpp M +1 -1 kio/slavebase.h M +2 -2 kssl/ksmimecrypto.h M +2 -2 kssl/ksslcsessioncache.h M +1 -0 misc/uiserver.h --- branches/KDE/3.5/kdelibs/kio/kfile/kfiletreeview.h #591638:591639 @@ -214,9 +214,9 @@ // The drop event allows to differentiate between move and copy void dropped( QWidget*, QDropEvent*, KURL::List&, KURL& ); - void dropped( QDropEvent *, QListViewItem * ); + void dropped( QDropEvent *e, QListViewItem * after); void dropped(KFileTreeView *, QDropEvent *, QListViewItem *); - void dropped(QDropEvent *, QListViewItem *, QListViewItem *); + void dropped(QDropEvent *e, QListViewItem * parent, QListViewItem * after); void dropped(KFileTreeView *, QDropEvent *, QListViewItem *, QListViewItem *); protected: --- branches/KDE/3.5/kdelibs/kio/kfile/kurlrequester.cpp #591638:591639 @@ -306,7 +306,7 @@ emit urlSelected( d->url() ); } -void KURLRequester::setMode(unsigned int mode) +void KURLRequester::setMode(uint mode) { Q_ASSERT( (mode & KFile::Files) == 0 ); d->fileDialogMode = mode; --- branches/KDE/3.5/kdelibs/kio/kio/defaultprogress.h #591638:591639 @@ -48,7 +48,7 @@ /** * Creates a new default progress dialog. * @param parent the parent of the dialog (or 0 for top-level) - * @param the name of the dialog, can be 0 + * @param name the name of the dialog, can be 0 * @since 3.1 */ DefaultProgress( QWidget* parent, const char* name = 0 ); @@ -62,16 +62,16 @@ unsigned long totalFiles ); public slots: - virtual void slotTotalSize( KIO::Job*, KIO::filesize_t size ); - virtual void slotTotalFiles( KIO::Job*, unsigned long files ); - virtual void slotTotalDirs( KIO::Job*, unsigned long dirs ); + virtual void slotTotalSize( KIO::Job *job, KIO::filesize_t size ); + virtual void slotTotalFiles( KIO::Job *job, unsigned long files ); + virtual void slotTotalDirs( KIO::Job *job, unsigned long dirs ); - virtual void slotProcessedSize( KIO::Job*, KIO::filesize_t bytes ); - virtual void slotProcessedFiles( KIO::Job*, unsigned long files ); - virtual void slotProcessedDirs( KIO::Job*, unsigned long dirs ); + virtual void slotProcessedSize( KIO::Job *job, KIO::filesize_t bytes ); + virtual void slotProcessedFiles( KIO::Job *job, unsigned long files ); + virtual void slotProcessedDirs( KIO::Job *job, unsigned long dirs ); - virtual void slotSpeed( KIO::Job*, unsigned long speed ); - virtual void slotPercent( KIO::Job*, unsigned long percent ); + virtual void slotSpeed( KIO::Job *job, unsigned long speed ); + virtual void slotPercent( KIO::Job *job, unsigned long percent ); /** * Called to set an information message. * @param job the KIO::Job @@ -79,38 +79,38 @@ */ virtual void slotInfoMessage( KIO::Job *job, const QString & msg ); - virtual void slotCopying( KIO::Job*, const KURL& src, const KURL& dest ); - virtual void slotMoving( KIO::Job*, const KURL& src, const KURL& dest ); - virtual void slotDeleting( KIO::Job*, const KURL& url ); + virtual void slotCopying( KIO::Job* job, const KURL& src, const KURL& dest ); + virtual void slotMoving( KIO::Job* job, const KURL& src, const KURL& dest ); + virtual void slotDeleting( KIO::Job* job, const KURL& url ); /** * Called when the job is transferring. * @param job the KIO::Job * @param url the url to transfer * @since 3.1 */ - void slotTransferring( KIO::Job*, const KURL& url ); - virtual void slotCreatingDir( KIO::Job*, const KURL& dir ); + void slotTransferring( KIO::Job* job, const KURL& url ); + virtual void slotCreatingDir( KIO::Job* job, const KURL& dir ); /** * Called when the job is requesting a stat. * @param job the KIO::Job * @param dir the dir to stat * @since 3.1 */ - virtual void slotStating( KIO::Job*, const KURL& dir ); + virtual void slotStating( KIO::Job* job, const KURL& dir ); /** * Called when the job is mounting. * @param job the KIO::Job * @param dev the device to mount * @param point the mount point */ - virtual void slotMounting( KIO::Job*, const QString & dev, const QString & point ); + virtual void slotMounting( KIO::Job* job, const QString & dev, const QString & point ); /** * Called when the job is unmounting. * @param job the KIO::Job * @param point the mount point */ - virtual void slotUnmounting( KIO::Job*, const QString & point ); - virtual void slotCanResume( KIO::Job*, KIO::filesize_t ); + virtual void slotUnmounting( KIO::Job* job, const QString & point ); + virtual void slotCanResume( KIO::Job* job, KIO::filesize_t from); /** * Called when the job is cleaned. --- branches/KDE/3.5/kdelibs/kio/kio/kscan.h #591638:591639 @@ -339,7 +339,7 @@ KOCRDialogFactory( QObject *parent=0, const char *name=0 ); virtual QObject* createObject( QObject* parent = 0, const char* name = 0, - const char* classname = "QObject", + const char* className = "QObject", const QStringList &args = QStringList() ); --- branches/KDE/3.5/kdelibs/kio/kio/kservice.cpp #591638:591639 @@ -447,19 +447,21 @@ QStringList groupList() const { return QStringList(); } - QMap entryMap(const QString &) const - { return QMap(); } + QMap entryMap(const QString &group) const + { Q_UNUSED(group); return QMap(); } void reparseConfiguration() { } - KEntryMap internalEntryMap( const QString &) const { return KEntryMap(); } + KEntryMap internalEntryMap( const QString &pGroup) const + { Q_UNUSED(pGroup); return KEntryMap(); } KEntryMap internalEntryMap() const { return KEntryMap(); } - void putData(const KEntryKey &, const KEntry&, bool) { } + void putData(const KEntryKey &_key, const KEntry& _data, bool _checkGroup) + { Q_UNUSED(_key); Q_UNUSED(_data); Q_UNUSED(_checkGroup); } - KEntry lookupData(const KEntryKey &) const - { KEntry entry; entry.mValue = value; return entry; } + KEntry lookupData(const KEntryKey &_key) const + { Q_UNUSED(_key); KEntry entry; entry.mValue = value; return entry; } protected: QString key; QCString value; --- branches/KDE/3.5/kdelibs/kio/kio/slavebase.cpp #591638:591639 @@ -85,21 +85,22 @@ QStringList groupList() const { return QStringList(); } - QMap entryMap(const QString &) const - { return QMap(); } + QMap entryMap(const QString &group) const + { Q_UNUSED(group); return QMap(); } void reparseConfiguration() { } - KEntryMap internalEntryMap( const QString &) const { return KEntryMap(); } + KEntryMap internalEntryMap( const QString &pGroup) const { Q_UNUSED(pGroup); return KEntryMap(); } KEntryMap internalEntryMap() const { return KEntryMap(); } - void putData(const KEntryKey &, const KEntry&, bool) { } + void putData(const KEntryKey &_key, const KEntry&_data, bool _checkGroup) + { Q_UNUSED(_key); Q_UNUSED(_data); Q_UNUSED(_checkGroup); } - KEntry lookupData(const KEntryKey &key) const + KEntry lookupData(const KEntryKey &_key) const { KEntry entry; - QString value = slave->metaData(key.c_key); + QString value = slave->metaData(_key.c_key); if (!value.isNull()) entry.mValue = value.utf8(); return entry; --- branches/KDE/3.5/kdelibs/kio/kio/slavebase.h #591638:591639 @@ -395,7 +395,7 @@ * * @see canResume() */ - virtual void put( const KURL& url, int permissions, bool overwrite, bool /*resume*/ ); + virtual void put( const KURL& url, int permissions, bool overwrite, bool resume ); /** * Finds all details for one file or directory. --- branches/KDE/3.5/kdelibs/kio/kssl/ksmimecrypto.h #591638:591639 @@ -85,7 +85,7 @@ * Does not check certificates for validity! * @param signedText signed message block * @param clearText cleartext of signed message - * @foundCerts certificates found in this mesasge + * @param foundCerts certificates found in this mesasge * @return 0 on success */ rc checkOpaqueSignature(const QByteArray &signedText, @@ -101,7 +101,7 @@ * @param clearText MIME representation of message to encrypt * @param cipherText returned encrypted message * @param algorithm encryption algorithm - * @recip recipient certificates + * @param recip recipient certificates * @return 0 on success */ rc encryptMessage(const QCString &clearText, --- branches/KDE/3.5/kdelibs/kio/kssl/ksslcsessioncache.h #591638:591639 @@ -31,14 +31,14 @@ /** * Store a SSL session (client side only) - * @param url URL the key belongs to. Method, host and port are used + * @param kurl URL the key belongs to. Method, host and port are used * @param session QString representing session to store */ static void putSessionForURL(const KURL &kurl, const QString &session); /** * Retrieve a SSL session (client side only) - * @param url URL the key belongs to + * @param kurl URL the key belongs to * @return if a key can be found, QString::null otherwise */ static QString getSessionForURL(const KURL &kurl); --- branches/KDE/3.5/kdelibs/kio/misc/uiserver.h #591638:591639 @@ -276,6 +276,7 @@ /** * Popup a message box. + * @param id The message identifier. * @param type type of message box: QuestionYesNo, WarningYesNo, WarningContinueCancel... * This enum is defined in slavebase.h, it currently is: * QuestionYesNo = 1, WarningYesNo = 2, WarningContinueCancel = 3,