Date: Wed, 13 Nov 2019 02:59:45 -0000 From: "Pau Amma" <pauamma@gundo.com> To: freebsd-doc@freebsd.org Subject: Why is the <caution> text I'm adding not taking? Message-ID: <f9e33a255dc930e91bcb90d2326dfccc.squirrel@webmail.gundo.com>
next in thread | raw e-mail | index | archive | help
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?
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?f9e33a255dc930e91bcb90d2326dfccc.squirrel>