Re: [PATCH 1/7] docs: formatstorage: Convert to RST

Apart from the bulk conversion itself, the section names 'general metadata' and 'target elements' were duplicated between the storage pool and storage volume sections. To prevent heading name clashes they were renamed appropriately. Signed-off-by: Peter Krempa <pkrempa(a)redhat.com&gt; --- docs/formatstorage.html.in | 1000 ------------------------------------ docs/formatstorage.rst | 823 +++++++++++++++++++++++++++++ docs/meson.build | 2 +- 3 files changed, 824 insertions(+), 1001 deletions(-) delete mode 100644 docs/formatstorage.html.in create mode 100644 docs/formatstorage.rst diff --git a/docs/formatstorage.html.in b/docs/formatstorage.html.in deleted file mode 100644 index 9ee5b89ee6..0000000000 --- a/docs/formatstorage.html.in +++ /dev/null - <p> - Valid features are: - </p> - <ul> - <dd><code>cow</code></dd> - <dt>Controls whether the filesystem performs copy-on-write (COW) for - images in the pool. This may only be set for directory / filesystem - pools on the <code>btrfs</code> filesystem. If not set then libvirt - will attempt to disable COW on any btrfs filesystems. - <span class="since">Since 6.6.0</span>.</dt> - </ul>

+ By default this is specified in bytes, but an optional attribute ``unit`` can + be specified to adjust the passed value. Values can be: 'B' or 'bytes' for + bytes, 'KB' (kilobytes, 10\ :sup:`3` or 1000 bytes), 'K' or 'KiB' (kibibytes, + 2\ :sup:`10` or 1024 bytes), 'MB' (megabytes, 10\ :sup:`6` or 1,000,000 + bytes), 'M' or 'MiB' (mebibytes, 2\ :sup:`20` or 1,048,576 bytes), 'GB' + (gigabytes, 10\ :sup:`9` or 1,000,000,000 bytes), 'G' or 'GiB' (gibibytes, + 2\ :sup:`30` or 1,073,741,824 bytes), 'TB' (terabytes, 10\ :sup:`12` or + 1,000,000,000,000 bytes), 'T' or 'TiB' (tebibytes, 2\ :sup:`40` or + 1,099,511,627,776 bytes), 'PB' (petabytes, 10\ :sup:`15` or + 1,000,000,000,000,000 bytes), 'P' or 'PiB' (pebibytes, 2\ :sup:`50` or + 1,125,899,906,842,624 bytes), 'EB' (exabytes, 10\ :sup:`18` or + 1,000,000,000,000,000,000 bytes), or 'E' or 'EiB' (exbibytes, 2\ :sup:`60` or + 1,152,921,504,606,846,976 bytes). :since:`Since 0.4.1, multi-character + ``unit`` since 0.9.11`