Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How to put a line break in xmldoc comments

I have a following summary snippet.

  /// <summary>
  ///  Holds the future state for 4 pixels
  ///  Every pixel can be in 4 states, on, off, unknown, or don't care
  ///  Off=00, on=01, unknown = 10, don't care = 11.
  ///   The grid is like this:
  ///   <code>
  ///      TL|TR        <br/>
  ///     ---+---       <br/>
  ///      BL|BR        <br/>
  ///  </code>
  /// </summary>

This is displayed in the popup hint as:

Holds the future state for 4 pixels Every pixel can be in 4 states,
on, off, unknown, or don't care Off=00, on=01, unknown = 10,
don't care = 11. The grid is like this: TL|TR ---+--- BL|BR

The ascii art in the middle is correctly shown in monospaced font, but no line breaks.
How to I get the line breaks to be displayed correctly

like image 570
Johan Avatar asked Dec 18 '22 04:12

Johan


1 Answers

You can use paragraph break <para/>:

/// <summary>
/// The grid is like this:
/// <code>
///      TL|TR        <para/>
///     ---+---       <para/>
///      BL|BR        <para/>
/// </code>
/// </summary>

Result:

enter image description here

like image 111
Victoria Avatar answered Dec 24 '22 01:12

Victoria