71fede769c
In the past, the options ca_certificates_file, nova_ca_certificates_file, cinder_ca_certificates_file, api_insecure, nova_api_insecure, cinder_api_insecure were supplied to instantiate nova, neutron and cinder clients. These options have now been subsumed in a more generic way into the Keystone session logic as 'cafile' and 'insecure'. Deprecate the older options in Stein so that we can remove them in a future release. This deprecation began many releases ago when we switched to using keystone sessions [1]. However, we were still overriding the values of "insecure" and "cafile" if provided, forcing users to continue using deprecated parameters "api_insecure" and "ca_certificates_file". So despite this fix originating in the Stein release, it would be prudent to backport it to all maintained releases and remove support for these older options in/beyond Train release (9.0.0). [1] Ic211a11308a3295409467efd88bff413482ee58d Change-Id: I148e9079c7c1ab119f519f727d4ad97758473325 Related-Bug: #1802393 Closes-Bug: #1809318 (cherry picked from commit 198bea78ac01aaf8a703ca7878b2a85a1b59667e) (cherry picked from commit 4947cb0f6c610d5abf6d34d20bb50febd5b0239b)
Manila Development Docs
Files under this directory tree are used for generating the documentation for the manila source code.
Developer documentation is built to: https://docs.openstack.org/manila/latest/
Tools
- Sphinx
-
The Python Sphinx package is used to generate the documentation output. Information on Sphinx, including formatting information for RST source files, can be found in the Sphinx online documentation.
- Graphviz
-
Some of the diagrams are generated using the
dotlanguage from Graphviz. See the Graphviz documentation for Graphviz and dot language usage information.
Building Documentation
Doc builds are performed using tox with the docs
target:
% cd ..
% tox -e docs