.NET Framework文档生成工具 NDoc 1.3 [转贴]

重点特性

       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