summaryrefslogtreecommitdiff
path: root/doc/source
Commit message (Collapse)AuthorAgeFilesLines
* Merge "Remove unicode-related Python2-only code"Zuul2023-01-121-4/+4
|\
| * Remove unicode-related Python2-only codeCyril Roelandt2022-11-141-4/+4
| | | | | | | | | | | | | | | | This commit: - removes the old "u" prefix from all strings - removes the unicode_key_value_to_string function Change-Id: I1da347e31e828fd2359f0935a4da47257116d4cb
* | Merge "Boolean options: use strict checking"Zuul2023-01-121-0/+5
|\ \
| * | Boolean options: use strict checkingCyril Roelandt2022-11-141-0/+5
| |/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | Boolean options (such as "--protected" for glance md-namespace-update) should accept a limited amount of valid values, rather than assuming an "invalid" value means "False". The following values (no matter the case) will now be interpreted as True: ‘t’,’true’, ‘on’, ‘y’, ‘yes’, or ‘1’. The following values (no matter the case) will now be interpreted as False: ‘f’, ‘false’, ‘off’, ‘n’, ‘no’, or ‘0’. Change-Id: I0e7942045d883ac398bab4a7a85f2b4ac9b1ed8c Closes-Bug: #1607317
* | Replace osc with glance commandsErno Kuvaja2022-09-221-3/+3
|/ | | | | | | the are glance client docs. OSC should have their own section for this. Change-Id: I27123793fdf8f8a82afb909f2cceec71693609ea Closes-Bug: #1990532
* Merge "Documentation: Add options for "glance image-import""Zuul2022-05-051-0/+27
|\
| * Documentation: Add options for "glance image-import"vihithad232022-01-131-0/+27
| | | | | | | | | | Closes-bug:#1886537 Change-Id: I66d99be1ec06806494c5504c467dff759dd38f2d
* | Add doc and test for verbose parameterwhoami-rajat2022-04-211-0/+4
|/ | | | | | | | | | We currently have support to show verbose output for image-list with the command ``glance --verbose image-list`` but there is no documentation about it. This patch adds the documentation and a test to run it via CLI. Closes-Bug: #1969565 Change-Id: Ic6db4f5ab2fecded373b044aa002f9a9bc262513
* Switch to newer openstackdocstheme and reno versions3.2.0Andreas Jaeger2020-05-221-9/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | 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. Remove docs requirements from lower-constraints, they are not needed during install or test but only for docs building. openstackdocstheme renames some variables, so follow the renames before the next release removes them. A couple of variables are also not needed anymore, remove them. 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: Ie4aec288c74b9bd8d8d117f4bc2e0282cea4db90
* Bump openstackdocstheme to 1.20.0翟小君2019-07-021-1/+0
| | | | | | | | | | | | Some options are now automatically configured by the version 1.20: - project - html_last_updated_fmt - latex_engine - latex_elements - version - release. Change-Id: I2577ca452a014402f1377474457095176d422b42
* image-list: add checksum algorithm descriptionChen Hanxiao2018-07-241-1/+1
| | | | | | | | We use MD5 for checksum, add this description in cli helps. Change-Id: I3469b0dface63f4684ad39421eee4c2a2de4d80b Signed-off-by: Chen Hanxiao <chenhx@certusnet.com.cn>
* Merge "Fix docs cli authorize environment variables"Zuul2018-07-172-4/+4
|\
| * Fix docs cli authorize environment variablescaishan2018-03-202-4/+4
| | | | | | | | | | | | OpenStack is deprecating 'tenant'. So use 'project' instead of 'tenant' Change-Id: I1dc4dbbbe1eb1d01b0750eaf7994956eb657c7a6
* | Merge "Update 'doc/source/reference/apiv2.rst'"Zuul2018-07-171-0/+12
|\ \
| * | Update 'doc/source/reference/apiv2.rst'ya.wang2018-03-121-0/+12
| |/ | | | | | | | | | | | | | | | | - Add a simple introduction for the original parameters - Add two necessary parameters for Identity API v3: - user_domain_{name|id} - project_domain_{name|id} Change-Id: Iebd9bb57fcdbd6abb8fc369e69ba52805fb77170
* | Update property keys documentBrian Rosmaita2018-05-021-341/+15
| | | | | | | | | | | | | | | | | | | | | | The list of useful image properties really belongs in the Glance Administration Guide. The only connection they have with the glanceclient is that you can use it to set them. Rewrite the property keys document to reflect this. The dependency moves the relevant text to the Glance Admin Guide. Depends-on: https://review.openstack.org/565780 Change-Id: I39add6728aad42988a07d2ad97cd81dbdaf4c54a
* | Follow the new PTI for document buildNguyen Hai2018-04-124-11/+11
|/ | | | | | | | | | | | | - Follow new PTI for docs build - Add sphinxcontrib.apidoc to replace pbr autodoc REF: https://governance.openstack.org/tc/reference/project-testing-interface.html http://lists.openstack.org/pipermail/openstack-dev/2017-December/125710.html http://lists.openstack.org/pipermail/openstack-dev/2018-March/128594.html Co-Authored-By: Nguyen Hai <nguyentrihai93@gmail.com> Change-Id: Id16a5eaa57bc0d96332849abfb62898e6766ef86
* Remove deprecated ssl optionsRui Yuan Dou2018-01-171-11/+1
| | | | | | | | Old deprecated ssl options block the new keystoneauth parser get the correct value, should be removed. Change-Id: Ie080f9a8fa7f4407b1fcbb7fb7c763152c5ec295 Closes-Bug: 1697163
* Merge "Update Image service property keys doc"Zuul2018-01-021-0/+8
|\
| * Update Image service property keys docBrian Rosmaita2017-12-221-0/+8
| | | | | | | | | | | | | | Doc update for change Ie8227fececa40e502aaa39d77de2a1cd0cd72682 Change-Id: I4b35d0ae768b331945cd014c004cef16ed2155b3 Closes-bug: #1694441
* | Update Image service property keys docsBrian Rosmaita2017-12-221-0/+7
|/ | | | | | | Doc update for change I7c77fb13f20b59ad764070d14dc98a46f8b7c823 Change-Id: I8a636019c88526f6d65a96e9184aad10010eded2 Closes-bug: #1651907
* Merge "Add documentation for image import commands"Jenkins2017-07-271-0/+173
|\
| * Add documentation for image import commandsBrian Rosmaita2017-07-271-0/+173
| | | | | | | | | | | | | | | | | | Add documentation for the image import commands, particularly pointing out that the image-create-via-import command is an EXPERIMENTAL command that my be renamed or removed in a future release. Change-Id: I20ebc0145db6acc794039ed25e7754ec8d479bc8
* | Merge "Update glanceclient version ref"Jenkins2017-07-271-1/+1
|\ \ | |/ |/|
| * Update glanceclient version refBrian Rosmaita2017-07-251-1/+1
| | | | | | | | | | | | | | Update a docs reference to the client version in preparation for the next release. Change-Id: I5f9542a543507290bdd8579adf773fe1b6bba5f6
* | Merge "Make --profile load from environment variables"Jenkins2017-07-261-4/+4
|\ \
| * | Make --profile load from environment variablesTovin Seven2017-07-241-4/+4
| |/ | | | | | | | | | | | | | | | | | | --profile argument can be loaded from OS_PROFILE environment variables to avoid repeating --profile in client commands. Correct/update help text. Co-Authored-By: Hieu LE <hieulq@vn.fujitsu.com> Change-Id: I67c1e4b859b972e380eb658c98ceae4fbef5c254
* | Removed the --no-ssl-compression parameter which is deprecatedPranaliD2017-07-251-6/+1
| | | | | | | | | | | | | | | | --no-ssl-compression is deprecated and no longer used. So, it is removed from the help message. Change-Id: I2b886671a568ed191ee380cf16335ccd9ae85062 Closes-Bug: #1583919
* | Update and optimize documentation linksHangdong Zhang2017-07-192-7/+7
|/ | | | | | | | 1. Update URLs according to document migration 2. Update the dead and outdated links 3. Optimize (e.g. http -> https) Change-Id: Iad743ad223b8c40ae914beccd936f71a81622d76
* Fix man page buildJavier Pena2017-07-041-1/+1
| | | | | | | | | | https://review.openstack.org/474775 moved glance.rst from the doc/source/man directory into doc/source/cli, so we need to adjust the path in conf.py to avoid issues when running: python setup.py build_sphinx -b man Change-Id: I2c37755553d1265fb9fb069067c4468853f395b7
* turn on warning-is-error in sphinx buildDoug Hellmann2017-06-281-1/+1
| | | | | | | | Fix a formatting error in one docstring and turn on the flag to ensure that future warnings in the doc build trigger a build failure. Change-Id: I7159b985d1690a8ae61ff885408da4623c105952 Signed-off-by: Doug Hellmann <doug@doughellmann.com>
* use openstackdocstheme html contextDoug Hellmann2017-06-281-1/+11
| | | | | | | | | | | Set some of the new config values and enable openstackdocstheme as an extension so it will inject values into the page context as it writes each documentation page. This ensures the pages link to the right bug tracker, etc. Change-Id: I316bd585f91064af4d1d1e7b834986619fc3a2d3 Depends-On: Icf3a40ed104cfd828f532f6f2b112ed02f996ff5 Signed-off-by: Doug Hellmann <doug@doughellmann.com>
* switch to openstackdocsthemeDoug Hellmann2017-06-281-1/+12
| | | | | Change-Id: Id687e3405d8afe0db201eb648941cc51bb9f741e Signed-off-by: Doug Hellmann <doug@doughellmann.com>
* import content from cli-reference in openstack-manualsDoug Hellmann2017-06-283-1/+1845
| | | | | Change-Id: Ibea5fe3e4711af997841992dead7171c99c69bfa Signed-off-by: Doug Hellmann <doug@doughellmann.com>
* move existing content into the new standard structureDoug Hellmann2017-06-287-98/+75
| | | | | | | | | | | | | | | | This patch rearranges and reformats existing content. It replaces the home-grown autodoc feature with the one built into pbr, for consistency with other OpenStack projects. It depends on the doc-migration spec and a pbr feature to allow us to specify where the autodoc content should go in the source tree during the build. Change-Id: I8d2bb11b5ef3e46fcd22c8bed8f84060d8ab6f03 Depends-On: Ia750cb049c0f53a234ea70ce1f2bbbb7a2aa9454 Depends-On: I2bd5652bb59cbd9c939931ba2e7db1b37d2b30bb Signed-off-by: Doug Hellmann <doug@doughellmann.com>
* move old release notes into the releasenotes doc treeDoug Hellmann2017-06-201-478/+0
| | | | | Change-Id: I00797d38d6ad9b1a7b198767a0cbbb2f619c3b43 Signed-off-by: Doug Hellmann <doug@doughellmann.com>
* doc: Remove cruft from conf.pyStephen Finucane2017-04-201-25/+6
| | | | Change-Id: I1bbb2d490f0415e4062da520e6fb09e6db477aa0
* Use Sphinx 1.5 warning-is-errorStephen Finucane2017-04-201-10/+8
| | | | | | | 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. Enable this. Change-Id: I39ffb22c37a05f00cade2fbd14449eaf77dc3d39
* Docs are generated incorrectlyTom Cocozzello2016-03-221-1/+11
| | | | | | | | | When docs are generated with pbr command 'warnerrors = True' there are many doc problems that are shown. This patch fixes these problems. Change-Id: Idb804ab924782b6d7d379494987bdba2acbce568 Closes-Bug: #1557235
* Merge "Change man page examples to correlate default v2"Jenkins2015-12-011-4/+6
|\
| * Change man page examples to correlate default v2Erno Kuvaja2015-11-171-4/+6
| | | | | | | | | | | | | | Changing examples to correlate default behavior (v2 API) rather than old v1 options. Change-Id: I13a0d6040bfcd246189e0c1aeadf104ff5eff131
* | Release Notes for version 1.2.01.2.0Erno Kuvaja2015-11-161-0/+44
|/ | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 1f1934e Add versions list function bff356e Added reactivate/deactivate image using CLI dfcb468 Fix the missing help descripiton of "image-create" 8a4cd79 Add documentation for running the functional tests c7c0754 Updated from global requirements d6a10f2 Remove unused sphinx Makefile 5a24705 Update docs to recommend KSA instead of KSC 84538d8 Use clouds.yaml from devstack for functional tests 4fb3092 Add translation to v2 shell 6b9133c Import i18n functions directly 8cf2bfc Updated from global requirements b51634a improve readme contents ca050ed Add support for setting Accept-Language header 3bd28bf Updated from global requirements 36937bb Use the subcomand parsed args instead of the base afd1810 Stop trying to send image_size to the server bf02b04 Support image deletion in batches in v2 a8a7c68 print usage when no argument is specified for python3 77012ee Updated from global requirements 603697a Updated from global requirements df0f664 Do not use openstack.common.i18n in glance client abf0381 Added unit tests for 'Unicode support shell client' 1f2fefb Use common identity parameters fro keystone client c31c136 No auth when token and endpoint are passed 557acb1 Use dictionary literal for dictionary creation c6addc7 Replace exception_to_str with oslo.utils function 586d401 Change ignore-errors to ignore_errors 05cd0c7 Add period in help message b8a881f Don't get the image before deleting it 3d3d829 Fix human readable when size is None 19480df Add parsing the endpoint URL 22ce845 Fix Typos in comments b9eee5e Add check Identity validate when get schemas Change-Id: If2964135d73b45a11faf03b7dfa6b6f756a1abe0
* Update docs to recommend KSA instead of KSCMonty Taylor2015-10-211-10/+10
| | | | | | | | For the session workflow (which is really the only workflow a dev should use), session objects should now come from keystoneauth1 instead of python-keystoneclient. Change-Id: Icb5f20ce3dc09ff7790b27d07f7f0cb3b83e1e7e
* Change next version in docs1.1.0Erno Kuvaja2015-09-141-1/+1
| | | | | | | As stated by Doug we need to release 1.1.0 instead of 1.0.1 https://review.openstack.org/#/c/222716/ Change-Id: Ifb24361a1d5a5270c6b3173ba28409addfec19b0
* 1.0.1 Release notesErno Kuvaja2015-09-111-0/+26
| | | | | | | | | | | | | | f6712f5 Print the reverting back to v1 to stderr 2c7da7c Invalid output running the command 'glance image-show <image_id>' 5026774 Don't make `help` require auth parameters 75ec903 check for None value in utils.safe_header f0b30f4 Updated from global requirements 1322fbc Consider `--os-token` when using v2 47423eb Check if v2 is available and fallback 90b7dc4 Update path to subunit2html in post_test_hook 1e2274a Password should be prompted once Change-Id: I70329b9596421a4d8c0c953c19759a96f29c8b0d
* 1.0.0 release notes1.0.0Erno Kuvaja2015-08-271-0/+52
| | | | Change-Id: I2cc3ba8d0064d6f424f16be94deaecdf1c5c8332
* Add release notes for 0.19.00.19.0Nikhil Komawar2015-06-101-0/+14
| | | | | | | | | | | | | | | | | | | | | | | | | Changes included in this release: $ git log 0.18.0..HEAD --no-merges --oneline dfa98ab Updated from global requirements 6cb26fc Include owner and status option in v2 image list 5d933b0 Fix Metadef Object update issue with python-glanceclient 9f5c581 Fix functional tests in gate 1686d6a Do not crash on homedir mkdir 1f89beb Improve import related error handling 583adc3 Check image-download for redirection 9c172fb Add some basic CLI functional tests bf413a6 Use assertIn instead of assertTrue in tests 6431fae Unorder compare in tests 5fa71aa Add release notes for 0.18.0 6d31116 Update README to work with release tools 71d9783 Create functional test base f2a8a52 Move unit tests to standard directory f931a20 Fixed doc example Co-Authored-By: Louis Taylor <louis@kragniz.eu> Change-Id: Ied7f5b4f298e2bbf4a5486eb6b7dbcea2d0e74d3
* Merge "Fixed doc example"Jenkins2015-05-261-1/+1
|\
| * Fixed doc exampleGeorges Dubus2014-10-221-1/+1
| | | | | | | | | | | | | | | | Image.data is a method, not an attribute. DocImpact Change-Id: I16555e456dcb2c9719de6c44c01ab68e82ad0590
* | Add release notes for 0.18.0Louis Taylor2015-04-231-0/+19
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Changes included in this release: $ git log 0.17.0..0.18.0 --no-merges --oneline 8b4456a Uncap library requirements for liberty 76c9f68 Add unit tests for log_curl_request bd0aa06 Fix https stack trace on python 3.4 client c698b4e Fix client when using no ssl compression 64a1a0f Add SSL cert verification regression tests c730266 Omit 'locations' as image-create parameter a6234d1 Creating task with invalid property crashes in py3 fd2f989 Don't accept *args for client e386e44 Stub authentication requests rather than plugins 27f70bb Remove keystoneclient mocks 02b1a05 Replace mox in tests with requests-mock 90407d9 Expose 'is_base' schema property attribute 2c08b40 Validate tag name when filtering for images 13b5a5a Remove redundant FakeSchemaAPI __init__ method c149a94 glance image-show now have --human-readable option 42d7548 Test unit for checking update active images 6d864ef Correct help messages for image-update command f272ab3 Generate API documentation a1bb3eb Use any instead of False in generator Change-Id: I687bef82afd7bb9a379297d7128a009cc051ca75
View Lorry Controller Status