Updated with new methods.

[squirrelmail.git] / doc / addressbook.txt

diff --git a/doc/addressbook.txt b/doc/addressbook.txt
index 29d87c1e76a7d2157020079760fa3ddd67f14543..fe746d584f484bdb2ba4c7e10185f1dba893fe07 100644 (file)
--- a/doc/addressbook.txt
+++ b/doc/addressbook.txt
@@ -78,11 +78,13 @@ methods are provided:
    fullname before it is returned.
 
 
-  lookup(NICKNAME)  
+  lookup(NICKNAME, [BNUM])  
 
      NICKNAME - Return the user identified by NICKNAME in
      the addressbook.
 
+     BNUM - ID of the backend to look in (optional).
+
    This method will return one result array (see below), an empty
    array if nothing was found, or false if the search failed. The
    lookup is only performed in "local" type backends.
@@ -108,6 +110,33 @@ methods are provided:
    was added, or false if it failed.
 
 
+  remove(NICKNAME, BNUM)
+
+     NICKNAME - Delete the user identified by NICKNAME in the
+     addressbook or, if NICKNAME is an array, all users indentified by
+     nthe nicknames in the array.
+
+     BNUM - ID of the backend, as returned by add_backend, to remove
+     the user(s) from.
+
+   This method will retrun true if the user(s) was removed, or false
+   if removal failed.
+
+
+  modify(NICKNAME, USERDATA, BNUM)
+
+     NICKNAME - Update the user identified by NICKNAME in the
+     addressbook.
+
+     USERDATA - Array with user data. The exisiting data for the user
+     will be replaced with this.
+
+     BNUM - ID of the backend, as returned by add_backend, to update
+     the user in.
+
+   This method will retrun true if the user was modified, or false if
+   something failed.
+
 
 If one of the above methods fail, an error message is available in the
 AddressBook->error variable. Feel free to ignore it.