pants doc gen: fix up relative paths that assumed "twitter/pants" (vs…

… "pants")

also added a shebang line for easier invokes

src/python/pants/docs/conf.py

@@ -22,7 +22,7 @@
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 sys.path.insert(0, os.path.abspath('../../..'))
 
-pants_egg_dir = os.path.abspath('../../../../../.pants.d/python/eggs')
+pants_egg_dir = os.path.abspath('../../../../.pants.d/python/eggs')
 if not os.path.exists(pants_egg_dir):
   raise RuntimeError(''.join([
     'Pants egg dependencies do not exist! Please build pants before ',

src/python/pants/docs/gen.py

@@ -1,3 +1,4 @@
+#!/usr/bin/env python
 # Copyright 2014 Pants project contributors (see CONTRIBUTORS.md).
 # Licensed under the Apache License, Version 2.0 (see LICENSE).
 
@@ -58,7 +59,7 @@ def gen_base_reference(rst_filename, dirname):
 def copy_builddict(docs_dir):
   for filename in ['build_dictionary.rst', 'goals_reference.rst']:
     filepath = os.path.abspath(os.path.join(docs_dir,
-        '../../../../../dist/builddict', filename))
+        '../../../../dist/builddict', filename))
     try:
       shutil.copy(filepath, docs_dir)
     except IOError as e: