If the colorama package is available then Sphinx colorizes the console
output. This doesn't play well with MantidPlot and hides the output
when running with -xq.

The patch causes Sphinx to fall over when running inside MantidPlot due
to the presence of IPython.

Missed this when moving script around.
Refs #9639

The driver script for running the sphinx process can now be called by a
user without any special requirements. The main use case will be
running a doctest individually.

It should be noted that even restricting the run to a single file with the
new -R option will actually still cause Sphinx to read every source file
at least once. This is baked in to Sphinx and cannot be avoided. However,
the config pickling does mean that all source files are only read once and
then after this only changed files are reread.
Refs #9639
Refs #

This gives greater flexibility in configuring the generated output
for each builder type. At this point the output is the same as it was
for the single conf file case.
Refs #9761

Refs #9639

Refs #9639

They can be disabled by turning off the SEPARATE_DOC_TESTS cmake option.
Refs #9639

Each builder type now has a separate environment so that the order of
running the targets doesn't make a difference. Shared doctree directories
meant that running doctest first just in vanilla python wouldn't
generate the screenshots and running the html target wouldn't reread
the unchanged source files to generate the images. It forced doctest
to run in MantidPlot and do the screenshot generation.

Refs #9639

Refs #9639

Refs #9639

The page reference must be before the page title so that it can be
referenced without including the link text.
Refs #9562

They are not necessary and they slow down the build quite considerably.
Refs #9562

It just calls the sphinx.main() function directly without the need to
go through pkg_resources.
Refs #9559

This will allow us to use a package rather than a fresh build if
necessary.
Refs #9521

They are no created in a directory specified by an environment variable so
that they don't have to touch the source directory.
Refs #9521

Only added if Sphinx can be found.
Refs #9521

Touches nearly everything unfortunately but is necessary.

The output PDF is not ideal at the moment but it is a start.

The API bits need a some tidy up but they are at least there and
can be searched.