Bring back and deprecate `Incremental.incDebugProp`.

The ae15eccd9c7aea2b4336ea454d974aed66d5ec16 accidentally removed
`Incremental.incDebugProp` which broke Scala IDE build that relies on it.

We bring back that val but at the same time we deprecate it because we
have better mechanism for configuring incremental compiler now.

I also added a little comment with the history of `incDebugProp` which
explains proper migration path.
Merge pull request #1076 from gkossakowski/bring-brack-incDebugProp

Bring back and deprecate `Incremental.incDebugProp`.