1

Closed

cref to enum type fails

description

My cref to an enum type fails i.e. when the project builds, the see also link is not clickable to the enum description and list of values. The type is declared as nullable (question mark is specified after type). Code snippet attached.

file attachments

Closed Apr 19, 2013 at 7:16 PM by EWoodruff
See comments.

comments

EWoodruff wrote Apr 18, 2013 at 7:25 PM

Is the enum in question in the set of documented assemblies? If it's just in a reference assembly, there's no documentation for it to link to. If appropriate, include the reference assembly as a documentation source. If you don't want it's content documented, the link will have to remain as normal text.

EWoodruff wrote Apr 18, 2013 at 7:28 PM

Also, since you're fully qualifying the name, make sure you've got it right. The compiler will generate a warning if you haven't. Typically, fully qualifying the target is unnecessary if the proper using statements are in place which I assume they are as the enum name is not qualified on the actual member declaration. You could try removing the namespace qualifiers too.

writestuff wrote Apr 19, 2013 at 9:02 AM

First off, just want to say that Sandcastle is a very good product. The enum issue is now resolved. The obvious answer was right (duh!) - make sure that all referenced code file are in the doc source. Thanks.