我已经尝试使用向导安装的GUI附带的修补程序对SandcaSTLe进行了尝试,但是除非我做错了什么,否则它基本上不适合记录F#代码(即使它对于C#而言确实很不错)。也许它对其他人有用,在这种情况下,我将非常感谢我可以从中开始的简短完整示例。非常感谢。
我知道Sandcastle doesn't output everything from a F# assembly,但是那里引用的项目似乎还没有准备就绪。
肯定有某些东西可以可靠地工作并且“足够好”吗?非常感谢您的任何建议。
编辑:非常感谢所有回答的人。 Brian的答案与我想要的最接近,所以我会接受的。但是,结果是似乎没有一个既适合F#又可靠地工作的解决方案。我现在将坚持文字评论。
我希望FsHtmlDoc.exe将在某个时候开始工作。尽管我不能排除它已经可以工作并且我没有正确使用它,但是在谷歌上搜索它并不是唯一发现它还不完善的人。
最佳答案
我几乎不了解SandcaSTLe,但是请注意,像C#一样,在F#中,您可以使用三斜杠注释,它们将在编译器输出的XML文档文件中输出(在VS中,在项目属性页上,“生成”选项卡,请选中“Xml文档文件”复选框;在命令行上,将--doc
参数用作fsc.exe
。)
另外,请参阅PowerPack中的FsHtmlDoc.exe
。