Expand @deprecated docblocks in EntityManager.php

Pasted from IRC:

not sure, referencing them all would be the safe option, something like to clear cached entity types, use X, to clear cached entity bundle information, use X. to clear entity field definitions, use X. actually, the last can be left out, if anything then that's something that needs to happen automatically when caches are cleared, not a public api
also, the onX methods are event listeners, not an API that should be called directly, so IMHO, they don't really to have replacement information

Forget that, I think this is fine as it is.

The additional calls are all depending data on the entity type definitions and they should somehow listen to that cache clear and re-act to it and the previously public method have their own deprecated documentation.

I just checked and the patch applies and appears to have the right format with a good reason to think it's good from Berdir.

Sounds like an RTBC.

We are in the process of adding @see links to these as well, so it would be appropriate to do it here I think instead of needing to change all of them again. The @see would be a URL to the change record where this change was made.

Here's the CR link https://www.drupal.org/node/2549139

Thanks, @vegantriathlete for rerolling the patch. We're near to RTBC. only few nitpicks needs to be addressed

+++ b/core/lib/Drupal/Core/Entity/EntityManager.php
@@ -25,6 +25,9 @@ class EntityManager implements EntityManagerInterface, ContainerAwareInterface {
+   * @see https://www.drupal.org/node/2549139

Add the @see statement after the Use and add a new line space b/w @see and Use. We need to change it across all places.

//Naveen

Here is an updated patch which implements #10

Thanks, @Dinesh18! This is the first Quickfix of the month which I'm RTBCing

//Naveen

Thanks for the update, now this looks much more complete :)

Missed some: #2897015: EntityManager class/method @deprecation is incomplete

Also, this fix turns #2873798: Add Change record to @deprecated for EntityManager into a duplicate and really belongs under #2873705: Add change records to all @deprecated code