'zpool get' command help output has two small errors

[opsec]

System information

Type	Version/Name
Distribution Name	FreeBSD
Distribution Version	15 and earlier
Kernel Version	FreeBSD
Architecture	amd64
OpenZFS Version	zfs-2.2.99-474-FreeBSD_g8f1b7a6fa

Describe the problem you're observing

zpool set
shows a list of properties and explainers. Two small errors:

• the property "capacity" is a and not a
• the property "name" is missing.

see also:
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=204626

Describe how to reproduce the problem

see above

Include any warning/errors/backtraces from the system logs

[robn]

Thanks for the report!

First is easy fixed, good eye: #16881.

The second is .. interesting. As best I can tell, name isn't a real property, and is marked "hidden" and handled specially (ditto the dataset and vdev name properties). I suspect it's excluded because if not, this special handling would have to be invoked for every "get all properties" request, which complicates the code, and possibly add overheads.

Still, there is a difference between usage information and actually doing the work. We could list "hidden" properties in zpool get in the same way, but call them out with something like "these properties are only shown when explicitly asked for". Would that be useful, or just more confusing?