Update Muon PhaseQuad documentation and user examples

[raquelalvarezbanos]

Fixes #11191

To test: this ticket is to update the algorithm's documentation, so basically the only two things to test here are the user examples.

[martyngigg]

There is nothing wrong with the line here, however, on some users' machines the current working directory is not writeable so this example may not work out of the box. In most of our examples that write files we tend to use the home directory, which is easy to access in Python. Can we change this line to something like

phaselist_path = os.path.join(os.path.expanduser("~"),"PhaseList.txt")
phaselist_file = open(phaselist_path, 'w')

Note that I have also replaced file withphaselist_file as file is a keyword in Python and is generally considered bad practice to over write keywords.

[martyngigg]

Could we also remove the temporary PhaseList file after we are finished? This just avoids having random files scattered around the build directories. This can be done outside of the test by adding the following lines underneath the .. testoutput:: ExPhaseQuadList section:

.. testcleanup:: ExPhaseQuadList

  import os
  try:
      os.remove(phaselist_path)
  except OSError:
      pass

See CreateDummyCalFile-v1.rst for an example.

[raquelalvarezbanos]

Sure, I will remove the file. Thanks Martyn

[raquelalvarezbanos]

I have just seen I missed the first comment, I will modify that too.

[raquelalvarezbanos]

Jenkins, retest this please

[martyngigg]

It looks like this doesn't merge cleanly with master any more. Could you merge master to your branch?

[martyngigg]

Jenkins, retest this please

[raquelalvarezbanos]

Jenkins, retest this please

[martyngigg]

One of the builds has failed with a git error. I don't think it is worth pushing this through the build servers again. I'll just wait until the build finish and merge it then.

[martyngigg]

The rhel6 failure is nothing to do with the changes here. The documentation tests have passed and rhel6 built before.