У меня есть много файлов .cs, и все они задокументированы с использованием файлов XML и тега <include>, например:
///<summary>My addition example method</summary>
///<include file="..." path="Docs/MyClass/Add/*"/>
public int Add(int b)
{
///do something here
}
. Указанный XML-файл содержит <param name="b">, <returns>и все остальные теги.Это все очень хорошо, пока я не хочу создавать HTML-документацию с помощью Doxygen.
Doxygen принимает исходные файлы .cs и в сгенерированной html-документации, в методе Add я вижу только тег include вместо фактического материала.
Теперь я могу потратить часы и часы, чтобы фактически заменить все теги включения документацией из файлов XML, но я надеюсь, что есть способ заставить Doxygen искать в этих файлах, или автоматический процессэто заменяет эти теги фактическим содержимым.
Я знаю, что Sandcastle может создавать HTML из XML, но я не мог заставить эту программу работать по другим причинам, поэтому, пожалуйста, не рекомендуйте это.