fix docs about docs.

I wanted to make sure a fix to 'goal markdown' didn't break 'goal confluence'.
So I had to get 'goal confluence' working. Along the way, figured out our
instructions were wrong, d'oh

Testing Done:
published a couple of pages to a wiki.

Bugs left over: 395

Bugs closed: 385, 387

Reviewed at https://rbcommons.com/s/twitter/r/730/
missing dep

Travis-CI had a sad. This updated dep makes Travis-CI happy.

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

Reviewed at https://rbcommons.com/s/twitter/r/748/
Upgrade to twitter.common.python 0.6.0 and adjust to api change.

This came up over here: https://rbcommons.com/s/twitter/r/737/

Testing Done:
$ ./build-support/bin/ci.sh

Bugs closed: 394

Reviewed at https://rbcommons.com/s/twitter/r/746/
First attempt for issue https://github.com/pantsbuild/pants/issues/326

End pants users arguably see no values from the stack trace (even if they occasionally do, they can use the reporting server log); but in PANTS_DEV mode, pants dev should see the stack. The change is to introduce a command line arg that pants bash script will pass to pants_exe if PANTS_DEV is set. And in pants_exe we setup an unhandled exception hook to print out the exception's stacktrace plus msg based on the cmdline arg's presence.

Testing Done:
17:04:04 05:01     [specs]
               Waiting for background workers to finish.
               SUCCESS
$ ./pants goal test tests::

Bugs closed: 326

Reviewed at https://rbcommons.com/s/twitter/r/655/
Get rid of code in scm/__init__.py.

Having code in __init__.py is bad practice in pants-world, due to possible
dependency issues: __init__.py is always executed when any code in a package
is loaded, even if that code has no visible import dependency on __init__.py,
and therefore no BUILD file dependency on it.
Get rid of code in distribution/__init__.py.
Remove last non-empty __init__.py file.

We no longer have namespace issues with tests/python/pants_test.
Restore namespace package to src/python/pants/__init__.py.

It turns out to be needed after all.

This reverts the salient part of commit 583eed04142a0aaa9afd525c178b834373f5ef22.
Release 0.0.20 with updated twitter.common.python dep.

This also adds a CHANGELOG.rst and incorporates it in
releases via the setup.py long_description field. Release
docs are updated to point out this file needs to be edited
along with the version.py when prepping a release.

Testing Done:
1) verify the long_description addition is going to work:
==
$ PANTS_DEV=1 ./pants setup_py src/python/pants:pants-packaged
*** Running pants in dev mode from /home/jsirois/dev/3rdparty/jsirois-pants/src/python/pants/bin/pants_exe.py ***
WARNING!  /home/jsirois/dev/3rdparty/jsirois-pants/dist/pantsbuild.pants.YHc2bE/src/pants/docs/conf.py is source but does not belong to a package!
WARNING!  /home/jsirois/dev/3rdparty/jsirois-pants/dist/pantsbuild.pants.YHc2bE/src/pants/docs/pagerank.py is source but does not belong to a package!
Running packager against /home/jsirois/dev/3rdparty/jsirois-pants/dist/pantsbuild.pants-0.0.20
Writing /home/jsirois/dev/3rdparty/jsirois-pants/dist/pantsbuild.pants-0.0.20.tar.gz
$ cd dist/ && tar -xzf pantsbuild.pants-0.0.20.tar.gz && cd pantsbuild.pants-0.0.20

# The concat of ABOUT.rst and CHANGELOG.rst is effective:
$ python setup.py --long-description
Pants is an Apache2 licensed build tool written in Python.

The latest documentation can be found `here <http://pantsbuild.github.io/>`_.

RELEASE HISTORY
===============

0.0.20 (7/25/2014)
------------------

API Changes
~~~~~~~~~~~

* Hide stack traces by default
  `Issue #326 <https://github.com/pantsbuild/pants/issues/326>`_
  `RB #655 <https://rbcommons.com/s/twitter/r/655/>`_
...

2) burn the new release docs: http://pantsbuild.github.io/jsirois/release.html

Bugs closed: 396

Reviewed at https://rbcommons.com/s/twitter/r/754/
Add a check to verify that all* __init.py__ files are empty.

*With one exception!

Reviewed at https://rbcommons.com/s/twitter/r/757/
Include java_sources in targets.
the final target set returned by context.targets() was not considering targets that weren't specified in the "dependencies" of thescala_library. In this case, a target was specified using "scala_library:java_sources" which was being dropped. This in turn was causing idea not to load the project with the java sources it should have had.

Modified ScalaLibrary to return its own implementation of closure()
which includes java_sources.

Testing Done:
1) $./pants goal idea src/scala/com/pants/testproject/javasources::
2) https://travis-ci.org/pantsbuild/pants/builds/30893765

Bugs closed: 390

Reviewed at https://rbcommons.com/s/twitter/r/733/
Fixup broken release script - avoid escaping issues and just duplicate the setup_py call for now.

Testing Done:
Used this to release https://pypi.python.org/pypi/pantsbuild.pants/0.0.20

Bugs closed: 398

Reviewed at https://rbcommons.com/s/twitter/r/761/
Merge branch 'master' of https://github.com/pantsbuild/pants
Fixup NailgunTasks with missing config_section overrides.

Update version and CHANGELOG in prep for a release for twitter/commons consumption.

Testing Done:
Travis CI went green here: https://travis-ci.org/pantsbuild/pants/builds/30896650

Bugs closed: 399

Reviewed at https://rbcommons.com/s/twitter/r/762/
Plumb ivysettings.xml location to the publish template.

Testing Done:
1.) tests including publish integration
==
$ PANTS_DEV=1 ./pants goal test tests/python/pants_test/::

2.) local publish
==
$ yes | PANTS_DEV=1 ./pants goal publish src/{java,scala}:: --no-publish-dryrun --publish-local=/tmp/repo --doc-javadoc-ignore-failure --doc-scaladoc-ignore-failure

Bugs closed: 400

Reviewed at https://rbcommons.com/s/twitter/r/764/
Fix a scope bug for java agent manifest writing.

Also fix a JavaAgent validation bug revelead by adding a test for
JarBuilder agent handling.

Testing Done:
$ PANTS_DEV=1 ./pants goal test tests/python/pants_test/tasks/:jar_task --test-pytest-options=-v
...
18:05:24 00:01   [test]
18:05:24 00:01     [pytest]
18:05:24 00:01       [run]
                     ============== test session starts ===============
                     platform linux2 -- Python 2.6.9 -- py-1.4.22 -- pytest-2.5.2 -- /usr/bin/python2.6
                     plugins: cov, timeout
                     collected 6 items

                     tests/python/pants_test/tasks/test_jar_task.py:111: JarTaskTest.test_custom_manifest PASSED
                     tests/python/pants_test/tasks/test_jar_task.py:86: JarTaskTest.test_overwrite_write PASSED
                     tests/python/pants_test/tasks/test_jar_task.py:102: JarTaskTest.test_overwrite_writestr PASSED
                     tests/python/pants_test/tasks/test_jar_task.py:57: JarTaskTest.test_update_write PASSED
                     tests/python/pants_test/tasks/test_jar_task.py:73: JarTaskTest.test_update_writestr PASSED
                     tests/python/pants_test/tasks/test_jar_task.py:133: JarBuilderTest.test_agent_manifest PASSED

                     ============ 6 passed in 1.27 seconds ============

18:05:26 00:03     [junit]
18:05:26 00:03     [specs]
               SUCCESS

Bugs closed: 401

Reviewed at https://rbcommons.com/s/twitter/r/768/
Upgrade requests, flip to a ranged requirement to help plugins.

Changelog here: https://pypi.python.org/pypi/requests
I grepped for DecodeError which we do not trap and the rest of the API Changes are additive for our use cases.

Testing Done:
The requests library is used by src/python/pants/cache/restful_artifact_cache.py and src/python/pants/net/http/fetcher.py, this validates the fetcher.py use:
==
$ rm -rf ~/.pants.d/tools
$ PANTS_DEV=1 ./pants goal resolve 3rdparty/:guava
...
21:28:52 00:00   [resolve]
21:28:52 00:00     [ivy] INFO]
Downloading http://repo1.maven.org/maven2/org/apache/ivy/ivy/2.3.0/ivy-2.3.0.jar
 INFO] Starting new HTTP connection (1): repo1.maven.org
100% .................................................. 1193 KB 10.480s
 INFO] sha1: c5ebf1c253ad4959a29f4acfe696ee48cdd9f473

21:29:02 00:10       [ivy-bootstrap]
21:29:03 00:11       [ivy-resolve]
21:29:03 00:11         [ivy]
               SUCCESS

Bugs closed: 404

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