Sometimes (?) cross reference links are consistently not generated

[LearnCocos2D]

I've come across this a couple times now using appledoc v2.2 (build 963).

In the class overview for class A I add the name of class B (a subclass of A in this case) yet appledoc will not create a link for that identifier.

Unfortunately there seems to be no workaround, I wish I could simply write [ClassB] to force generating a link to "ClassB". Using @see doesn't work either in the class overview.

This only seems to happen in some classes and I have yet to find the root cause for this. Sometimes changing the text that comes before the cross reference helps but in my current case the class overview just has a plain english sentence followed by a list of class names, all of which are missing the cross reference links.

Is this a known issue? Is there perhaps a workaround?

[LearnCocos2D]

One explanation I might have: the particular class with the overview comment without cross references is in a header with many other interfaces (its subclasses). However not all of the missing links are to subclasses, one is to another class entirely (not related in any way) and it doesn't link to that class either.

Btw here's a screenshot of the output with the missing crossref links:

[LearnCocos2D]

Following text creates the cross ref links for the CCAction classes:

/** Base class for instant actions, ie actions which perform their task immediately and quit.

 ### Subclasses

 - CCActionCallBlock, CCActionCallFunc (runs a block or selector)
 */

Adding this last list item removes the cross ref links from the class names (except for CCSprite which remains linked):

/** Base class for instant actions, ie actions which perform their task immediately and quit.

 ### Subclasses

 - CCActionCallBlock, CCActionCallFunc (runs a block or selector)
 - CCActionFlipX, CCActionFlipY (sets the [CCSprite setFlipX:] and [CCSprite setFlipY:] properties of a CCSprite)
 */

I narrowed it down to this, apparently the manual cross reference link causes the automatic class cross refs to break, this is the minimum text that made the cross refs disappear:

/** Base class for instant actions, ie actions which perform their task immediately and quit.

 ### Subclasses

 - CCActionCallBlock, CCActionCallFunc (runs a block or selector)
 - CCActionFlipX, CCActionFlipY sets the 

 [CCSprite setFlipX:]
 */

[LearnCocos2D]

Interestingly, with this text all classes preceding `[CCNode removeFromParent]`` are not linked, but the classes following that text fragment do have links. My best guess is that the [] is in conflict with markdown and it expects or treats this as a markdown link ...

CCActionCallBlock, CCActionCallFunc (runs a block or runs a selector on a given target)
CCActionFlipX, CCActionFlipY (sets the flipX / flipY properties of a CCSprite)
CCActionPlace (sets the position property of a CCNode)
CCActionRemove (removes a CCNode from its parent, ie calls [CCNode removeFromParent])
CCActionShow, CCActionHide, CCActionToggleVisibility (sets the visible property of a CCNode)
CCActionSoundEffect (plays a sound effect via OALSimpleAudio)
CCActionSpriteFrame (sets the spriteFrame property of a CCSprite)