plugins

Mark services with `@Service`, and reference them via path in the model

Also fixes rule-cycles in Android plugin.

+review REVIEW-5640

Make it explicit in the docs that PluginManager.withPlugin() actions fire after the plugin has been applied.

+review REVIEW-5420

Don't need PluginManager to be extensible.

+review REVIEW-5369

Added PluginManager to the DSL reference

Javadocs.

Javadocs.

Change rule source marking from annotation to base class

+review REVIEW-5359

Fix a javadoc sample

Remove AppliedPlugins and make PluginManager the public replacement for PluginContainer.

+review REVIEW-5298

Don't deprecate any of PluginContainer.

+review REVIEW-5298

Some changes to detangle some service and DSL objects when applying plugins:

- Added PluginAwareInternal to provide access to the PluginManager for a target object

- Use this in DefaultObjectConfigurationAction to apply plugins using a PluginManager, for `apply plugin: ...` DSL usages.

- Use this in DefaultPluginRequestApplicator to apply plugins using a PluginManager, for `plugins { ... }` DSL usage.

Clean up of API docs for PluginAware and AppliedPlugin.

+review REVIEW-5214

Annotate deprecated methods with @java.lang.Deprecated

+review REVIEW-5239

Imports.

+review REVIEW-5214

Deprecate all mutative methods of PluginContainer

+review REVIEW-5239

Add PluginAware(Action).

+review REVIEW-5214

Make withId(), hasPlugin() etc. work for qualified and unqualified “privileged” names regardless of how the plugin was applied.

+review REVIEW-5214

Deprecate PluginContainer.apply(Class) and PluginContainer.apply(String)

+review REVIEW-5239

Collapse AppliedPlugins into PluginAware.

+review REVIEW-5214

Improvements to dealing with ID-less plugins and general polishing.

+review REVIEW-5214

Centralise detection/handling of different types of plugins.

+review REVIEW-5214

Add ability to query for plugins and rule sources by id

+review REVIEW-5214

Intorduce PluginAwareInternal and AppliedPlugins interfaces

+review REVIEW-5214