Doclet API docs: APIs need more documentation about returned arrays

In general, all APIs need to declare whether null or a zero
length array is returned. Usually, it is a zero length
array. But for example containingClass() returns null for
a top level class.