Add pdf version of the documentation

[rjleveque]

To create the pdf:

    cd $CLAW/doc/doc
    make latex
    cd _build/latex
    make
    # then type q when it starts throwing errors that need to be fixed
    pdflatex ClawpackDocs30Nov2014

The last step seems needed to make the TOC properly.

Problems:

• Lots of math errors are thrown.
• Various things should probably be omitted, e.g. gallery?

[ketch]

@rjleveque This has nothing to do with this pull request, but looking through error messages I noticed that I am missing a file doc/doc/git_links.inc. Does this exist locally on your machine? It is not in the repo.

[rjleveque]

@ketch: I just added it.

[ketch]

Thanks. I agree that some parts should be omitted. For instance, the source of all the pyclaw examples, which occupies a huge amount of space. I couldn't find an easy, automatic way to do it. Of course, we could manually edit a copy now and then for release.

[ketch]

Also, the whole "developers guide" section appears twice in the PDF, because the pyclaw documentation links to it in a TOC. It seems desirable to do so in the HTML, since it only produces a hyperlink. But in the PDF it actually duplicates the whole section.

[mandli]

I was browsing through the sphinx documentation for something that would allow us to exclude files or directories based on the output type but could not find anything.

[rjleveque]

I see a way to add additional material at http://sphinx-doc.org/config.html, but not an easy way to omit.

[mandli]

I just noticed this PR, should we merge this?

[rjleveque]

There have been other changes since this PR, in particular we decided to get rid of git_resources.rst, so I'll clean this up before merging.

[rjleveque]

I am closing this for now since I'm about to delete the master branch in view of our new naming conventions, see #188.