Clean up views.api.php and update for D8

I started by simply making it core-compatible. Next removing hooks that don't exist anymore, along with all references to them elsewhere.

[lorentz:views | Wed 11:41:43] $ grep -r "_views_plugins(" *
lib/Drupal/views/Plugin/views/access/AccessPluginBase.php: * @see hook_views_plugins()
lib/Drupal/views/Plugin/views/argument_default/ArgumentDefaultPluginBase.php: * @see hook_views_plugins()
lib/Drupal/views/Plugin/views/argument_validator/ArgumentValidatorPluginBase.php: * @see hook_views_plugins()
lib/Drupal/views/Plugin/views/cache/CachePluginBase.php: * @see hook_views_plugins()
lib/Drupal/views/Plugin/views/display/DisplayPluginBase.php: * @see hook_views_plugins()
lib/Drupal/views/Plugin/views/exposed_form/ExposedFormPluginBase.php: * @see hook_views_plugins()
lib/Drupal/views/Plugin/views/pager/PagerPluginBase.php: * @see hook_views_plugins()
lib/Drupal/views/Plugin/views/row/RowPluginBase.php: * @see hook_views_plugins()
lib/Drupal/views/Plugin/views/style/StylePluginBase.php: * @see hook_views_plugins()
views.api.php: * Plugins are registered by implementing hook_views_plugins() in your
views.api.php: * For examples please look at views_views_plugins() in
views.api.php:function hook_views_plugins() {
views.api.php: * @see hook_views_plugins()
views.module: * 'contextual_links_locations' properties in hook_views_plugins() and
views.module: *   also need to use hook_views_plugins() or hook_views_plugins_alter() to
views.module: * @see hook_views_plugins()

Removing references to hook_views_plugins() also means updating the the generic plugin documentation. I'm mostly punting on that for now. Followup tasks:

• Include more detailed documentation on what goes in annotations.
• Potentially @ingroup views_plugin to all our goddamn plugin classes. :)
• Move information about plugin options to the appropriate base classes.
• Additional examples.

I'd like a review on this before I commit it since it involves several actual docs changes. The lines about the plugin options were just cut from the hook_views_plugins() docblock and moved up to the defgroup; I haven't proofread them. We can do that later when we move them to the right place.

Removing the old plugin options stuff as well; @timplunkett suggested that we should just rewrite it from scratch, so we can do that when we improve the plugin docs later.

Alright, #3 is committed.

Working on the rest.

I pushed updates to the the handler and plugin defgroups; I'd appreciate it if someone could review them.

I think there's still several more hook docblocks I need to check.

Er, to clarify, they're in 8.x-3.x:
http://drupalcode.org/project/views.git/blob/refs/heads/8.x-3.x:/views.a...

Well, there's an @todo to add examples eventually, but maybe an explicit "Look in the lib/Drupal/views/Plugin/Views" folder would help?

Re: 80 characters, when the line contains only something that can't be broken onto multiple lines, it's the only time it's okay to go over 80 characters.

I'll remove the stale references.

Started pulling on the spaghetti that is hook_views_data() this morning. hook_views_data() and hook_views_data_alter()

• are ONLY invoked from funky little helper _views_fetch_data_build() in cache.inc
• which is ONLY called from _views_fetch_data()
• which is wrapped by views_fetch_data()
• which is a procedural function, but is called in ViewExecutable::initQuery() and any number of base plugins and handlers, as well as used for the admin UI.

Alright, views.api.php is all cleaned up now. It still eventually needs more documentation for plugins and on the hook execution order, but as far as I know everything is now correct for D8.

Edit: hook_views_data() might also need some work, but I will file followup issues.