Clarifies findWord doc
Creates a generic preference page for syntax colouring

With some initial reorganization of code.
Cleans up ScalaSyntaxClass
Creates an API for the syntax parsing support

The API classes were split of the implementation and moved in core.lexical.
Makes RegionUtils part of the API

Moves to util.eclipse
Adds documentation
Adds/updates tests
Improves code scanners and partitioners doc
Merge pull request #811 from skyluc/issue/API-Syntax

Issue/api syntax
Remove the hard-coded InteractiveCompilationUnit from `ScalaHover`

The associated compilation unit may change (see #1002251) when the editor
is reused. On top of that, the structured editor in the Play plugin needs
a no-arg constructor (it’s instantiated through an extension point).

This change allows the Play plugin to use plain Scala hovers, including
all the goodies (configured font and CSS, scaladoc, etc).
Allow for dot in extension for SourceFileProvider registry.

Play templates are not just `html`, but `scala.html`. This change allows
one to declare a source file provider for them. Unfortunately, this makes
lookup linear in the number of providers, but hopefully that’s not a big
deal (so far we only have two).
A number of changes in the compilation unit APIs.

- added default implementations for a number of ICU methods. These are
  tricky aspects (like initial reconcile and scheduleReconcile) that are
  unlikely to change, and the compiler relies on a certain protocol
- added a `ScalaCompilationProblem` case class, extending the Java `IProblem`.
  This allows finer control over how errors are reported
- added the concept of a source map. This is how any compilation unit is
  translated to Scala, and provides way to translate positions back and
  forth.
- updated usages of compilation units to go through the mapping functions
- added a self-type, fixing the dispatch order for ask-methods to go again
  through `flushScheduledReloads`
- fixed the hyperlink selection region for operator names (it used to
  be according to the encoded name).
No more printlns!
Fix NPE in attached sources, and make Hovers aware of source maps.

- expanded and corrected documentation about source maps and related methods.
- removed one instance of ⇒ that made Eclipse go nuts in that file (line spacing
  was increased, see [206740](https://bugs.eclipse.org/bugs/show_bug.cgi?id=206740)
Merge pull request #812 from dragos/api/refactor-compilation-unit

Refactor the way compilation units work
Fix formatting (unclosed markup), now that we have Scala doc.
Move `getOption` out of `asyncExec`, since this leads to a deadlock.

The deadlock is broken by a timeout after 10 seconds, but the problem remains,
and is especially annoying when waiting for a quick fix.
Cleaned up Scala hovers and moved editor classes in the API packages.