C# 为Doxygen提供库类的文档存根
我的项目中有许多类实现INotifyPropertyChanged。我希望每个PropertyChanged事件中的所有PropertyChanged事件都能够从接口继承文档,但由于接口不是我项目的一部分,因此它没有Doxygen页面 我可以通过这个文档获得接口的部分文档,类页面出现,继承图显示了实现它的所有类。但我无法声明事件。添加事件时是否缺少关键字C# 为Doxygen提供库类的文档存根,c#,doxygen,inotifypropertychanged,C#,Doxygen,Inotifypropertychanged,我的项目中有许多类实现INotifyPropertyChanged。我希望每个PropertyChanged事件中的所有PropertyChanged事件都能够从接口继承文档,但由于接口不是我项目的一部分,因此它没有Doxygen页面 我可以通过这个文档获得接口的部分文档,类页面出现,继承图显示了实现它的所有类。但我无法声明事件。添加事件时是否缺少关键字 namespace MyNamespace { /** * @class INotifyPropertyChanged
namespace MyNamespace
{
/**
* @class INotifyPropertyChanged
* @brief Interface to allow subscribers to know when the object has been updated. See <a href="http://msdn.microsoft.com/en-us/library/system.componentmodel.inotifypropertychanged.aspx">MSDN Doc</a>
* @fn void INotifyPropertyChanged::PropertyChanged(sender, e)
* @memberof INotifyPropertyChanged
* @brief Notification that a property of the object has changed.
* @details the name of the property is in the event arguments
* Still having trouble documenting the parameters correctly, but this doesn't inherit anyway because it's a function, not an event
*/
}
名称空间MyNamespace
{
/**
*@class INotifyPropertyChanged
*@brief接口,允许订阅者知道对象何时更新。请参阅
*@fn void INotifyPropertyChanged::PropertyChanged(发件人,e)
*@MemberOfInotifyPropertyChanged
*@对象属性已更改的简短通知。
*@details属性的名称在事件参数中
*仍然无法正确记录参数,但这不会继承,因为它是函数,而不是事件
*/
}
或者我完全错过了机会,有办法导入Intellisense文档吗?尝试创建INotifyPropertyChanged.cs文件,将文档化的接口声明放在那里,但不要包含在任何项目中进行编译,只能由doxygen选择
据介绍,它支持标准ECMA-334 XML标记,这些标记通常用于注释C#代码,因此不需要使用@class、@brief标记等。是否存在用于.net库的现有标记文件?谢谢!我试试看!我知道xml样式,这是我喜欢的样式,但是你做客户付钱让你做的事情,客户要求@style文档。越来越近了。子类Doxygen输出在事件简要摘要中列出事件两次,一次作为子版本,一次作为接口版本。在事件文档部分中,仅列出了子版本。如果我将
/**@copydoc System::ComponentModel::INotifyPropertyChanged::PropertyChanged*/
添加到子版本,它们都会被记录下来。没有copydoc,子版本就不会被记录。使INotifyPropertyChanged成为类或接口具有相同的结果。