Document new matching behavior.

Refs cakephp/cakephp#5410
[fr] matching behavior
Merge pull request #2143 from cakephp/matching

Document new matching behavior.