benjy added a blurb on http://www.pantsbuild.org/build_files.html#target-definitions , but it still might not have been enough to explain that