Invalid cross reference are reported for examples inside code span or block
appledoc warns when encounters something like [object doSomething:] inside code section or example block. Many times this is just used as an example to make the documented entity more understandable. This could be suppressed for at least example blocks. For code spans it's more tricky as cross refs to known objects are often embedded inside one.
See also #77.
+1
I'm wondering if these invalid cross ref warnings might lead to this particular problem here: https://github.com/tomaz/appledoc/issues/491
Because the file in question generates 2-3 such warnings. Will test. ... Hmmm, nope, fixing the cross-ref warnings had no effect on #491 unless maybe I need to fix all 40+ of them in other classes, too.