[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH v2] machine: add missing doc for memory-backend option
From: |
Peter Maydell |
Subject: |
Re: [PATCH v2] machine: add missing doc for memory-backend option |
Date: |
Fri, 15 Jan 2021 10:02:04 +0000 |
On Thu, 14 Jan 2021 at 23:48, Igor Mammedov <imammedo@redhat.com> wrote:
>
> Add documentation for '-machine memory-backend' CLI option and
> how to use it.
>
> And document that x-use-canonical-path-for-ramblock-id,
> is considered to be stable to make sure it won't go away by accident.
That's not what the x- prefix is supposed to mean.
If we have an internal constraint that we mustn't delete
the option in order to support some other must-be-stable
interface (eg migration of some machines) we can document
that in a comment, but that doesn't mean that we should
document to users that direct use of an x-prefix option
is supported as a stable interface.
Alternatively, if the option is really stable for direct
use by users then we should commit to making it so by
removing the x-.
thanks
-- PMM