[Tcladdressbook-commits] Help tcladdressbook.n,1.8,1.9

[Bernard D. <bde...@us...>]

Update of /cvsroot/tcladdressbook/Help
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv29254/Help

Modified Files:
	tcladdressbook.n 
Log Message:
[add] and [remove] take multiple args

Index: tcladdressbook.n
===================================================================
RCS file: /cvsroot/tcladdressbook/Help/tcladdressbook.n,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- tcladdressbook.n	30 Jul 2004 21:30:32 -0000	1.8
+++ tcladdressbook.n	1 Aug 2004 06:31:51 -0000	1.9
@@ -1,7 +1,7 @@
 .de uline
 \Z'\\$1'\v'.25m'\D'l \w'\\$1'u 0'\v'-.25m'
 ..
-.TH tcladdressbook n "" "2004-07-30" "addressbook extension for Tcl"
+.TH tcladdressbook n "" "2004-08-01" "addressbook extension for Tcl"
 .SH NAME
 .PP
 addressbook - manipulate the Macintosh OSX Address Book database
@@ -17,10 +17,10 @@
 subcommands are explained in the next sections.
 .SH SUBCOMMANDS
 .PP
-.SS addressbook add \fI recordID\fP \fI groupID\fP
+.SS addressbook add \fI groupID\fP \fI recordID ?recordID ...?\fP
 .PP
-This command lets you add an already existing item (person or group) 
-designated by its unique ID \fI recordID\fP to the group with ID 
+This command lets you add one or more already existing items (persons or
+groups) designated by their unique ID \fI recordID\fP to the group with ID
 \fI groupID\fP.
 .SS addressbook changed
 .PP
@@ -100,14 +100,17 @@
 which will be used by default if no \fI distribution identifier\fP has
 been specified using the \fBaddressbook identifier set\fP command.
 Property \fI propName\fP must be a multi-value list property (such as 
-\fI Phone, Email\fP). ((nl Used without the \fI ident\fP argument, the
-command will return the \fI primary identifier\fP concerning property 
-\fI propName\fP for the person \fI personID\fP.
+\fI Phone, Email\fP). 
+.PP
+ Used without the \fI ident\fP argument, the command will return the
+\fI primary identifier\fP concerning property \fI propName\fP for the
+person \fI personID\fP.
 .PP
  If the \fI ident\fP argument is specified, the command will set the
 primary value to be the value for the given identifier \fI ident\fP. This
 value must be a valid identifier used by the multi-value list: one can get
-the identifiers of any element of a multi-value list using the \fBaddressbook identifier get\fP command.
+the identifiers of any element of a multi-value list using the 
+\fBaddressbook identifier get\fP command.
 .SS addressbook identifier set \fI groupID\fP \fI personID\fP \fI propName\fP ?\fI ident\fP?
 .PP
 This command lets you get or set the \fI distribution identifier\fP for a
@@ -201,21 +204,21 @@
 .PP
  The format used for a particular property's value depends on the type of
 the property (string, integer, date, multivalue etc.). Some properties have
-a multiple type: MultiString for fields like Email, Phone etc., MultiDate
-for fields like ABDate, MultiDictionary for the Address field. In case of a
+a multiple type: \fI MultiString\fP for fields like Email, Phone etc., \fI MultiDate\fP
+for fields like ABDate, \fI MultiDictionary\fP for the Address field. In case of a
 multivalue, the returned value is a keyed list itself. Each element of the list
 corresponds to a single property. For instance:
 .RS
 .IP * 4
-the elements of a MultiString or MultiDate value list are two-elements 
+the elements of a \fI MultiString\fP or \fI MultiDate\fP value list are two-elements 
 sublists: the first element is the label of the corresponding 
-property (like Home, Work etc.) and the second is the value itself.
+property (like \fI Home, Work\fP etc.) and the second is the value itself.
 .IP * 4
-the elements of a MultiDictionary value list are lists themselves,
+the elements of a \fI MultiDictionary\fP value list are lists themselves,
 representing a Label/Dictionary pair (dictionary in the AddressBook sense,
 not a Tcl dictionary as defined in version 8.5 of Tcl). Each element of
 this list has two elements: the first one is the label describing the
-address (like Home, Work etc.) and the second one is a list representing
+address (like \fI Home, Work\fP etc.) and the second one is a list representing
 the dictionary. The lists representing dictionaries contain two-elements
 sublists: the first item is the key in the dictionary and the second one is
 the value associated with this key. For instance a person could have two
@@ -230,10 +233,10 @@
  Note that keyed lists can be easily manipulated 
 using the \fBkeylget\fP and \fBkeylset\fP commands defined in the TclX 
 extension.
-.SS addressbook remove \fI recordID\fP \fI groupID\fP
+.SS addressbook remove \fI groupID\fP \fI recordID ?recordID ...?\fP
 .PP
-This command lets you remove an already existing item (person or group) 
-designated by its unique ID \fI recordID\fP from the group with ID 
+This command lets you remove one or more already existing items (persons or
+groups) designated by their unique ID \fI recordID\fP from the group with ID
 \fI groupID\fP.
 .SS addressbook save
 .PP
@@ -385,7 +388,9 @@
 1.1b2 -- 2004/07/29 -- New command [setme].
 .IP * 4
 1.1b3 -- 2004/07/30 -- New command [identifier] to handle 
-distribution lists.
+distribution lists. Subcommands: count, get, primary, set.
+.IP * 4
+1.1b4 -- 2004/07/31 -- New command [identifier index].
 .RE
 .SH REQUIREMENTS AND PORTABILITY
 .PP