commands: remove some commented-out code

This removes some commented-out code, which appears to have been only
for debugging. This code was also causing pep8 errors with later
versions (v1.5-ish) of pep8. The errors I saw when running `tox -e pep8`
were as follows:

zpmlib/commands.py:145:5: E265 block comment should start with '# '
zpmlib/commands.py:146:5: E265 block comment should start with '# '
zpmlib/commands.py:147:5: E265 block comment should start with '# '
Merge pull request #61 from larsbutler/remove-commented-code

commands: remove some commented-out code
doc: add stub page about the zar.json file
doc: document sections in zar.json
doc: start a glossary
doc: reference zar.json section from intro
post_job: take job object instead of low-level JSON str
Merge pull request #58 from mgeisler/zar-json-doc

Document the zar.json format
Merge pull request #59 from mgeisler/post-job

post_job: take job object instead of low-level JSON str
zpm,commands: create_project returns zar.json path

The `zpm.create_project` function now return the full zar.json path,
which allows the command line interface to notify the user that the file
was created. We now print the full path, instead of just telling the
user into which directory the file was created. I think this is more
useful and explicit.
test_zpm: update test with _create_zar_json retval

Since this function now returns a value, this change updates the test to
check the return value.
Merge pull request #62 from larsbutler/fix-zpm-new-2

Fix `zpm new` command, part 2