重点特性
NDoc 1.3包括以下重要新特性:
• 全新制作的Html Help 2文档生成器,新名称为“VS.NET 2003 Documenter”。
• 支持一些新的代码注释标记,如preliminary、threaadsafety和exclude等。
• 支持ObsoleteAttribute和FlagsAttribute属性。
• 允许用户自定义代码注释标签并控制其格式。
• 增强的用户界面。
• 在反射和文档生成方面都有性能提升。
• 更好地提供MSDN相容性
"VS.NET 2003" Documenter
新的VS.NET 2003 Documenter创建HTML Help 2文档,支持XML数据岛,更好地集成到Visual Studio在线帮助中。
性能提升
全部代码生成器都得到了显著性能提升。
• XML Merge进程速度得到提高,只占全部进程时间的一小部分。
• 页面生成时间缩短20-50%。
• 内存耗费显著减少。
• 命名空间树的生成不再导致性能和稳定性问题,且总是被创建文档。
程序集装载
• 在修改一个程序集后,GUI无需重启即可装载之。
• 多数程序集均可从网络共享资源装载。由于.NET Framework的限制,受管C++程序集必须存在于本地驱动器,否则会引发安全异常。
• 程序集分辨功能得到改善,很少出现不能发现某个程序集的情况。
国际化
NDoc现在可以处理非英语文字字符。
除MSDN HtmlHelp之外,Unicode(UTF-8)支持在其他文档中均得到支持。HTML Help编译器中有一些已知问题,导致其无法支持混和字符编码。
虽然NDoc支持多字符集,但类似节标头等的NDoc自动产生的文本在这个版本中仍不能被本地化。
同时启动多个NDoc
解决了之前的文件锁定问题,多个NDoc实例可以同时运行。
用户界面
• 拖放操作。从资源管理器中拖放程序集到NDoc GUI,可以把程序集加入到工程中。
• 错误处理得到加强。
• Help编译器信息。这些信息现在被写入日志,如果编译时发生错误,将显示错误信息。
• Property Grid(属性表格)得到多方面加强。
• 支持没有XML文档的程序集。
• 支持程序集相对路径。
相关资源
• 官方网站: http://ndoc.sourceforge.net/
• NDoc 1.3文档:http://ndoc.sourceforge.net/usersguide.html
• NDoc 1.3下载:http://prdownloads.sourceforge.net/ndoc/NDoc-v1.3.msi?download