[PATCH v3 0/5] docs: automated info about machine deprecation/removal info

Daniel P. Berrangé via Devel posted 5 patches 4 months ago
Failed in applying to current master (apply log)
There is a newer version of this series
docs/about/deprecated.rst       |  7 ++++
docs/about/removed-features.rst | 10 +++---
docs/conf.py                    | 39 +++++++++++++++++++++-
include/hw/boards.h             | 58 +++++++++++++++++++++------------
4 files changed, 89 insertions(+), 25 deletions(-)
[PATCH v3 0/5] docs: automated info about machine deprecation/removal info
Posted by Daniel P. Berrangé via Devel 4 months ago
Since we deprecate and remove versioned machine types on a fixed
schedule, we can automatically ensure that the docs reflect the
latest version info, rather than requiring manual updates on each
dev cycle.

The first patch in this series removes the hack which postponed
automatic removal of versioned machine types to the 10.1.0 release,
since we're now in the 10.1.0 dev cycle.

The second patch in this series fixes the logic to ensure dev snapshots
and release candidates don't have an off-by-1 error in setting
deprecation and removal thresholds - they must predict the next formal
release version number.

The following three patches deal with the docs stuff.

Changed in v3:

 - Remove mistaken mention of 'ppc', only 'ppc64' has versioned
   machine types

Changed in v2:

 - Remove hack that temporarily postponed automatic deletion
   of machine types
 - Fix docs version info for stable bugfix releases

Daniel P. Berrangé (5):
  Revert "include/hw: temporarily disable deletion of versioned machine
    types"
  include/hw/boards: cope with dev/rc versions in deprecation checks
  docs/about/deprecated: auto-generate a note for versioned machine
    types
  docs/about/removed-features: auto-generate a note for versioned
    machine types
  include/hw/boards: add warning about changing deprecation logic

 docs/about/deprecated.rst       |  7 ++++
 docs/about/removed-features.rst | 10 +++---
 docs/conf.py                    | 39 +++++++++++++++++++++-
 include/hw/boards.h             | 58 +++++++++++++++++++++------------
 4 files changed, 89 insertions(+), 25 deletions(-)

-- 
2.49.0
Re: [PATCH v3 0/5] docs: automated info about machine deprecation/removal info
Posted by Michael S. Tsirkin via Devel 4 months ago
On Tue, May 06, 2025 at 05:00:19PM +0100, Daniel P. Berrangé wrote:
> Since we deprecate and remove versioned machine types on a fixed
> schedule, we can automatically ensure that the docs reflect the
> latest version info, rather than requiring manual updates on each
> dev cycle.
> 
> The first patch in this series removes the hack which postponed
> automatic removal of versioned machine types to the 10.1.0 release,
> since we're now in the 10.1.0 dev cycle.
> 
> The second patch in this series fixes the logic to ensure dev snapshots
> and release candidates don't have an off-by-1 error in setting
> deprecation and removal thresholds - they must predict the next formal
> release version number.
> 
> The following three patches deal with the docs stuff.

series:
Reviewed-by: Michael S. Tsirkin <mst@redhat.com>

> Changed in v3:
> 
>  - Remove mistaken mention of 'ppc', only 'ppc64' has versioned
>    machine types
> 
> Changed in v2:
> 
>  - Remove hack that temporarily postponed automatic deletion
>    of machine types
>  - Fix docs version info for stable bugfix releases
> 
> Daniel P. Berrangé (5):
>   Revert "include/hw: temporarily disable deletion of versioned machine
>     types"
>   include/hw/boards: cope with dev/rc versions in deprecation checks
>   docs/about/deprecated: auto-generate a note for versioned machine
>     types
>   docs/about/removed-features: auto-generate a note for versioned
>     machine types
>   include/hw/boards: add warning about changing deprecation logic
> 
>  docs/about/deprecated.rst       |  7 ++++
>  docs/about/removed-features.rst | 10 +++---
>  docs/conf.py                    | 39 +++++++++++++++++++++-
>  include/hw/boards.h             | 58 +++++++++++++++++++++------------
>  4 files changed, 89 insertions(+), 25 deletions(-)
> 
> -- 
> 2.49.0
Re: [PATCH v3 0/5] docs: automated info about machine deprecation/removal info
Posted by Philippe Mathieu-Daudé 4 months ago
On 6/5/25 18:00, Daniel P. Berrangé wrote:

> Daniel P. Berrangé (5):
>    Revert "include/hw: temporarily disable deletion of versioned machine
>      types"
>    include/hw/boards: cope with dev/rc versions in deprecation checks
>    docs/about/deprecated: auto-generate a note for versioned machine
>      types
>    docs/about/removed-features: auto-generate a note for versioned
>      machine types
>    include/hw/boards: add warning about changing deprecation logic

Series (on top on Thomas pc-q35-4.1 removal):
Tested-by: Philippe Mathieu-Daudé <philmd@linaro.org>
Re: [PATCH v3 0/5] docs: automated info about machine deprecation/removal info
Posted by Thomas Huth via Devel 4 months ago
On 06/05/2025 18.00, Daniel P. Berrangé wrote:
> Since we deprecate and remove versioned machine types on a fixed
> schedule, we can automatically ensure that the docs reflect the
> latest version info, rather than requiring manual updates on each
> dev cycle.
> 
> The first patch in this series removes the hack which postponed
> automatic removal of versioned machine types to the 10.1.0 release,
> since we're now in the 10.1.0 dev cycle.
> 
> The second patch in this series fixes the logic to ensure dev snapshots
> and release candidates don't have an off-by-1 error in setting
> deprecation and removal thresholds - they must predict the next formal
> release version number.
> 
> The following three patches deal with the docs stuff.

Series
Reviewed-by: Thomas Huth <thuth@redhat.com>
Re: [PATCH v3 0/5] docs: automated info about machine deprecation/removal info
Posted by Michael S. Tsirkin via Devel 4 months ago
On Tue, May 06, 2025 at 05:00:19PM +0100, Daniel P. Berrangé wrote:
> Since we deprecate and remove versioned machine types on a fixed
> schedule, we can automatically ensure that the docs reflect the
> latest version info, rather than requiring manual updates on each
> dev cycle.
> 
> The first patch in this series removes the hack which postponed
> automatic removal of versioned machine types to the 10.1.0 release,
> since we're now in the 10.1.0 dev cycle.
> 
> The second patch in this series fixes the logic to ensure dev snapshots
> and release candidates don't have an off-by-1 error in setting
> deprecation and removal thresholds - they must predict the next formal
> release version number.
> 
> The following three patches deal with the docs stuff.


Reviewed-by: Michael S. Tsirkin <mst@redhat.com>

> Changed in v3:
> 
>  - Remove mistaken mention of 'ppc', only 'ppc64' has versioned
>    machine types
> 
> Changed in v2:
> 
>  - Remove hack that temporarily postponed automatic deletion
>    of machine types
>  - Fix docs version info for stable bugfix releases
> 
> Daniel P. Berrangé (5):
>   Revert "include/hw: temporarily disable deletion of versioned machine
>     types"
>   include/hw/boards: cope with dev/rc versions in deprecation checks
>   docs/about/deprecated: auto-generate a note for versioned machine
>     types
>   docs/about/removed-features: auto-generate a note for versioned
>     machine types
>   include/hw/boards: add warning about changing deprecation logic
> 
>  docs/about/deprecated.rst       |  7 ++++
>  docs/about/removed-features.rst | 10 +++---
>  docs/conf.py                    | 39 +++++++++++++++++++++-
>  include/hw/boards.h             | 58 +++++++++++++++++++++------------
>  4 files changed, 89 insertions(+), 25 deletions(-)
> 
> -- 
> 2.49.0