/// <summary>Writes an indented comment.</summary>
/// <param name="value"> The value.</param>
/// <param name="isSummary">(Optional) True if is summary, false if not.</param>
private void WriteIndentedComment(string value, bool isSummary = true)
{
if (isSummary)
{
_writer.WriteLineIndented("/// <summary>");
}
string comment = value
.Replace('\r', '\n')
.Replace("\r\n", "\n")
.Replace("\n\n", "\n")
.Replace("<", "<")
.Replace(">", ">");
string[] lines = comment.Split('\n');
foreach (string line in lines)
{
_writer.WriteIndented("/// ");
_writer.WriteLine(line);
}
if (isSummary)
{
_writer.WriteLineIndented("/// </summary>");
}
}
/// <summary>Writes an indented comment.</summary>
/// <param name="writer">The writer to write the comment to.</param>
/// <param name="value">The value.</param>
/// <param name="isSummary">(Optional) True if is summary, false if not.</param>
/// <param name="singleLine">(Optional) True if this is a short comment using a single line comment prefix. Implies isSummary = false.</param>
public static void WriteIndentedComment(ExportStreamWriter writer, string value, bool isSummary = true, bool singleLine = false)
{
if (string.IsNullOrEmpty(value))
{
return;
}
if (singleLine)
{
isSummary = false;
}
if (isSummary)
{
writer.WriteLineIndented("/// <summary>");
}
string comment = value.Replace('\r', '\n').Replace("\r\n", "\n").Replace("\n\n", "\n")
.Replace("&", "&").Replace("<", "<").Replace(">", ">");
string[] lines = comment.Split('\n');
foreach (string line in lines)
{
writer.WriteIndented(singleLine ? "// " : "/// ");
writer.WriteLine(line);
}
if (isSummary)
{
writer.WriteLineIndented("/// </summary>");
}
}