Obviously, in a shared, open-source environment, you are welcome to change things as you feel appropriate. But still, this document may help to keep the build.xml file more consistent (I hope).
Remember that you can also influence the Ant process by using your own build.properties file without making any changes directly in the build.xml file. But the changes listed below are those that need to be done directly in build.xml.
Here is a list of the most common things you may want to do:
If you wish, however, to exclude some packages, add their names to excludepackagenames in the build.xml -> docs ->javadoc task. You may use there a comma-separated list, wildcards are allowed.
If you wish to exclude only some files, this was the idea:
If you wish to exclude only some files, add their names into one of the filesets (again in the build.xml -> docs ->javadoc task), or add your own fileset there....but it does not work. Any idea how to exclude only some files without breaking the package exclusion defined by/in excludepackagenames?
When you add a new package or a group of packages belonging to the same logical group, consider also to add new group element (again in the build.xml -> docs ->javadoc task).