The naming and behavior of the archive task methods is confusing:

• to set the (basic) content of the archive: resourceCollections = [ new FileSet(...), ... ]
• to add one resourceCollection: fileSet(dir: ...)
• (WAR) to set the class files: classesFileSets = [ new FileSet(...), ... ]
• (WAR) there is no analogon classesFileSet(dir: ...) to fileSet(dir: ...)
• (WAR) there is no method to set the webAppDir, although the convention object has a webAppDirName
• (WAR) property additionalLibFileSets but method additionalLibs instead of additionalLibFileSet

When used with the libs

of the WarPlugin for a second war file (e.g. mockup of a web service) this means that

• do not use fileSet(dir: new File(projectDir, mockWebAppDirName)) --> you will get two web directories (this and the one from the conventions object)
• use resourceCollections = [ new FileSet(new File(projectDir, mockWebAppDirName)) ] instead for the file sets
• use classesFileSets = [ ... ] for the class files

Suggestions:

• for WAR have a webAppDir = ... which overwrites default/inherited values
• add an "alias" fileSets for resourceCollections in the archive tasks
• for WAR add methods classesFileSet analog to fileSet of archive tasks
• for WAR do the same webInfFileSets
• for WAR rename additionalLibs to additionalLibFileSet
• ,,,