Cleaned up and brought up to date the help text...

Cleaned up and brought up to date the help text for -X and -Y options.
Made some enhancements to PhasesSetting, which are documented if you
run scalac -X or -Y. (Try it!) Disabled some dead settings and renamed
others to reflect their current purpose. No review.

1 files changed, 27 insertions, 25 deletions

diff --git a/test/files/run/programmatic-main.check b/test/files/run/programmatic-main.check
index 6cf6fa8ca6..b2c2b8546d 100644
--- a/test/files/run/programmatic-main.check
+++ b/test/files/run/programmatic-main.check
@@ -1,26 +1,28 @@
-        parser  parse source into ASTs, perform simple desugaring
-         namer  resolve names, attach symbols to named trees
-packageobjects  load package objects
-         typer  the meat and potatoes: type the trees
-superaccessors  add super accessors in traits and nested classes
-       pickler  serialize symbol tables
-     refchecks  reference and override checking, translate nested objects
-      liftcode  reify trees
-       uncurry  uncurry, translate function values to anonymous classes
-     tailcalls  replace tail calls by jumps
-    specialize  @specialized-driven class and method specialization
- explicitouter  C.this refs become outer pointers, translate pattern matches
-       erasure  erase types, add interfaces for traits
-      lazyvals  allocate bitmaps, translate lazy vals into lazified defs
-    lambdalift  move nested functions to top level
-  constructors  move field definitions into constructors
-       flatten  eliminate inner classes
-         mixin  mixin composition
-       cleanup  platform-specific cleanups, generate reflective calls
-         icode  generate portable intermediate code
-       inliner  optimization: do inlining
-      closelim  optimization: eliminate uncalled closures
-           dce  optimization: eliminate dead code
-           jvm  generate JVM bytecode
-      terminal  The last phase in the compiler chain
+    phase name  id  description
+    ----------  --  -----------
+        parser   1  parse source into ASTs, perform simple desugaring
+         namer   2  resolve names, attach symbols to named trees
+packageobjects   3  load package objects
+         typer   4  the meat and potatoes: type the trees
+superaccessors   5  add super accessors in traits and nested classes
+       pickler   6  serialize symbol tables
+     refchecks   7  reference and override checking, translate nested objects
+      liftcode   8  reify trees
+       uncurry   9  uncurry, translate function values to anonymous classes
+     tailcalls  10  replace tail calls by jumps
+    specialize  11  @specialized-driven class and method specialization
+ explicitouter  12  this refs to outer pointers, translate patterns
+       erasure  13  erase types, add interfaces for traits
+      lazyvals  14  allocate bitmaps, translate lazy vals into lazified defs
+    lambdalift  15  move nested functions to top level
+  constructors  16  move field definitions into constructors
+       flatten  17  eliminate inner classes
+         mixin  18  mixin composition
+       cleanup  19  platform-specific cleanups, generate reflective calls
+         icode  20  generate portable intermediate code
+       inliner  21  optimization: do inlining
+      closelim  22  optimization: eliminate uncalled closures
+           dce  23  optimization: eliminate dead code
+           jvm  24  generate JVM bytecode
+      terminal  25  The last phase in the compiler chain