[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [PATCH] qemu-deprecated: Remove text about Python 2

From: Philippe Mathieu-Daudé
Subject: Re: [PATCH] qemu-deprecated: Remove text about Python 2
Date: Thu, 30 Jan 2020 23:09:38 +0100
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.2.2

On 1/15/20 6:16 PM, John Snow wrote:
On 1/15/20 11:04 AM, Markus Armbruster wrote:
Daniel P. Berrangé <address@hidden> writes:

On Tue, Jan 14, 2020 at 11:08:16AM +0100, Thomas Huth wrote:
On 13/01/2020 23.36, John Snow wrote:
Right now, we don't
really have these docs hosted in a searchable way online in a
per-version format. Once the notice is gone, it's gone from the mirror.

I removed some bitmap functionality not too long ago and I created a
"Recently Removed" section as a bit of a troubleshooting guide should it
be needed.

- Do we want this section?
- Should I remove it?
- Can we add historical docs to the website to see previous deprecated
docs in a searchable manner?

I also once started a page in the Wiki here:


... but apparently, it did not get enough attention yet, otherwise you
would have noticed it before introducing the new chapter into the
qemu-doc ...

We definitely need one spot where we can document removed features. I
don't mind which way we do it, either the qemu-doc or the wiki, but we
should unify on one of the two. I guess the qemu-doc is the better place
since we are tracking the deprecated features there already and one more
or less just has to move the text to the other chapter when things get
finally removed?

Yeah, I've said in the past that we should not be deleting deprecations
from the docs entirely.

If you look at GTK docs for example, you'll see they keep a record of
all incompatible or noteworth changes between release:


IMHO, we should follow this and have an appendix of removed features,
with sub-sections per QEMU release listing each removed feature. Thus
deprecation docs just get moved to this appendix at the right time.

This is exactly the "Recently Removed" appendix John added in commit

Now we need a sucker^Wvolunteer to restore all the stuff we dropped from
appendix "Deprecated features" to this appendix.  John, you were
incautious enough to signal you care; what about you?

Can add to the pile, but admittedly I am a little backlogged trying to
recover from the holidays. I can't promise any time to it right this minute.

I can try next week, if I don't forget.

In case you forgot :P

reply via email to

[Prev in Thread] Current Thread [Next in Thread]