Skip to contentSkip to conversation

Documentation: kvm: Fix a section number

PATCH In review Xin Li (Intel) 2 participants 6 messages Apr 14, 2025 – Jun 16, 2025

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Documentation: kvm: Fix a section number

The previous section is 7.41, thus this should be 7.42.

---
 Documentation/virt/kvm/api.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
Documentation/virt/kvm/api.rst +1 -1
index 47c7c3f92314..58478b470860 100644
@@ -8478,7 +8478,7 @@ ENOSYS for the others.
 When enabled, KVM will exit to userspace with KVM_EXIT_SYSTEM_EVENT of
 type KVM_SYSTEM_EVENT_SUSPEND to process the guest suspend request.
 
-7.37 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
+7.42 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
 -------------------------------------
 
 :Architectures: arm64

base-commit: 8ffd015db85fea3e15a77027fda6c02ced4d2444

Signature · 1 line
2.49.0
maintainer
#1 lore raw
Quoted 12 lines · Xin Li (Intel)

The previous section is 7.41, thus this should be 7.42.

---
 Documentation/virt/kvm/api.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
Documentation/virt/kvm/api.rst +0 -0
index 47c7c3f92314..58478b470860 100644

Documentation/virt/kvm/api.rst ENOSYS for the others. · line 8482

Quoted 6 lines
Documentation/virt/kvm/api.rst +1 -1
@@ -8478,7 +8478,7 @@ ENOSYS for the others.
 When enabled, KVM will exit to userspace with KVM_EXIT_SYSTEM_EVENT of
 type KVM_SYSTEM_EVENT_SUSPEND to process the guest suspend request.
 
-7.37 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
+7.42 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
 -------------------------------------

The fix seems fine but ... I have to ask ... do the section numbers buy anything here? We have a documentation system that can do nice cross-references when needed, so I'm not sure that these numbers add anything other than a bit of manual maintenance hassle.

Thanks,

jon

author
#2 lore raw
Quoted 7 lines · Jonathan Corbet
Quoted 3 lines

-7.37 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
+7.42 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
-------------------------------------

The fix seems fine but ... I have to ask ... do the section numbers buy anything here? We have a documentation system that can do nice cross-references when needed, so I'm not sure that these numbers add anything other than a bit of manual maintenance hassle.

So you prefer to get rid of the section numbering?

Looks it makes it simpler to maintain the documentation. But that would anyway be another serial patches, right?

Thanks!
Xin

maintainer
#3 lore raw
Quoted 9 lines · Xin Li
Quoted 7 lines · Jonathan Corbet
Quoted 3 lines

-7.37 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
+7.42 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
-------------------------------------

The fix seems fine but ... I have to ask ... do the section numbers buy anything here? We have a documentation system that can do nice cross-references when needed, so I'm not sure that these numbers add anything other than a bit of manual maintenance hassle.

Quoted 4 lines

So you prefer to get rid of the section numbering?

Looks it makes it simpler to maintain the documentation. But that would anyway be another serial patches, right?

*I* would prefer it, but that call is really up to the KVM folks, not me. Their preference far outweighs mine on this ... I'm just venting :)

Thanks,

jon

author
#4 lore raw
Quoted 11 lines · Jonathan Corbet
Quoted 9 lines · Xin Li
Quoted 7 lines · Jonathan Corbet
Quoted 3 lines

-7.37 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
+7.42 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
-------------------------------------

The fix seems fine but ... I have to ask ... do the section numbers buy anything here? We have a documentation system that can do nice cross-references when needed, so I'm not sure that these numbers add anything other than a bit of manual maintenance hassle.

Quoted 7 lines
Quoted 4 lines

So you prefer to get rid of the section numbering?

Looks it makes it simpler to maintain the documentation. But that would anyway be another serial patches, right?

*I* would prefer it, but that call is really up to the KVM folks, not me. Their preference far outweighs mine on this ... I'm just venting :)

/facepalm

author
#5 lore raw
In reply to Xin Li (Intel)
Quoted 21 lines · Xin Li (Intel)

The previous section is 7.41, thus this should be 7.42.

---
  Documentation/virt/kvm/api.rst | 2 +-
  1 file changed, 1 insertion(+), 1 deletion(-)
Documentation/virt/kvm/api.rst +1 -1
index 47c7c3f92314..58478b470860 100644
@@ -8478,7 +8478,7 @@ ENOSYS for the others.
  When enabled, KVM will exit to userspace with KVM_EXIT_SYSTEM_EVENT of
  type KVM_SYSTEM_EVENT_SUSPEND to process the guest suspend request.
 
-7.37 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
+7.42 KVM_CAP_ARM_WRITABLE_IMP_ID_REGS
  -------------------------------------
 
  :Architectures: arm64
Quoted 1 line

base-commit: 8ffd015db85fea3e15a77027fda6c02ced4d2444

A gentle ping!