Home All Groups Group Topic Archive Search About

How to create a multiline ///<Summary> section? in c#

Author
7 Feb 2006 8:23 PM
arfeengodil
Hi ..

I have this structure in C# with a couple of variables and I'm adding a
little description of that variable  like:

/// <summary>
/// Some description
/// Some description line # 2
/// Some description line # 3
/// </summary>
String someVariable;

But when I view it in the intellisense menu, the description is
displayed in one long string instead of three different strings in
three different lines.

I just want to display some important information in this summary
section but having everything cluttered in one big string makes it hard
to read and understand.

Anybody have any ideas ?

Thanks
Arfeen

Author
7 Feb 2006 9:00 PM
dkode8@gmail.com
maybe try a \r\n?

carriage return line feed?
Author
7 Feb 2006 9:16 PM
Lee Roth
you could also try using <param> and <returns> tags if that is some of
the summary info you have. also <remarks> might help separate
Author
8 Feb 2006 7:00 AM
Markus Ewald
<arfeengo***@gmail.com> schrieb im Newsbeitrag
news:1139343827.443595.235200@g47g2000cwa.googlegroups.com...
> Hi ..
>
> I have this structure in C# with a couple of variables and I'm adding a
> little description of that variable  like:
>
> /// <summary>
> /// Some description
> /// Some description line # 2
> /// Some description line # 3
> /// </summary>
> String someVariable;
>

Normally, you'd do it like this:

    /// <summary>
    ///   <para>
    ///     First paragraph
    ///   </para>
    ///   <para>
    ///     Second paragraph
    ///   </para>
    /// </summary>

but then again, the <summary /> tag is intended to be used for giving a
summary, not a formatted essay about the variable's purpose. So this should
become

    /// <summary>Short description</summary>
    /// <remarks>
    ///   <para>
    ///     First paragraph
    ///   </para>
    ///   <para>
    ///     Second paragraph
    ///   </para>
    /// </remarks>

> [...]
>
> Anybody have any ideas ?
>
> Thanks
> Arfeen
>

-Markus-
Author
9 Feb 2006 8:23 PM
arfeengodil
Hi all,
Thanks for the replies, but none of the above suggestions work. So I
guess I'll just go with single line summaries .

Regards
Arfeen
Author
9 Feb 2006 11:05 PM
joy
workaround for the timebeing:

1. use \n (or any other  delimiter) for line break.  (do not use the
characters < or > in the delimiter)
2. generate the code comment pages
3. use any editor with the "find and replace in all files" capability
and replace \n or the delimiter with <br>

- Joy

arfeengo***@gmail.com wrote:
Show quote
> Hi all,
> Thanks for the replies, but none of the above suggestions work. So I
> guess I'll just go with single line summaries .
>
> Regards
> Arfeen

AddThis Social Bookmark Button