Expand the text a bit to make the new syntax more explicit and point
users to the man page for further info.

Reported-by: Peter Maydell <peter.maydell@linaro.org>
Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
---
 system/vl.c | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/system/vl.c b/system/vl.c
index eded498fa7..d1d9209038 100644
--- a/system/vl.c
+++ b/system/vl.c
@@ -3239,8 +3239,13 @@ void qemu_init(int argc, char **argv)
                 default_monitor = 0;
                 break;
             case QEMU_OPTION_mon:
-                warn_report_once("'-mon' is deprecated, use '-object' with "
-                                 "'monitor-hmp' or 'monitor-qmp' types instead");
+                warn_report_once(
+                    "'-mon' is deprecated. Switch to either "
+                    "'-object monitor-hmp,id=ID,chardev=CHR-ID' or "
+                    "'-object monitor-qmp,id=ID,chardev=CHR-ID' instead. "
+                    "See '-object' docs in the QEMU manual for further "
+                    "configuration guidance: "
+                    "https://www.qemu.org/docs/master/system/invocation.html");
                 if (!qemu_opts_parse_noisily(qemu_find_opts("mon"), optarg,
                                              true)) {
                     exit(1);
-- 
2.55.0

On 2/9/26 12:47, Daniel P. Berrangé wrote:
> Expand the text a bit to make the new syntax more explicit and point
> users to the man page for further info.
> 
> Reported-by: Peter Maydell <peter.maydell@linaro.org>
> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
> ---
>   system/vl.c | 9 +++++++--
>   1 file changed, 7 insertions(+), 2 deletions(-)

Patch queued, thanks.

On Wed, 2 Sept 2026 at 11:48, Daniel P. Berrangé <berrange@redhat.com> wrote:
>
> Expand the text a bit to make the new syntax more explicit and point
> users to the man page for further info.
>
> Reported-by: Peter Maydell <peter.maydell@linaro.org>
> Signed-off-by: Daniel P. Berrangé <berrange@redhat.com>
> ---
>  system/vl.c | 9 +++++++--
>  1 file changed, 7 insertions(+), 2 deletions(-)
>
> diff --git a/system/vl.c b/system/vl.c
> index eded498fa7..d1d9209038 100644
> --- a/system/vl.c
> +++ b/system/vl.c
> @@ -3239,8 +3239,13 @@ void qemu_init(int argc, char **argv)
>                  default_monitor = 0;
>                  break;
>              case QEMU_OPTION_mon:
> -                warn_report_once("'-mon' is deprecated, use '-object' with "
> -                                 "'monitor-hmp' or 'monitor-qmp' types instead");
> +                warn_report_once(
> +                    "'-mon' is deprecated. Switch to either "
> +                    "'-object monitor-hmp,id=ID,chardev=CHR-ID' or "
> +                    "'-object monitor-qmp,id=ID,chardev=CHR-ID' instead. "
> +                    "See '-object' docs in the QEMU manual for further "
> +                    "configuration guidance: "
> +                    "https://www.qemu.org/docs/master/system/invocation.html");
>                  if (!qemu_opts_parse_noisily(qemu_find_opts("mon"), optarg,
>                                               true)) {
>                      exit(1);
> --

Reviewed-by: Peter Maydell <peter.maydell@linaro.org>

thanks
-- PMM