我有用 C# 编写的库,在我的方法上有标准 C# 文档,如下例所示,Visual Studio 自动执行自动完成并弹出各种参数描述。我使用 SandCastle 助手来生成“已编译的 html”文档页面。
我的用户似乎是一半的 Windows 和一半的 Linux 开发人员,后者主要使用 Eclipse。任何人都可以建议一个简单的跨平台选项,它仍然适用于 Visual Studio 和生成手册页,但也给我 Eclipse 自动完成和悬停弹出窗口(例如自动生成所需的 PDT 文件)?如果这涉及修改我的 C# 文档以使用更像 Javadoc 的东西,我可以这样做。当然,理想情况下,我不想创建代码分支或复制我的文档......
/// <summary>
/// Puts the current group into DHT mode, but without specifying a target size and without setting aside extra members.
/// </summary>
/// <param name="ReplicationFactor">Requested data replication factor</param>
/// <param name="ExpectedGroupSize">Your estimate of the typical size of this group (N); a multiple of the replication factor</param>
/// <param name="MinimumGroupSize">The smallest group size at which the DHT will accept DHTPut/DHTGet commands</param>
/// <remarks>If the replication factor is too small, you run the risk that our random hashing scheme could leave some affinity
/// group with too few, or too many members. </remarks>
public void DHTEnable(int ReplicationFactor, int ExpectedGroupSize, int MinimumGroupSize)
{
DHTEnable(ReplicationFactor, ExpectedGroupSize, MinimumGroupSize, int.MaxValue);
}