[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-commits
Subject:    kdelibs/kabc
From:       David Faure <faure () kde ! org>
Date:       2004-10-13 15:01:52
Message-ID: 20041013150152.70D2516C96 () office ! kde ! org
[Download RAW message or body]

CVS commit by faure: 

Docu: many addressbook methods should be const, but that's for KDE4.
Added comment about the fact that insertCustom() with an empty value does nothing
(I expected it to overwrite with empty, i.e. remove the entry)


  M +15 -15    addressbook.h   1.53
  M +3 -0      scripts/addressee.src.h   1.44


--- kdelibs/kabc/addressbook.h  #1.52:1.53
@@ -236,5 +236,5 @@ class KABC_EXPORT AddressBook : public Q
       @param addr The addresee you are looking for.
      */
-    Iterator find( const Addressee &addr );
+    Iterator find( const Addressee &addr ); // KDE4: const
 
     /**
@@ -245,10 +245,10 @@ class KABC_EXPORT AddressBook : public Q
               empty addressee.
      */
-    Addressee findByUid( const QString &uid );
+    Addressee findByUid( const QString &uid ); // KDE4: const
 
     /**
       Returns a list of all addressees in the address book.
      */
-    Addressee::List allAddressees();
+    Addressee::List allAddressees(); // KDE4: const
 
     /**
@@ -258,5 +258,5 @@ class KABC_EXPORT AddressBook : public Q
       @return A list of all matching addressees.
      */
-    Addressee::List findByName( const QString &name );
+    Addressee::List findByName( const QString &name ); // KDE4: const
 
     /**
@@ -266,5 +266,5 @@ class KABC_EXPORT AddressBook : public Q
       @return A list of all matching addressees.
      */
-    Addressee::List findByEmail( const QString &email );
+    Addressee::List findByEmail( const QString &email ); // KDE4: const
 
     /**
@@ -274,5 +274,5 @@ class KABC_EXPORT AddressBook : public Q
       @return A list of all matching addressees.
      */
-    Addressee::List findByCategory( const QString &category );
+    Addressee::List findByCategory( const QString &category ); // KDE4: const
 
     /**
@@ -280,5 +280,5 @@ class KABC_EXPORT AddressBook : public Q
       created by concatenation of the resource identifiers.
      */
-    virtual QString identifier();
+    virtual QString identifier(); // KDE4: const
 
     /**
@@ -286,5 +286,5 @@ class KABC_EXPORT AddressBook : public Q
       with the given field category.
      */
-    Field::List fields( int category = Field::All );
+    Field::List fields( int category = Field::All ); // KDE4: const
 
     /**
@@ -320,5 +320,5 @@ class KABC_EXPORT AddressBook : public Q
       Returns a list of all resources.
      */
-    QPtrList<Resource> resources();
+    QPtrList<Resource> resources(); // KDE4: const
 
     /**

--- kdelibs/kabc/scripts/addressee.src.h  #1.43:1.44
@@ -307,4 +307,7 @@ class KABC_EXPORT Addressee
       application and a unique name. If an entry with the given app and name
       already exists its value is replaced with the new given value.
+
+      An empty value isn't allowed (nothing happens if this is called with
+      any of the three arguments being empty)
      */
     void insertCustom( const QString &app, const QString &name,


[prev in list] [next in list] [prev in thread] [next in thread]