Failure attempting to build TS docs

[jbonacci]

Was attempting the following:
08:45 < tarek> its in docs/ https://github.com/mozilla-services/tokenserver/tree/master/docs
08:45 < tarek> if you want to build it:
08:46 < tarek> cd docs; SPHINXBUILD=../bin/sphinx-build make html
08:46 < tarek> then you have it in docs/build/html

Was not able to do this from a local install of tokenserver (git clone)

SPHINXBUILD=../bin/sphinx-build make html
../bin/sphinx-build -b html -d build/doctrees source build/html
Running Sphinx v1.1.2
loading pickled environment... done
building [html]: targets for 8 source files that are out of date
updating environment: 0 added, 0 changed, 0 removed
looking for now-outdated files... none found
preparing documents... done
IOError: [Errno 2] No such file or directory: u'../../lib/python2.6/site-packages/docutils-0.8.1-py2.6.egg/docutils/writers/html4css1/html4css1.css'
Unable to open source file for reading ('../../lib/python2.6/site-packages/docutils-0.8.1-py2.6.egg/docutils/writers/html4css1/html4css1.css'). Exiting.
make: *** [html] Error 1

From the "docs" directory:
ls ../../lib/python2.6/site-packages/docutils-0.8.1-py2.6.egg/docutils/writers/html4css1/html4css1.css
ls: cannot access ../../lib/python2.6/site-packages/docutils-0.8.1-py2.6.egg/docutils/writers/html4css1/html4css1.css: No such file or directory

Instead I try this:
ls ../lib/python2.6/site-packages/docutils-0.8.1-py2.6.egg/docutils/writers/html4css1/html4css1.css
../lib/python2.6/site-packages/docutils-0.8.1-py2.6.egg/docutils/writers/html4css1/html4css1.css

That works, so it's looking in the wrong place for docutils?

[rfk]

@jbonacci with #20 I can successfull build the docs, can you please try this again and see if we can close it out?

[jbonacci]

@rfk I should be able to get to this Monday.

[jbonacci]

Nope. Not on Mac anyway. This is what I did/see:

$ cd docs
$ SPHINXBUILD=../bin/sphinx-build make html
../bin/sphinx-build -b html -d build/doctrees   source build/html
Making output directory...
Running Sphinx v1.2

Extension error:
Could not import extension cornice.sphinxext (exception: No module named sphinxext)
make: *** [html] Error 1

[rfk]

you may have to git update I think I changed that import in a recent commit

[rfk]

Ah, it hasn't landed yet, #20

[jbonacci]

"git pull" did not fix the issue...

[jbonacci]

Gotcha... will wait...

[jbonacci]

Hmmm... latest everything on AWS rhel.
I see this:
$ cd docs
[ec2-user@ip-10-225-137-232 docs]$ SPHINXBUILD=../bin/sphinx-build make html
../bin/sphinx-build -b html -d build/doctrees source build/html
Making output directory...
Running Sphinx v1.2

Extension error:
Could not import extension cornice.ext.sphinxext (exception: No module named importlib)
make: *** [html] Error 1

[jbonacci]

Aha! But this does work on Mac!
So, Linux issue.
I will try another flavor of Linux before closing this out...

[jbonacci]

Results for SciLinux 6.4: same as for AWS rhel:
$ SPHINXBUILD=../bin/sphinx-build make html
../bin/sphinx-build -b html -d build/doctrees source build/html
Making output directory...
Running Sphinx v1.2

Extension error:
Could not import extension cornice.ext.sphinxext (exception: No module named importlib)
make: *** [html] Error 1

[rfk]

Likely a python2.6/python2.7 difference that's causing the error.

[jbonacci]

Works on AWS ubuntu which is 2.7 also.