Document Method
Refactoring with
Document Method is a simple way of adding a comment block prior to a method. Components of the method, e.g. return value and parameters, are listed on separate lines of the block so you can document their meanings individually.
Hover over the declaration or implementation of a method and select
Document Method from the refactoring menu.
A comment block is created prior to the method.
Format of Comment Block
You can modify the format of comment block by editing the
VA Snippet for
Refactor Document Method. There are separate VA Snippets for C++, C# and VB.
The VA Snippets entries include special characters expanded only when refactoring. These special characters are:
| Reserved String | Meaning |
| $SymbolName$ | Name of method |
| $SymbolContext$ | Context and name of method |
| $SymbolType$ | Return type of method |
| $SymbolVirtual$ | Keyword virtual or blank |
| $SymbolPrivileges$ | Access of method |
| $SymbolStatic$ | Keyword static or blank |
| $MethodQualifier$ | Qualifier or blank |
| $MethodArg$ | One parameter of the method and its type |
| $MethodArgName$ | One parameter of the method |
| $MethodArgType$ | Type of one parameter of the method |
The line of the VA Snippets entry containing $MethodArg$ or $MethodArgName$ is repeated for each parameter of the method.
If you delete a VA Snippets entry and invoke
Document Method, a default entry is created for you.