Update sphinx and turn on warnings-is-error

In order to do that, fix the warnings that are now errors.

Change-Id: I1e582a6763fc82496e4ab33f60ced193b0534f28
This commit is contained in:
Monty Taylor 2017-03-16 12:17:51 +01:00
parent 5458e569fa
commit db45323809
No known key found for this signature in database
GPG Key ID: 7BAE94BC7141A594
6 changed files with 52 additions and 39 deletions

View File

@ -89,7 +89,7 @@ A flavor for a Nova Server.
Flavor Access
------
-------------
An access entry for a Nova Flavor.
@ -366,7 +366,7 @@ A volume from cinder.
VolumeType
------
----------
A volume type from cinder.
@ -384,7 +384,7 @@ A volume type from cinder.
VolumeTypeAccess
------
----------------
A volume type access from cinder.

View File

@ -1,7 +1,7 @@
---
prelude: >
This release marks the beginning of the path towards removing all
of the 'python-*client' libraries as dependencies. Subsequent releases
of the 'python-\*client' libraries as dependencies. Subsequent releases
should expect to have fewer and fewer library depdencies.
upgrade:
- Removed glanceclient as a dependency. All glance operations

View File

@ -26,6 +26,7 @@ console_scripts =
source-dir = doc/source
build-dir = doc/build
all_files = 1
warning-is-error = 1
[upload_sphinx]
upload-dir = doc/build/html

View File

@ -2372,13 +2372,13 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
:returns: A keypair ``munch.Munch`` or None if no matching keypair is
found.
"""
return _utils._get_entity(self.search_keypairs, name_or_id, filters)
@ -2396,6 +2396,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2420,6 +2421,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2465,6 +2467,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2488,6 +2491,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2512,6 +2516,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2537,6 +2542,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2544,7 +2550,6 @@ class OpenStackCloud(_normalize.Normalizer):
Whether or not the list_flavors call should get the extra flavor
specs.
:returns: A flavor ``munch.Munch`` or None if no matching flavor is
found.
@ -2567,6 +2572,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2626,6 +2632,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2653,6 +2660,7 @@ class OpenStackCloud(_normalize.Normalizer):
{
'policy': 'affinity',
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2678,6 +2686,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2752,6 +2761,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
@ -2934,7 +2944,8 @@ class OpenStackCloud(_normalize.Normalizer):
:param string port_id: The ID of the port to use for the interface
:returns: A ``munch.Munch`` with the router ID (ID),
subnet ID (subnet_id), port ID (port_id) and tenant ID (tenant_id).
subnet ID (subnet_id), port ID (port_id) and tenant ID
(tenant_id).
:raises: OpenStackCloudException on operation error.
"""
@ -4050,13 +4061,13 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
:returns: A volume ``munch.Munch`` or None if no matching volume is
found.
"""
return _utils._get_entity(self.search_volume_snapshots, name_or_id,
filters)
@ -4113,7 +4124,6 @@ class OpenStackCloud(_normalize.Normalizer):
:returns: A backup ``munch.Munch`` or None if no matching backup is
found.
"""
return _utils._get_entity(self.search_volume_backups, name_or_id,
filters)
@ -4137,12 +4147,14 @@ class OpenStackCloud(_normalize.Normalizer):
:param bool detailed: Also list details for each entry
:param dict search_opts: Search options
A dictionary of meta data to use for further filtering. Example::
{
'name': 'my-volume-backup',
'status': 'available',
'volume_id': 'e126044c-7b4c-43be-a32a-c9cbbc9ddb56',
'all_tenants': 1
}
:returns: A list of volume backups ``munch.Munch``.
"""
with _utils.shade_exceptions("Error getting a list of backups"):
@ -6908,8 +6920,7 @@ class OpenStackCloud(_normalize.Normalizer):
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"
:returns: A zone dict or None if no matching zone is
found.
:returns: A zone dict or None if no matching zone is found.
"""
return _utils._get_entity(self.search_zones, name_or_id, filters)
@ -7174,6 +7185,7 @@ class OpenStackCloud(_normalize.Normalizer):
'gender': 'Female'
}
}
OR
A string containing a jmespath expression for further filtering.
Example:: "[?last_name==`Smith`] | [?other.gender]==`Female`]"

View File

@ -1426,17 +1426,17 @@ class OperatorCloud(openstackcloud.OpenStackCloud):
def list_role_assignments(self, filters=None):
"""List Keystone role assignments
:param dict filters: Dict of filter conditions. Acceptable keys are::
:param dict filters: Dict of filter conditions. Acceptable keys are:
- 'user' (string) - User ID to be used as query filter.
- 'group' (string) - Group ID to be used as query filter.
- 'project' (string) - Project ID to be used as query filter.
- 'domain' (string) - Domain ID to be used as query filter.
- 'role' (string) - Role ID to be used as query filter.
- 'os_inherit_extension_inherited_to' (string) - Return inherited
* 'user' (string) - User ID to be used as query filter.
* 'group' (string) - Group ID to be used as query filter.
* 'project' (string) - Project ID to be used as query filter.
* 'domain' (string) - Domain ID to be used as query filter.
* 'role' (string) - Role ID to be used as query filter.
* 'os_inherit_extension_inherited_to' (string) - Return inherited
role assignments for either 'projects' or 'domains'
- 'effective' (boolean) - Return effective role assignments.
- 'include_subtree' (boolean) - Include subtree
* 'effective' (boolean) - Return effective role assignments.
* 'include_subtree' (boolean) - Include subtree
'user' and 'group' are mutually exclusive, as are 'domain' and
'project'.

View File

@ -6,7 +6,7 @@ mock>=1.0
python-subunit
oslosphinx>=2.2.0 # Apache-2.0
requests-mock
sphinx>=1.1.2,!=1.2.0,!=1.3b1,<1.3
sphinx>=1.5.0
testrepository>=0.0.17
testscenarios>=0.4,<0.5
testtools>=0.9.32