Sandcastle不会从F#程序集输出所有内容 [英] Sandcastle doesn't output everything from a F# assembly

问题描述

它仅识别顶级非函数值声明. 例如令a = 2 并且不提供有关函数或类型定义的文档.

It only recognizes top-level non-function value declarations. e.g. let a = 2 and doesn't produce documentation for functions or type definitions.

我已经检查了xml文档文件，并在源代码中添加了所有///注释，但最终的html中都没有显示(顶级值除外).

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.

推荐答案

是的，使用以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

这篇关于Sandcastle不会从F#程序集输出所有内容的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！