openzfs / zfs

OpenZFS on Linux and FreeBSD
https://openzfs.github.io/openzfs-docs
Other
10.68k stars 1.76k forks source link

Expand `zpool-remove.8` manpage with example results #16777

Closed smokris closed 6 days ago

smokris commented 1 week ago

Motivation and Context

In the zpool-remove manpage's example of removing mirrors, it wasn't clear to me whether the removal commands would remove the entire vdev, or merely cause the mirrored vdev become unmirrored (reduce its redundancy). I performed a test and confirmed that it's the former, so I figured it might be useful to include the results in the example.

Also, zpool-remove.8 has a comment cross-referencing to zpool.8, but the example number was off, so I fixed it.

How Has This Been Tested?

Verified formatting by running:

man ./man/man8/zpool-remove.8
man ./man/man8/zpool.8

Also ran:

./scripts/mancheck.sh man

Types of changes

Checklist: