Только определенные теги xmldoc имеют отношение к IntelliSense
У Microsoft есть все виды документированных тегов xml для комментариев к документам (начиная с тройного слеша), но некоторые из них (например, <list>
) на самом деле не меняйте форматирование текста всплывающей подсказки, которую мне дает IntelliSense, и вместо этого он просто попадает в перемешанную кучу:
Вот комментарии к документу, которые создали эту подсказку:
/// <summary>
/// <code>None of this gets formatted</code>
/// Test list:
/// <list type="number"><listheader><term>testT</term><description>testD</description></listheader>
/// <item><term>This gets</term><description>crammed</description></item></list>
/// See <see cref="unixEpoch"/>
/// </summary>
/// <param name="date"></param>
/// <param name="TimeZoneOption"></param>
/// <returns>Things that have <code>code</code></returns>
Итак, мои вопросы:
- Кажется, что все, что не помечено звездочкой в документе MS, просто игнорируется для целей IntelliSense, но почему даже есть
<code>
тег, если текст внутри не будет выглядеть иначе? - Почему
<returns>
часть не появляется в подсказке вообще? - Есть ли способ заставить новую строку, что я скучаю?