Readme.rst updated with link to deployment.rst
Merge pull request #276 from sant0sh/master

Readme.rst updated with link to deployment.rst
Expand deployment documentation, especially deployment with Apache and mod_wsgi
Knock off the ridiculously long titles.
Use a prettier theme.

The page-spanning header bars made it hard to see what was subordinate to what, and the left-hand TOC subjugated the content.
Complete a Getting Started chapter that details the quickest way to get your own code showing up in DXR.
Rewrite deployment docs. Most of Jack Bates's material survives, but I've gone over it for flow, accuracy, brevity, etc.

We don't need to support non-virtualenv setups. Let's keep it simple and recommend good ideas.
Indexing large application runs out of memory

Steps to reproduce:

dxr-build.py with very large application (120,000+ objects)

Actual results:

Received "out of memory" message from system during the "Generating callgraph" step and process was apparently killed by the kernel (?).  On a retry we observed the process was using almost all of the 21gb swap space on the system after getting to the callgraph step.

After instrumenting the build script the problem seems to occur in the fetchall functions and fetchall variables steps, which makes sense.

Expected results:

Process should have completed eventually over the weekend.
cleaned up chunking by Jack Marr into a generator
Made doc string more descriptive
removed extra p that broke tests
fixed to comply with pep8 and dxr standards
Cut memory use when generating inheritance tree and call graph. Fixes bug #1004547. Close #279.
Factor out the repetition of the "no results" message. Fixes bug #973113.
Fix mostly formatting in various chapters.
Fix some formatting in Configuration.
Stop supporting the `dxrroot` config option.

It makes more sense to remove this option than to document it. Its main purpose is to point to a custom templates directory, and we previously removed support for custom templates. It can also be used, indirectly, to point to a custom plugins dir, but that's also about to be obsolete, with the upcoming new plugin system.
Rewrite and make true the Configuration chapter.
Morph the highlighting docs into general use docs.
Add glossary.