From 75f2875a6e2be5c7fef56ebc1f3c235aa5ae1521 Mon Sep 17 00:00:00 2001 From: "zhiyong.dai" Date: Mon, 19 Dec 2016 17:23:35 +0800 Subject: Add ":option:` `" in the help message This patch mainly adds ":option:` `" in several help messages in the doc. This modification will create one link which helps the readers find the relative option quickly and conveniently in website. Change-Id: Ia047e15c3b2064e4822ee7df7922d4774d862602 --- doc/source/command-objects/image.rst | 28 +++++++++++++++++++--------- 1 file changed, 19 insertions(+), 9 deletions(-) (limited to 'doc/source/command-objects/image.rst') diff --git a/doc/source/command-objects/image.rst b/doc/source/command-objects/image.rst index 1913355e..7ebcb54a 100644 --- a/doc/source/command-objects/image.rst +++ b/doc/source/command-objects/image.rst @@ -23,10 +23,12 @@ Associate project with image Domain the project belongs to (name or ID). This can be used in case collisions between project names exist. +.. _image_add_project-image: .. describe:: Image to share (name or ID). +.. _image_add_project-project: .. describe:: Project to associate with image (name or ID) @@ -83,7 +85,7 @@ Create/upload an image .. option:: --size - Image size, in bytes (only used with --location and --copy-from) + Image size, in bytes (only used with :option:`--location` and :option:`--copy-from`) *Image version 1 only.* @@ -91,7 +93,7 @@ Create/upload an image Minimum disk size needed to boot image, in gigabytes -.. option:: --min-ram +.. option:: --min-ram Minimum RAM size needed to boot image, in megabytes @@ -103,7 +105,7 @@ Create/upload an image .. option:: --copy-from - Copy image from the data store (similar to --location) + Copy image from the data store (similar to :option:`--location`) *Image version 1 only.* @@ -117,7 +119,7 @@ Create/upload an image .. option:: --force - Force image creation if volume is in use (only meaningful with --volume) + Force image creation if volume is in use (only meaningful with :option:`--volume`) .. option:: --checksum @@ -163,6 +165,7 @@ Create/upload an image .. versionadded:: 2 +.. _image_create-image-name: .. describe:: New image name @@ -178,6 +181,7 @@ Delete image(s) openstack image delete +.. _image_delete-image: .. describe:: Image(s) to delete (name or ID) @@ -246,13 +250,15 @@ Disassociate project with image openstack image remove remove [--project-domain ] - + + .. option:: --project-domain Domain the project belongs to (name or ID). This can be used in case collisions between project names exist. +.. _image_remove_project: .. describe:: Image to unshare (name or ID). @@ -277,6 +283,7 @@ Save an image locally Downloaded image save filename (default: stdout) +.. _image_save-image: .. describe:: Image to save (name or ID) @@ -294,7 +301,7 @@ Set image properties openstack image set [--name ] [--min-disk ] - [--min-ram ] + [--min-ram ] [--container-format ] [--disk-format ] [--size ] @@ -328,7 +335,7 @@ Set image properties Minimum disk size needed to boot image, in gigabytes -.. option:: --min-ram +.. option:: --min-ram Minimum RAM size needed to boot image, in megabytes @@ -377,7 +384,7 @@ Set image properties .. option:: --copy-from - Copy image from the data store (similar to --location) + Copy image from the data store (similar to :option:`--location`) *Image version 1 only.* @@ -395,7 +402,7 @@ Set image properties .. option:: --force - Force image update if volume is in use (only meaningful with --volume) + Force image update if volume is in use (only meaningful with :option:`--volume`) *Image version 1 only.* @@ -483,6 +490,7 @@ Set image properties .. versionadded:: 2 +.. _image_set-image: .. describe:: Image to modify (name or ID) @@ -498,6 +506,7 @@ Display image details openstack image show +.. _image_show-image: .. describe:: Image to display (name or ID) @@ -525,6 +534,7 @@ Unset image tags or properties Unset a property on this image (repeat option to unset multiple properties) +.. _image_unset-image: .. describe:: Image to modify (name or ID) -- cgit v1.2.1