[mono-api-html] Allow ignoring parameter names, virtual.
authorJonathan Pryor <jonpryor@vt.edu>
Wed, 12 Nov 2014 22:28:48 +0000 (17:28 -0500)
committerJonathan Pryor <jonpryor@vt.edu>
Wed, 12 Nov 2014 22:34:21 +0000 (17:34 -0500)
commit789517f8781bffec2b95ca6e39fba5afe63b0681
treeedbe3faacf7226cb18a113bb724c688eba21d958
parentb486e8372e04fadee01ac36401a1e76e67c9bbfd
[mono-api-html] Allow ignoring parameter names, virtual.

I've been trying to review API diffs in Xamarin.Android between API
levels, but the diffs are "noisy" because Google will change parameter
names at-will, or will change a non-virtual method into a virtual
method, or a virtual method into an override, all of which are
acceptable changes but individually generate a Removed line in
mono-api-html output, and manually removing the *hundreds* of changes
is error-prone.

Add two new option flags to mono-api-html:

  --ignore-changes-parameter-names:
      Ignore changes in constructor and method parameter names.

      If parameter names change between <reference.xml> and
      <assembly.xml>, don't report a change for the constructor or
      method.

  --ignore-changes-virtual:
      Ignore changes in "virtual-ness".

      If a method or property changes from non-virtual to virtual,
      non-virtual to override, or virtual to override, don't report a
      change for the member.
mcs/tools/corcompare/mono-api-html/ApiDiff.cs
mcs/tools/corcompare/mono-api-html/ConstructorComparer.cs
mcs/tools/corcompare/mono-api-html/PropertyComparer.cs