帮助洞察中的新行

New line in help insight

借助工具提示帮助洞察力,我可以在将鼠标悬停在 classname/fieldname/procedurename 等上时显示一些额外的评论,如下所示:

/// <comments>Some comments on e.g. a class.</comments>

如何在显示的文本中强制换行?

在XE7和XE8以下

  public
    { Public declarations }
    /// <comments>Some comments<para/>comments on a second line</comments>
    procedure SetUp;

将文本 'comments on a second line' 放在 Help Insight 弹出窗口中的新行中。一个小怪癖是第二行缩进了几个空格,但如果我这样做

/// <comments>Some comments<para>comments on a second line</para>third line</comments>

'third line' 没有缩进。缩进不一致可以通过执行以下操作来掩盖(以缩进两个空格为代价):

///<comments><para>Some comments</para><para>comments on a second line</para><para>third</para></comments>
procedure SetUp;

根据实验判断,

<p/>

XML 标签曾经在 XE4 中工作,但在 XE7 中停止工作,正如我最初的测试:

  TForm1 = class(TForm)
    CDS: TClientDataSet;
    DataSource1: TDataSource;
    DBGrid1: TDBGrid;
    Button1: TButton;
    procedure CDSCalcFields(DataSet: TDataSet);
    procedure FormCreate(Sender: TObject);
    procedure Button1Click(Sender: TObject);
  private
    ///<comments>Some comments<p/>more</comments>
    procedure AddHLIndex;

在 XE4 中,上面的 'more' 在 XE4 的新行上显示,但与 XE8 中的 'Some comments' 在同一行。

我想知道 XE8 中的差异是否与 Castalia 的存在有关,但我发现 XE4 和 XE8 之间的差异相同,XE8 以 /NOCASTALIA 开关启动。

我没有进行详尽的测试,但 XE8 忽略了我尝试过的所有 'HTML' 格式化标签(除了

<c>

提问者提到的标签),当然这可能是故意更改或意外的结果。另一方面,它似乎确实处理 HTML 转义,例如

&gt;

&lt;

但不幸的是,

&#10;

,它只是忽略了。