api-doc-tools
api-doc-tools copied to clipboard
.NET Reference API Toolchain
Based on #131 discussion CSharpFormatter ignores generic parameter attributes. Can be reproduced on the assembly compiled from mdoc/Test/DocTest-v1.cs file. 1. csc DocTest-v1.cs /unsafe 2. mdoc update -o en DocTest-v1.dll ```...
In order for Mono to support a [reproducible build](https://wiki.debian.org/ReproducibleBuilds/About), it needs all of its dependencies to support it as well ... including mdoc: https://bugzilla.xamarin.com/show_bug.cgi?id=37367 mdoc's `assemble` subcommand should add a...
Update the project to the latest version(s) of: - mono.cecil - sharpziplib (if it's been updated)
Sometimes, an engineering team will want to document an API, not for 3rd parties, but for themselves. _mdoc_ currently only documents public APIs, but maintainers (particularly newcomers being onboarded) are...
ccording to Microsoft documentation the bullet list's items should have description subtags (https://docs.microsoft.com/de-de/dotnet/csharp/programming-guide/xmldoc/list) /// /// /// Item 1. /// /// /// Item 2. /// /// In this case mdoc will...
Xamarin.Android and Xamarin.iOS bind native APIs, and may change names in the process. For example, the Android type `android.view.View` is bound as the `Android.Views.View` type. [Searching for `android.view.view`](https://developer.xamarin.com/en-us/search?q=android.view.view) would ideally...
if a member takes a parameter that is of private type, this member cannot be invoked by user, so it should not be in ECMAXML.
any string applied to a type or member in an attribute should be added to the search index.
The `EcmaUrlParser` is built using Jay and this [grammar](/mono/api-doc-tools/tree/master/monodoc/Monodoc.Ecma/EcmaUrlParser.jay). For the time being, the [prebuilt version of `EcmaUrlParser.cs`](/mono/api-doc-tools/tree/master/monodoc/Monodoc.Ecma/prebuilt/EcmaUrlParser.cs) is included in this repository, but we need to move to building...
https://github.com/mono/monodevelop is using this build of monodoc: ``` commit eab22f0e69b7168631b63b1469005fe5b3ee13cb Author: Jérémie Laval Date: Thu May 9 12:18:37 2013 -0400 [macdoc] Bump bundled monodoc.dll to mono/mono@245dee37992a827b99b9cb9df36cf78ce65db454 ``` At startup of...