I'd prefer to make the latter change, expanding the example, rather than removing 
that bit. But, I've not used LDAP, so I'm unsure how to represent that 
functionality. Could you provide some example code to do so? I'd greatly 
appreciate that.

Otherwise, I'll just remove the line.

Hello frozenfire,
I think who wants to use this php function should know how LDAP works.

We can provide two examples are the best way to describe how to handle a simple and a more complex LDAP data entry.

In the the first example the mail-attribute should be removed because it's wrong:
$info["cn"] = "John Jones";
$info["sn"] = "Jones";
$info["objectclass"] = "person";
 
The second example with email is a little bit more complex because a second objectclass:
$info["cn"] = "John Jones";
$info["sn"] = "Jones";
$info["mail"] = "jonj@example.com";
$info["objectclass"][] = "person";
$info["objectclass"][] = "inetOrgPerson";

Maybe an information about LDAP is helpful because LDAP only accept right structured data. If you want to save any kind of 
attribute you have to declare additionally the right objectclass. The next thing to understand is that the LDAP server has 
to know the right information schema where the objectclasses are described. This only ca be handled with LDAP 
configuration not by PHP.
The objectclass "person" is provided by the schema "core" and the objectclass "inetOrgPerson" is provided by the schema 
"inetorgperson". If somebody needs other data structures as existing schemas can provide there is only one clean way to 
declare: You need to request an organisation number from the IANA (Internet Assigned Numbers Authority). 

kind regards,
Carsten

This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.

Fixed in revision 330183 by removing the 'mail' line.