Sandcastle不会从F#程序集输出所有内容

本文介绍了Sandcastle不会从F#程序集输出所有内容的处理方法，对大家解决问题具有一定的参考价值，需要的朋友们下面随着小编来一起学习吧！ 问题描述

它仅识别顶级非函数值声明. 例如令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成熟: 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: bitbucket/IntelliFactory/if-doc