tomaz/appledoc — Issue #155: @see not adding companion guide link for class comment.
Author: JulesLooker
Created: 2011-12-03 15:28:48+00:00
State: open

Reading the documentation and Issue #68, it indicates an @see (static-template reference) in a class comment will add a Companion guide link to the static-template document.

When I try to add a companion guide using this method appledoc reports this in the build log:

appledoc version: 2.0.4 (build 703)
Oops, something went wrong...
AppledocException: Can't create token identifier for Document1-template.markdown; object is not top level and has no parent assigned!

Just putting a reference to my static doc in the class comment adds a navigable link in situ so I am happy the static doc is defined correctly.

I have posted a project demonstrating this at https://github.com/JulesLooker/SeeAlsoInvestigation. As is, the project builds and you can look at the installed docset. Then look at the comment in InvestigationClass.h, change AMP to an @ and build again to see the error.

It's quite possible I'm missing something, please advise.