Don't highlight 'goal eclipse' in the first Pants Tutorial

In hindsight, the ide-gen goals are not so exemplary.

Bugs closed: 708

Reviewed at https://rbcommons.com/s/twitter/r/1315/
Add java_sources to the depmap-info.

More context:
Ity added this diff long long ago https://rbcommons.com/s/twitter/r/733 to include java_sources in self.context which had some performance issues.

I went ahead and removed it https://rbcommons.com/s/twitter/r/1130.
We relied on java_sources to be already present in self.targets for depmap goal.

This diff fixes the issue where for a scala target owning java_sources, the java_target is included in depmap output under targets found.

Without this patch, the java_sources is mising from targets but is present in targets['examples/src/scala/com/pants/example/scala_with_java_sources:scala_with_java_source']['targets']

[tw-172-25-146-131 pants]$ ./pants goal depmap --depmap-project-info examples/src/scala/com/pants/example/scala_with_java_sources:
*** Running pants in dev mode from /Users/tdesai/projects/pants/src/python/pants/bin/pants_exe.py ***
{
    "libraries": {},
    "targets": {
        "examples/src/scala/com/pants/example/scala_with_java_sources:scala_with_java_sources": {
            "libraries": [
                "org.scala-lang:scala-library:2.9.3"
            ],
            "is_code_gen": false,
            "targets": [
                ":scala-library-2.9.3",
                "examples/src/java/com/pants/examples/java_sources:java_sources"
            ],
            "roots": [
                {
                    "source_root":   "/Users/tdesai/projects/pants/examples/src/scala/com/pants/example/scala_with_java_sources",
                    "package_prefix": "com.pants.example.scala_with_java_sources"
                }
            ],
            "target_type": "SOURCE"
        },

        "examples/src/java/com/pants/examples/java_sources:java_sources": {
            "libraries": [],
            "is_code_gen": false,
            "targets": [],
            "roots": [
                {
                    "source_root": "/Users/tdesai/projects/pants/examples/src/java/com/pants/examples/java_sources",
                    "package_prefix": "com.pants.examples.java_sources"
                }
            ],
            "target_type": "SOURCE"
        },
        ":scala-library-2.9.3": {
            "libraries": [],
            "is_code_gen": false,
            "targets": [],
            "roots": [],
            "target_type": "SOURCE"
        }
    }
}

Testing Done:
yes.

./pants tests/python/pants_test/tasks:depmap_integration

and
./pants tests/python/pants_test/tasks:depmap

pass

CI:
https://travis-ci.org/pantsbuild/pants/builds/40829185

Reviewed at https://rbcommons.com/s/twitter/r/1324/
publish docs the new way

mv publish_docs_new.sh publish_docs.sh ; rm src/python/pants/docs/*.rst , other Sphinx things

the parts I only halfway-understood, listed in order of rising scariness:

Did some clean-up in our scripts:
rm'd sphinx things from 3rdparty/python/dev_only_requirements.txt . which was all of it so...
rm'd 3rdparty/python/dev_only_requirements.txt
rm'd DEV_REQUIREMENTS from pants_venv
rm'd reference to DEV_REQUIREMENTS from ./pants , use REQUIREMENTS instead.

There might have been other cleanup possible. Backed off from some possible
changes that got into gnarly territory.

Testing Done:
https://travis-ci.org/pantsbuild/pants/builds/40938680

./build-support/bin/publish_docs.sh -opd sitegen-test

for the ./pants change:
export WRAPPER_REQUIREMENTS="tmp_requirements.txt" # file with one line: scrapy
in some temporarily-added pants code, from scrapy import Spider, Item, Field
worked OK. (and correctly errored out in another shell that didn't have WRAPPER_REQUIREMENTS set)

Reviewed at https://rbcommons.com/s/twitter/r/1292/
Remove legacy flag support from new options.

We no longer need it now that we're on the new parser.

Removed a couple of legacy= kwargs, to prove that things still work.
Future changes will clean up the remaining kwargs from option registrations.

Testing Done:
Integration and unit tests passed.

Full CI baking.

Reviewed at https://rbcommons.com/s/twitter/r/1328/