[ docs ] some polishing of .rst for release (#262)

docs/Makefile

@@ -14,7 +14,9 @@ ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 # the i18n builder cannot share the environment and doctrees with the others
 I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
 
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+.PHONY: default help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf xelatex text man changes linkcheck doctest gettext
+
+default: html xelatex
 
 help:
  @echo "Please use \`make <target>' where <target> is one of"
@@ -29,6 +31,7 @@ help:
  @echo " epub to make an epub"
  @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
  @echo " latexpdf to make LaTeX files and run them through pdflatex"
+ @echo " xelatex to make LaTeX files and run them through xelatex"
  @echo " text to make text files"
  @echo " man to make manual pages"
  @echo " texinfo to make Texinfo files"
@@ -108,6 +111,12 @@ latexpdf:
  $(MAKE) -C $(BUILDDIR)/latex all-pdf
  @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
 
+xelatex:
+ $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+ @echo "Running LaTeX files through xelatex..."
+ PDFLATEX="latexmk -xelatex" $(MAKE) -e -C $(BUILDDIR)/latex all-pdf
+ @echo "xelatex finished; the PDF files are in $(BUILDDIR)/latex."
+
 text:
  $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
  @echo