Project

General

Profile

Bug #5659

in the manual page for zpool(1M), one misuse of the word 'zpool' to describe a pool

Added by Graham Perrin over 4 years ago. Updated over 3 years ago.

Status:
Closed
Priority:
Normal
Assignee:
Category:
manpage - manual pages
Start date:
2015-02-25
Due date:
% Done:

100%

Estimated time:
Difficulty:
Bite-size
Tags:
needs-triage

Description

At https://github.com/illumos/illumos-gate/blob/master/usr/src/man/man1m/zpool.1m#L931

Do not add a disk that is currently configured as a quorum device to a zpool.

– should be:

Do not add a disk that is currently configured as a quorum device to a pool.

History

#1

Updated by Damian Wojslaw over 4 years ago

Is it? zpool is just what it is: a zfs pool and in this context both are interchangeable, IMHO.

#2

Updated by Graham Perrin about 4 years ago

… zpool is just what it is: a zfs pool …

For correctness and consistency in documentation, such as manual pages, there should not be interchangeability around the name of a command (not to be confused with a pool).

#3

Updated by Yuri Pankov over 3 years ago

  • Subject changed from in the manual page for zpool(1), one misuse of the word 'zpool' to describe a pool to in the manual page for zpool(1M), one misuse of the word 'zpool' to describe a pool
  • Status changed from New to In Progress
  • Assignee set to Yuri Pankov
#4

Updated by Electric Monk over 3 years ago

  • Status changed from In Progress to Closed
  • % Done changed from 0 to 100

git commit c8323d4323a565676ba44883bfeb289d9ed8813e

commit  c8323d4323a565676ba44883bfeb289d9ed8813e
Author: Yuri Pankov <yuri.pankov@nexenta.com>
Date:   2016-03-01T14:59:29.000Z

    4465 zpool(1M) is able to offline cache vdevs despite what man page says
    5659 in the manual page for zpool(1M), one misuse of the word 'zpool' to describe a pool
    Reviewed by: Matthew Ahrens <mahrens@delphix.com>
    Approved by: Hans Rosenfeld <rosenfeld@grumpf.hope-2000.org>

#5

Updated by Graham Perrin over 3 years ago

Thanks!

Meanwhile, in the world of ZFS on Linux, zpool (not the zpool command), ZPool (not the zpool command) and expressions such as ZFS ZPool are popularised at pages such as https://wiki.ubuntu.com/ZFS/ZPool https://wiki.ubuntu.com/Kernel/Reference/ZFS and https://wiki.ubuntu.com/ZFS/VirtualFileSystem

Also available in: Atom PDF