ralfbiedert/interoptopus

Convert rust document comments into C# style

ZhaoXiangXML opened this issue · 1 comments

Is it possible to convert rust document comments into C# style so we can generate C# API document with it?

for instance:

/// This function has documentation.
#[ffi_function]
#[no_mangle]
pub extern "C" fn documented(_x: StructDocumented) -> EnumDocumented {
    EnumDocumented::A
}

should be convert to:

/// <summary>
/// This function has documentation.
/// </summary>
...

No this isn't supported, and it's in general not on the roadmap. Main reason is Interoptopus is a general-purpose generator, and it would be impossible to properly satisfy all Python, C#, ... documentation tags.

I would, however, accept PRs that automatically inserts some tags that can easily and universally be inferred (e.g., create summary from first Rust summary sentence), but that's about it.