docs/system/introduction.rst | 9 +++++++++ 1 file changed, 9 insertions(+)
Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others.
Suggested-by: Peter Maydell <peter.maydell@linaro.org>
Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254
Signed-off-by: Linisha <linisha232@gmail.com>
---
v2: Take a different approach based on review feedback from Daniel
Berrangé and Peter Maydell. Instead of incorrectly claiming
pflash0/pflash1 are virt-only (they actually work on x86 pc/q35
machines too), add a general note near the start of the introduction
about how options, properties, and command lines may differ between
target architectures and machine types.
docs/system/introduction.rst | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst
index bec7291e47..8d9ef61d26 100644
--- a/docs/system/introduction.rst
+++ b/docs/system/introduction.rst
@@ -1,6 +1,15 @@
Introduction
============
+.. note::
+ QEMU supports many different target CPU architectures and many
+ different machine types for each architecture. Options, properties,
+ and command lines that work for one architecture or machine type
+ will not necessarily work on another. The examples shown in this
+ manual are specific to the architecture and machine type being
+ demonstrated. When in doubt, consult the documentation for your
+ specific target architecture and machine type.
+
.. _Accelerators:
Virtualisation Accelerators
--
2.47.0.windows.1
CC Pierrick as docs maintainer. On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: > Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. Please ensure commit messages are line wrapped. > > Suggested-by: Peter Maydell <peter.maydell@linaro.org> > > Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > Signed-off-by: Linisha <linisha232@gmail.com> > --- > > v2: Take a different approach based on review feedback from Daniel > Berrangé and Peter Maydell. Instead of incorrectly claiming > pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > machines too), add a general note near the start of the introduction > about how options, properties, and command lines may differ between > target architectures and machine types. > > > docs/system/introduction.rst | 9 +++++++++ > 1 file changed, 9 insertions(+) > > diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst > index bec7291e47..8d9ef61d26 100644 > --- a/docs/system/introduction.rst > +++ b/docs/system/introduction.rst > @@ -1,6 +1,15 @@ > Introduction > ============ > > +.. note:: > + QEMU supports many different target CPU architectures and many > + different machine types for each architecture. Options, properties, > + and command lines that work for one architecture or machine type > + will not necessarily work on another. The examples shown in this > + manual are specific to the architecture and machine type being > + demonstrated. When in doubt, consult the documentation for your > + specific target architecture and machine type. > + Not convinced many people will read this, but I gues it doesn't hurt. Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > .. _Accelerators: > > Virtualisation Accelerators > -- > 2.47.0.windows.1 > With regards, Daniel -- |: https://berrange.com ~~ https://hachyderm.io/@berrange :| |: https://libvirt.org ~~ https://entangle-photo.org :| |: https://pixelfed.art/berrange ~~ https://fstop138.berrange.com :|
On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: > CC Pierrick as docs maintainer. > Thanks Daniel. I wonder how I was not in original recipients for this patch. @Linisha: did you explicitly set list of recipients, or remove some people? > On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: >> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. > > Please ensure commit messages are line wrapped. > >> >> Suggested-by: Peter Maydell <peter.maydell@linaro.org> >> >> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 >> Signed-off-by: Linisha <linisha232@gmail.com> >> --- >> >> v2: Take a different approach based on review feedback from Daniel >> Berrangé and Peter Maydell. Instead of incorrectly claiming >> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 >> machines too), add a general note near the start of the introduction >> about how options, properties, and command lines may differ between >> target architectures and machine types. >> >> >> docs/system/introduction.rst | 9 +++++++++ >> 1 file changed, 9 insertions(+) >> >> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst >> index bec7291e47..8d9ef61d26 100644 >> --- a/docs/system/introduction.rst >> +++ b/docs/system/introduction.rst >> @@ -1,6 +1,15 @@ >> Introduction >> ============ >> >> +.. note:: >> + QEMU supports many different target CPU architectures and many >> + different machine types for each architecture. Options, properties, >> + and command lines that work for one architecture or machine type >> + will not necessarily work on another. The examples shown in this >> + manual are specific to the architecture and machine type being >> + demonstrated. When in doubt, consult the documentation for your >> + specific target architecture and machine type. >> + > > Not convinced many people will read this, but I gues it doesn't > hurt. > > Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > > >> .. _Accelerators: >> >> Virtualisation Accelerators >> -- >> 2.47.0.windows.1 >> > > With regards, > Daniel
Hi Daniel, Pierrick, Thank you, Daniel, for the Reviewed-by tag and the wrapping feedback. Pierrick — I didn't intentionally remove anyone. I used scripts/get_maintainer.pl -f docs/ which returned Peter Maydell, Philippe Mathieu-Daudé, Richard Henderson, Alex Bennée, and Cédric Le Goater, and I picked CCs from that list along with people who responded to v1. You weren't in the script's output, so I didn't know to include you. Apologies for the miss — I'll CC you on any future v3. Daniel — I'll send a v3 with the commit message body properly line-wrapped to 76 characters. Let me know if there are other changes you'd like at the same time. Best regards, Linisha On Fri, Jun 26, 2026 at 9:09 PM Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> wrote: > > On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: > > CC Pierrick as docs maintainer. > > > > Thanks Daniel. > > I wonder how I was not in original recipients for this patch. > @Linisha: did you explicitly set list of recipients, or remove some people? > > > On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: > >> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. > > > > Please ensure commit messages are line wrapped. > > > >> > >> Suggested-by: Peter Maydell <peter.maydell@linaro.org> > >> > >> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > >> Signed-off-by: Linisha <linisha232@gmail.com> > >> --- > >> > >> v2: Take a different approach based on review feedback from Daniel > >> Berrangé and Peter Maydell. Instead of incorrectly claiming > >> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > >> machines too), add a general note near the start of the introduction > >> about how options, properties, and command lines may differ between > >> target architectures and machine types. > >> > >> > >> docs/system/introduction.rst | 9 +++++++++ > >> 1 file changed, 9 insertions(+) > >> > >> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst > >> index bec7291e47..8d9ef61d26 100644 > >> --- a/docs/system/introduction.rst > >> +++ b/docs/system/introduction.rst > >> @@ -1,6 +1,15 @@ > >> Introduction > >> ============ > >> > >> +.. note:: > >> + QEMU supports many different target CPU architectures and many > >> + different machine types for each architecture. Options, properties, > >> + and command lines that work for one architecture or machine type > >> + will not necessarily work on another. The examples shown in this > >> + manual are specific to the architecture and machine type being > >> + demonstrated. When in doubt, consult the documentation for your > >> + specific target architecture and machine type. > >> + > > > > Not convinced many people will read this, but I gues it doesn't > > hurt. > > > > Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > > > > > >> .. _Accelerators: > >> > >> Virtualisation Accelerators > >> -- > >> 2.47.0.windows.1 > >> > > > > With regards, > > Daniel >
On 6/26/2026 10:44 AM, linisha wrote: > Hi Daniel, Pierrick, > > Thank you, Daniel, for the Reviewed-by tag and the wrapping feedback. > > Pierrick — I didn't intentionally remove anyone. I used > scripts/get_maintainer.pl -f docs/ which returned Peter Maydell, > Philippe Mathieu-Daudé, Richard Henderson, Alex Bennée, and Cédric Le > Goater, and I picked CCs from that list along with people who > responded to v1. You weren't in the script's output, so I didn't know > to include you. Apologies for the miss — I'll CC you on any future v3. > Thanks for your answer. Just to dig this further, is your tree up to date? When running it on my side (from upstream/master), I get: $ scripts/get_maintainer.pl -f docs/ Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General Documenta...) qemu-devel@nongnu.org (open list:All patches CC here) > Daniel — I'll send a v3 with the commit message body properly > line-wrapped to 76 characters. Let me know if there are other changes > you'd like at the same time. > > Best regards, Linisha > > On Fri, Jun 26, 2026 at 9:09 PM Pierrick Bouvier > <pierrick.bouvier@oss.qualcomm.com> wrote: >> >> On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: >>> CC Pierrick as docs maintainer. >>> >> >> Thanks Daniel. >> >> I wonder how I was not in original recipients for this patch. >> @Linisha: did you explicitly set list of recipients, or remove some people? >> >>> On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: >>>> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. >>> >>> Please ensure commit messages are line wrapped. >>> >>>> >>>> Suggested-by: Peter Maydell <peter.maydell@linaro.org> >>>> >>>> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 >>>> Signed-off-by: Linisha <linisha232@gmail.com> >>>> --- >>>> >>>> v2: Take a different approach based on review feedback from Daniel >>>> Berrangé and Peter Maydell. Instead of incorrectly claiming >>>> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 >>>> machines too), add a general note near the start of the introduction >>>> about how options, properties, and command lines may differ between >>>> target architectures and machine types. >>>> >>>> >>>> docs/system/introduction.rst | 9 +++++++++ >>>> 1 file changed, 9 insertions(+) >>>> >>>> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst >>>> index bec7291e47..8d9ef61d26 100644 >>>> --- a/docs/system/introduction.rst >>>> +++ b/docs/system/introduction.rst >>>> @@ -1,6 +1,15 @@ >>>> Introduction >>>> ============ >>>> >>>> +.. note:: >>>> + QEMU supports many different target CPU architectures and many >>>> + different machine types for each architecture. Options, properties, >>>> + and command lines that work for one architecture or machine type >>>> + will not necessarily work on another. The examples shown in this >>>> + manual are specific to the architecture and machine type being >>>> + demonstrated. When in doubt, consult the documentation for your >>>> + specific target architecture and machine type. >>>> + >>> >>> Not convinced many people will read this, but I gues it doesn't >>> hurt. >>> >>> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> >>> >>> >>>> .. _Accelerators: >>>> >>>> Virtualisation Accelerators >>>> -- >>>> 2.47.0.windows.1 >>>> >>> >>> With regards, >>> Daniel >>
Hi Pierrick, You're right — my tree was outdated. I just ran git pull and now scripts/get_maintainer.pl -f docs/ does show you as maintainer for General Documentation. Sorry for the miss; I'll make sure to pull and re-check maintainers before sending future versions. Best regards, Linisha On Fri, Jun 26, 2026 at 11:58 PM Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> wrote: > > On 6/26/2026 10:44 AM, linisha wrote: > > Hi Daniel, Pierrick, > > > > Thank you, Daniel, for the Reviewed-by tag and the wrapping feedback. > > > > Pierrick — I didn't intentionally remove anyone. I used > > scripts/get_maintainer.pl -f docs/ which returned Peter Maydell, > > Philippe Mathieu-Daudé, Richard Henderson, Alex Bennée, and Cédric Le > > Goater, and I picked CCs from that list along with people who > > responded to v1. You weren't in the script's output, so I didn't know > > to include you. Apologies for the miss — I'll CC you on any future v3. > > > > Thanks for your answer. > > Just to dig this further, is your tree up to date? > > When running it on my side (from upstream/master), I get: > $ scripts/get_maintainer.pl -f docs/ > Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General > Documenta...) > qemu-devel@nongnu.org (open list:All patches CC here) > > > Daniel — I'll send a v3 with the commit message body properly > > line-wrapped to 76 characters. Let me know if there are other changes > > you'd like at the same time. > > > > Best regards, Linisha > > > > On Fri, Jun 26, 2026 at 9:09 PM Pierrick Bouvier > > <pierrick.bouvier@oss.qualcomm.com> wrote: > >> > >> On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: > >>> CC Pierrick as docs maintainer. > >>> > >> > >> Thanks Daniel. > >> > >> I wonder how I was not in original recipients for this patch. > >> @Linisha: did you explicitly set list of recipients, or remove some people? > >> > >>> On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: > >>>> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. > >>> > >>> Please ensure commit messages are line wrapped. > >>> > >>>> > >>>> Suggested-by: Peter Maydell <peter.maydell@linaro.org> > >>>> > >>>> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > >>>> Signed-off-by: Linisha <linisha232@gmail.com> > >>>> --- > >>>> > >>>> v2: Take a different approach based on review feedback from Daniel > >>>> Berrangé and Peter Maydell. Instead of incorrectly claiming > >>>> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > >>>> machines too), add a general note near the start of the introduction > >>>> about how options, properties, and command lines may differ between > >>>> target architectures and machine types. > >>>> > >>>> > >>>> docs/system/introduction.rst | 9 +++++++++ > >>>> 1 file changed, 9 insertions(+) > >>>> > >>>> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst > >>>> index bec7291e47..8d9ef61d26 100644 > >>>> --- a/docs/system/introduction.rst > >>>> +++ b/docs/system/introduction.rst > >>>> @@ -1,6 +1,15 @@ > >>>> Introduction > >>>> ============ > >>>> > >>>> +.. note:: > >>>> + QEMU supports many different target CPU architectures and many > >>>> + different machine types for each architecture. Options, properties, > >>>> + and command lines that work for one architecture or machine type > >>>> + will not necessarily work on another. The examples shown in this > >>>> + manual are specific to the architecture and machine type being > >>>> + demonstrated. When in doubt, consult the documentation for your > >>>> + specific target architecture and machine type. > >>>> + > >>> > >>> Not convinced many people will read this, but I gues it doesn't > >>> hurt. > >>> > >>> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > >>> > >>> > >>>> .. _Accelerators: > >>>> > >>>> Virtualisation Accelerators > >>>> -- > >>>> 2.47.0.windows.1 > >>>> > >>> > >>> With regards, > >>> Daniel > >> >
Hi Pierrick, Quick correction to my last reply — I checked again more carefully and get_maintainer.pl -f docs/ still says "No maintainers found" on my tree (origin/master), even after git pull. It only lists recent contributors. So whatever change adds you to MAINTAINERS isn't in my tree yet — could you point me to the commit/branch? Apologies for the confusion. Best regards, Linisha On Sat, Jun 27, 2026 at 12:08 AM linisha <linisha232@gmail.com> wrote: > > Hi Pierrick, > > You're right — my tree was outdated. I just ran git pull and now > scripts/get_maintainer.pl -f docs/ does show you as maintainer for > General Documentation. Sorry for the miss; I'll make sure to pull and > re-check maintainers before sending future versions. > > Best regards, > Linisha > > On Fri, Jun 26, 2026 at 11:58 PM Pierrick Bouvier > <pierrick.bouvier@oss.qualcomm.com> wrote: > > > > On 6/26/2026 10:44 AM, linisha wrote: > > > Hi Daniel, Pierrick, > > > > > > Thank you, Daniel, for the Reviewed-by tag and the wrapping feedback. > > > > > > Pierrick — I didn't intentionally remove anyone. I used > > > scripts/get_maintainer.pl -f docs/ which returned Peter Maydell, > > > Philippe Mathieu-Daudé, Richard Henderson, Alex Bennée, and Cédric Le > > > Goater, and I picked CCs from that list along with people who > > > responded to v1. You weren't in the script's output, so I didn't know > > > to include you. Apologies for the miss — I'll CC you on any future v3. > > > > > > > Thanks for your answer. > > > > Just to dig this further, is your tree up to date? > > > > When running it on my side (from upstream/master), I get: > > $ scripts/get_maintainer.pl -f docs/ > > Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General > > Documenta...) > > qemu-devel@nongnu.org (open list:All patches CC here) > > > > > Daniel — I'll send a v3 with the commit message body properly > > > line-wrapped to 76 characters. Let me know if there are other changes > > > you'd like at the same time. > > > > > > Best regards, Linisha > > > > > > On Fri, Jun 26, 2026 at 9:09 PM Pierrick Bouvier > > > <pierrick.bouvier@oss.qualcomm.com> wrote: > > >> > > >> On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: > > >>> CC Pierrick as docs maintainer. > > >>> > > >> > > >> Thanks Daniel. > > >> > > >> I wonder how I was not in original recipients for this patch. > > >> @Linisha: did you explicitly set list of recipients, or remove some people? > > >> > > >>> On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: > > >>>> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. > > >>> > > >>> Please ensure commit messages are line wrapped. > > >>> > > >>>> > > >>>> Suggested-by: Peter Maydell <peter.maydell@linaro.org> > > >>>> > > >>>> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > > >>>> Signed-off-by: Linisha <linisha232@gmail.com> > > >>>> --- > > >>>> > > >>>> v2: Take a different approach based on review feedback from Daniel > > >>>> Berrangé and Peter Maydell. Instead of incorrectly claiming > > >>>> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > > >>>> machines too), add a general note near the start of the introduction > > >>>> about how options, properties, and command lines may differ between > > >>>> target architectures and machine types. > > >>>> > > >>>> > > >>>> docs/system/introduction.rst | 9 +++++++++ > > >>>> 1 file changed, 9 insertions(+) > > >>>> > > >>>> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst > > >>>> index bec7291e47..8d9ef61d26 100644 > > >>>> --- a/docs/system/introduction.rst > > >>>> +++ b/docs/system/introduction.rst > > >>>> @@ -1,6 +1,15 @@ > > >>>> Introduction > > >>>> ============ > > >>>> > > >>>> +.. note:: > > >>>> + QEMU supports many different target CPU architectures and many > > >>>> + different machine types for each architecture. Options, properties, > > >>>> + and command lines that work for one architecture or machine type > > >>>> + will not necessarily work on another. The examples shown in this > > >>>> + manual are specific to the architecture and machine type being > > >>>> + demonstrated. When in doubt, consult the documentation for your > > >>>> + specific target architecture and machine type. > > >>>> + > > >>> > > >>> Not convinced many people will read this, but I gues it doesn't > > >>> hurt. > > >>> > > >>> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > > >>> > > >>> > > >>>> .. _Accelerators: > > >>>> > > >>>> Virtualisation Accelerators > > >>>> -- > > >>>> 2.47.0.windows.1 > > >>>> > > >>> > > >>> With regards, > > >>> Daniel > > >> > >
Just to clear the confusion, attached the screenshot. Best regards, Linisha On Sat, Jun 27, 2026 at 12:10 AM linisha <linisha232@gmail.com> wrote: > > Hi Pierrick, > > Quick correction to my last reply — I checked again more carefully and > get_maintainer.pl -f docs/ still says "No maintainers found" on my > tree (origin/master), even after git pull. It only lists recent > contributors. So whatever change adds you to MAINTAINERS isn't in my > tree yet — could you point me to the commit/branch? > > Apologies for the confusion. > > Best regards, > Linisha > > On Sat, Jun 27, 2026 at 12:08 AM linisha <linisha232@gmail.com> wrote: > > > > Hi Pierrick, > > > > You're right — my tree was outdated. I just ran git pull and now > > scripts/get_maintainer.pl -f docs/ does show you as maintainer for > > General Documentation. Sorry for the miss; I'll make sure to pull and > > re-check maintainers before sending future versions. > > > > Best regards, > > Linisha > > > > On Fri, Jun 26, 2026 at 11:58 PM Pierrick Bouvier > > <pierrick.bouvier@oss.qualcomm.com> wrote: > > > > > > On 6/26/2026 10:44 AM, linisha wrote: > > > > Hi Daniel, Pierrick, > > > > > > > > Thank you, Daniel, for the Reviewed-by tag and the wrapping feedback. > > > > > > > > Pierrick — I didn't intentionally remove anyone. I used > > > > scripts/get_maintainer.pl -f docs/ which returned Peter Maydell, > > > > Philippe Mathieu-Daudé, Richard Henderson, Alex Bennée, and Cédric Le > > > > Goater, and I picked CCs from that list along with people who > > > > responded to v1. You weren't in the script's output, so I didn't know > > > > to include you. Apologies for the miss — I'll CC you on any future v3. > > > > > > > > > > Thanks for your answer. > > > > > > Just to dig this further, is your tree up to date? > > > > > > When running it on my side (from upstream/master), I get: > > > $ scripts/get_maintainer.pl -f docs/ > > > Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General > > > Documenta...) > > > qemu-devel@nongnu.org (open list:All patches CC here) > > > > > > > Daniel — I'll send a v3 with the commit message body properly > > > > line-wrapped to 76 characters. Let me know if there are other changes > > > > you'd like at the same time. > > > > > > > > Best regards, Linisha > > > > > > > > On Fri, Jun 26, 2026 at 9:09 PM Pierrick Bouvier > > > > <pierrick.bouvier@oss.qualcomm.com> wrote: > > > >> > > > >> On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: > > > >>> CC Pierrick as docs maintainer. > > > >>> > > > >> > > > >> Thanks Daniel. > > > >> > > > >> I wonder how I was not in original recipients for this patch. > > > >> @Linisha: did you explicitly set list of recipients, or remove some people? > > > >> > > > >>> On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: > > > >>>> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. > > > >>> > > > >>> Please ensure commit messages are line wrapped. > > > >>> > > > >>>> > > > >>>> Suggested-by: Peter Maydell <peter.maydell@linaro.org> > > > >>>> > > > >>>> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > > > >>>> Signed-off-by: Linisha <linisha232@gmail.com> > > > >>>> --- > > > >>>> > > > >>>> v2: Take a different approach based on review feedback from Daniel > > > >>>> Berrangé and Peter Maydell. Instead of incorrectly claiming > > > >>>> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > > > >>>> machines too), add a general note near the start of the introduction > > > >>>> about how options, properties, and command lines may differ between > > > >>>> target architectures and machine types. > > > >>>> > > > >>>> > > > >>>> docs/system/introduction.rst | 9 +++++++++ > > > >>>> 1 file changed, 9 insertions(+) > > > >>>> > > > >>>> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst > > > >>>> index bec7291e47..8d9ef61d26 100644 > > > >>>> --- a/docs/system/introduction.rst > > > >>>> +++ b/docs/system/introduction.rst > > > >>>> @@ -1,6 +1,15 @@ > > > >>>> Introduction > > > >>>> ============ > > > >>>> > > > >>>> +.. note:: > > > >>>> + QEMU supports many different target CPU architectures and many > > > >>>> + different machine types for each architecture. Options, properties, > > > >>>> + and command lines that work for one architecture or machine type > > > >>>> + will not necessarily work on another. The examples shown in this > > > >>>> + manual are specific to the architecture and machine type being > > > >>>> + demonstrated. When in doubt, consult the documentation for your > > > >>>> + specific target architecture and machine type. > > > >>>> + > > > >>> > > > >>> Not convinced many people will read this, but I gues it doesn't > > > >>> hurt. > > > >>> > > > >>> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > > > >>> > > > >>> > > > >>>> .. _Accelerators: > > > >>>> > > > >>>> Virtualisation Accelerators > > > >>>> -- > > > >>>> 2.47.0.windows.1 > > > >>>> > > > >>> > > > >>> With regards, > > > >>> Daniel > > > >> > > >
On 6/26/2026 11:44 AM, linisha wrote: > Just to clear the confusion, attached the screenshot. > Hum interesting. On my side, reproduced on a clean debian container: $ git clone https://gitlab.com/qemu-project/qemu --depth=1 && cd qemu && ./scripts/get_maintainer.pl -f docs/ Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General Documenta...) qemu-devel@nongnu.org (open list:All patches CC here) Maybe we have a funny joke hiding there with mingw/windows. > Best regards, > Linisha > > On Sat, Jun 27, 2026 at 12:10 AM linisha <linisha232@gmail.com> wrote: >> >> Hi Pierrick, >> >> Quick correction to my last reply — I checked again more carefully and >> get_maintainer.pl -f docs/ still says "No maintainers found" on my >> tree (origin/master), even after git pull. It only lists recent >> contributors. So whatever change adds you to MAINTAINERS isn't in my >> tree yet — could you point me to the commit/branch? >> >> Apologies for the confusion. >> >> Best regards, >> Linisha >> >> On Sat, Jun 27, 2026 at 12:08 AM linisha <linisha232@gmail.com> wrote: >>> >>> Hi Pierrick, >>> >>> You're right — my tree was outdated. I just ran git pull and now >>> scripts/get_maintainer.pl -f docs/ does show you as maintainer for >>> General Documentation. Sorry for the miss; I'll make sure to pull and >>> re-check maintainers before sending future versions. >>> >>> Best regards, >>> Linisha >>> >>> On Fri, Jun 26, 2026 at 11:58 PM Pierrick Bouvier >>> <pierrick.bouvier@oss.qualcomm.com> wrote: >>>> >>>> On 6/26/2026 10:44 AM, linisha wrote: >>>>> Hi Daniel, Pierrick, >>>>> >>>>> Thank you, Daniel, for the Reviewed-by tag and the wrapping feedback. >>>>> >>>>> Pierrick — I didn't intentionally remove anyone. I used >>>>> scripts/get_maintainer.pl -f docs/ which returned Peter Maydell, >>>>> Philippe Mathieu-Daudé, Richard Henderson, Alex Bennée, and Cédric Le >>>>> Goater, and I picked CCs from that list along with people who >>>>> responded to v1. You weren't in the script's output, so I didn't know >>>>> to include you. Apologies for the miss — I'll CC you on any future v3. >>>>> >>>> >>>> Thanks for your answer. >>>> >>>> Just to dig this further, is your tree up to date? >>>> >>>> When running it on my side (from upstream/master), I get: >>>> $ scripts/get_maintainer.pl -f docs/ >>>> Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General >>>> Documenta...) >>>> qemu-devel@nongnu.org (open list:All patches CC here) >>>> >>>>> Daniel — I'll send a v3 with the commit message body properly >>>>> line-wrapped to 76 characters. Let me know if there are other changes >>>>> you'd like at the same time. >>>>> >>>>> Best regards, Linisha >>>>> >>>>> On Fri, Jun 26, 2026 at 9:09 PM Pierrick Bouvier >>>>> <pierrick.bouvier@oss.qualcomm.com> wrote: >>>>>> >>>>>> On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: >>>>>>> CC Pierrick as docs maintainer. >>>>>>> >>>>>> >>>>>> Thanks Daniel. >>>>>> >>>>>> I wonder how I was not in original recipients for this patch. >>>>>> @Linisha: did you explicitly set list of recipients, or remove some people? >>>>>> >>>>>>> On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: >>>>>>>> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. >>>>>>> >>>>>>> Please ensure commit messages are line wrapped. >>>>>>> >>>>>>>> >>>>>>>> Suggested-by: Peter Maydell <peter.maydell@linaro.org> >>>>>>>> >>>>>>>> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 >>>>>>>> Signed-off-by: Linisha <linisha232@gmail.com> >>>>>>>> --- >>>>>>>> >>>>>>>> v2: Take a different approach based on review feedback from Daniel >>>>>>>> Berrangé and Peter Maydell. Instead of incorrectly claiming >>>>>>>> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 >>>>>>>> machines too), add a general note near the start of the introduction >>>>>>>> about how options, properties, and command lines may differ between >>>>>>>> target architectures and machine types. >>>>>>>> >>>>>>>> >>>>>>>> docs/system/introduction.rst | 9 +++++++++ >>>>>>>> 1 file changed, 9 insertions(+) >>>>>>>> >>>>>>>> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst >>>>>>>> index bec7291e47..8d9ef61d26 100644 >>>>>>>> --- a/docs/system/introduction.rst >>>>>>>> +++ b/docs/system/introduction.rst >>>>>>>> @@ -1,6 +1,15 @@ >>>>>>>> Introduction >>>>>>>> ============ >>>>>>>> >>>>>>>> +.. note:: >>>>>>>> + QEMU supports many different target CPU architectures and many >>>>>>>> + different machine types for each architecture. Options, properties, >>>>>>>> + and command lines that work for one architecture or machine type >>>>>>>> + will not necessarily work on another. The examples shown in this >>>>>>>> + manual are specific to the architecture and machine type being >>>>>>>> + demonstrated. When in doubt, consult the documentation for your >>>>>>>> + specific target architecture and machine type. >>>>>>>> + >>>>>>> >>>>>>> Not convinced many people will read this, but I gues it doesn't >>>>>>> hurt. >>>>>>> >>>>>>> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> >>>>>>> >>>>>>> >>>>>>>> .. _Accelerators: >>>>>>>> >>>>>>>> Virtualisation Accelerators >>>>>>>> -- >>>>>>>> 2.47.0.windows.1 >>>>>>>> >>>>>>> >>>>>>> With regards, >>>>>>> Daniel >>>>>> >>>>
Hmm that would explain it! I'm on Git Bash / MinGW on Windows, so there may indeed be a line-ending or Perl quirk affecting how the script parses MAINTAINERS. Good to know, I'll keep this in mind and double-check the MAINTAINERS file directly when picking CCs in the future, rather than relying solely on the script's output. On Sat, Jun 27, 2026 at 12:19 AM Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> wrote: > > On 6/26/2026 11:44 AM, linisha wrote: > > Just to clear the confusion, attached the screenshot. > > > > Hum interesting. > > On my side, reproduced on a clean debian container: > > $ git clone https://gitlab.com/qemu-project/qemu --depth=1 && > cd qemu && ./scripts/get_maintainer.pl -f docs/ > Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General > Documenta...) > qemu-devel@nongnu.org (open list:All patches CC here) > > Maybe we have a funny joke hiding there with mingw/windows. > > > Best regards, > > Linisha > > > > On Sat, Jun 27, 2026 at 12:10 AM linisha <linisha232@gmail.com> wrote: > >> > >> Hi Pierrick, > >> > >> Quick correction to my last reply — I checked again more carefully and > >> get_maintainer.pl -f docs/ still says "No maintainers found" on my > >> tree (origin/master), even after git pull. It only lists recent > >> contributors. So whatever change adds you to MAINTAINERS isn't in my > >> tree yet — could you point me to the commit/branch? > >> > >> Apologies for the confusion. > >> > >> Best regards, > >> Linisha > >> > >> On Sat, Jun 27, 2026 at 12:08 AM linisha <linisha232@gmail.com> wrote: > >>> > >>> Hi Pierrick, > >>> > >>> You're right — my tree was outdated. I just ran git pull and now > >>> scripts/get_maintainer.pl -f docs/ does show you as maintainer for > >>> General Documentation. Sorry for the miss; I'll make sure to pull and > >>> re-check maintainers before sending future versions. > >>> > >>> Best regards, > >>> Linisha > >>> > >>> On Fri, Jun 26, 2026 at 11:58 PM Pierrick Bouvier > >>> <pierrick.bouvier@oss.qualcomm.com> wrote: > >>>> > >>>> On 6/26/2026 10:44 AM, linisha wrote: > >>>>> Hi Daniel, Pierrick, > >>>>> > >>>>> Thank you, Daniel, for the Reviewed-by tag and the wrapping feedback. > >>>>> > >>>>> Pierrick — I didn't intentionally remove anyone. I used > >>>>> scripts/get_maintainer.pl -f docs/ which returned Peter Maydell, > >>>>> Philippe Mathieu-Daudé, Richard Henderson, Alex Bennée, and Cédric Le > >>>>> Goater, and I picked CCs from that list along with people who > >>>>> responded to v1. You weren't in the script's output, so I didn't know > >>>>> to include you. Apologies for the miss — I'll CC you on any future v3. > >>>>> > >>>> > >>>> Thanks for your answer. > >>>> > >>>> Just to dig this further, is your tree up to date? > >>>> > >>>> When running it on my side (from upstream/master), I get: > >>>> $ scripts/get_maintainer.pl -f docs/ > >>>> Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General > >>>> Documenta...) > >>>> qemu-devel@nongnu.org (open list:All patches CC here) > >>>> > >>>>> Daniel — I'll send a v3 with the commit message body properly > >>>>> line-wrapped to 76 characters. Let me know if there are other changes > >>>>> you'd like at the same time. > >>>>> > >>>>> Best regards, Linisha > >>>>> > >>>>> On Fri, Jun 26, 2026 at 9:09 PM Pierrick Bouvier > >>>>> <pierrick.bouvier@oss.qualcomm.com> wrote: > >>>>>> > >>>>>> On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: > >>>>>>> CC Pierrick as docs maintainer. > >>>>>>> > >>>>>> > >>>>>> Thanks Daniel. > >>>>>> > >>>>>> I wonder how I was not in original recipients for this patch. > >>>>>> @Linisha: did you explicitly set list of recipients, or remove some people? > >>>>>> > >>>>>>> On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: > >>>>>>>> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. > >>>>>>> > >>>>>>> Please ensure commit messages are line wrapped. > >>>>>>> > >>>>>>>> > >>>>>>>> Suggested-by: Peter Maydell <peter.maydell@linaro.org> > >>>>>>>> > >>>>>>>> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > >>>>>>>> Signed-off-by: Linisha <linisha232@gmail.com> > >>>>>>>> --- > >>>>>>>> > >>>>>>>> v2: Take a different approach based on review feedback from Daniel > >>>>>>>> Berrangé and Peter Maydell. Instead of incorrectly claiming > >>>>>>>> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > >>>>>>>> machines too), add a general note near the start of the introduction > >>>>>>>> about how options, properties, and command lines may differ between > >>>>>>>> target architectures and machine types. > >>>>>>>> > >>>>>>>> > >>>>>>>> docs/system/introduction.rst | 9 +++++++++ > >>>>>>>> 1 file changed, 9 insertions(+) > >>>>>>>> > >>>>>>>> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst > >>>>>>>> index bec7291e47..8d9ef61d26 100644 > >>>>>>>> --- a/docs/system/introduction.rst > >>>>>>>> +++ b/docs/system/introduction.rst > >>>>>>>> @@ -1,6 +1,15 @@ > >>>>>>>> Introduction > >>>>>>>> ============ > >>>>>>>> > >>>>>>>> +.. note:: > >>>>>>>> + QEMU supports many different target CPU architectures and many > >>>>>>>> + different machine types for each architecture. Options, properties, > >>>>>>>> + and command lines that work for one architecture or machine type > >>>>>>>> + will not necessarily work on another. The examples shown in this > >>>>>>>> + manual are specific to the architecture and machine type being > >>>>>>>> + demonstrated. When in doubt, consult the documentation for your > >>>>>>>> + specific target architecture and machine type. > >>>>>>>> + > >>>>>>> > >>>>>>> Not convinced many people will read this, but I gues it doesn't > >>>>>>> hurt. > >>>>>>> > >>>>>>> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > >>>>>>> > >>>>>>> > >>>>>>>> .. _Accelerators: > >>>>>>>> > >>>>>>>> Virtualisation Accelerators > >>>>>>>> -- > >>>>>>>> 2.47.0.windows.1 > >>>>>>>> > >>>>>>> > >>>>>>> With regards, > >>>>>>> Daniel > >>>>>> > >>>> >
On 6/26/2026 11:58 AM, linisha wrote: > Hmm that would explain it! I'm on Git Bash / MinGW on Windows, so > there may indeed be a line-ending or Perl quirk affecting how the > script parses MAINTAINERS. Good to know, I'll keep this in mind and > double-check the MAINTAINERS file directly when picking CCs in the > future, rather than relying solely on the script's output. > In case your (corporate) machine allows it, you can also use WSL to have a native Linux env instead of using MSYS2. In my experience it works very well. > On Sat, Jun 27, 2026 at 12:19 AM Pierrick Bouvier > <pierrick.bouvier@oss.qualcomm.com> wrote: >> >> On 6/26/2026 11:44 AM, linisha wrote: >>> Just to clear the confusion, attached the screenshot. >>> >> >> Hum interesting. >> >> On my side, reproduced on a clean debian container: >> >> $ git clone https://gitlab.com/qemu-project/qemu --depth=1 && >> cd qemu && ./scripts/get_maintainer.pl -f docs/ >> Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General >> Documenta...) >> qemu-devel@nongnu.org (open list:All patches CC here) >> >> Maybe we have a funny joke hiding there with mingw/windows. >> >>> Best regards, >>> Linisha >>> >>> On Sat, Jun 27, 2026 at 12:10 AM linisha <linisha232@gmail.com> wrote: >>>> >>>> Hi Pierrick, >>>> >>>> Quick correction to my last reply — I checked again more carefully and >>>> get_maintainer.pl -f docs/ still says "No maintainers found" on my >>>> tree (origin/master), even after git pull. It only lists recent >>>> contributors. So whatever change adds you to MAINTAINERS isn't in my >>>> tree yet — could you point me to the commit/branch? >>>> >>>> Apologies for the confusion. >>>> >>>> Best regards, >>>> Linisha >>>> >>>> On Sat, Jun 27, 2026 at 12:08 AM linisha <linisha232@gmail.com> wrote: >>>>> >>>>> Hi Pierrick, >>>>> >>>>> You're right — my tree was outdated. I just ran git pull and now >>>>> scripts/get_maintainer.pl -f docs/ does show you as maintainer for >>>>> General Documentation. Sorry for the miss; I'll make sure to pull and >>>>> re-check maintainers before sending future versions. >>>>> >>>>> Best regards, >>>>> Linisha >>>>> >>>>> On Fri, Jun 26, 2026 at 11:58 PM Pierrick Bouvier >>>>> <pierrick.bouvier@oss.qualcomm.com> wrote: >>>>>> >>>>>> On 6/26/2026 10:44 AM, linisha wrote: >>>>>>> Hi Daniel, Pierrick, >>>>>>> >>>>>>> Thank you, Daniel, for the Reviewed-by tag and the wrapping feedback. >>>>>>> >>>>>>> Pierrick — I didn't intentionally remove anyone. I used >>>>>>> scripts/get_maintainer.pl -f docs/ which returned Peter Maydell, >>>>>>> Philippe Mathieu-Daudé, Richard Henderson, Alex Bennée, and Cédric Le >>>>>>> Goater, and I picked CCs from that list along with people who >>>>>>> responded to v1. You weren't in the script's output, so I didn't know >>>>>>> to include you. Apologies for the miss — I'll CC you on any future v3. >>>>>>> >>>>>> >>>>>> Thanks for your answer. >>>>>> >>>>>> Just to dig this further, is your tree up to date? >>>>>> >>>>>> When running it on my side (from upstream/master), I get: >>>>>> $ scripts/get_maintainer.pl -f docs/ >>>>>> Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General >>>>>> Documenta...) >>>>>> qemu-devel@nongnu.org (open list:All patches CC here) >>>>>> >>>>>>> Daniel — I'll send a v3 with the commit message body properly >>>>>>> line-wrapped to 76 characters. Let me know if there are other changes >>>>>>> you'd like at the same time. >>>>>>> >>>>>>> Best regards, Linisha >>>>>>> >>>>>>> On Fri, Jun 26, 2026 at 9:09 PM Pierrick Bouvier >>>>>>> <pierrick.bouvier@oss.qualcomm.com> wrote: >>>>>>>> >>>>>>>> On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: >>>>>>>>> CC Pierrick as docs maintainer. >>>>>>>>> >>>>>>>> >>>>>>>> Thanks Daniel. >>>>>>>> >>>>>>>> I wonder how I was not in original recipients for this patch. >>>>>>>> @Linisha: did you explicitly set list of recipients, or remove some people? >>>>>>>> >>>>>>>>> On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: >>>>>>>>>> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. >>>>>>>>> >>>>>>>>> Please ensure commit messages are line wrapped. >>>>>>>>> >>>>>>>>>> >>>>>>>>>> Suggested-by: Peter Maydell <peter.maydell@linaro.org> >>>>>>>>>> >>>>>>>>>> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 >>>>>>>>>> Signed-off-by: Linisha <linisha232@gmail.com> >>>>>>>>>> --- >>>>>>>>>> >>>>>>>>>> v2: Take a different approach based on review feedback from Daniel >>>>>>>>>> Berrangé and Peter Maydell. Instead of incorrectly claiming >>>>>>>>>> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 >>>>>>>>>> machines too), add a general note near the start of the introduction >>>>>>>>>> about how options, properties, and command lines may differ between >>>>>>>>>> target architectures and machine types. >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> docs/system/introduction.rst | 9 +++++++++ >>>>>>>>>> 1 file changed, 9 insertions(+) >>>>>>>>>> >>>>>>>>>> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst >>>>>>>>>> index bec7291e47..8d9ef61d26 100644 >>>>>>>>>> --- a/docs/system/introduction.rst >>>>>>>>>> +++ b/docs/system/introduction.rst >>>>>>>>>> @@ -1,6 +1,15 @@ >>>>>>>>>> Introduction >>>>>>>>>> ============ >>>>>>>>>> >>>>>>>>>> +.. note:: >>>>>>>>>> + QEMU supports many different target CPU architectures and many >>>>>>>>>> + different machine types for each architecture. Options, properties, >>>>>>>>>> + and command lines that work for one architecture or machine type >>>>>>>>>> + will not necessarily work on another. The examples shown in this >>>>>>>>>> + manual are specific to the architecture and machine type being >>>>>>>>>> + demonstrated. When in doubt, consult the documentation for your >>>>>>>>>> + specific target architecture and machine type. >>>>>>>>>> + >>>>>>>>> >>>>>>>>> Not convinced many people will read this, but I gues it doesn't >>>>>>>>> hurt. >>>>>>>>> >>>>>>>>> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> >>>>>>>>> >>>>>>>>> >>>>>>>>>> .. _Accelerators: >>>>>>>>>> >>>>>>>>>> Virtualisation Accelerators >>>>>>>>>> -- >>>>>>>>>> 2.47.0.windows.1 >>>>>>>>>> >>>>>>>>> >>>>>>>>> With regards, >>>>>>>>> Daniel >>>>>>>> >>>>>> >>
Thanks for the tip! On Sat, Jun 27, 2026 at 12:43 AM Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> wrote: > > On 6/26/2026 11:58 AM, linisha wrote: > > Hmm that would explain it! I'm on Git Bash / MinGW on Windows, so > > there may indeed be a line-ending or Perl quirk affecting how the > > script parses MAINTAINERS. Good to know, I'll keep this in mind and > > double-check the MAINTAINERS file directly when picking CCs in the > > future, rather than relying solely on the script's output. > > > > In case your (corporate) machine allows it, you can also use WSL to have > a native Linux env instead of using MSYS2. > In my experience it works very well. > > > On Sat, Jun 27, 2026 at 12:19 AM Pierrick Bouvier > > <pierrick.bouvier@oss.qualcomm.com> wrote: > >> > >> On 6/26/2026 11:44 AM, linisha wrote: > >>> Just to clear the confusion, attached the screenshot. > >>> > >> > >> Hum interesting. > >> > >> On my side, reproduced on a clean debian container: > >> > >> $ git clone https://gitlab.com/qemu-project/qemu --depth=1 && > >> cd qemu && ./scripts/get_maintainer.pl -f docs/ > >> Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General > >> Documenta...) > >> qemu-devel@nongnu.org (open list:All patches CC here) > >> > >> Maybe we have a funny joke hiding there with mingw/windows. > >> > >>> Best regards, > >>> Linisha > >>> > >>> On Sat, Jun 27, 2026 at 12:10 AM linisha <linisha232@gmail.com> wrote: > >>>> > >>>> Hi Pierrick, > >>>> > >>>> Quick correction to my last reply — I checked again more carefully and > >>>> get_maintainer.pl -f docs/ still says "No maintainers found" on my > >>>> tree (origin/master), even after git pull. It only lists recent > >>>> contributors. So whatever change adds you to MAINTAINERS isn't in my > >>>> tree yet — could you point me to the commit/branch? > >>>> > >>>> Apologies for the confusion. > >>>> > >>>> Best regards, > >>>> Linisha > >>>> > >>>> On Sat, Jun 27, 2026 at 12:08 AM linisha <linisha232@gmail.com> wrote: > >>>>> > >>>>> Hi Pierrick, > >>>>> > >>>>> You're right — my tree was outdated. I just ran git pull and now > >>>>> scripts/get_maintainer.pl -f docs/ does show you as maintainer for > >>>>> General Documentation. Sorry for the miss; I'll make sure to pull and > >>>>> re-check maintainers before sending future versions. > >>>>> > >>>>> Best regards, > >>>>> Linisha > >>>>> > >>>>> On Fri, Jun 26, 2026 at 11:58 PM Pierrick Bouvier > >>>>> <pierrick.bouvier@oss.qualcomm.com> wrote: > >>>>>> > >>>>>> On 6/26/2026 10:44 AM, linisha wrote: > >>>>>>> Hi Daniel, Pierrick, > >>>>>>> > >>>>>>> Thank you, Daniel, for the Reviewed-by tag and the wrapping feedback. > >>>>>>> > >>>>>>> Pierrick — I didn't intentionally remove anyone. I used > >>>>>>> scripts/get_maintainer.pl -f docs/ which returned Peter Maydell, > >>>>>>> Philippe Mathieu-Daudé, Richard Henderson, Alex Bennée, and Cédric Le > >>>>>>> Goater, and I picked CCs from that list along with people who > >>>>>>> responded to v1. You weren't in the script's output, so I didn't know > >>>>>>> to include you. Apologies for the miss — I'll CC you on any future v3. > >>>>>>> > >>>>>> > >>>>>> Thanks for your answer. > >>>>>> > >>>>>> Just to dig this further, is your tree up to date? > >>>>>> > >>>>>> When running it on my side (from upstream/master), I get: > >>>>>> $ scripts/get_maintainer.pl -f docs/ > >>>>>> Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com> (maintainer:General > >>>>>> Documenta...) > >>>>>> qemu-devel@nongnu.org (open list:All patches CC here) > >>>>>> > >>>>>>> Daniel — I'll send a v3 with the commit message body properly > >>>>>>> line-wrapped to 76 characters. Let me know if there are other changes > >>>>>>> you'd like at the same time. > >>>>>>> > >>>>>>> Best regards, Linisha > >>>>>>> > >>>>>>> On Fri, Jun 26, 2026 at 9:09 PM Pierrick Bouvier > >>>>>>> <pierrick.bouvier@oss.qualcomm.com> wrote: > >>>>>>>> > >>>>>>>> On 6/26/2026 3:09 AM, Daniel P. Berrangé wrote: > >>>>>>>>> CC Pierrick as docs maintainer. > >>>>>>>>> > >>>>>>>> > >>>>>>>> Thanks Daniel. > >>>>>>>> > >>>>>>>> I wonder how I was not in original recipients for this patch. > >>>>>>>> @Linisha: did you explicitly set list of recipients, or remove some people? > >>>>>>>> > >>>>>>>>> On Fri, Jun 26, 2026 at 12:51:19AM +0530, Linisha wrote: > >>>>>>>>>> Add a note near the start of the introduction explaining that QEMU options, properties, and command lines may differ between target architectures and machine types. This helps prevent confusion when examples shown for one architecture do not work for another, such as the pflash0/pflash1 options visible in -machine help on some machines but not others. > >>>>>>>>> > >>>>>>>>> Please ensure commit messages are line wrapped. > >>>>>>>>> > >>>>>>>>>> > >>>>>>>>>> Suggested-by: Peter Maydell <peter.maydell@linaro.org> > >>>>>>>>>> > >>>>>>>>>> Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > >>>>>>>>>> Signed-off-by: Linisha <linisha232@gmail.com> > >>>>>>>>>> --- > >>>>>>>>>> > >>>>>>>>>> v2: Take a different approach based on review feedback from Daniel > >>>>>>>>>> Berrangé and Peter Maydell. Instead of incorrectly claiming > >>>>>>>>>> pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > >>>>>>>>>> machines too), add a general note near the start of the introduction > >>>>>>>>>> about how options, properties, and command lines may differ between > >>>>>>>>>> target architectures and machine types. > >>>>>>>>>> > >>>>>>>>>> > >>>>>>>>>> docs/system/introduction.rst | 9 +++++++++ > >>>>>>>>>> 1 file changed, 9 insertions(+) > >>>>>>>>>> > >>>>>>>>>> diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst > >>>>>>>>>> index bec7291e47..8d9ef61d26 100644 > >>>>>>>>>> --- a/docs/system/introduction.rst > >>>>>>>>>> +++ b/docs/system/introduction.rst > >>>>>>>>>> @@ -1,6 +1,15 @@ > >>>>>>>>>> Introduction > >>>>>>>>>> ============ > >>>>>>>>>> > >>>>>>>>>> +.. note:: > >>>>>>>>>> + QEMU supports many different target CPU architectures and many > >>>>>>>>>> + different machine types for each architecture. Options, properties, > >>>>>>>>>> + and command lines that work for one architecture or machine type > >>>>>>>>>> + will not necessarily work on another. The examples shown in this > >>>>>>>>>> + manual are specific to the architecture and machine type being > >>>>>>>>>> + demonstrated. When in doubt, consult the documentation for your > >>>>>>>>>> + specific target architecture and machine type. > >>>>>>>>>> + > >>>>>>>>> > >>>>>>>>> Not convinced many people will read this, but I gues it doesn't > >>>>>>>>> hurt. > >>>>>>>>> > >>>>>>>>> Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > >>>>>>>>> > >>>>>>>>> > >>>>>>>>>> .. _Accelerators: > >>>>>>>>>> > >>>>>>>>>> Virtualisation Accelerators > >>>>>>>>>> -- > >>>>>>>>>> 2.47.0.windows.1 > >>>>>>>>>> > >>>>>>>>> > >>>>>>>>> With regards, > >>>>>>>>> Daniel > >>>>>>>> > >>>>>> > >> >
Add a note near the start of the introduction explaining that QEMU
options, properties, and command lines may differ between target
architectures and machine types. This helps prevent confusion when
examples shown for one architecture do not work for another, such as
the pflash0/pflash1 options visible in -machine help on some machines
but not others.
Suggested-by: Peter Maydell <peter.maydell@linaro.org>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254
Signed-off-by: Linisha <linisha232@gmail.com>
---
v3:
- Wrap commit message body at 76 characters (Daniel P. Berrangé)
- Add Reviewed-by: Daniel P. Berrangé
v2: Take a different approach based on review feedback from Daniel
Berrangé and Peter Maydell. Instead of incorrectly claiming
pflash0/pflash1 are virt-only (they actually work on x86 pc/q35
machines too), add a general note near the start of the introduction
about how options, properties, and command lines may differ between
target architectures and machine types.
docs/system/introduction.rst | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/docs/system/introduction.rst b/docs/system/introduction.rst
index bec7291e47..8d9ef61d26 100644
--- a/docs/system/introduction.rst
+++ b/docs/system/introduction.rst
@@ -1,6 +1,15 @@
Introduction
============
+.. note::
+ QEMU supports many different target CPU architectures and many
+ different machine types for each architecture. Options, properties,
+ and command lines that work for one architecture or machine type
+ will not necessarily work on another. The examples shown in this
+ manual are specific to the architecture and machine type being
+ demonstrated. When in doubt, consult the documentation for your
+ specific target architecture and machine type.
+
.. _Accelerators:
Virtualisation Accelerators
--
2.47.0.windows.1
On 6/26/2026 11:11 AM, Linisha wrote: > Add a note near the start of the introduction explaining that QEMU > options, properties, and command lines may differ between target > architectures and machine types. This helps prevent confusion when > examples shown for one architecture do not work for another, such as > the pflash0/pflash1 options visible in -machine help on some machines > but not others. > > Suggested-by: Peter Maydell <peter.maydell@linaro.org> > Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > Signed-off-by: Linisha <linisha232@gmail.com> > --- > > v3: > - Wrap commit message body at 76 characters (Daniel P. Berrangé) > - Add Reviewed-by: Daniel P. Berrangé > > v2: Take a different approach based on review feedback from Daniel > Berrangé and Peter Maydell. Instead of incorrectly claiming > pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > machines too), add a general note near the start of the introduction > about how options, properties, and command lines may differ between > target architectures and machine types. > > docs/system/introduction.rst | 9 +++++++++ > 1 file changed, 9 insertions(+) > This was merged into master (20553466cc47af6a8c95f665b601fce3c852e503). Thank you for your contribution! Regards, Pierrick
😊 linisha reacted via Gmail <https://www.google.com/gmail/about/?utm_source=gmail-in-product&utm_medium=et&utm_campaign=emojireactionemail#app> On Mon, 29 Jun, 2026, 9:22 pm Pierrick Bouvier, < pierrick.bouvier@oss.qualcomm.com> wrote: > On 6/26/2026 11:11 AM, Linisha wrote: > > Add a note near the start of the introduction explaining that QEMU > > options, properties, and command lines may differ between target > > architectures and machine types. This helps prevent confusion when > > examples shown for one architecture do not work for another, such as > > the pflash0/pflash1 options visible in -machine help on some machines > > but not others. > > > > Suggested-by: Peter Maydell <peter.maydell@linaro.org> > > Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > > Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > > Signed-off-by: Linisha <linisha232@gmail.com> > > --- > > > > v3: > > - Wrap commit message body at 76 characters (Daniel P. Berrangé) > > - Add Reviewed-by: Daniel P. Berrangé > > > > v2: Take a different approach based on review feedback from Daniel > > Berrangé and Peter Maydell. Instead of incorrectly claiming > > pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > > machines too), add a general note near the start of the introduction > > about how options, properties, and command lines may differ between > > target architectures and machine types. > > > > docs/system/introduction.rst | 9 +++++++++ > > 1 file changed, 9 insertions(+) > > > > This was merged into master (20553466cc47af6a8c95f665b601fce3c852e503). > Thank you for your contribution! > > Regards, > Pierrick >
On 6/26/2026 11:11 AM, Linisha wrote: > Add a note near the start of the introduction explaining that QEMU > options, properties, and command lines may differ between target > architectures and machine types. This helps prevent confusion when > examples shown for one architecture do not work for another, such as > the pflash0/pflash1 options visible in -machine help on some machines > but not others. > > Suggested-by: Peter Maydell <peter.maydell@linaro.org> > Reviewed-by: Daniel P. Berrangé <berrange@redhat.com> > Buglink: https://gitlab.com/qemu-project/qemu/-/issues/3254 > Signed-off-by: Linisha <linisha232@gmail.com> > --- > > v3: > - Wrap commit message body at 76 characters (Daniel P. Berrangé) > - Add Reviewed-by: Daniel P. Berrangé > > v2: Take a different approach based on review feedback from Daniel > Berrangé and Peter Maydell. Instead of incorrectly claiming > pflash0/pflash1 are virt-only (they actually work on x86 pc/q35 > machines too), add a general note near the start of the introduction > about how options, properties, and command lines may differ between > target architectures and machine types. > > docs/system/introduction.rst | 9 +++++++++ > 1 file changed, 9 insertions(+) > Reviewed-by: Pierrick Bouvier <pierrick.bouvier@oss.qualcomm.com>
© 2016 - 2026 Red Hat, Inc.