[Condor-devel] documentation horked re splitslotname and splitusername classad functions

[Todd Tannenbaum <tannenba@xxxxxxxxxxx>]

In looking over Dan's fix to the memory leak for splitslotname and 
splitusername classad functions (thanks Dan!!), I noticed that the 
documentation for these functions in the Condor Manual is 
misleading/confusing.

The problem is these functions, along with quantize() make use of "new" 
ClassAd lists. However, the Condor Manual does not document new classad 
language constructs such as lists or nested ads.  Further adding to the 
confusion:
  1. there are no examples in the manual how to even reference a member 
of a new classad list.
  2. in section 4 "Predefined functions", the function listings do not 
distinguish between a "string list" (a string that contains a list) and 
a new classad "list of strings".  For instance, the Manual claims 
splitUserName() returns a "String list" and also claims stringListSum() 
takes a parameter "String list".


--
Todd Tannenbaum <tannenba@xxxxxxxxxxx> University of Wisconsin-Madison
Center for High Throughput Computing   Department of Computer Sciences
Condor Project Technical Lead          1210 W. Dayton St. Rm #4257
Phone: (608) 263-7132                  Madison, WI 53706-1685