[PATCH 0/4] hw/ppc: Clean up includes

Markus Armbruster posted 4 patches 1 year, 4 months ago
Patches applied successfully (tree, apply log)
git fetch https://github.com/patchew-project/qemu tags/patchew/20221210112140.4057731-1-armbru@redhat.com
Maintainers: "Cédric Le Goater" <clg@kaod.org>
There is a newer version of this series
hw/pci-host/pnv_phb.h          |   2 +-
include/hw/pci-host/pnv_phb3.h |   1 -
include/hw/pci-host/pnv_phb4.h |   5 +-
include/hw/ppc/pnv.h           | 146 +-------------------------------
include/hw/ppc/pnv_chip.h      | 147 +++++++++++++++++++++++++++++++++
include/hw/ppc/pnv_core.h      |   3 +-
include/hw/ppc/pnv_homer.h     |   2 +-
include/hw/ppc/pnv_lpc.h       |  11 +--
include/hw/ppc/pnv_occ.h       |   3 +-
include/hw/ppc/pnv_pnor.h      |   2 +-
include/hw/ppc/pnv_sbe.h       |   3 +-
include/hw/ppc/pnv_xive.h      |   7 +-
include/hw/ppc/pnv_xscom.h     |   3 +-
include/hw/ppc/xive2.h         |   2 +
include/hw/ppc/xive2_regs.h    |   2 +
hw/intc/pnv_xive.c             |   1 +
hw/intc/pnv_xive2.c            |   1 +
hw/pci-host/pnv_phb3.c         |   1 +
hw/pci-host/pnv_phb4_pec.c     |   1 +
hw/ppc/pnv.c                   |   3 +
hw/ppc/pnv_core.c              |   1 +
hw/ppc/pnv_homer.c             |   1 +
hw/ppc/pnv_lpc.c               |   1 +
hw/ppc/pnv_psi.c               |   1 +
hw/ppc/pnv_xscom.c             |   1 +
25 files changed, 186 insertions(+), 165 deletions(-)
create mode 100644 include/hw/ppc/pnv_chip.h
[PATCH 0/4] hw/ppc: Clean up includes
Posted by Markus Armbruster 1 year, 4 months ago
Back in 2016, we discussed[1] rules for headers, and these were
generally liked:

1. Have a carefully curated header that's included everywhere first.  We
   got that already thanks to Peter: osdep.h.

2. Headers should normally include everything they need beyond osdep.h.
   If exceptions are needed for some reason, they must be documented in
   the header.  If all that's needed from a header is typedefs, put
   those into qemu/typedefs.h instead of including the header.

3. Cyclic inclusion is forbidden.

After this series, include/hw/ppc and include/hw/pci-host/pnv* conform
to these rules.

It is based on

    [PATCH 0/5] include/hw/pci include/hw/cxl: Clean up includes
    [PATCH 0/3] block: Clean up includes
    [PATCH 0/4] coroutine: Clean up includes

[1] Message-ID: <87h9g8j57d.fsf@blackfin.pond.sub.org>
    https://lists.nongnu.org/archive/html/qemu-devel/2016-03/msg03345.html

Based-on: <20221209134802.3642942-1-armbru@redhat.com>

Markus Armbruster (4):
  include/hw/ppc: Split pnv_chip.h off pnv.h
  include/hw/ppc: Supply a few missing includes
  include/hw/ppc: Don't include hw/pci-host/pnv_phb.h from pnv.h
  include/hw/ppc include/hw/pci-host: Drop extra typedefs

 hw/pci-host/pnv_phb.h          |   2 +-
 include/hw/pci-host/pnv_phb3.h |   1 -
 include/hw/pci-host/pnv_phb4.h |   5 +-
 include/hw/ppc/pnv.h           | 146 +-------------------------------
 include/hw/ppc/pnv_chip.h      | 147 +++++++++++++++++++++++++++++++++
 include/hw/ppc/pnv_core.h      |   3 +-
 include/hw/ppc/pnv_homer.h     |   2 +-
 include/hw/ppc/pnv_lpc.h       |  11 +--
 include/hw/ppc/pnv_occ.h       |   3 +-
 include/hw/ppc/pnv_pnor.h      |   2 +-
 include/hw/ppc/pnv_sbe.h       |   3 +-
 include/hw/ppc/pnv_xive.h      |   7 +-
 include/hw/ppc/pnv_xscom.h     |   3 +-
 include/hw/ppc/xive2.h         |   2 +
 include/hw/ppc/xive2_regs.h    |   2 +
 hw/intc/pnv_xive.c             |   1 +
 hw/intc/pnv_xive2.c            |   1 +
 hw/pci-host/pnv_phb3.c         |   1 +
 hw/pci-host/pnv_phb4_pec.c     |   1 +
 hw/ppc/pnv.c                   |   3 +
 hw/ppc/pnv_core.c              |   1 +
 hw/ppc/pnv_homer.c             |   1 +
 hw/ppc/pnv_lpc.c               |   1 +
 hw/ppc/pnv_psi.c               |   1 +
 hw/ppc/pnv_xscom.c             |   1 +
 25 files changed, 186 insertions(+), 165 deletions(-)
 create mode 100644 include/hw/ppc/pnv_chip.h

-- 
2.37.3
Re: [PATCH 0/4] hw/ppc: Clean up includes
Posted by Daniel Henrique Barboza 1 year, 4 months ago

On 12/10/22 08:21, Markus Armbruster wrote:
> Back in 2016, we discussed[1] rules for headers, and these were
> generally liked:
> 
> 1. Have a carefully curated header that's included everywhere first.  We
>     got that already thanks to Peter: osdep.h.
> 
> 2. Headers should normally include everything they need beyond osdep.h.
>     If exceptions are needed for some reason, they must be documented in
>     the header.  If all that's needed from a header is typedefs, put
>     those into qemu/typedefs.h instead of including the header.
> 
> 3. Cyclic inclusion is forbidden.
> 
> After this series, include/hw/ppc and include/hw/pci-host/pnv* conform
> to these rules.
> 
> It is based on
> 
>      [PATCH 0/5] include/hw/pci include/hw/cxl: Clean up includes
>      [PATCH 0/3] block: Clean up includes
>      [PATCH 0/4] coroutine: Clean up includes
> 
> [1] Message-ID: <87h9g8j57d.fsf@blackfin.pond.sub.org>
>      https://lists.nongnu.org/archive/html/qemu-devel/2016-03/msg03345.html
> 
> Based-on: <20221209134802.3642942-1-armbru@redhat.com>
> 
> Markus Armbruster (4):
>    include/hw/ppc: Split pnv_chip.h off pnv.h
>    include/hw/ppc: Supply a few missing includes
>    include/hw/ppc: Don't include hw/pci-host/pnv_phb.h from pnv.h
>    include/hw/ppc include/hw/pci-host: Drop extra typedefs


Series:

Reviewed-by: Daniel Henrique Barboza <danielhb413@gmail.com>


I see this is based on "[PATCH 0/5] include/hw/pci include/hw/cxl: Clean
up includes". Feel free to queue this up in the same queue.


Thanks,

Daniel


> 
>   hw/pci-host/pnv_phb.h          |   2 +-
>   include/hw/pci-host/pnv_phb3.h |   1 -
>   include/hw/pci-host/pnv_phb4.h |   5 +-
>   include/hw/ppc/pnv.h           | 146 +-------------------------------
>   include/hw/ppc/pnv_chip.h      | 147 +++++++++++++++++++++++++++++++++
>   include/hw/ppc/pnv_core.h      |   3 +-
>   include/hw/ppc/pnv_homer.h     |   2 +-
>   include/hw/ppc/pnv_lpc.h       |  11 +--
>   include/hw/ppc/pnv_occ.h       |   3 +-
>   include/hw/ppc/pnv_pnor.h      |   2 +-
>   include/hw/ppc/pnv_sbe.h       |   3 +-
>   include/hw/ppc/pnv_xive.h      |   7 +-
>   include/hw/ppc/pnv_xscom.h     |   3 +-
>   include/hw/ppc/xive2.h         |   2 +
>   include/hw/ppc/xive2_regs.h    |   2 +
>   hw/intc/pnv_xive.c             |   1 +
>   hw/intc/pnv_xive2.c            |   1 +
>   hw/pci-host/pnv_phb3.c         |   1 +
>   hw/pci-host/pnv_phb4_pec.c     |   1 +
>   hw/ppc/pnv.c                   |   3 +
>   hw/ppc/pnv_core.c              |   1 +
>   hw/ppc/pnv_homer.c             |   1 +
>   hw/ppc/pnv_lpc.c               |   1 +
>   hw/ppc/pnv_psi.c               |   1 +
>   hw/ppc/pnv_xscom.c             |   1 +
>   25 files changed, 186 insertions(+), 165 deletions(-)
>   create mode 100644 include/hw/ppc/pnv_chip.h
>