Re: [PATCH] qemu-options.hx: Replace deprecated -M example

["Dr. David Alan Gilbert" <dave@treblig.org>]

* Thomas Huth (thuth@redhat.com) wrote:
> On 02/12/2025 01.57, dave@treblig.org wrote:
> > From: "Dr. David Alan Gilbert" <dave@treblig.org>
> > 
> > The -M option was deprecated by -machine in 2011 by 80f52a669
> > and isn't actually documented in the manpage, but is still used in
> > one of the examples.  Replace it by -machine.
> > -M still gets used all over the place in other docs, and I'm
> > not sure I realised it was deprecated until Julian pointed out it
> > wasn't actually documented.
> 
> -M is not mentioned in docs/about/deprecated.rst, so no, it's not officially
> deprecated. And I think it's a nice short hand feature for an option that is
> used very often, so I also don't think that we should ever remove it. Thus I
> think it would be better to simply add it back to qemu-options.hx instead.

Fair enough; I wasn't too sure which way this would go - I'm pretty
sure I'd always used -M, but there again I saw libvirt used -machine
now, and I'd frequently confused -m and -M so it did make some sense
to move away from it.

I'll cut another patch adding -M back.

Dave

>  Thomas
> 
-- 
 -----Open up your eyes, open up your mind, open up your code -------   
/ Dr. David Alan Gilbert    |       Running GNU/Linux       | Happy  \ 
\        dave @ treblig.org |                               | In Hex /
 \ _________________________|_____ http://www.treblig.org   |_______/