[mono-api-html] Expand "ignore" functionality (#7154) #7175
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Context: dotnet/android#1078
xamarin-android uses
mono-api-htmlandmono-api-infoin order toperform API comparisons; see e.g. 4e45904.
A recent problem has arisen regarding "inter-API-level diffs": there
are many API changes which we consider to be acceptable, and thus
would like to ignore. Unfortunately,
mono-api-htmldoesn't supportignoring many of these constructs, e.g. base class changes:
and property type changes:
Overhaul the
mono-api-html"ignore" infrastructure:Introduce ignore "scoping". Previously, the ignore options would
only match the member text against any provided regular
expression. Thus,
mono-api-html -r ToStringwould ignore allmembers containing
ToString. Furthermore, there was no way torestrict the ignore to a particular type. Expand the regex
semantics so that the declaring type is used as a "prefix" for the
to-be-matched text. For example, if a class
Exampleis removed,mono-api-htmlwill now match the following value against any-rregular expressions:Add a
mono-api-html -voption, to control output verbosity.When specified,
mono-api-htmlwill print out available-r/etc.option values:
Additionally, allow
mono-api-htmlto take aMono.Options.ResponseFileSource, which allows@response-filestobe used as command-line options.