Синтаксис Delphi HelpInsight cref - PullRequest
Новая
       18

Синтаксис Delphi HelpInsight cref

0 голосов
/ 21 марта 2019

У меня проблема с синтаксисом cref в документации по Delphi. Когда я использую только IDE, ссылка работает и открывает другую тему. 

/// <summary>
///  Opens a file FileName in Mode. Mode constants are in unit Sys_Files. Opened file must be closed with <see cref="R_FunctionsDoc|TScriptFunctionsDocumentation.FileClose">FileClose</see>.
/// </summary>

Но когда я хочу скомпилировать проект с флагом --doc, я получаю предупреждение 

Warning: W1206 XML comment on 'FileOpen' has cref attribute 'R_FunctionsDoc|TScriptFunctionsDocumentation.FileClose' that could not be resolved

и в выводе xml есть только 

<devnotes>
<!-- Badly formed XML comment ignored for member 'FileClose' -->
</devnotes>

С другой стороны, когда я заменяю | с . предупреждение компилятора отсутствует, но в справке IDE не идет по ссылке. В выводе xml есть 

<devnotes>
  <summary>
    Opens a file FileName in Mode. Mode constants are in unit Sys_Files. Opened file must be closed with <see cref="M:R_FunctionsDoc.TScriptFunctionsDocumentation.FileClose(System.Integer)">FileClose</see>.
  </summary>
</devnotes>

Существует ли какое-либо решение, чтобы иметь оба? Мне нужен вывод xml для следующей обработки, и рабочая справка в IDE также была бы отличной.

...