Page MenuHomeFreeBSD

nvmecontrol.8: Explain which power modes are marked with an asterisk
ClosedPublic

Authored by mail_fbsd2.e4m.org on Mon, Jul 27, 2:47 PM.
Tags
None
Referenced Files
F166079065: D58480.diff
Tue, Aug 11, 2:05 PM
F166023286: D58480.id182790.diff
Tue, Aug 11, 3:27 AM
Unknown Object (File)
Mon, Aug 10, 9:12 PM
Unknown Object (File)
Sat, Aug 8, 5:55 PM
Unknown Object (File)
Sat, Aug 8, 5:47 PM
Unknown Object (File)
Sat, Aug 8, 1:58 PM
Unknown Object (File)
Sat, Aug 8, 1:56 PM
Unknown Object (File)
Sat, Aug 8, 10:07 AM
Subscribers

Details

Summary

"nvmecontrol power -l ..." lists the available power modes. Non-operational modes are
marked with an asterisk. This needs to be explained in the man page.
While here, add ⟨device-id | namespace-id⟩ to the "nvmecontrol power" synopsis.

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

mail_fbsd2.e4m.org updated this revision to Diff 182790.

Now with the correct diff...

michaelo added a reviewer: ziaee.
michaelo added inline comments.
sbin/nvmecontrol/nvmecontrol.8
36

You are from the future.

This revision now requires changes to proceed.Mon, Jul 27, 3:52 PM

This looks fine as is. I usually tweak .Dd dates when I notice :) But this one should be fixed.

dab requested changes to this revision.Tue, Jul 28, 2:03 AM
dab added inline comments.
sbin/nvmecontrol/nvmecontrol.8
36

Agree that this date should be fixed. Otherwise, change LGTM.

ziaee requested changes to this revision.Tue, Jul 28, 4:58 AM
ziaee added inline comments.
sbin/nvmecontrol/nvmecontrol.8
633

In this doc, the quote style is Dq (28 matches), so we should use that.

mail_fbsd2.e4m.org marked 2 inline comments as done.

Fix date and quoting...

Can I MFC this after three days? Any objections?

ziaee requested changes to this revision.Tue, Jul 28, 7:50 PM

Yes, please MFC after 3 days.

sbin/nvmecontrol/nvmecontrol.8
633

The Pq that proceeded the Dq in my suggestion is important. Alternatively, you could use an appositive, but Pq Dq is what we want here.

This revision now requires changes to proceed.Tue, Jul 28, 7:50 PM

I'm good with the text and mfc plan.

mail_fbsd2.e4m.org marked 2 inline comments as done.

Adding the overlooked "Pq"

Just saw that my inline comments apparently never made it. Let's see if we can change that
(this tool and I are not right for each other ;-)).

sbin/nvmecontrol/nvmecontrol.8
36

Interesting. Most people say I live in the past (due to my affinity to ctm and cvs:-)).
Now fixed (no idea what got into me here...)

633

Again what learned (I just took pwd_mkdb.8 as example).

633

The Pq that proceeded the Dq in my suggestion is important. Alternatively, you could use an appositive, but Pq Dq is what we want here.

OK. The email I received contained just "In this doc, the quote style is Dq (28 matches), so we should use that."
So I started to check the doc for "Dq" to see what it does and implemented "Dq". I didn't check the inline
comment -- silently assuming it would contain the same content as the email. So I missed your notes about Pq...

ziaee added inline comments.
sbin/nvmecontrol/nvmecontrol.8
633

My bad, I should have been more precise in the message.

This revision is now accepted and ready to land.Fri, Jul 31, 11:32 PM
sbin/nvmecontrol/nvmecontrol.8
633

Not at all. Im still learning this tool and will hopefully remember its peculiarities.

Thanks to you and all others for your patience :-)