Documentation

[Daddoon]

Add documentation in methods when needed.
Source: https://mozilla.github.io/geckoview/javadoc/mozilla-central/org/mozilla/geckoview/package-tree.html

[Daddoon]

javadoc jar has been added on the project, but even if everything is configured, Visual Studio fail to match documentation / C# api.

So it's not working at the moment.
Also there is a bug that prevent JavaDocs to compile with the default VS2019 Xamarin.Android build target.

In Xamarin.Android.Bindings.targets in the MSBuild for the moment we must replace:

<Touch Files="@(JavaDocJar->'$(IntermediateOutputPath)javadocs\%(FileName).stamp')" /> 

To

<Touch Files="@(JavaDocJar->'$(IntermediateOutputPath)javadocs\%(FileName).stamp')" AlwaysCreate="True" />

Also see: dotnet/android#2745

[Daddoon]

As quoted:

Steps to Reproduce

1. I tried to create a binding library from glide
   download glide-3.7.0-javadoc.jar glide-3.7.0.jar and set action build to JavaDocJar
2. build binding library

Expected Behavior

build success and binding library has original Java parameter

Actual Behavior

build error xxxx.stamp not exist

Version Information

Log File

Xamarin.Android.Bindings.targets
<Touch Files="@(JavaDocJar->'$(IntermediateOutputPath)javadocs\%(FileName).stamp')" />
maybe miss the attribute AlwaysCreate="True"