473,379 Members | 1,511 Online
Bytes | Software Development & Data Engineering Community
Post Job

Home Posts Topics Members FAQ

Join Bytes to post your question to a community of 473,379 software developers and data experts.

comment a structure

Hi all

I have this structure ,

public struct struct_name{

public int len;

public bool tmp;

}

What is the right way to comment this structure?

Every way I try I get this warning:

Missing xml comment for publicly visible type or member ...

Thank you

Sharon
Nov 17 '05 #1
2 2867
/// <summary>This is what struct_name is for...</summary>
public struct struct_name{
/// <summary>This is what 'len' means.</summary>
public int len;
/// <summary>This is what 'tmp' means.</summary>
public bool tmp;
}

Nov 17 '05 #2
Sharon <Sh*******@hotmail.com> wrote:
Hi all

I have this structure ,

public struct struct_name{

public int len;

public bool tmp;

}

What is the right way to comment this structure?

Every way I try I get this warning:

Missing xml comment for publicly visible type or member ...


Put an XML comment before the struct itself and each of the members:
/// <summary>
/// ...
/// </summary>
public struct struct_name{

/// <summary>
/// ...
/// </summary>
public int len;

/// <summary>
/// ...
/// </summary>
public bool tmp;
}

--
Jon Skeet - <sk***@pobox.com>
http://www.pobox.com/~skeet
If replying to the group, please do not mail me too
Nov 17 '05 #3

This thread has been closed and replies have been disabled. Please start a new discussion.

Similar topics

5
by: Alexandre | last post by:
Hi, Im a newb to dev and python... my first sefl assigned mission was to read a pickled file containing a list with DB like data and convert this to MySQL... So i wrote my first module which...
13
by: Colin Jones | last post by:
Hi - I have recently finished and launched a new website, which I am trying to make accessible and standards compliant. I have checked it with various online validators and it seems to come...
48
by: Andrew Quine | last post by:
Hi Just read this article http://www.artima.com/intv/choices.html. Towards the end of the dicussions, when asked "Did you consider including support for the concept of immutable directly in C#...
1
by: james autry | last post by:
When using the IDE, and the XML based auto commenting feature, how does one format an input parameter that is a structure. ie. describing each element of the structure between one <param> block. ...
16
by: Abhishek | last post by:
why do I see that in most C programs, pointers in functions are accepted as: int func(int i,(void *)p) where p is a pointer or an address which is passed from the place where it is called. what...
13
by: Pedro Graca | last post by:
I'm sure this isn't very pythonic; comments and advice appreciated def curious(text): """ Return the words in input text scrambled except for the first and last letter. """ new_text = "" word...
0
by: Randy | last post by:
After making a complete arse of myself by stupidly posting to the wrong group, I'll try here. ---------- Does anyone know if the NetShareSetInfo() API has any known oddities when using the...
12
by: Jason | last post by:
hello everyone! recently i've been working through K&R's The C programming language, and i just finished exercise 3.3, since my solution is shorter than the "suggested solution" online, i want to...
39
by: polas | last post by:
Afternoon all. I was just wondering about this point - I have (generally) used // for commenting a single line in C, but from looking at code other people have written it seems many use /* */...
1
by: CloudSolutions | last post by:
Introduction: For many beginners and individual users, requiring a credit card and email registration may pose a barrier when starting to use cloud servers. However, some cloud server providers now...
0
by: Faith0G | last post by:
I am starting a new it consulting business and it's been a while since I setup a new website. Is wordpress still the best web based software for hosting a 5 page website? The webpages will be...
0
by: ryjfgjl | last post by:
In our work, we often need to import Excel data into databases (such as MySQL, SQL Server, Oracle) for data analysis and processing. Usually, we use database tools like Navicat or the Excel import...
0
by: taylorcarr | last post by:
A Canon printer is a smart device known for being advanced, efficient, and reliable. It is designed for home, office, and hybrid workspace use and can also be used for a variety of purposes. However,...
0
by: ryjfgjl | last post by:
If we have dozens or hundreds of excel to import into the database, if we use the excel import function provided by database editors such as navicat, it will be extremely tedious and time-consuming...
0
by: ryjfgjl | last post by:
In our work, we often receive Excel tables with data in the same format. If we want to analyze these data, it can be difficult to analyze them because the data is spread across multiple Excel files...
0
BarryA
by: BarryA | last post by:
What are the essential steps and strategies outlined in the Data Structures and Algorithms (DSA) roadmap for aspiring data scientists? How can individuals effectively utilize this roadmap to progress...
1
by: nemocccc | last post by:
hello, everyone, I want to develop a software for my android phone for daily needs, any suggestions?
1
by: Sonnysonu | last post by:
This is the data of csv file 1 2 3 1 2 3 1 2 3 1 2 3 2 3 2 3 3 the lengths should be different i have to store the data by column-wise with in the specific length. suppose the i have to...

By using Bytes.com and it's services, you agree to our Privacy Policy and Terms of Use.

To disable or enable advertisements and analytics tracking please visit the manage ads & tracking page.