Why is the <caution> text I'm adding not taking?
Pau Amma
pauamma at gundo.com
Wed Nov 13 02:59:47 UTC 2019
Following a Freenode IRC discussion with tsoome on the unadvisability of
using whole disks in vdevs, I wanted to add the following <caution> to
en_US.ISO8859-1/books/handbook/zfs/chapter.xml:
<caution>
<para>Using an entire disk as part of a bootable
pool is strongly discouraged, as this may render
the pool unbootable. Likewise, you should not
use an entire disk as part of a mirror or
<acronym>RAID-Z</acronym> vdev. These are
because it it impossible to reliably determine
the size of an unpartitioned disk.</para>
</caution>
below:
<para
xml:id="zfs-term-vdev-disk"><emphasis>Disk</emphasis>
- The most basic type of vdev is a standard block
device. This can be an entire disk (such as
<filename><replaceable>/dev/ada0</replaceable></filename>
or
<filename><replaceable>/dev/da0</replaceable></filename>)
or a partition
(<filename><replaceable>/dev/ada0p3</replaceable></filename>
).
On &os;, there is no performance penalty for using
a partition rather than the entire disk. This
differs from recommendations made by the Solaris
documentation.</para>
This is similar to the way the <note> is written 2 <listitem>s below. Yet,
my new <caution> fails to appear after "make all install" whereas the
<note> does. Why? Did I make a mistake I'm not seeing?
More information about the freebsd-doc
mailing list