Switch font-lock tests to substring-based face assertions

Add support for ("substring" face) specs alongside the existing
(start end face) positional specs in the test helpers. Substring
specs use sequential search-forward, so repeated substrings resolve
naturally in document order.

Convert most existing and new font-lock tests from opaque numeric
positions to readable substring form, making the tests much easier
to understand and maintain.

Author: bbatsov