Merge pull request #31 from xamarin/dev/pjc/merge-ji-d3f0c5c-live

Fixes: dotnet/java-interop#931
Fixes: dotnet/java-interop#932
Fixes: dotnet/java-interop#933

Changes of note:

  * Includes a bunch of fixes for method overloads.

  * Documentation URLs have been fixed for type members with complex
     parameters.

Author: pjcollins

docs/Mono.Android/en/Android.AccessibilityServices/AccessibilityButtonController.xml

@@ -167,8 +167,8 @@
         <Parameter Name="handler" Type="Android.OS.Handler" />
       </Parameters>
       <Docs>
-        <param name="handler">To be added.</param>
         <param name="callback">the callback to add, must be non-null</param>
+        <param name="handler">To be added.</param>
         <summary>Registers the provided <c>AccessibilityButtonCallback</c> for interaction and state
             changes callbacks related to the accessibility button.</summary>
         <remarks>

docs/Mono.Android/en/Android.AccessibilityServices/AccessibilityService.xml

@@ -2332,13 +2332,15 @@
         <Parameter Name="displayId" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="displayId">To be added.</param>
-        <summary>Returns the controller for the accessibility button within the system's navigation area.</summary>
+        <param name="displayId">The logic display id, use <c>Display#DEFAULT_DISPLAY</c> for default
+                             display.</param>
+        <summary>Returns the controller of specified logical display for the accessibility button within the
+            system's navigation area.</summary>
         <returns>the accessibility button controller for this <c>AccessibilityService</c></returns>
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService#getAccessibilityButtonController()" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityService.getAccessibilityButtonController()</code>.</a>
+              <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService#getAccessibilityButtonController(int)" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityService.getAccessibilityButtonController(int)</code>.</a>
             </format>
           </para>
           <para>
@@ -3173,15 +3175,14 @@
         <Parameter Name="gestureEvent" Type="Android.AccessibilityServices.AccessibilityGestureEvent" />
       </Parameters>
       <Docs>
-        <param name="gestureEvent">To be added.</param>
-        <param name="gestureId">The unique id of the performed gesture.</param>
-        <summary>Called by <c>#onGesture(AccessibilityGestureEvent)</c> when the user performs a specific
-            gesture on the default display.</summary>
+        <param name="gestureEvent">The information of gesture.</param>
+        <summary>Called by the system when the user performs a specific gesture on the
+            specific touch screen.</summary>
         <returns>Whether the gesture was handled.</returns>
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService#onGesture(int)" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityService.onGesture(int)</code>.</a>
+              <a href="https://developer.android.com/reference/android/accessibilityservice/AccessibilityService#onGesture(android.accessibilityservice.AccessibilityGestureEvent)" title="Reference documentation">Java documentation for <code>android.accessibilityservice.AccessibilityService.onGesture(android.accessibilityservice.AccessibilityGestureEvent)</code>.</a>
             </format>
           </para>
           <para>

docs/Mono.Android/en/Android.Accounts/AccountManager.xml

@@ -124,7 +124,7 @@
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult()" title="Reference documentation">Java documentation for <code>android.accounts.AccountManagerFuture.getResult()</code>.</a>
+              <a href="https://developer.android.com/reference/android/accounts/AccountManagerFuture#getResult(long,%20java.util.concurrent.TimeUnit)" title="Reference documentation">Java documentation for <code>android.accounts.AccountManagerFuture.getResult(long, java.util.concurrent.TimeUnit)</code>.</a>
             </format>
           </para>
           <para>

docs/Mono.Android/en/Android.Accounts/IAccountManagerFuture.xml

@@ -366,7 +366,7 @@
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/animation/AnimatorSet#playSequentially(android.animation.Animator)" title="Reference documentation">Java documentation for <code>android.animation.AnimatorSet.playSequentially(android.animation.Animator)</code>.</a>
+              <a href="https://developer.android.com/reference/android/animation/AnimatorSet#playSequentially(java.util.List%3Candroid.animation.Animator%3E)" title="Reference documentation">Java documentation for <code>android.animation.AnimatorSet.playSequentially(java.util.List&lt;android.animation.Animator&gt;)</code>.</a>
             </format>
           </para>
           <para>
@@ -451,7 +451,7 @@
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/animation/AnimatorSet#playTogether(android.animation.Animator)" title="Reference documentation">Java documentation for <code>android.animation.AnimatorSet.playTogether(android.animation.Animator)</code>.</a>
+              <a href="https://developer.android.com/reference/android/animation/AnimatorSet#playTogether(java.util.Collection%3Candroid.animation.Animator%3E)" title="Reference documentation">Java documentation for <code>android.animation.AnimatorSet.playTogether(java.util.Collection&lt;android.animation.Animator&gt;)</code>.</a>
             </format>
           </para>
           <para>

docs/Mono.Android/en/Android.Animation/AnimatorSet.xml

@@ -118,7 +118,7 @@
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/animation/BidirectionalTypeConverter#convertBack(java.lang.Object)" title="Reference documentation">Java documentation for <code>android.animation.BidirectionalTypeConverter.convertBack(java.lang.Object)</code>.</a>
+              <a href="https://developer.android.com/reference/android/animation/BidirectionalTypeConverter#convertBack(V)" title="Reference documentation">Java documentation for <code>android.animation.BidirectionalTypeConverter.convertBack(V)</code>.</a>
             </format>
           </para>
           <para>

docs/Mono.Android/en/Android.Animation/BidirectionalTypeConverter.xml

@@ -95,12 +95,12 @@
         <Parameter Name="reuseArray" Type="System.Single[]" />
       </Parameters>
       <Docs>
-        <param name="reuseArray">To be added.</param>
-        <summary>Create a FloatArrayEvaluator that does not reuse the animated value.</summary>
+        <param name="reuseArray">The array to modify and return from &lt;code&gt;evaluate&lt;/code&gt;.</param>
+        <summary>Create a FloatArrayEvaluator that reuses &lt;code&gt;reuseArray&lt;/code&gt; for every evaluate() call.</summary>
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/animation/FloatArrayEvaluator#FloatArrayEvaluator()" title="Reference documentation">Java documentation for <code>android.animation.FloatArrayEvaluator.FloatArrayEvaluator()</code>.</a>
+              <a href="https://developer.android.com/reference/android/animation/FloatArrayEvaluator#FloatArrayEvaluator(float[])" title="Reference documentation">Java documentation for <code>android.animation.FloatArrayEvaluator.FloatArrayEvaluator(float[])</code>.</a>
             </format>
           </para>
           <para>

docs/Mono.Android/en/Android.Animation/FloatArrayEvaluator.xml

@@ -76,7 +76,7 @@
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/animation/TypeEvaluator#evaluate(float,%20java.lang.Object,%20java.lang.Object)" title="Reference documentation">Java documentation for <code>android.animation.TypeEvaluator.evaluate(float, java.lang.Object, java.lang.Object)</code>.</a>
+              <a href="https://developer.android.com/reference/android/animation/TypeEvaluator#evaluate(float,%20T,%20T)" title="Reference documentation">Java documentation for <code>android.animation.TypeEvaluator.evaluate(float, T, T)</code>.</a>
             </format>
           </para>
           <para>

docs/Mono.Android/en/Android.Animation/ITypeEvaluator.xml

@@ -95,12 +95,12 @@
         <Parameter Name="reuseArray" Type="System.Int32[]" />
       </Parameters>
       <Docs>
-        <param name="reuseArray">To be added.</param>
-        <summary>Create an IntArrayEvaluator that does not reuse the animated value.</summary>
+        <param name="reuseArray">The array to modify and return from &lt;code&gt;evaluate&lt;/code&gt;.</param>
+        <summary>Create an IntArrayEvaluator that reuses &lt;code&gt;reuseArray&lt;/code&gt; for every evaluate() call.</summary>
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/animation/IntArrayEvaluator#IntArrayEvaluator()" title="Reference documentation">Java documentation for <code>android.animation.IntArrayEvaluator.IntArrayEvaluator()</code>.</a>
+              <a href="https://developer.android.com/reference/android/animation/IntArrayEvaluator#IntArrayEvaluator(int[])" title="Reference documentation">Java documentation for <code>android.animation.IntArrayEvaluator.IntArrayEvaluator(int[])</code>.</a>
             </format>
           </para>
           <para>

docs/Mono.Android/en/Android.Animation/IntArrayEvaluator.xml

@@ -237,8 +237,7 @@
       </ReturnValue>
       <Docs>
         <summary>Gets the optional interpolator for this Keyframe. -or- Sets the optional interpolator for this Keyframe.</summary>
-        <value>The optional interpolator for this Keyframe.</value>
-        <value>The optional interpolator for this Keyframe.</value>
+        <returns>The optional interpolator for this Keyframe.</returns>
         <remarks>
           <para>Property getter documentation:</para>
           <para>
@@ -361,18 +360,17 @@
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="value">The value that the object will animate to as the animation time approaches
- the time in this keyframe, and the the value animated from as the time passes the time in
- this keyframe.
-</param>
         <param name="fraction">The time, expressed as a value between 0 and 1, representing the fraction
             of time elapsed of the overall animation duration.</param>
-        <summary>Constructs a Keyframe object with the given time.</summary>
+        <param name="value">The value that the object will animate to as the animation time approaches
+            the time in this keyframe, and the value animated from as the time passes the time in
+            this keyframe.</param>
+        <summary>Constructs a Keyframe object with the given time and value.</summary>
         <returns>To be added.</returns>
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/animation/Keyframe#ofFloat(float)" title="Reference documentation">Java documentation for <code>android.animation.Keyframe.ofFloat(float)</code>.</a>
+              <a href="https://developer.android.com/reference/android/animation/Keyframe#ofFloat(float,%20float)" title="Reference documentation">Java documentation for <code>android.animation.Keyframe.ofFloat(float, float)</code>.</a>
             </format>
           </para>
           <para>
@@ -450,18 +448,17 @@
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="value">The value that the object will animate to as the animation time approaches
- the time in this keyframe, and the the value animated from as the time passes the time in
- this keyframe.
-</param>
         <param name="fraction">The time, expressed as a value between 0 and 1, representing the fraction
             of time elapsed of the overall animation duration.</param>
-        <summary>Constructs a Keyframe object with the given time.</summary>
+        <param name="value">The value that the object will animate to as the animation time approaches
+            the time in this keyframe, and the value animated from as the time passes the time in
+            this keyframe.</param>
+        <summary>Constructs a Keyframe object with the given time and value.</summary>
         <returns>To be added.</returns>
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/animation/Keyframe#ofInt(float)" title="Reference documentation">Java documentation for <code>android.animation.Keyframe.ofInt(float)</code>.</a>
+              <a href="https://developer.android.com/reference/android/animation/Keyframe#ofInt(float,%20int)" title="Reference documentation">Java documentation for <code>android.animation.Keyframe.ofInt(float, int)</code>.</a>
             </format>
           </para>
           <para>
@@ -539,18 +536,17 @@
         <Parameter Name="value" Type="Java.Lang.Object" />
       </Parameters>
       <Docs>
-        <param name="value">The value that the object will animate to as the animation time approaches
- the time in this keyframe, and the the value animated from as the time passes the time in
- this keyframe.
-</param>
         <param name="fraction">The time, expressed as a value between 0 and 1, representing the fraction
             of time elapsed of the overall animation duration.</param>
-        <summary>Constructs a Keyframe object with the given time.</summary>
+        <param name="value">The value that the object will animate to as the animation time approaches
+            the time in this keyframe, and the value animated from as the time passes the time in
+            this keyframe.</param>
+        <summary>Constructs a Keyframe object with the given time and value.</summary>
         <returns>To be added.</returns>
         <remarks>
           <para>
             <format type="text/html">
-              <a href="https://developer.android.com/reference/android/animation/Keyframe#ofObject(float)" title="Reference documentation">Java documentation for <code>android.animation.Keyframe.ofObject(float)</code>.</a>
+              <a href="https://developer.android.com/reference/android/animation/Keyframe#ofObject(float,%20java.lang.Object)" title="Reference documentation">Java documentation for <code>android.animation.Keyframe.ofObject(float, java.lang.Object)</code>.</a>
             </format>
           </para>
           <para>