Item14563: Document the use of AUTOINC in the API

core/lib/Foswiki/Func.pm

@@ -2107,6 +2107,11 @@ try {
 };
 </verbatim>
 
+The topic name can include an =AUTOINCnnn= mask. For details on
+=AUTOINC= masks, see [[TemplateTopics#Automatically_generated_topic_names]].
+If the actual name of the topic is required, the =Foswiki::Meta= API
+should be used to save the topic.
+
 In the event of an error an exception will be thrown. Callers can elect
 to trap the exceptions thrown, or allow them to propagate to the calling
 environment. May throw Foswiki::OopsException or Error::Simple.

core/lib/Foswiki/Meta.pm

@@ -612,6 +612,11 @@ sub web {
       * *Since* 28 Nov 2008
 Get/set the topic name associated with the object.
 
+The topic name be set to include an =AUTOINCnnn= mask. For details on
+=AUTOINC= masks, see [[TemplateTopics#Automatically_generated_topic_names]].
+The mask will be converted to the next available topicname during save, and the
+saved name can be retrieved with this method.
+
 =cut
 
 sub topic {
@@ -1942,6 +1947,9 @@ sub haveAccess {
 Save the current object, invoking appropriate plugin handlers
    * =%options= - Hash of options, see saveAs for list of keys
 
+The topic name can include an =AUTOINCnnn= mask. For details on
+=AUTOINC= masks, see [[TemplateTopics#Automatically_generated_topic_names]]
+
 Returns the new revision number.
 
 =cut
@@ -2068,6 +2076,9 @@ so an extension author can in fact use all these options. However those
 marked "core only" are for core use only and should *not* be used in
 extensions.
 
+The topic name can include an =AUTOINCnnn= mask. For details on
+=AUTOINC= masks, see [[TemplateTopics#Automatically_generated_topic_names]]
+
 Returns the saved revision number.
 
 =cut