git: 6a2f1e3a06bc - stable/15 - nvmecontrol.8: Explain non-operational power modes

The branch stable/15 has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=6a2f1e3a06bc4e70eb60ac37b77cf6f3c7d9d8a3

commit 6a2f1e3a06bc4e70eb60ac37b77cf6f3c7d9d8a3
Author:     Andre Albsmeier <mail@fbsd2.e4m.org>
AuthorDate: 2026-07-31 23:27:23 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-08-05 15:54:25 +0000

    nvmecontrol.8: Explain non-operational power modes
    
    `nvmecontrol power -l ...` lists the available power modes.
    Non-operational modes are marked with an asterisk. While here,
    add <device-id | namespace-id> to the "nvmecontrol power" synopsis.
    
    MFC after:              3 days
    Reviewed by:            dab, imp, michaelo, ziaee
    Differential Revision:  https://reviews.freebsd.org/D58480
    
    (cherry picked from commit 868158f7fd2a172ef22f1b6b682cc1d38e54cf63)
---
 sbin/nvmecontrol/nvmecontrol.8 | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/sbin/nvmecontrol/nvmecontrol.8 b/sbin/nvmecontrol/nvmecontrol.8
index 55373f428ddf..4497263d5873 100644
--- a/sbin/nvmecontrol/nvmecontrol.8
+++ b/sbin/nvmecontrol/nvmecontrol.8
@@ -33,7 +33,7 @@
 .\"
 .\" Author: Jim Harris <jimharris@FreeBSD.org>
 .\"
-.Dd February 20, 2026
+.Dd July 31, 2026
 .Dt NVMECONTROL 8
 .Os
 .Sh NAME
@@ -175,6 +175,7 @@
 .Op Fl l
 .Op Fl p power_state
 .Op Fl w workload_hint
+.Aq Ar device-id | Ar namespace-id
 .Nm
 .Ic selftest
 .Aq Fl c Ar code
@@ -628,6 +629,9 @@ Manage the power modes of the NVMe controller.
 .Bl -tag -width 6n
 .It Fl l
 List all supported power modes.
+Modes marked with an asterisk
+.Pq Dq *
+are non-operational power modes.
 .It Fl p Ar mode
 Set the power mode to
 .Ar mode .