Fixup README

Author: m-bull

roles/os_images/README.md

@@ -27,8 +27,8 @@ on the build host.
 
 `os_images_cache`: a path to a directory in which to cache build artefacts.
 It defaults to `~/disk_images`
-`NOTE`: new images will NOT be built, even if changes are made in config, if an image is already cached.
-Use `force_rebuild` flag in order to apply new config changes.
+`NOTE`: new images will NOT be built, even if changes are made in config, if an image
+is already cached. Use `force_rebuild` flag in order to apply new config changes.
 
 `os_images_auth_type`: OpenStack authentication endpoint and credentials.
 Defaults to `password`.
@@ -68,15 +68,15 @@ mutually exclusive where each contain:
   [here](https://docs.openstack.org/glance/latest/user/common-image-properties.html).
 * `type`: (optional) image type. Default in DIB is qcow2. Image formats are
   available [here](https://docs.openstack.org/glance/latest/user/formats.html).
-* `force_rebuild`: (optional) boolean flag indicating whether or not the image should always
-  be built (even if an existing image that name has been built before). The images on glance
-  will be replaced if `os_images_upload` is set to `True`. This defaults to
+* `force_rebuild`: (optional) boolean flag indicating whether or not the image should
+  always be built (even if an existing image that name has been built before). The images
+  in glance will be replaced if `os_images_upload` is set to `True`. This defaults to
   `os_images_force_rebuild`if left unset.
-* `is_public`: (optional) (deprecated - use `visibility`) whether the image should be set as visible to all
-  projects or kept private. Note that if both `is_public` and `visibility` are provided, `is_public` will 
-  be preferred.
+* `is_public`: (optional) (deprecated - use `visibility`) whether the image should be set
+  as visible to all projects or kept private. Note that if both `is_public` and `visibility`
+  are provided, `is_public` will be preferred.
 * `visibility`: (optional) Allowed values are 'public', 'private', 'shared'
-or 'community'. Default is 'public'
+  or 'community'. Default is 'public'
 * `owner`: (optional) ID of the project that should own the uploaded image.
 
 `os_images_common`: A set of elements to include in every image listed.
@@ -105,36 +105,50 @@ following parameters:
 
 `os_images_upload`: Whether to upload built images to Glance. Defaults to `True`.
 
-`os_images_force_rebuild`: Whether or not to force a rebuild of the DIB image. The images on Glance
-will be replaced with the newly built image if `os_images_upload` is set to `True`. Defaults to
-`False`.
+`os_images_force_rebuild`: Whether or not to force a rebuild of the DIB image.
+The images on Glance will be replaced with the newly built image if `os_images_upload`
+is set to `True`. Defaults to `False`.
 
-`os_images_public`: (Deprecated - use `os_images_visibility`) Whether uploaded images are public. Defaults to `True` - note this requires admin permissions. 
+`os_images_public`: (Deprecated - use `os_images_visibility`) Whether uploaded
+images are public. Defaults to `True` - note this requires admin permissions.
 
-`os_images_visibility`: The visibility of images uploaded. One of `community`,`public` or `private`. If unset, defaults to `os_images_public` (requires admin permissions for anything other than `private`)
+`os_images_visibility`: The visibility of images uploaded. One of `community`,
+`public` or `private`. If unset, defaults to `os_images_public` (requires admin
+permissions for anything other than `private`)
 
-`os_images_venv`: Path to virtualenv in which to install python dependencies to upload images.
+`os_images_venv`: Path to virtualenv in which to install python dependencies to
+upload images.
 
 `os_images_dib_venv`: Path to virtualenv in which to install DIB to build images.
 
 `os_images_promote`: Whether or not to promote new images. Defaults to `False`.
 
-`os_images_retire`: Whether or not to retire old images. Defaults to `os_image_promote`. May be necessary to set separately if you are promoting a new candidate image for which there is no existing one to retire, for example. 
+`os_images_retire`: Whether or not to retire old images. Defaults to `os_image_promote`.
+May be necessary to set separately if you are promoting a new candidate image for which
+there is no existing one to retire, for example.
 
 `os_images_build`: Whether or not to build the images.
 
-`os_images_name_suffix`: Image suffix which would be removed during image promotion, for exmple: -rc, -dev, -test etc. Mandatory for promotion functionality. Empty by default.
+`os_images_name_suffix`: Image suffix which would be removed during image promotion, for
+exmple: -rc, -dev, -test etc. Mandatory for promotion functionality. Empty by default.
 
-`os_images_hide`: Whether or not to hide the images in Glance list. Hiding images is available as an option in image retirement/promotion process. Defaults to `False`.
+`os_images_hide`: Whether or not to hide the images in Glance list. Hiding images is
+available as an option in image retirement/promotion process. Defaults to `False`.
 
 Changing platform architecture in os_images
 -------------------------------------------
 
-The target CPU architecture for each image defined in `os_images_list` may be set to any architecture supported by diskimage-builder with the `architecture` parameter.
+The target CPU architecture for each image defined in `os_images_list` may be set to any
+architecture supported by diskimage-builder with the `architecture` parameter.
 
-If it is unset, an image with the default diskimage-builder architecture (`x86_64`) will be built and optionally uploaded to Glance, with the Glance image property `cpu_arch` set to `x86_64`. If it is set to `arm64` or `aarch64`, images will be uploaded to Glance with the Glance image property `cpu_arch` set to `aarch64`.
+If it is unset, an image with the default diskimage-builder architecture (`x86_64`) will
+be built and optionally uploaded to Glance, with the Glance image property `cpu_arch` set
+to `x86_64`. If it is set to `arm64` or `aarch64`, images will be uploaded to Glance with
+the Glance image property `cpu_arch` set to `aarch64`.
 
-If setting to a different `architecture`, consider also setting `properties.cpu_arch` to an architecture [supported by Glance](https://docs.openstack.org/glance/latest/admin/useful-image-properties.html#image-property-keys-and-values).
+If setting to a different `architecture`, consider also setting `properties.cpu_arch` to an
+architecture
+[supported by Glance](https://docs.openstack.org/glance/latest/admin/useful-image-properties.html#image-property-keys-and-values).
 
 Dependencies
 ------------