Code Documentation

The Code Assistance window can display documentation for the selected identifier.

AutocompleteWithDoc.png

To create documentation for a function, you need to add a Javadoc comment block immediately above the function prototype (or definition if available) that starts with '/**' on the first line. The editor can assist you by auto-populating a basic Javadoc comment block.

To add a documentation comment with the editor's assistance:

1

Type in the following sequence of characters on the line immediately above the item you wish to document: /**

2

Press Enter

3

The editor will automatically add a skeleton for the documentation similar to the one shown below (if documenting a function).

/**
*
* @param num
* @param radix
*/
void lcdPutInt(long num, char radix);

On the first line with a '*', you can type in a description the function. The @param lines were added automatically based on the parameter list of the function prototype immediately below. You can add comments after each parameter on the same line and they will also appear in the documentation window.

The documentation shown in the image above was generated by the following comments immediately above the lcdPutCur function declaration.

/**
* Positions the cursor on a character LCD module at the specified row and column, both of which are zero based.
* @param row    Row number of the display, where the top row is 0.
* @param column    Column number of the display, where the leftmost column is 0.
*/
void lcdPutCur(char row, char col);

Javadoc formatted comments can be considerably more complex. Comments may be formatted as HTML which can then be used to generate documentation in the form of web pages. For more details on the syntax and capabilities of this feature, please see the Oracle web site's page on the topic.

20th Annual
Microchip MASTERs Conference 2016
Register now - Deadline: July 29

JW Marriott Desert Ridge Resort-Phoenix, AZ

© 2016 Microchip Technology, Inc.
Information contained on this site regarding device applications and the like is provided only for your convenience and may be superseded by updates. It is your responsibility to ensure that your application meets with your specifications. MICROCHIP MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND WHETHER EXPRESS OR IMPLIED, WRITTEN OR ORAL, STATUTORY OR OTHERWISE, RELATED TO THE INFORMATION, INCLUDING BUT NOT LIMITED TO ITS CONDITION, QUALITY, PERFORMANCE, MERCHANTABILITY OR FITNESS FOR PURPOSE. Microchip disclaims all liability arising from this information and its use. Use of Microchip devices in life support and/or safety applications is entirely at the buyer's risk, and the buyer agrees to defend, indemnify and hold harmless Microchip from any and all damages, claims, suits, or expenses resulting from such use. No licenses are conveyed, implicitly or otherwise, under any Microchip intellectual property rights.