[FLAPI-185] adds @see to the top of builder interfaces, pointing
back to the helper for that block

The two addOrCreate methods have been altered to return whether
the JDefinedClass is a new construction, so that callers can make
decisions which would only apply to the initial construction.