-
Book Overview & Buying
-
Table Of Contents
F# for Quantitative Finance
By :
XML documentation is useful when you want to autogenerate documentation for your code. If you just put the documentation directly in a triple-slash comment, the entire content will be a summary. The other possibility is to use specific XML tags to specify which type of documentation the specific text belongs to. Doing that enables you, as a programmer, to document the code in a more versatile way.
The following are some useful XML tags:
|
Tag |
Description |
|---|---|
|
|
Summary describes code that is commented on |
|
|
Specifies what's returned |
|
|
A remark or something to notice about the code |
|
|
Specifies exceptions that may be thrown from the code |
|
|
Enables you to link your documentation to other sections for more details |
XML documentation is used by Visual Studio and it's IntelliSense to provide information about the code. Let's add some XML documentation to a function that we have used before...
Change the font size
Change margin width
Change background colour