-
July 14th, 2010, 01:44 PM
#1
XML Documentation in Object Browser
I'm trying to document my code and for some reason my example code is not showing up in the object browser window. Should my code show up when I do this?
Code:
/// <summary>
/// <para>The color sensor contains 4 sensors. (C)lear which does not contain a light filter, (R)ed, (G)reen, and (B)lue
/// which contain filters. CRGB Returns an integer with each byte in the integer containing the level of each filter.</para>
/// </summary>
/// <returns>Returns Clear, Red, Green, and Blue contained in a 4 byte integer.</returns>
/// <example>
/// <code>
/// public static void Main()
/// {
/// Colorimeter.ADJD_S371_Q999 myColorSensor = new ADJD_S371_Q999();
///
/// //Poll the sensor to update the levels
/// myColorSensor.Poll;
///
/// int rgb = myColorSensor.CRGB;
/// int redMask = 0x00ff0000;
/// int temp;
/// byte level;
///
/// //Mask the unused bytes
/// temp = (rgb & redMask);
///
/// //Shift the bytes so the red byte is in the least signifcant position
/// level = (byte)(temp >> 16);
/// }
/// </code>
/// </example>
-
July 14th, 2010, 03:32 PM
#2
Re: XML Documentation in Object Browser
There is no code there, you have commented all of it out, so no, it will not show up.
-
July 15th, 2010, 07:40 AM
#3
Re: XML Documentation in Object Browser
I think he's trying to use the <example></example> XML documentation tags to provide an example of how to use some code that's not shown here.
I don't think that the Object Browser supports these tags. Most of the tags are intended to be used with specialized documentation-generating tools (like NDoc), some of which can produce a set of web-pages similar to the classic MSDN page layout.
-
July 16th, 2010, 11:47 PM
#4
Re: XML Documentation in Object Browser
I'm trying to document my code and for some reason my example code is not showing up in the object browser window. Should my code show up when I do this?
yes why did you comment the following code ????please remove commet and run it .and if found any error .tell me ????
Posting Permissions
- You may not post new threads
- You may not post replies
- You may not post attachments
- You may not edit your posts
-
Forum Rules
|
Click Here to Expand Forum to Full Width
|