SI-3577 Make varianceInType aware of BoundedWildcardType.
Make RefChecks#validateVariance aware of BoundedWildcardType.

The only test case that I know for this will be neutered
by the imminent fix for SI-6258; so I haven't been able to
test this.

But trying this manually, you can see that this patch defers the
the SI-6258 to the erasure phase.

Original:

scala.MatchError: ? (of class scala.reflect.internal.Types$BoundedWildcardType)
	at scala.tools.nsc.typechecker.RefChecks$RefCheckTransformer$$anon$3.scala$tools$nsc$typechecker$RefChecks$RefCheckTransformer$$anon$$validateVariance$1(RefChecks.scala:894)
	at scala.tools.nsc.typechecker.RefChecks$RefCheckTransformer$$anon$3.validateVariance(RefChecks.scala:965)

Modified:

java.lang.ClassCastException: scala.reflect.internal.Types$TypeRef$$anon$6 cannot be cast to scala.reflect.internal.Types$TypeBounds
	at scala.reflect.internal.Types$TypeMap.mapOver(Types.scala:4160)
	at scala.reflect.internal.transform.Erasure$ErasureMap.apply(Erasure.scala:156)
Mention BoundedWildcardType in "a standard type pattern match".
Deprecate unmaintained/old classes for removal in 2.11
exposes Symbol.children

As requested in http://stackoverflow.com/questions/12078366/
adds ClassSymbol.baseClasses

Sure this stuff is also declared in Type.baseClasses, but this is
one of the hot paths in reflection (e.g. like ClassSymbol.typeParams),
so I think it's justified to have it as a dedicated method.

Unfortunately we cannot remove Type.baseClasses, because it includes
ridiculously involved calculation of base classes for compound types.
adds Symbol.isJava

Doesn't seem to be inferrable from the API we expose right now
Exposes Symbol.deSkolemize to macros
exposes MethodSymbol.isPrimaryConstructor

Doesn't seem to be inferrable from the API we expose right now
Exposes ToolBox.classLoader

By giving ToolBox.mirror the correct type and constructing the underlying
mirror from a proper classloader, we improve user experience w.r.t
runtime code generation.

Direct motivator: http://stackoverflow.com/questions/12122939, in which
instances of a toolbox-generated class are accessed with Scala reflection.
Fix SI-4581.

Specifically, the final flag on the generated static field
is no longer ommitted.

Fix 2 failing test-cases.
removes AbstractFileApi

no longer necessary, since scala.tools.nsc.io.AbstractFile
has been long moved to scala-reflect.jar
rehash of source file information for Symbol

Symbol.pos is moved to macros.Universe, because it's empty at runtime.

Also added Symbol.associatedFile, because it has valid usages during runtime.
When reflecting one might want to get to a classfile of the symbol and then
analyze it to e.g. decompile the bytecode or find out the associated src file.
Exposes Symbol.sourceModule

As discussed, this is not the best API to expose, because this is an
implementation detail that might change.

However the ship has sailed. We're already imposing
the moduleClass <-> sourceModule quirk to the users of our API:
Evidence: http://stackoverflow.com/questions/12128783.

There are reflection tasks that cannot be pulled without the knowledge
of this implementation detail, so we shouldn't pretend that we can
change it on a whim and not break anything.

Hence I propose to add sourceModule to the public contract
and bear the potential consequences.
definitive way to learn if a symbol is a val/var

I think `isVal` and `isVar` are the right names, because they
exactly map on Scala syntax.
Fix SI-6294.
Two fixes for the worksheet instrumenter

(1) Handle empty worksheets
(2) Handle for expressions

Review by @dragos
Removed dead code.
Made instrumenter more robust by looking at tokens

Made instrumenter more robust by taking into account the positions of the tokens in the source. This allows us to reliably put instrumentation code at the end of the previous token, which tends to put it at end of lines. Furthermore, we now skip left parents. Previously, the instrumenter got confused for a statement like

( x + 1 )

because it thought that the statement started at the `x` and not at the `(`.

Another small change is that we now use decoded names in the worksheet. So ??? will show as ??? not $qmark$qmark$qmark.
Removed previosuly uncommented code, added more diagnosis output to REPL.