diff options
author | Heinz Mauelshagen <heinzm@redhat.com> | 2017-03-27 16:45:48 +0200 |
---|---|---|
committer | Heinz Mauelshagen <heinzm@redhat.com> | 2017-03-27 16:49:39 +0200 |
commit | 36cac41115cca875f5d120631933b5dfb3c3c524 (patch) | |
tree | 17655c869a2acd7e4c1843c1ddbe2541d03e2cd6 /man/lvcreate.8_end | |
parent | 6165e092215c795eafa297268cddbd9dade3a82c (diff) | |
download | lvm2-36cac41115cca875f5d120631933b5dfb3c3c524.tar.gz |
man-generator/man/help: simplify hyphen escaping
Commits a29bb6a14b5e920092495fb9a1623e527d22daac
... 5c199d99f4dc9911d62673baba7643ea649ffe64
narrowed down on addressing the escaping of hyphens
in the dynamic creation of manuals whilst avoiding
them in creating help texts. This lead to a sequence
of slipping through hyphens adrressed by additional
patches in aforementioned commit series.
On the other hand, postprocessing dynamically man-generator
created and statically provided manuals catches all hyphens
in need of escaping.
Changes:
- revert the above commits whilst keeping man-generator
streamlining and the detection of any '\' when generating
help texts in order to avoid escapes to slip in
- Dynamically escape hyphens in manaual pages using sed(1)
in the respective Makefile targets
- remove any manually added escaping on hyphens from any
static manual sources or headers
Diffstat (limited to 'man/lvcreate.8_end')
-rw-r--r-- | man/lvcreate.8_end | 44 |
1 files changed, 22 insertions, 22 deletions
diff --git a/man/lvcreate.8_end b/man/lvcreate.8_end index b4ebd2d99..2770f62a8 100644 --- a/man/lvcreate.8_end +++ b/man/lvcreate.8_end @@ -3,56 +3,56 @@ Create a striped LV with 3 stripes, a stripe size of 8KiB and a size of 100MiB. The LV name is chosen by lvcreate. .br -.B lvcreate \-i 3 \-I 8 \-L 100m vg00 +.B lvcreate -i 3 -I 8 -L 100m vg00 Create a raid1 LV with two images, and a useable size of 500 MiB. This operation requires two devices, one for each mirror image. RAID metadata (superblock and bitmap) is also included on the two devices. .br -.B lvcreate \-\-type raid1 \-m1 \-L 500m \-n mylv vg00 +.B lvcreate --type raid1 -m1 -L 500m -n mylv vg00 Create a mirror LV with two images, and a useable size of 500 MiB. This operation requires three devices: two for mirror images and one for a disk log. .br -.B lvcreate \-\-type mirror \-m1 \-L 500m \-n mylv vg00 +.B lvcreate --type mirror -m1 -L 500m -n mylv vg00 Create a mirror LV with 2 images, and a useable size of 500 MiB. This operation requires 2 devices because the log is in memory. .br -.B lvcreate \-\-type mirror \-m1 \-\-mirrorlog core \-L 500m \-n mylv vg00 +.B lvcreate --type mirror -m1 --mirrorlog core -L 500m -n mylv vg00 -Create a copy\-on\-write snapshot of an LV: +Create a copy-on-write snapshot of an LV: .br -.B lvcreate \-\-snapshot \-\-size 100m \-\-name mysnap vg00/mylv +.B lvcreate --snapshot --size 100m --name mysnap vg00/mylv -Create a copy\-on\-write snapshot with a size sufficient +Create a copy-on-write snapshot with a size sufficient for overwriting 20% of the size of the original LV. .br -.B lvcreate \-s \-l 20%ORIGIN \-n mysnap vg00/mylv +.B lvcreate -s -l 20%ORIGIN -n mysnap vg00/mylv Create a sparse LV with 1TiB of virtual space, and actual space just under 100MiB. .br -.B lvcreate \-\-snapshot \-\-virtualsize 1t \-\-size 100m \-\-name mylv vg00 +.B lvcreate --snapshot --virtualsize 1t --size 100m --name mylv vg00 Create a linear LV with a usable size of 64MiB on specific physical extents. .br -.B lvcreate \-L 64m \-n mylv vg00 /dev/sda:0\-7 /dev/sdb:0\-7 +.B lvcreate -L 64m -n mylv vg00 /dev/sda:0-7 /dev/sdb:0-7 Create a RAID5 LV with a usable size of 5GiB, 3 stripes, a stripe size of 64KiB, using a total of 4 devices (including one for parity). .br -.B lvcreate \-\-type raid5 \-L 5G \-i 3 \-I 64 \-n mylv vg00 +.B lvcreate --type raid5 -L 5G -i 3 -I 64 -n mylv vg00 Create a RAID5 LV using all of the free space in the VG and spanning all the PVs in the VG (note that the command will fail if there are more than 8 PVs in -the VG, in which case \fB\-i 7\fP must be used to get to the current maximum of +the VG, in which case \fB-i 7\fP must be used to get to the current maximum of 8 devices including parity for RaidLVs). .br -.B lvcreate \-\-config allocation/raid_stripe_all_devices=1 +.B lvcreate --config allocation/raid_stripe_all_devices=1 .RS -.B \-\-type raid5 \-l 100%FREE \-n mylv vg00 +.B --type raid5 -l 100%FREE -n mylv vg00 .RE Create RAID10 LV with a usable size of 5GiB, using 2 stripes, each on @@ -62,36 +62,36 @@ differently: but \fB-m\fP specifies the number of images in addition to the first image). .br -.B lvcreate \-\-type raid10 \-L 5G \-i 2 \-m 1 \-n mylv vg00 +.B lvcreate --type raid10 -L 5G -i 2 -m 1 -n mylv vg00 Create a 1TiB thin LV, first creating a new thin pool for it, where the thin pool has 100MiB of space, uses 2 stripes, has a 64KiB stripe size, and 256KiB chunk size. .br -.B lvcreate \-\-type thin \-\-name mylv \-\-thinpool mypool +.B lvcreate --type thin --name mylv --thinpool mypool .RS -.B \-V 1t \-L 100m \-i 2 \-I 64 \-c 256 vg00 +.B -V 1t -L 100m -i 2 -I 64 -c 256 vg00 .RE Create a thin snapshot of a thin LV (the size option must not be used, otherwise a copy-on-write snapshot would be created). .br -.B lvcreate \-\-snapshot \-\-name mysnap vg00/thinvol +.B lvcreate --snapshot --name mysnap vg00/thinvol Create a thin snapshot of the read-only inactive LV named "origin" which becomes an external origin for the thin snapshot LV. .br -.B lvcreate \-\-snapshot \-\-name mysnap \-\-thinpool mypool vg00/origin +.B lvcreate --snapshot --name mysnap --thinpool mypool vg00/origin Create a cache pool from a fast physical device. The cache pool can then be used to cache an LV. .br -.B lvcreate \-\-type cache-pool \-L 1G \-n my_cpool vg00 /dev/fast1 +.B lvcreate --type cache-pool -L 1G -n my_cpool vg00 /dev/fast1 Create a cache LV, first creating a new origin LV on a slow physical device, then combining the new origin LV with an existing cache pool. .br -.B lvcreate \-\-type cache \-\-cachepool my_cpool +.B lvcreate --type cache --cachepool my_cpool .RS -.B \-L 100G \-n mylv vg00 /dev/slow1 +.B -L 100G -n mylv vg00 /dev/slow1 .RE |