In python 3, all strings are considered as unicode string.

This patch drops the explicit unicode literal (u'...')
or (u"..") appearances from the unicode strings.

Change-Id: I9902966892a1dc4f85d449dfe580fb128647487b

Our CLI docs are very out of date. These used to be generated by the
docs team with some tooling they had. Since the docs moved in-repo, that
tooling has gone away, and for the most part no one has done any updates
to the CLI docs.

This adds a sphinx directive that will generate these docs every time
the docs are built. This way, whenever someone makes a CLI change, they
do not need to have to know to also edit a documentation file to match
their change. Any code changes will automatically be picked up and
reflected in the docs.

Change-Id: I4406872ab6e9335e338b710e492171580df74fa5
Signed-off-by: Sean McGinnis <sean.mcginnis@gmail.com>

Switch to openstackdocstheme 2.2.1 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems

Update Sphinx version as well.

openstackdocstheme renames some variables, so follow the renames. A
couple of variables are also not needed anymore, remove them.

Set openstackdocs_auto_name to use project as name.

Set openstackdocs_pdf_link to link to PDF file. Note that
the link to the published document only works on docs.openstack.org
where the PDF file is placed in the top-level html directory. The
site-preview places the PDF in a pdf directory.

Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.

See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html

Change-Id: I2cc022495b162bec1424ec69611acb879900c005

This needs to go to "python-cinderclient"
to work instead of "cinderclient".

Add a "doc" tag to these bugs as well.

Change-Id: I45ae03e9c071dd9b159b1c0183b53db4dd837453

The previously choosen PDF file name conflicts in some repos with the
project logos (badge). Thus change https://review.opendev.org/679777
renames the desired PDF name to be doc-PROJECT.pdf to allow using the
badge in PDF files.

Follow this rename.

Change-Id: Ife8461f00ba2206d18ae45837bbc31d211e29841

This patch updates tox.ini to build the pdf version of
cinderclient documentation.

run tox -epdf-docs

Change-Id: If1f43e593db6ff6740b8a88b517c4505e39a3edd

Some options are now automatically configured by the version 1.20:
- project
- html_last_updated_fmt
- latex_engine
- latex_elements
- version
- release.

Change-Id: Icbfa21da1e83f745a98822a2f33c4ebc8d11fd0c

Doc build keeps failing w/

Recursion error:
    maximum recursion depth exceeded while pickling an object

Sphinx recommends bumping up the recursion limit to
get around this, and it appears to work.

Change-Id: If0a78f9af2e4ddd5fd88c44757642355b3a5bf2e

Change-Id: I0c0c77c25d3c96dd3c6a2a01be4f196c02e71dd6

With pbr 2.0 and Sphinx 1.5, the setting for treat sphinx warnings as
errors is setting warning-is-error in build_sphinx section. Migrate the
setting from the old warnerrors one.

Change-Id: Ifd411ead74497a43ab22c57090ece2e1c7cfddb5