You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Aug 27, 2026. It is now read-only.
Repository navigation
This repository was archived by the owner on Aug 27, 2026. It is now read-only.
Currently, there is partial -- and not particularly robust -- support for importing JavaDoc documentation into an Assembly.xml documentation file by way of mdoc:
The above support requires the mdoc utility, but we're not sure of the long term distribution mechanics of mdoc: dotnet/runtime#35852
As an alternate take, once PR #623 is merged, we might be able to instead do the conversion within generator, such that the generated code itself contains C# code comments converted from JavaDoc. This would allow us to use the "normal" csc /doc toolchain, and remove the need for mdoc entirely. (Except for updating https://github.com/xamarin/android-api-docs, but that's a separate concern.)
Activity
jonpryor commentedon Nov 9, 2020
In-progress: #687
[generator] Add `generator --with-javadoc-xml=FILE` support. (#687)
[generator] Add `generator --with-javadoc-xml=FILE` support. (#687)