Part of meta-issue #1310084: [meta] API documentation cleanup sprint
I assume that we are now in code cleanup phase. I use PhpStorm to find possible bugs and problems in the Drupal 8 core. Normally I will not alter code flow. If I find problems in a file, which I will not fix, but find suspicious. I'll mention it in the text here.
For changes in the PHP Documentation I use this node as guide: http://drupal.org/node/1354
Checked: ajax.inc, authorize.inc (added a @todo), bathc.inc, bootstrap.inc, cache.inc, common.inc file.
There are 3 alterings elsewere in that patch which were connected to my observations.