Sandcastle 不会输出 F# 程序集中的所有内容
它仅识别顶级非函数值声明。 例如令 a = 2 并且不生成函数或类型定义的文档。
我已经检查了 xml 文档文件,它包含我在源代码中放入的所有 /// 注释,但它们(除了顶级值之外)都没有显示在生成的 html 中。
It only recognizes top-level non-function value declarations.
e.g. let a = 2
and doesn't produce documentation for functions or type definitions.
I've checked the xml documentation file and it has all the /// comments I put in the source, but none of them (except for the top level values) show up in the resulting html.
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(1)
是的,使用以 C# 为中心的工具来生成 F# 文档通常非常糟糕。我们不久前启动了一个替代项目,但它还不如 SandCastle 成熟:http://bitbucket。 org/IntelliFactory/if-doc
Yes, using C#-centric tools for F# documentation generation is usually pretty horrible. We started an alternative project a while ago, but it is not yet as mature as SandCastle: http://bitbucket.org/IntelliFactory/if-doc