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

Daniel P. Berrangé via Devel posted 5 patches 4 months, 1 week 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 v2 0/5] docs: automated info about machine deprecation/removal info
Posted by Daniel P. Berrangé via Devel 4 months, 1 week 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.

With this series applied all versioned machine types prior to 4.1
are now removed (hidden). We can delete the code at our leisure.

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 v2 0/5] docs: automated info about machine deprecation/removal info
Posted by Michael S. Tsirkin via Devel 4 months ago
On Tue, Apr 29, 2025 at 02:15:21PM +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.
> 
> With this series applied all versioned machine types prior to 4.1
> are now removed (hidden). We can delete the code at our leisure.


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

> 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