Merged V2.2 to HEAD

8078: Merged V2.1 to V2.2
      8025: Fixes WCM-1039, problems with case insensitive name handling.
   8079: Merged V2.1 to V2.2
      8035: -- DONE SEPARATELY --
      8040: Fix AR-1985: SQL Server dialect is derived from Sybase dialect there need additional no-op script
      8046: Better Javadocs for getChildByName()
      8056: Fixed WCM-790: Date conversion for metadata extractors
      8057: Fixed WCM-790: Properties that don't convert can be discarded (default is to fail)
      8059: -- DONE SEPARATELY --
      8061: Fixes WCM-790: Fallout from CHK-2168 and CHK-2169
   8081: Fix for WCM-1018
   8082: Merged V2.1 to V2.2
      8016: Merged V2.1-A to V2.1
         8000: Additional indexes for AVM
         8013: Patch to introduce reverse indexes required for AVM


git-svn-id: https://svn.alfresco.com/repos/alfresco-enterprise/alfresco/HEAD/root@8474 c4b6b30b-aa2e-2d43-bbcb-ca4b014f7261

source/java/org/alfresco/service/cmr/repository/NodeService.java

@@ -480,6 +480,11 @@ public interface NodeService
     /**
      * Get the node with the given name within the context of the parent node.  The name
      * is case-insensitive as Alfresco has to support case-insensitive clients as standard.
+     * <p>
+     * That API method getChildByName only works for associations that don't allow duplicate child names.
+     * See <b>cm:folder</b> and the <b>duplicate</b> tag.  Child associations without this allow duplicate
+     * child names and therefore it is possible to have multiple children with the same name stored against
+     * the given association type.
      * 
      * @param nodeRef the parent node - usuall a <b>container</b>
      * @param assocTypeQName the type of the association