Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

Why I can't see xml comments from external library?

Is it normal I can't see xml comments from external libraries? For example I have an external library with xml comments on methods. After making a reference to this library I was hoping that xml comments appears when I make usage of the external library; But nothing appear in the tooltip :

screenshot

Maybe I have to do something special when I make the build of the lib.

like image 604
bAN Avatar asked Jan 11 '12 10:01

bAN


People also ask

How do I enable XML comment analysis?

Enabling XML Comments XML comments are enabled by default in Visual Basic projects, and cannot be disabled. To enable or disable XML comments for a specific project, go to the project properties page, the Compile tab, and update the "Generate XML documentation file" checkbox.

How to comment XML?

An XML comment encountered outside the document type declaration is represented by the Comment value syntax element. It contains the comment text from the XML message. If the value of the element contains the character sequence --> , the sequence is replaced with the text --> .

What are XML comments in C#?

C# documentation comments use XML elements to define the structure of the output documentation. One consequence of this feature is that you can add any valid XML in your documentation comments. The C# compiler copies these elements into the output XML file.


1 Answers

First you need to enabled "XML File Documentation" generation. You can find it in the Settings of the Project under the section Build.

Then will the compiler generate an XML File containing your documentation of the assembly on build.

If you reference the assembly in another project and you want to see the documentation of types, methods, etc. in IntelliSense you need to store the xml documentation file in the same folder, where the referenced assembly is stored.

like image 99
Jehof Avatar answered Sep 17 '22 07:09

Jehof