Як додати розрив рядка в документації на C # .NET

Це повинно бути легше ...

Я хочу додати "закодований" розрив рядка до документації XML у своєму коді

/// <summary>
/// Get a human-readable variant of the SQL WHERE statement of the search element. &lt;br/&gt;
/// Rather than return SQL, this method returns a string with icon-tokens, which 
/// could be used to represent the search in a condensed pictogram format.
/// </summary>

Як бачите, я знайшов відповіді, які демонстрували додавання дужок <і>. Цікаво, що хороший 'ol <br /> розрив рядків не створює розрив рядків у спливаючому вікні Intellisense.

Мені це дратує ...

Будь-які пропозиції?

Ви можете використовувати <para />тег для створення розриву абзацу, або ви можете загортати текст у <para></para>теги, як спосіб згрупувати текст і додати порожній рядок після нього, але немає еквіваленту <br />чи нічого подібного. (Відповідно до цієї старої публікації на форумі MS - це дизайн.) Ви можете отримати список доступних тегів у цій статті документації від MS. Документування вашого коду

Приклад (на основі оригінального зразка ОП):

/// <summary>
/// <para>Get a human-readable variant of the SQL WHERE statement of the search element.</para>
/// Rather than return SQL, this method returns a string with icon-tokens, which 
/// could be used to represent the search in a condensed pictogram format.
/// </summary>

Це моє використання, начебто <br/>, працює :)

/// <summary>
/// Value: 0/1/2
/// <para/>0 foo,
/// <para/>1 bar,
/// <para/>2 other
/// </summary>

Станом на Visual Studio 2019 використовуйте <br/> для коментарів нові рядки.

Приклад:

/// <summary>
/// This is a comment.<br/>
/// This is another comment <br/>
/// This is a long comment so i want it to continue <br/> on another line.
/// </summary>

Зауважте, що додаткового рядка не додано, коли ми використовуємо <br/>замість цього <para>.

Додайте <para>тег із спеціальним char у ньому, 255 char чи невидимим char .

/// <summary>
/// Some text
/// <para>   </para>
/// More text
/// </summary>
/// <param name="str">Some string</param>
public void SomeMethod(string str) { }

Він працюватиме так:

<br></br>і <br />, здається, не працює, а іноді справа не в тому, щоб зробити <para>речення відокремленими настільки, як про бажання мати порожній рядок для розлуки. Я згадую це тут, тому що це питання, мабуть, відповідає багатьом закритим питанням подібного характеру.

Єдине, що я знайшов працювати

<para>&#160;</para>

Наприклад

/// <summary>
///     <para>
///         "This sentence shows up when the type is hovered"
///     </para>
///     <para>&#160;</para>
///     <para>int PrimaryKey</para>
///     <para>&#160;</para>
///     <para>virtual Relation Relation</para>
/// </summary>

Призводить до

"This sentence shows up when the type is hovered"

int PrimaryKey

virtual Relation Relation