[Skiboot] [RFC PATCH 10/23] doc/release-notes/skiboot-5.2.x: rename .txt to .rst

Stewart Smith stewart at linux.vnet.ibm.com
Wed Jul 27 17:43:11 AEST 2016


Signed-off-by: Stewart Smith <stewart at linux.vnet.ibm.com>
---
 doc/release-notes/skiboot-5.2.0-rc1.rst | 211 +++++++++++++++++++++++++++
 doc/release-notes/skiboot-5.2.0-rc1.txt | 211 ---------------------------
 doc/release-notes/skiboot-5.2.0-rc2.rst |  53 +++++++
 doc/release-notes/skiboot-5.2.0-rc2.txt |  53 -------
 doc/release-notes/skiboot-5.2.0.rst     | 249 ++++++++++++++++++++++++++++++++
 doc/release-notes/skiboot-5.2.0.txt     | 249 --------------------------------
 doc/release-notes/skiboot-5.2.1.rst     | 121 ++++++++++++++++
 doc/release-notes/skiboot-5.2.1.txt     | 121 ----------------
 doc/release-notes/skiboot-5.2.2.rst     |  32 ++++
 doc/release-notes/skiboot-5.2.2.txt     |  32 ----
 doc/release-notes/skiboot-5.2.3.rst     |  57 ++++++++
 doc/release-notes/skiboot-5.2.3.txt     |  57 --------
 doc/release-notes/skiboot-5.2.4.rst     |  27 ++++
 doc/release-notes/skiboot-5.2.4.txt     |  27 ----
 14 files changed, 750 insertions(+), 750 deletions(-)
 create mode 100644 doc/release-notes/skiboot-5.2.0-rc1.rst
 delete mode 100644 doc/release-notes/skiboot-5.2.0-rc1.txt
 create mode 100644 doc/release-notes/skiboot-5.2.0-rc2.rst
 delete mode 100644 doc/release-notes/skiboot-5.2.0-rc2.txt
 create mode 100644 doc/release-notes/skiboot-5.2.0.rst
 delete mode 100644 doc/release-notes/skiboot-5.2.0.txt
 create mode 100644 doc/release-notes/skiboot-5.2.1.rst
 delete mode 100644 doc/release-notes/skiboot-5.2.1.txt
 create mode 100644 doc/release-notes/skiboot-5.2.2.rst
 delete mode 100644 doc/release-notes/skiboot-5.2.2.txt
 create mode 100644 doc/release-notes/skiboot-5.2.3.rst
 delete mode 100644 doc/release-notes/skiboot-5.2.3.txt
 create mode 100644 doc/release-notes/skiboot-5.2.4.rst
 delete mode 100644 doc/release-notes/skiboot-5.2.4.txt

diff --git a/doc/release-notes/skiboot-5.2.0-rc1.rst b/doc/release-notes/skiboot-5.2.0-rc1.rst
new file mode 100644
index 0000000..44283a3
--- /dev/null
+++ b/doc/release-notes/skiboot-5.2.0-rc1.rst
@@ -0,0 +1,211 @@
+skiboot-5.2.0-rc1
+-----------------
+
+skiboot-5.2.0-rc1 was released on Friday Feb 26th, 2016.
+
+skiboot-5.2.0-rc1 is the first release candidate of skiboot 5.2, which will
+become the new stable release of skiboot following the 5.1 release, first
+released August 17th, 2015.
+
+skiboot-5.2.0-rc1 contains all bug fixes as of skiboot-5.1.13.
+
+This is the second release that will follow the (now documented) Skiboot
+stable rules - see doc/stable-skiboot-rules.txt.
+
+The current plan is to release skiboot-5.2.0 mid-March 2016, with a focus on
+bug fixing for future 5.2.0-rc releases.
+
+Over skiboot-5.1, the following features have been added:
+- Naples (P8', i.e. P8 with NVLINK) processor support, including NVLINK.
+- Improvements in gard, libflash/pflash and opal-prd utilities
+  - increased testing
+  - increased usability
+  - systemd scripts for opal-prd
+  - pflash can now use the /dev/mtd device to access BMC flash rather than
+    accessing it directly. It is *important* that you use --mtd if your
+    BMC may otherwise know how to interact with its own flash.
+- support for Micron N25Q256Ax and N25Qx256Ax NOR flash.
+- support for Winbond W25Q256BV NOR flash
+- support for an emulated ("fake") RTC clock, useful in simulators
+  and during bringup
+- Explicit 1:1 mapping in ranges properties have been added to PCI
+  bridges. This allows a neat trick with offb and VGA ports that should
+  probably not be told to young children.
+- Added support to read the V2 format of the OCC-OPAL memory region,
+  which supports Workload Optimized Frequency (WOF)
+
+Changes in behavior:
+- Assigning OPAL IDs to PHBs is now fixed and based on the chip id and PHB
+  index on that chip. On POWER7, we continue to use allocated numbers.
+- We now query the BMC for BT capabilities rather than making assumptions
+
+Removed support:
+- p5ioc2 is no longer supported.
+  This affects a grand total of two POWER7 systems in the world.
+NOTE: It is planned that skiboot-5.2 will be the last release supporting
+POWER7 machines.
+
+Bugs fixed:
+- PHB3: Fix unexpected ER (all) on errinjct by PCI config
+- hw/bt: timeout messages when BT interface isn't functional
+- On Habanero, Slot3 should have been "Slot 3".
+- We now completely flush the console buffer before power down and reboot
+- For chips with ibm,occ-functional-state set to false, we don't wait
+  for the OCC to start. This caused needless delay in booting on simulators
+  which did not simulate OCCs.
+- Change OCC reset order to always reset slave OCCs first.
+- slw: Remove overwrites for EX_PM_CORE_ECO_VRET and EX_PM_CORE_PFET_VRET
+  (these were already initialized in hostboot)
+- p8-i2c: send stop bit on timeouts.
+  Some devices can otherwise leave the bus in a held state.
+
+Other improvements include:
+- many fixes of compiler and static analysis warnings
+- increased unit test coverage
+- Unit test of "boot debian jessie installer"
+- ability to plug in other simulators to run existing tests (e.g. simulator for
+  non pegasus p8)
+- Support using (patched) Qemu with PowerNV platform support for running
+  unit tests.
+- increased support for running with sparse
+- We now build with -fstack-protector-strong if supported by the compiler
+- We now build with -Werror for -Wformat
+- pflash is now built as part of travis-ci and for Coverity Scan.
+- There is now a RPM SPEC file that can be used as the basis for packaging
+  skiboot and associated utilities.
+
+Contributors
+------------
+
+We have had a number of improvements in workflow over skiboot-5.1.0. Looking
+back, we have roughly the same number of changesets (372 for 5.1.0, 334 for
+5.2.0-rc1 - even closer for 5.1.0-beta1) which indicates a relatively stable
+rate of development.
+
+Complete statistics are included below (generated by gitdm), but I'd like to
+draw attention to a couple of stats:
+
+Release	 csets	Ack	Reviews	Tested	Reported
+5.0	 329	 15	     20	     1	       0
+5.1	 372	 13	     38	     1	       4
+5.2-rc1	 334	 20	     34	     6	      11
+
+Overall, it looks like we're on the right trajectory for increasing the number
+of eyeballs looking at code before it heads in tree, especially around testing.
+Largely, this increase in Tested-by can be attributed to encouraging the
+existing test teams to start commenting on the patches themselves.
+
+Anyway, here's the full stats from skiboot 5.1.0 to 5.2.0-rc1:
+
+Processed 334 csets from 27 developers
+2 employers found
+A total of 46172 lines added, 23274 removed (delta 22898)
+
+Developers with the most changesets
+Stewart Smith              146 (43.7%)
+Cyril Bur                   52 (15.6%)
+Benjamin Herrenschmidt      15 (4.5%)
+Joel Stanley                12 (3.6%)
+Gavin Shan                  12 (3.6%)
+Alistair Popple             10 (3.0%)
+Vasant Hegde                10 (3.0%)
+Michael Neuling             10 (3.0%)
+Russell Currey               9 (2.7%)
+Cédric Le Goater             8 (2.4%)
+Jeremy Kerr                  8 (2.4%)
+Samuel Mendoza-Jonas         6 (1.8%)
+Neelesh Gupta                6 (1.8%)
+Shilpasri G Bhat             4 (1.2%)
+Oliver O'Halloran            4 (1.2%)
+Mahesh Salgaonkar            4 (1.2%)
+Vipin K Parashar             3 (0.9%)
+Daniel Axtens                3 (0.9%)
+Andrew Donnellan             2 (0.6%)
+Philippe Bergheaud           2 (0.6%)
+Ananth N Mavinakayanahalli   2 (0.6%)
+Vaibhav Jain                 1 (0.3%)
+Sam Mendoza-Jonas            1 (0.3%)
+Adriana Kobylak              1 (0.3%)
+Shreyas B. Prabhu            1 (0.3%)
+Vaidyanathan Srinivasan      1 (0.3%)
+Ian Munsie                   1 (0.3%)
+
+Developers with the most changed lines
+Stewart Smith            19533 (39.4%)
+Oliver O'Halloran        17920 (36.1%)
+Alistair Popple           3285 (6.6%)
+Daniel Axtens             2154 (4.3%)
+Cyril Bur                 2028 (4.1%)
+Benjamin Herrenschmidt     941 (1.9%)
+Neelesh Gupta              434 (0.9%)
+Gavin Shan                 294 (0.6%)
+Russell Currey             261 (0.5%)
+Vasant Hegde               245 (0.5%)
+Cédric Le Goater           209 (0.4%)
+Vipin K Parashar           155 (0.3%)
+Shilpasri G Bhat           153 (0.3%)
+Joel Stanley               140 (0.3%)
+Vaidyanathan Srinivasan    135 (0.3%)
+Michael Neuling            111 (0.2%)
+Samuel Mendoza-Jonas        81 (0.2%)
+Jeremy Kerr                 60 (0.1%)
+Mahesh Salgaonkar           58 (0.1%)
+Vaibhav Jain                50 (0.1%)
+Ananth N Mavinakayanahalli  43 (0.1%)
+Shreyas B. Prabhu           17 (0.0%)
+Sam Mendoza-Jonas           12 (0.0%)
+Andrew Donnellan            10 (0.0%)
+Ian Munsie                   8 (0.0%)
+Philippe Bergheaud           6 (0.0%)
+Adriana Kobylak              6 (0.0%)
+
+Developers with the most lines removed
+Daniel Axtens             2149 (9.2%)
+Shreyas B. Prabhu           17 (0.1%)
+Andrew Donnellan             9 (0.0%)
+Vipin K Parashar             2 (0.0%)
+
+Developers with the most signoffs (total 190)
+Stewart Smith              188 (98.9%)
+Gavin Shan                   1 (0.5%)
+Neelesh Gupta                1 (0.5%)
+
+Developers with the most reviews (total 34)
+Patrick Williams             5 (14.7%)
+Joel Stanley                 5 (14.7%)
+Cédric Le Goater            5 (14.7%)
+Vasant Hegde                 4 (11.8%)
+Alistair Popple              4 (11.8%)
+Sam Mendoza-Jonas            3 (8.8%)
+Samuel Mendoza-Jonas         3 (8.8%)
+Andrew Donnellan             2 (5.9%)
+Cyril Bur                    2 (5.9%)
+Vaibhav Jain                 1 (2.9%)
+
+Developers with the most test credits (total 6)
+Vipin K Parashar             3 (50.0%)
+Vaibhav Jain                 2 (33.3%)
+Gajendra B Bandhu1           1 (16.7%)
+
+Developers who gave the most tested-by credits (total 6)
+Gavin Shan                   2 (33.3%)
+Ananth N Mavinakayanahalli    2 (33.3%)
+Alistair Popple              1 (16.7%)
+Stewart Smith                1 (16.7%)
+
+Developers with the most report credits (total 11)
+Vaibhav Jain                 2 (18.2%)
+Paul Nguyen                  2 (18.2%)
+Alistair Popple              1 (9.1%)
+Cédric Le Goater            1 (9.1%)
+Aneesh Kumar K.V             1 (9.1%)
+Dionysius d. Bell            1 (9.1%)
+Pradeep Ramanna              1 (9.1%)
+John Walthour                1 (9.1%)
+Benjamin Herrenschmidt       1 (9.1%)
+
+Developers who gave the most report credits (total 11)
+Gavin Shan                   6 (54.5%)
+Stewart Smith                3 (27.3%)
+Samuel Mendoza-Jonas         1 (9.1%)
+Shilpasri G Bhat             1 (9.1%)
diff --git a/doc/release-notes/skiboot-5.2.0-rc1.txt b/doc/release-notes/skiboot-5.2.0-rc1.txt
deleted file mode 100644
index 44283a3..0000000
--- a/doc/release-notes/skiboot-5.2.0-rc1.txt
+++ /dev/null
@@ -1,211 +0,0 @@
-skiboot-5.2.0-rc1
------------------
-
-skiboot-5.2.0-rc1 was released on Friday Feb 26th, 2016.
-
-skiboot-5.2.0-rc1 is the first release candidate of skiboot 5.2, which will
-become the new stable release of skiboot following the 5.1 release, first
-released August 17th, 2015.
-
-skiboot-5.2.0-rc1 contains all bug fixes as of skiboot-5.1.13.
-
-This is the second release that will follow the (now documented) Skiboot
-stable rules - see doc/stable-skiboot-rules.txt.
-
-The current plan is to release skiboot-5.2.0 mid-March 2016, with a focus on
-bug fixing for future 5.2.0-rc releases.
-
-Over skiboot-5.1, the following features have been added:
-- Naples (P8', i.e. P8 with NVLINK) processor support, including NVLINK.
-- Improvements in gard, libflash/pflash and opal-prd utilities
-  - increased testing
-  - increased usability
-  - systemd scripts for opal-prd
-  - pflash can now use the /dev/mtd device to access BMC flash rather than
-    accessing it directly. It is *important* that you use --mtd if your
-    BMC may otherwise know how to interact with its own flash.
-- support for Micron N25Q256Ax and N25Qx256Ax NOR flash.
-- support for Winbond W25Q256BV NOR flash
-- support for an emulated ("fake") RTC clock, useful in simulators
-  and during bringup
-- Explicit 1:1 mapping in ranges properties have been added to PCI
-  bridges. This allows a neat trick with offb and VGA ports that should
-  probably not be told to young children.
-- Added support to read the V2 format of the OCC-OPAL memory region,
-  which supports Workload Optimized Frequency (WOF)
-
-Changes in behavior:
-- Assigning OPAL IDs to PHBs is now fixed and based on the chip id and PHB
-  index on that chip. On POWER7, we continue to use allocated numbers.
-- We now query the BMC for BT capabilities rather than making assumptions
-
-Removed support:
-- p5ioc2 is no longer supported.
-  This affects a grand total of two POWER7 systems in the world.
-NOTE: It is planned that skiboot-5.2 will be the last release supporting
-POWER7 machines.
-
-Bugs fixed:
-- PHB3: Fix unexpected ER (all) on errinjct by PCI config
-- hw/bt: timeout messages when BT interface isn't functional
-- On Habanero, Slot3 should have been "Slot 3".
-- We now completely flush the console buffer before power down and reboot
-- For chips with ibm,occ-functional-state set to false, we don't wait
-  for the OCC to start. This caused needless delay in booting on simulators
-  which did not simulate OCCs.
-- Change OCC reset order to always reset slave OCCs first.
-- slw: Remove overwrites for EX_PM_CORE_ECO_VRET and EX_PM_CORE_PFET_VRET
-  (these were already initialized in hostboot)
-- p8-i2c: send stop bit on timeouts.
-  Some devices can otherwise leave the bus in a held state.
-
-Other improvements include:
-- many fixes of compiler and static analysis warnings
-- increased unit test coverage
-- Unit test of "boot debian jessie installer"
-- ability to plug in other simulators to run existing tests (e.g. simulator for
-  non pegasus p8)
-- Support using (patched) Qemu with PowerNV platform support for running
-  unit tests.
-- increased support for running with sparse
-- We now build with -fstack-protector-strong if supported by the compiler
-- We now build with -Werror for -Wformat
-- pflash is now built as part of travis-ci and for Coverity Scan.
-- There is now a RPM SPEC file that can be used as the basis for packaging
-  skiboot and associated utilities.
-
-Contributors
-------------
-
-We have had a number of improvements in workflow over skiboot-5.1.0. Looking
-back, we have roughly the same number of changesets (372 for 5.1.0, 334 for
-5.2.0-rc1 - even closer for 5.1.0-beta1) which indicates a relatively stable
-rate of development.
-
-Complete statistics are included below (generated by gitdm), but I'd like to
-draw attention to a couple of stats:
-
-Release	 csets	Ack	Reviews	Tested	Reported
-5.0	 329	 15	     20	     1	       0
-5.1	 372	 13	     38	     1	       4
-5.2-rc1	 334	 20	     34	     6	      11
-
-Overall, it looks like we're on the right trajectory for increasing the number
-of eyeballs looking at code before it heads in tree, especially around testing.
-Largely, this increase in Tested-by can be attributed to encouraging the
-existing test teams to start commenting on the patches themselves.
-
-Anyway, here's the full stats from skiboot 5.1.0 to 5.2.0-rc1:
-
-Processed 334 csets from 27 developers
-2 employers found
-A total of 46172 lines added, 23274 removed (delta 22898)
-
-Developers with the most changesets
-Stewart Smith              146 (43.7%)
-Cyril Bur                   52 (15.6%)
-Benjamin Herrenschmidt      15 (4.5%)
-Joel Stanley                12 (3.6%)
-Gavin Shan                  12 (3.6%)
-Alistair Popple             10 (3.0%)
-Vasant Hegde                10 (3.0%)
-Michael Neuling             10 (3.0%)
-Russell Currey               9 (2.7%)
-Cédric Le Goater             8 (2.4%)
-Jeremy Kerr                  8 (2.4%)
-Samuel Mendoza-Jonas         6 (1.8%)
-Neelesh Gupta                6 (1.8%)
-Shilpasri G Bhat             4 (1.2%)
-Oliver O'Halloran            4 (1.2%)
-Mahesh Salgaonkar            4 (1.2%)
-Vipin K Parashar             3 (0.9%)
-Daniel Axtens                3 (0.9%)
-Andrew Donnellan             2 (0.6%)
-Philippe Bergheaud           2 (0.6%)
-Ananth N Mavinakayanahalli   2 (0.6%)
-Vaibhav Jain                 1 (0.3%)
-Sam Mendoza-Jonas            1 (0.3%)
-Adriana Kobylak              1 (0.3%)
-Shreyas B. Prabhu            1 (0.3%)
-Vaidyanathan Srinivasan      1 (0.3%)
-Ian Munsie                   1 (0.3%)
-
-Developers with the most changed lines
-Stewart Smith            19533 (39.4%)
-Oliver O'Halloran        17920 (36.1%)
-Alistair Popple           3285 (6.6%)
-Daniel Axtens             2154 (4.3%)
-Cyril Bur                 2028 (4.1%)
-Benjamin Herrenschmidt     941 (1.9%)
-Neelesh Gupta              434 (0.9%)
-Gavin Shan                 294 (0.6%)
-Russell Currey             261 (0.5%)
-Vasant Hegde               245 (0.5%)
-Cédric Le Goater           209 (0.4%)
-Vipin K Parashar           155 (0.3%)
-Shilpasri G Bhat           153 (0.3%)
-Joel Stanley               140 (0.3%)
-Vaidyanathan Srinivasan    135 (0.3%)
-Michael Neuling            111 (0.2%)
-Samuel Mendoza-Jonas        81 (0.2%)
-Jeremy Kerr                 60 (0.1%)
-Mahesh Salgaonkar           58 (0.1%)
-Vaibhav Jain                50 (0.1%)
-Ananth N Mavinakayanahalli  43 (0.1%)
-Shreyas B. Prabhu           17 (0.0%)
-Sam Mendoza-Jonas           12 (0.0%)
-Andrew Donnellan            10 (0.0%)
-Ian Munsie                   8 (0.0%)
-Philippe Bergheaud           6 (0.0%)
-Adriana Kobylak              6 (0.0%)
-
-Developers with the most lines removed
-Daniel Axtens             2149 (9.2%)
-Shreyas B. Prabhu           17 (0.1%)
-Andrew Donnellan             9 (0.0%)
-Vipin K Parashar             2 (0.0%)
-
-Developers with the most signoffs (total 190)
-Stewart Smith              188 (98.9%)
-Gavin Shan                   1 (0.5%)
-Neelesh Gupta                1 (0.5%)
-
-Developers with the most reviews (total 34)
-Patrick Williams             5 (14.7%)
-Joel Stanley                 5 (14.7%)
-Cédric Le Goater            5 (14.7%)
-Vasant Hegde                 4 (11.8%)
-Alistair Popple              4 (11.8%)
-Sam Mendoza-Jonas            3 (8.8%)
-Samuel Mendoza-Jonas         3 (8.8%)
-Andrew Donnellan             2 (5.9%)
-Cyril Bur                    2 (5.9%)
-Vaibhav Jain                 1 (2.9%)
-
-Developers with the most test credits (total 6)
-Vipin K Parashar             3 (50.0%)
-Vaibhav Jain                 2 (33.3%)
-Gajendra B Bandhu1           1 (16.7%)
-
-Developers who gave the most tested-by credits (total 6)
-Gavin Shan                   2 (33.3%)
-Ananth N Mavinakayanahalli    2 (33.3%)
-Alistair Popple              1 (16.7%)
-Stewart Smith                1 (16.7%)
-
-Developers with the most report credits (total 11)
-Vaibhav Jain                 2 (18.2%)
-Paul Nguyen                  2 (18.2%)
-Alistair Popple              1 (9.1%)
-Cédric Le Goater            1 (9.1%)
-Aneesh Kumar K.V             1 (9.1%)
-Dionysius d. Bell            1 (9.1%)
-Pradeep Ramanna              1 (9.1%)
-John Walthour                1 (9.1%)
-Benjamin Herrenschmidt       1 (9.1%)
-
-Developers who gave the most report credits (total 11)
-Gavin Shan                   6 (54.5%)
-Stewart Smith                3 (27.3%)
-Samuel Mendoza-Jonas         1 (9.1%)
-Shilpasri G Bhat             1 (9.1%)
diff --git a/doc/release-notes/skiboot-5.2.0-rc2.rst b/doc/release-notes/skiboot-5.2.0-rc2.rst
new file mode 100644
index 0000000..4052cee
--- /dev/null
+++ b/doc/release-notes/skiboot-5.2.0-rc2.rst
@@ -0,0 +1,53 @@
+skiboot-5.2.0-rc2
+-----------------
+
+skiboot-5.2.0-rc2 was released on Wednesday March 9th, 2016.
+
+skiboot-5.2.0-rc2 is the second release candidate of skiboot 5.2, which will
+become the new stable release of skiboot following the 5.1 release, first
+released August 17th, 2015.
+
+skiboot-5.2.0-rc2 contains all bug fixes as of skiboot-5.1.14.
+
+This is the second release that will follow the (now documented) Skiboot
+stable rules - see doc/stable-skiboot-rules.txt.
+
+The current plan is to release skiboot-5.2.0 mid-March 2016, with a focus on
+bug fixing for future 5.2.0-rc releases (if any - I hope this will be the last)
+
+Over skiboot-5.2.0-rc1, we have the following changes:
+
+New platform!
+- Add Barreleye platform
+
+Generic:
+- hw/p8-i2c: Speed up SMBUS_WRITE
+- Fix early backtraces
+
+FSP Platforms:
+- fsp-sensor: rework device tree for sensors
+- platforms/firenze: Fix I2C clock source frequency
+
+Simics simulator:
+- Enable Simics UART console
+
+Mambo simulator:
+- platforms/mambo: Add terminate callback
+  - fix hang in multi-threaded mambo
+  - add multithreaded mambo tests
+
+IPMI:
+- hw/ipmi: fix event data 1 for System Firmware Progress sensor
+- ipmi: Log exact NetFn value in OPAL logs
+
+AST BMC based platforms:
+- hw/bt: allow BT driver to use different buffer size
+
+opal-prd utility:
+- opal-prd: Add debug output for firmware-driven OCC events
+    We indicate when we have a user-driven event, so add corresponding
+    outputs for firmware-driven ones too.
+
+getscom utility:
+- Add Naples chip support
+
diff --git a/doc/release-notes/skiboot-5.2.0-rc2.txt b/doc/release-notes/skiboot-5.2.0-rc2.txt
deleted file mode 100644
index 4052cee..0000000
--- a/doc/release-notes/skiboot-5.2.0-rc2.txt
+++ /dev/null
@@ -1,53 +0,0 @@
-skiboot-5.2.0-rc2
------------------
-
-skiboot-5.2.0-rc2 was released on Wednesday March 9th, 2016.
-
-skiboot-5.2.0-rc2 is the second release candidate of skiboot 5.2, which will
-become the new stable release of skiboot following the 5.1 release, first
-released August 17th, 2015.
-
-skiboot-5.2.0-rc2 contains all bug fixes as of skiboot-5.1.14.
-
-This is the second release that will follow the (now documented) Skiboot
-stable rules - see doc/stable-skiboot-rules.txt.
-
-The current plan is to release skiboot-5.2.0 mid-March 2016, with a focus on
-bug fixing for future 5.2.0-rc releases (if any - I hope this will be the last)
-
-Over skiboot-5.2.0-rc1, we have the following changes:
-
-New platform!
-- Add Barreleye platform
-
-Generic:
-- hw/p8-i2c: Speed up SMBUS_WRITE
-- Fix early backtraces
-
-FSP Platforms:
-- fsp-sensor: rework device tree for sensors
-- platforms/firenze: Fix I2C clock source frequency
-
-Simics simulator:
-- Enable Simics UART console
-
-Mambo simulator:
-- platforms/mambo: Add terminate callback
-  - fix hang in multi-threaded mambo
-  - add multithreaded mambo tests
-
-IPMI:
-- hw/ipmi: fix event data 1 for System Firmware Progress sensor
-- ipmi: Log exact NetFn value in OPAL logs
-
-AST BMC based platforms:
-- hw/bt: allow BT driver to use different buffer size
-
-opal-prd utility:
-- opal-prd: Add debug output for firmware-driven OCC events
-    We indicate when we have a user-driven event, so add corresponding
-    outputs for firmware-driven ones too.
-
-getscom utility:
-- Add Naples chip support
-
diff --git a/doc/release-notes/skiboot-5.2.0.rst b/doc/release-notes/skiboot-5.2.0.rst
new file mode 100644
index 0000000..45af203
--- /dev/null
+++ b/doc/release-notes/skiboot-5.2.0.rst
@@ -0,0 +1,249 @@
+skiboot-5.2.0
+-------------
+
+skiboot-5.2.0 was released on Wednesday March 16th, 2016.
+
+skiboot-5.2.0 is the first stable release of skiboot 5.2, the new stable
+release of skiboot, which will take over from the 5.1.x series which was
+first released August 17th, 2015.
+
+skiboot-5.2.0 contains all bug fixes as of skiboot-5.1.15.
+
+This is the second release that will follow the (now documented) Skiboot
+stable rules - see doc/stable-skiboot-rules.txt.
+
+Over skiboot-5.2.0-rc2, the following fixes are included:
+- Include 'extract-gcov' in make clean.
+- ipmi-sel: Fix esel event logger to handle early boot PANIC events
+- IPMI: Enable synchronous eSEL logging option (for PANIC events)
+- libflash/libffs: Reporting seeing all 0xFF bytes during init.
+- ipmi-sel: Fix memory leak in error path
+
+Over skiboot-5.2.0-rc1, we have the following changes:
+- Add Barreleye platform
+
+Generic:
+- hw/p8-i2c: Speed up SMBUS_WRITE
+- Fix early backtraces
+
+FSP Platforms:
+- fsp-sensor: rework device tree for sensors
+- platforms/firenze: Fix I2C clock source frequency
+
+Simics simulator:
+- Enable Simics UART console
+
+Mambo simulator:
+- platforms/mambo: Add terminate callback
+  - fix hang in multi-threaded mambo
+  - add multithreaded mambo tests
+
+IPMI:
+- hw/ipmi: fix event data 1 for System Firmware Progress sensor
+- ipmi: Log exact NetFn value in OPAL logs
+
+AST BMC based platforms:
+- hw/bt: allow BT driver to use different buffer size
+
+opal-prd utility:
+- opal-prd: Add debug output for firmware-driven OCC events
+    We indicate when we have a user-driven event, so add corresponding
+    outputs for firmware-driven ones too.
+
+getscom utility:
+- Add Naples chip support
+
+Over skiboot-5.1, the following features have been added:
+- Naples (P8', i.e. P8 with NVLINK) processor support, including NVLINK.
+- Improvements in gard, libflash/pflash and opal-prd utilities
+  - increased testing
+  - increased usability
+  - systemd scripts for opal-prd
+  - pflash can now use the /dev/mtd device to access BMC flash rather than
+    accessing it directly. It is *important* that you use --mtd if your
+    BMC may otherwise know how to interact with its own flash.
+- support for Micron N25Q256Ax and N25Qx256Ax NOR flash.
+- support for Winbond W25Q256BV NOR flash
+- support for an emulated ("fake") RTC clock, useful in simulators
+  and during bringup
+- Explicit 1:1 mapping in ranges properties have been added to PCI
+  bridges. This allows a neat trick with offb and VGA ports that should
+  probably not be told to young children.
+- Added support to read the V2 format of the OCC-OPAL memory region,
+  which supports Workload Optimized Frequency (WOF)
+
+Changes in behavior:
+- Assigning OPAL IDs to PHBs is now fixed and based on the chip id and PHB
+  index on that chip. On POWER7, we continue to use allocated numbers.
+- We now query the BMC for BT capabilities rather than making assumptions
+
+Removed support:
+- p5ioc2 is no longer supported.
+  This affects a grand total of two POWER7 systems in the world.
+NOTE: It is planned that skiboot-5.2 will be the last release supporting
+POWER7 machines.
+
+Bugs fixed:
+- PHB3: Fix unexpected ER (all) on errinjct by PCI config
+- hw/bt: timeout messages when BT interface isn't functional
+- On Habanero, Slot3 should have been "Slot 3".
+- We now completely flush the console buffer before power down and reboot
+- For chips with ibm,occ-functional-state set to false, we don't wait
+  for the OCC to start. This caused needless delay in booting on simulators
+  which did not simulate OCCs.
+- Change OCC reset order to always reset slave OCCs first.
+- slw: Remove overwrites for EX_PM_CORE_ECO_VRET and EX_PM_CORE_PFET_VRET
+  (these were already initialized in hostboot)
+- p8-i2c: send stop bit on timeouts.
+  Some devices can otherwise leave the bus in a held state.
+
+Other improvements include:
+- many fixes of compiler and static analysis warnings
+- increased unit test coverage
+- Unit test of "boot debian jessie installer"
+- ability to plug in other simulators to run existing tests (e.g. simulator for
+  non pegasus p8)
+- Support using (patched) Qemu with PowerNV platform support for running
+  unit tests.
+- increased support for running with sparse
+- We now build with -fstack-protector-strong if supported by the compiler
+- We now build with -Werror for -Wformat
+- pflash is now built as part of travis-ci and for Coverity Scan.
+- There is now a RPM SPEC file that can be used as the basis for packaging
+  skiboot and associated utilities.
+
+Contributors
+------------
+
+We have had a number of improvements in workflow over skiboot-5.1.0. Looking
+back, we have roughly the same number of changesets (372 for 5.1.0, 334 for
+5.2.0-rc1 - even closer for 5.1.0-beta1) which indicates a relatively stable
+rate of development.
+
+Complete statistics are included below (generated by gitdm), but I'd like to
+draw attention to a couple of stats:
+
+Release	 csets	Ack	Reviews	Tested	Reported
+5.0	 329	 15	     20	     1	       0
+5.1	 372	 13	     38	     1	       4
+5.2-rc1	 334	 20	     34	     6	      11
+
+Overall, it looks like we're on the right trajectory for increasing the number
+of eyeballs looking at code before it heads in tree, especially around testing.
+Largely, this increase in Tested-by can be attributed to encouraging the
+existing test teams to start commenting on the patches themselves.
+
+Anyway, here's the full stats from skiboot 5.1.0 to 5.2.0-rc1:
+
+Processed 334 csets from 27 developers
+2 employers found
+A total of 46172 lines added, 23274 removed (delta 22898)
+
+Developers with the most changesets
+Stewart Smith              146 (43.7%)
+Cyril Bur                   52 (15.6%)
+Benjamin Herrenschmidt      15 (4.5%)
+Joel Stanley                12 (3.6%)
+Gavin Shan                  12 (3.6%)
+Alistair Popple             10 (3.0%)
+Vasant Hegde                10 (3.0%)
+Michael Neuling             10 (3.0%)
+Russell Currey               9 (2.7%)
+Cédric Le Goater             8 (2.4%)
+Jeremy Kerr                  8 (2.4%)
+Samuel Mendoza-Jonas         6 (1.8%)
+Neelesh Gupta                6 (1.8%)
+Shilpasri G Bhat             4 (1.2%)
+Oliver O'Halloran            4 (1.2%)
+Mahesh Salgaonkar            4 (1.2%)
+Vipin K Parashar             3 (0.9%)
+Daniel Axtens                3 (0.9%)
+Andrew Donnellan             2 (0.6%)
+Philippe Bergheaud           2 (0.6%)
+Ananth N Mavinakayanahalli   2 (0.6%)
+Vaibhav Jain                 1 (0.3%)
+Sam Mendoza-Jonas            1 (0.3%)
+Adriana Kobylak              1 (0.3%)
+Shreyas B. Prabhu            1 (0.3%)
+Vaidyanathan Srinivasan      1 (0.3%)
+Ian Munsie                   1 (0.3%)
+
+Developers with the most changed lines
+Stewart Smith            19533 (39.4%)
+Oliver O'Halloran        17920 (36.1%)
+Alistair Popple           3285 (6.6%)
+Daniel Axtens             2154 (4.3%)
+Cyril Bur                 2028 (4.1%)
+Benjamin Herrenschmidt     941 (1.9%)
+Neelesh Gupta              434 (0.9%)
+Gavin Shan                 294 (0.6%)
+Russell Currey             261 (0.5%)
+Vasant Hegde               245 (0.5%)
+Cédric Le Goater           209 (0.4%)
+Vipin K Parashar           155 (0.3%)
+Shilpasri G Bhat           153 (0.3%)
+Joel Stanley               140 (0.3%)
+Vaidyanathan Srinivasan    135 (0.3%)
+Michael Neuling            111 (0.2%)
+Samuel Mendoza-Jonas        81 (0.2%)
+Jeremy Kerr                 60 (0.1%)
+Mahesh Salgaonkar           58 (0.1%)
+Vaibhav Jain                50 (0.1%)
+Ananth N Mavinakayanahalli  43 (0.1%)
+Shreyas B. Prabhu           17 (0.0%)
+Sam Mendoza-Jonas           12 (0.0%)
+Andrew Donnellan            10 (0.0%)
+Ian Munsie                   8 (0.0%)
+Philippe Bergheaud           6 (0.0%)
+Adriana Kobylak              6 (0.0%)
+
+Developers with the most lines removed
+Daniel Axtens             2149 (9.2%)
+Shreyas B. Prabhu           17 (0.1%)
+Andrew Donnellan             9 (0.0%)
+Vipin K Parashar             2 (0.0%)
+
+Developers with the most signoffs (total 190)
+Stewart Smith              188 (98.9%)
+Gavin Shan                   1 (0.5%)
+Neelesh Gupta                1 (0.5%)
+
+Developers with the most reviews (total 34)
+Patrick Williams             5 (14.7%)
+Joel Stanley                 5 (14.7%)
+Cédric Le Goater            5 (14.7%)
+Vasant Hegde                 4 (11.8%)
+Alistair Popple              4 (11.8%)
+Sam Mendoza-Jonas            3 (8.8%)
+Samuel Mendoza-Jonas         3 (8.8%)
+Andrew Donnellan             2 (5.9%)
+Cyril Bur                    2 (5.9%)
+Vaibhav Jain                 1 (2.9%)
+
+Developers with the most test credits (total 6)
+Vipin K Parashar             3 (50.0%)
+Vaibhav Jain                 2 (33.3%)
+Gajendra B Bandhu1           1 (16.7%)
+
+Developers who gave the most tested-by credits (total 6)
+Gavin Shan                   2 (33.3%)
+Ananth N Mavinakayanahalli    2 (33.3%)
+Alistair Popple              1 (16.7%)
+Stewart Smith                1 (16.7%)
+
+Developers with the most report credits (total 11)
+Vaibhav Jain                 2 (18.2%)
+Paul Nguyen                  2 (18.2%)
+Alistair Popple              1 (9.1%)
+Cédric Le Goater            1 (9.1%)
+Aneesh Kumar K.V             1 (9.1%)
+Dionysius d. Bell            1 (9.1%)
+Pradeep Ramanna              1 (9.1%)
+John Walthour                1 (9.1%)
+Benjamin Herrenschmidt       1 (9.1%)
+
+Developers who gave the most report credits (total 11)
+Gavin Shan                   6 (54.5%)
+Stewart Smith                3 (27.3%)
+Samuel Mendoza-Jonas         1 (9.1%)
+Shilpasri G Bhat             1 (9.1%)
diff --git a/doc/release-notes/skiboot-5.2.0.txt b/doc/release-notes/skiboot-5.2.0.txt
deleted file mode 100644
index 45af203..0000000
--- a/doc/release-notes/skiboot-5.2.0.txt
+++ /dev/null
@@ -1,249 +0,0 @@
-skiboot-5.2.0
--------------
-
-skiboot-5.2.0 was released on Wednesday March 16th, 2016.
-
-skiboot-5.2.0 is the first stable release of skiboot 5.2, the new stable
-release of skiboot, which will take over from the 5.1.x series which was
-first released August 17th, 2015.
-
-skiboot-5.2.0 contains all bug fixes as of skiboot-5.1.15.
-
-This is the second release that will follow the (now documented) Skiboot
-stable rules - see doc/stable-skiboot-rules.txt.
-
-Over skiboot-5.2.0-rc2, the following fixes are included:
-- Include 'extract-gcov' in make clean.
-- ipmi-sel: Fix esel event logger to handle early boot PANIC events
-- IPMI: Enable synchronous eSEL logging option (for PANIC events)
-- libflash/libffs: Reporting seeing all 0xFF bytes during init.
-- ipmi-sel: Fix memory leak in error path
-
-Over skiboot-5.2.0-rc1, we have the following changes:
-- Add Barreleye platform
-
-Generic:
-- hw/p8-i2c: Speed up SMBUS_WRITE
-- Fix early backtraces
-
-FSP Platforms:
-- fsp-sensor: rework device tree for sensors
-- platforms/firenze: Fix I2C clock source frequency
-
-Simics simulator:
-- Enable Simics UART console
-
-Mambo simulator:
-- platforms/mambo: Add terminate callback
-  - fix hang in multi-threaded mambo
-  - add multithreaded mambo tests
-
-IPMI:
-- hw/ipmi: fix event data 1 for System Firmware Progress sensor
-- ipmi: Log exact NetFn value in OPAL logs
-
-AST BMC based platforms:
-- hw/bt: allow BT driver to use different buffer size
-
-opal-prd utility:
-- opal-prd: Add debug output for firmware-driven OCC events
-    We indicate when we have a user-driven event, so add corresponding
-    outputs for firmware-driven ones too.
-
-getscom utility:
-- Add Naples chip support
-
-Over skiboot-5.1, the following features have been added:
-- Naples (P8', i.e. P8 with NVLINK) processor support, including NVLINK.
-- Improvements in gard, libflash/pflash and opal-prd utilities
-  - increased testing
-  - increased usability
-  - systemd scripts for opal-prd
-  - pflash can now use the /dev/mtd device to access BMC flash rather than
-    accessing it directly. It is *important* that you use --mtd if your
-    BMC may otherwise know how to interact with its own flash.
-- support for Micron N25Q256Ax and N25Qx256Ax NOR flash.
-- support for Winbond W25Q256BV NOR flash
-- support for an emulated ("fake") RTC clock, useful in simulators
-  and during bringup
-- Explicit 1:1 mapping in ranges properties have been added to PCI
-  bridges. This allows a neat trick with offb and VGA ports that should
-  probably not be told to young children.
-- Added support to read the V2 format of the OCC-OPAL memory region,
-  which supports Workload Optimized Frequency (WOF)
-
-Changes in behavior:
-- Assigning OPAL IDs to PHBs is now fixed and based on the chip id and PHB
-  index on that chip. On POWER7, we continue to use allocated numbers.
-- We now query the BMC for BT capabilities rather than making assumptions
-
-Removed support:
-- p5ioc2 is no longer supported.
-  This affects a grand total of two POWER7 systems in the world.
-NOTE: It is planned that skiboot-5.2 will be the last release supporting
-POWER7 machines.
-
-Bugs fixed:
-- PHB3: Fix unexpected ER (all) on errinjct by PCI config
-- hw/bt: timeout messages when BT interface isn't functional
-- On Habanero, Slot3 should have been "Slot 3".
-- We now completely flush the console buffer before power down and reboot
-- For chips with ibm,occ-functional-state set to false, we don't wait
-  for the OCC to start. This caused needless delay in booting on simulators
-  which did not simulate OCCs.
-- Change OCC reset order to always reset slave OCCs first.
-- slw: Remove overwrites for EX_PM_CORE_ECO_VRET and EX_PM_CORE_PFET_VRET
-  (these were already initialized in hostboot)
-- p8-i2c: send stop bit on timeouts.
-  Some devices can otherwise leave the bus in a held state.
-
-Other improvements include:
-- many fixes of compiler and static analysis warnings
-- increased unit test coverage
-- Unit test of "boot debian jessie installer"
-- ability to plug in other simulators to run existing tests (e.g. simulator for
-  non pegasus p8)
-- Support using (patched) Qemu with PowerNV platform support for running
-  unit tests.
-- increased support for running with sparse
-- We now build with -fstack-protector-strong if supported by the compiler
-- We now build with -Werror for -Wformat
-- pflash is now built as part of travis-ci and for Coverity Scan.
-- There is now a RPM SPEC file that can be used as the basis for packaging
-  skiboot and associated utilities.
-
-Contributors
-------------
-
-We have had a number of improvements in workflow over skiboot-5.1.0. Looking
-back, we have roughly the same number of changesets (372 for 5.1.0, 334 for
-5.2.0-rc1 - even closer for 5.1.0-beta1) which indicates a relatively stable
-rate of development.
-
-Complete statistics are included below (generated by gitdm), but I'd like to
-draw attention to a couple of stats:
-
-Release	 csets	Ack	Reviews	Tested	Reported
-5.0	 329	 15	     20	     1	       0
-5.1	 372	 13	     38	     1	       4
-5.2-rc1	 334	 20	     34	     6	      11
-
-Overall, it looks like we're on the right trajectory for increasing the number
-of eyeballs looking at code before it heads in tree, especially around testing.
-Largely, this increase in Tested-by can be attributed to encouraging the
-existing test teams to start commenting on the patches themselves.
-
-Anyway, here's the full stats from skiboot 5.1.0 to 5.2.0-rc1:
-
-Processed 334 csets from 27 developers
-2 employers found
-A total of 46172 lines added, 23274 removed (delta 22898)
-
-Developers with the most changesets
-Stewart Smith              146 (43.7%)
-Cyril Bur                   52 (15.6%)
-Benjamin Herrenschmidt      15 (4.5%)
-Joel Stanley                12 (3.6%)
-Gavin Shan                  12 (3.6%)
-Alistair Popple             10 (3.0%)
-Vasant Hegde                10 (3.0%)
-Michael Neuling             10 (3.0%)
-Russell Currey               9 (2.7%)
-Cédric Le Goater             8 (2.4%)
-Jeremy Kerr                  8 (2.4%)
-Samuel Mendoza-Jonas         6 (1.8%)
-Neelesh Gupta                6 (1.8%)
-Shilpasri G Bhat             4 (1.2%)
-Oliver O'Halloran            4 (1.2%)
-Mahesh Salgaonkar            4 (1.2%)
-Vipin K Parashar             3 (0.9%)
-Daniel Axtens                3 (0.9%)
-Andrew Donnellan             2 (0.6%)
-Philippe Bergheaud           2 (0.6%)
-Ananth N Mavinakayanahalli   2 (0.6%)
-Vaibhav Jain                 1 (0.3%)
-Sam Mendoza-Jonas            1 (0.3%)
-Adriana Kobylak              1 (0.3%)
-Shreyas B. Prabhu            1 (0.3%)
-Vaidyanathan Srinivasan      1 (0.3%)
-Ian Munsie                   1 (0.3%)
-
-Developers with the most changed lines
-Stewart Smith            19533 (39.4%)
-Oliver O'Halloran        17920 (36.1%)
-Alistair Popple           3285 (6.6%)
-Daniel Axtens             2154 (4.3%)
-Cyril Bur                 2028 (4.1%)
-Benjamin Herrenschmidt     941 (1.9%)
-Neelesh Gupta              434 (0.9%)
-Gavin Shan                 294 (0.6%)
-Russell Currey             261 (0.5%)
-Vasant Hegde               245 (0.5%)
-Cédric Le Goater           209 (0.4%)
-Vipin K Parashar           155 (0.3%)
-Shilpasri G Bhat           153 (0.3%)
-Joel Stanley               140 (0.3%)
-Vaidyanathan Srinivasan    135 (0.3%)
-Michael Neuling            111 (0.2%)
-Samuel Mendoza-Jonas        81 (0.2%)
-Jeremy Kerr                 60 (0.1%)
-Mahesh Salgaonkar           58 (0.1%)
-Vaibhav Jain                50 (0.1%)
-Ananth N Mavinakayanahalli  43 (0.1%)
-Shreyas B. Prabhu           17 (0.0%)
-Sam Mendoza-Jonas           12 (0.0%)
-Andrew Donnellan            10 (0.0%)
-Ian Munsie                   8 (0.0%)
-Philippe Bergheaud           6 (0.0%)
-Adriana Kobylak              6 (0.0%)
-
-Developers with the most lines removed
-Daniel Axtens             2149 (9.2%)
-Shreyas B. Prabhu           17 (0.1%)
-Andrew Donnellan             9 (0.0%)
-Vipin K Parashar             2 (0.0%)
-
-Developers with the most signoffs (total 190)
-Stewart Smith              188 (98.9%)
-Gavin Shan                   1 (0.5%)
-Neelesh Gupta                1 (0.5%)
-
-Developers with the most reviews (total 34)
-Patrick Williams             5 (14.7%)
-Joel Stanley                 5 (14.7%)
-Cédric Le Goater            5 (14.7%)
-Vasant Hegde                 4 (11.8%)
-Alistair Popple              4 (11.8%)
-Sam Mendoza-Jonas            3 (8.8%)
-Samuel Mendoza-Jonas         3 (8.8%)
-Andrew Donnellan             2 (5.9%)
-Cyril Bur                    2 (5.9%)
-Vaibhav Jain                 1 (2.9%)
-
-Developers with the most test credits (total 6)
-Vipin K Parashar             3 (50.0%)
-Vaibhav Jain                 2 (33.3%)
-Gajendra B Bandhu1           1 (16.7%)
-
-Developers who gave the most tested-by credits (total 6)
-Gavin Shan                   2 (33.3%)
-Ananth N Mavinakayanahalli    2 (33.3%)
-Alistair Popple              1 (16.7%)
-Stewart Smith                1 (16.7%)
-
-Developers with the most report credits (total 11)
-Vaibhav Jain                 2 (18.2%)
-Paul Nguyen                  2 (18.2%)
-Alistair Popple              1 (9.1%)
-Cédric Le Goater            1 (9.1%)
-Aneesh Kumar K.V             1 (9.1%)
-Dionysius d. Bell            1 (9.1%)
-Pradeep Ramanna              1 (9.1%)
-John Walthour                1 (9.1%)
-Benjamin Herrenschmidt       1 (9.1%)
-
-Developers who gave the most report credits (total 11)
-Gavin Shan                   6 (54.5%)
-Stewart Smith                3 (27.3%)
-Samuel Mendoza-Jonas         1 (9.1%)
-Shilpasri G Bhat             1 (9.1%)
diff --git a/doc/release-notes/skiboot-5.2.1.rst b/doc/release-notes/skiboot-5.2.1.rst
new file mode 100644
index 0000000..efa6e35
--- /dev/null
+++ b/doc/release-notes/skiboot-5.2.1.rst
@@ -0,0 +1,121 @@
+skiboot-5.2.1
+-------------
+
+skiboot-5.2.1 was released on Wednesday April 27th, 2016.
+
+skiboot-5.2.1 is the second stable release of skiboot 5.2, the new stable
+release of skiboot, which will take over from the 5.1.x series which was
+first released August 17th, 2015.
+
+skiboot-5.2.1 contains all bug fixes as of skiboot-5.1.15.
+
+This is the second release that will follow the (now documented) Skiboot
+stable rules - see doc/stable-skiboot-rules.txt.
+
+Over skiboot-5.2.0, the following fixes are included:
+
+pflash:
+- Allow building under yocto.
+  Makefile fixes to enable building as part of an OpenBMC build.
+
+Garrison platform:
+- Add PCIe and NPU slot location names
+- hw/npu.c: Add ibm, npu-index property to npu device tree
+- hmi: Add handling for NPU checkstops
+
+PHB3 (all POWER8 platforms):
+- hw/phb3: Ensure PQ bits are cleared in the IVC when masking IRQ
+  When we mask an interrupt, we may race with another interrupt coming
+  in from the hardware.  If this occurs, the P and/or Q bit may end up
+  being set but we never EOI/clear them.  This could result in a lost
+  interrupt or the next interrupt that comes in after re-enabling never
+  being presented.
+
+  This fixes a bug seen with some CAPI workloads which have lots of
+  interrupt masking at the same time as high interrupt load.  The fix is
+  not specific to CAPI though.
+- hw/phb3: Fix potential race in EOI
+  When we EOI we need to clear the present (P) bit in the Interrupt
+  Vector Cache (IVC).  We must clear P ensuring that any additional
+  interrupts that come in aren't lost while also maintaining coherency
+  with the Interrupt Vector Table (IVT).
+
+  To do this, the hardware provides a conditional update bit in the
+  IVC. This bit ensures that generation counts between the IVT and the
+  IVC updates are synchronised.
+
+  Unfortunately we never set this the bit to conditionally update the P
+  bit in the IVC based on the generation count.  Also, we didn't set
+  what we wanted the new generation count to be if the update was
+  successful.
+
+FSP platforms:
+- OPAL:Handle mbox response with bad status:0x24 during FSP termination
+  OPAL committed a predictive log with SRC BB822411 in some situations.
+
+
+Generic:
+- hmi: Fix a bug where partial hmi event was reported to host.
+  This bug fix ensures the CPU PIR is reported correctly:
+    [  305.628283] Fatal Hypervisor Maintenance interrupt [Not recovered]
+    [  305.628341]  Error detail: Malfunction Alert
+    [  305.628388] 	HMER: 8040000000000000
+  - [  305.628423] 	CPU PIR: 00000000
+  + [  200.123021] 	CPU PIR: 000008e8
+    [  305.628458] 	[Unit: VSU] Logic core check stop
+
+- xscom: Return OPAL_WRONG_STATE on XSCOM ops if CPU is asleep
+
+
+Contributors
+------------
+
+Processed 15 csets from 7 developers
+A total of 436 lines added, 59 removed (delta 377)
+
+Developers with the most changesets
+Russell Currey               7 (46.7%)
+Alistair Popple              2 (13.3%)
+Michael Neuling              2 (13.3%)
+Patrick Williams             1 (6.7%)
+Stewart Smith                1 (6.7%)
+Mamatha                      1 (6.7%)
+Mahesh Salgaonkar            1 (6.7%)
+
+Developers with the most changed lines
+Alistair Popple            215 (48.3%)
+Russell Currey             140 (31.5%)
+Michael Neuling             55 (12.4%)
+Mamatha                     15 (3.4%)
+Patrick Williams             9 (2.0%)
+Mahesh Salgaonkar            8 (1.8%)
+Stewart Smith                3 (0.7%)
+
+Developers with the most lines removed
+Patrick Williams             5 (8.5%)
+
+Developers with the most signoffs (total 30)
+Stewart Smith               15 (50.0%)
+Russell Currey               7 (23.3%)
+Michael Neuling              2 (6.7%)
+Alistair Popple              2 (6.7%)
+Patrick Williams             1 (3.3%)
+Oliver O'Halloran            1 (3.3%)
+Mahesh Salgaonkar            1 (3.3%)
+Mamatha                      1 (3.3%)
+
+Developers with the most reviews (total 11)
+Alistair Popple              5 (45.5%)
+Andrew Donnellan             3 (27.3%)
+Mahesh Salgaonkar            2 (18.2%)
+Joel Stanley                 1 (9.1%)
+
+Developers with the most Acked-by (total 1)
+Alistair Popple              1 (100.0%)
+
+Developers with the most test credits (total 3)
+Andrew Donnellan             2 (66.7%)
+Vaibhav Jain                 1 (33.3%)
+
+Developers who received the most tested-by credits (total 3)
+Michael Neuling              3 (100.0%)
diff --git a/doc/release-notes/skiboot-5.2.1.txt b/doc/release-notes/skiboot-5.2.1.txt
deleted file mode 100644
index efa6e35..0000000
--- a/doc/release-notes/skiboot-5.2.1.txt
+++ /dev/null
@@ -1,121 +0,0 @@
-skiboot-5.2.1
--------------
-
-skiboot-5.2.1 was released on Wednesday April 27th, 2016.
-
-skiboot-5.2.1 is the second stable release of skiboot 5.2, the new stable
-release of skiboot, which will take over from the 5.1.x series which was
-first released August 17th, 2015.
-
-skiboot-5.2.1 contains all bug fixes as of skiboot-5.1.15.
-
-This is the second release that will follow the (now documented) Skiboot
-stable rules - see doc/stable-skiboot-rules.txt.
-
-Over skiboot-5.2.0, the following fixes are included:
-
-pflash:
-- Allow building under yocto.
-  Makefile fixes to enable building as part of an OpenBMC build.
-
-Garrison platform:
-- Add PCIe and NPU slot location names
-- hw/npu.c: Add ibm, npu-index property to npu device tree
-- hmi: Add handling for NPU checkstops
-
-PHB3 (all POWER8 platforms):
-- hw/phb3: Ensure PQ bits are cleared in the IVC when masking IRQ
-  When we mask an interrupt, we may race with another interrupt coming
-  in from the hardware.  If this occurs, the P and/or Q bit may end up
-  being set but we never EOI/clear them.  This could result in a lost
-  interrupt or the next interrupt that comes in after re-enabling never
-  being presented.
-
-  This fixes a bug seen with some CAPI workloads which have lots of
-  interrupt masking at the same time as high interrupt load.  The fix is
-  not specific to CAPI though.
-- hw/phb3: Fix potential race in EOI
-  When we EOI we need to clear the present (P) bit in the Interrupt
-  Vector Cache (IVC).  We must clear P ensuring that any additional
-  interrupts that come in aren't lost while also maintaining coherency
-  with the Interrupt Vector Table (IVT).
-
-  To do this, the hardware provides a conditional update bit in the
-  IVC. This bit ensures that generation counts between the IVT and the
-  IVC updates are synchronised.
-
-  Unfortunately we never set this the bit to conditionally update the P
-  bit in the IVC based on the generation count.  Also, we didn't set
-  what we wanted the new generation count to be if the update was
-  successful.
-
-FSP platforms:
-- OPAL:Handle mbox response with bad status:0x24 during FSP termination
-  OPAL committed a predictive log with SRC BB822411 in some situations.
-
-
-Generic:
-- hmi: Fix a bug where partial hmi event was reported to host.
-  This bug fix ensures the CPU PIR is reported correctly:
-    [  305.628283] Fatal Hypervisor Maintenance interrupt [Not recovered]
-    [  305.628341]  Error detail: Malfunction Alert
-    [  305.628388] 	HMER: 8040000000000000
-  - [  305.628423] 	CPU PIR: 00000000
-  + [  200.123021] 	CPU PIR: 000008e8
-    [  305.628458] 	[Unit: VSU] Logic core check stop
-
-- xscom: Return OPAL_WRONG_STATE on XSCOM ops if CPU is asleep
-
-
-Contributors
-------------
-
-Processed 15 csets from 7 developers
-A total of 436 lines added, 59 removed (delta 377)
-
-Developers with the most changesets
-Russell Currey               7 (46.7%)
-Alistair Popple              2 (13.3%)
-Michael Neuling              2 (13.3%)
-Patrick Williams             1 (6.7%)
-Stewart Smith                1 (6.7%)
-Mamatha                      1 (6.7%)
-Mahesh Salgaonkar            1 (6.7%)
-
-Developers with the most changed lines
-Alistair Popple            215 (48.3%)
-Russell Currey             140 (31.5%)
-Michael Neuling             55 (12.4%)
-Mamatha                     15 (3.4%)
-Patrick Williams             9 (2.0%)
-Mahesh Salgaonkar            8 (1.8%)
-Stewart Smith                3 (0.7%)
-
-Developers with the most lines removed
-Patrick Williams             5 (8.5%)
-
-Developers with the most signoffs (total 30)
-Stewart Smith               15 (50.0%)
-Russell Currey               7 (23.3%)
-Michael Neuling              2 (6.7%)
-Alistair Popple              2 (6.7%)
-Patrick Williams             1 (3.3%)
-Oliver O'Halloran            1 (3.3%)
-Mahesh Salgaonkar            1 (3.3%)
-Mamatha                      1 (3.3%)
-
-Developers with the most reviews (total 11)
-Alistair Popple              5 (45.5%)
-Andrew Donnellan             3 (27.3%)
-Mahesh Salgaonkar            2 (18.2%)
-Joel Stanley                 1 (9.1%)
-
-Developers with the most Acked-by (total 1)
-Alistair Popple              1 (100.0%)
-
-Developers with the most test credits (total 3)
-Andrew Donnellan             2 (66.7%)
-Vaibhav Jain                 1 (33.3%)
-
-Developers who received the most tested-by credits (total 3)
-Michael Neuling              3 (100.0%)
diff --git a/doc/release-notes/skiboot-5.2.2.rst b/doc/release-notes/skiboot-5.2.2.rst
new file mode 100644
index 0000000..3c65e11
--- /dev/null
+++ b/doc/release-notes/skiboot-5.2.2.rst
@@ -0,0 +1,32 @@
+skiboot-5.2.2
+-------------
+
+skiboot-5.2.2 was released on Thursday May 5th, 2016.
+
+skiboot-5.2.2 is the third stable release of skiboot 5.2, the new stable
+release of skiboot, which will take over from the 5.1.x series which was
+first released August 17th, 2015.
+
+Skiboot 5.2.2 replaces skiboot-5.2.1 as the current stable version, which was
+released on April 27th, 2016. Over skiboot-5.2.1, skiboot 5.2.2 contains
+one bug fix targeted at P8NVL systems, notably the Garrison platform.
+
+skiboot-5.2.2 contains all bug fixes as of skiboot-5.1.16.
+
+This is the second release that will follow the (now documented) Skiboot
+stable rules - see doc/stable-skiboot-rules.txt.
+
+Over skiboot-5.2.1, the following fixes are included:
+
+P8NVL/Garrison:
+- PHB3: Fix corruption of pref window register
+    On P8+ Garrison platform, the root port's pref window register might
+    be not writable and we have to emulate the window because of hardware
+    defect. In order to detect that, we read the register content, write
+    inversed value and read the register content again. The register is
+    regarded as read-only if the values from the two continuous read are
+    same. However, the original register content isn't written back and
+    it causes corruption on pref window register if it's writable.
+
+    This fixes the above issue by writing the original content back to
+    the register at the end.
diff --git a/doc/release-notes/skiboot-5.2.2.txt b/doc/release-notes/skiboot-5.2.2.txt
deleted file mode 100644
index 3c65e11..0000000
--- a/doc/release-notes/skiboot-5.2.2.txt
+++ /dev/null
@@ -1,32 +0,0 @@
-skiboot-5.2.2
--------------
-
-skiboot-5.2.2 was released on Thursday May 5th, 2016.
-
-skiboot-5.2.2 is the third stable release of skiboot 5.2, the new stable
-release of skiboot, which will take over from the 5.1.x series which was
-first released August 17th, 2015.
-
-Skiboot 5.2.2 replaces skiboot-5.2.1 as the current stable version, which was
-released on April 27th, 2016. Over skiboot-5.2.1, skiboot 5.2.2 contains
-one bug fix targeted at P8NVL systems, notably the Garrison platform.
-
-skiboot-5.2.2 contains all bug fixes as of skiboot-5.1.16.
-
-This is the second release that will follow the (now documented) Skiboot
-stable rules - see doc/stable-skiboot-rules.txt.
-
-Over skiboot-5.2.1, the following fixes are included:
-
-P8NVL/Garrison:
-- PHB3: Fix corruption of pref window register
-    On P8+ Garrison platform, the root port's pref window register might
-    be not writable and we have to emulate the window because of hardware
-    defect. In order to detect that, we read the register content, write
-    inversed value and read the register content again. The register is
-    regarded as read-only if the values from the two continuous read are
-    same. However, the original register content isn't written back and
-    it causes corruption on pref window register if it's writable.
-
-    This fixes the above issue by writing the original content back to
-    the register at the end.
diff --git a/doc/release-notes/skiboot-5.2.3.rst b/doc/release-notes/skiboot-5.2.3.rst
new file mode 100644
index 0000000..6de7f99
--- /dev/null
+++ b/doc/release-notes/skiboot-5.2.3.rst
@@ -0,0 +1,57 @@
+skiboot-5.2.3
+-------------
+
+skiboot-5.2.3 was released on Thursday June 30th, 2016.
+
+skiboot-5.2.3 is the 4th stable release of skiboot 5.2, the new stable
+release of skiboot, which takes over from the 5.1.x series which was
+first released August 17th, 2015.
+
+Skiboot 5.2.3 replaces skiboot-5.2.2 as the current stable version, which was
+released on May 5th, 2016. Over skiboot-5.2.2, skiboot 5.2.3 contains
+one important bug fix regarding parsing data from the OCC regarding CPU
+frequency tables, which could lead to no CPU frequency scaling.
+
+skiboot-5.2.3 contains all bug fixes as of skiboot-5.1.16.
+
+This is the second release that will follow the (now documented) Skiboot
+stable rules - see doc/stable-skiboot-rules.txt.
+
+Over skiboot-5.2.2, the following fixes are included:
+
+OpenPOWER platforms:
+- occ: Filter out entries from Pmin to Pmax in pstate table
+  (cherry picked from commit eca02ee2e62cee115d921a01cea061782ce47cc7)
+  Without this fix, with newer OCC firmware on some OpenPOWER machines,
+  we would fail to parse the table from the OCC, which meant the host OS
+  would not get a table of supported CPU frequencies.
+
+General:
+- pci: Do a dummy config write to devices to establish bus number
+  (cherry picked from commit f46c1e506d199332b0f9741278c8ec35b3e39135)
+
+    On PCI Express, devices need to know their own bus number in order
+    to provide the correct source identification (aka RID) in upstream
+    packets they might send, such as error messages or DMAs.
+
+    However while devices know (and hard wire) their own device and
+    function number, they know nothing about bus numbers by default, those
+    are decoded by bridges for routing. All they know is that if their
+    parent bridge sends a "type 0" configuration access, they should decode
+    it provided the device and function numbers match.
+
+    The PCIe spec thus defines that when a device receive such a configuration
+    access and it's a write, it should "capture" the bus number in the source
+    field of the packet, and re-use as the originator bus number of all
+    subsequent outgoing requests.
+
+    In order to ensure that a device has this bus number firmly established
+    before it's likely to send error packets upstream, we should thus do a
+    dummy configuration write to it as soon as possible after probing.
+- Fix GCC 6 warning in backtrace code
+  (cherry picked from commit 793f6f5b32c96f2774bd955b6062c74a672317ca)
+- Backport of user visible typo fixes
+  partial cherry picked from 4c95b5e04e3c4f72e4005574f67cd6e365d3276f
+
+Utilities:
+- Fix ARM build failure with parallel make
diff --git a/doc/release-notes/skiboot-5.2.3.txt b/doc/release-notes/skiboot-5.2.3.txt
deleted file mode 100644
index 6de7f99..0000000
--- a/doc/release-notes/skiboot-5.2.3.txt
+++ /dev/null
@@ -1,57 +0,0 @@
-skiboot-5.2.3
--------------
-
-skiboot-5.2.3 was released on Thursday June 30th, 2016.
-
-skiboot-5.2.3 is the 4th stable release of skiboot 5.2, the new stable
-release of skiboot, which takes over from the 5.1.x series which was
-first released August 17th, 2015.
-
-Skiboot 5.2.3 replaces skiboot-5.2.2 as the current stable version, which was
-released on May 5th, 2016. Over skiboot-5.2.2, skiboot 5.2.3 contains
-one important bug fix regarding parsing data from the OCC regarding CPU
-frequency tables, which could lead to no CPU frequency scaling.
-
-skiboot-5.2.3 contains all bug fixes as of skiboot-5.1.16.
-
-This is the second release that will follow the (now documented) Skiboot
-stable rules - see doc/stable-skiboot-rules.txt.
-
-Over skiboot-5.2.2, the following fixes are included:
-
-OpenPOWER platforms:
-- occ: Filter out entries from Pmin to Pmax in pstate table
-  (cherry picked from commit eca02ee2e62cee115d921a01cea061782ce47cc7)
-  Without this fix, with newer OCC firmware on some OpenPOWER machines,
-  we would fail to parse the table from the OCC, which meant the host OS
-  would not get a table of supported CPU frequencies.
-
-General:
-- pci: Do a dummy config write to devices to establish bus number
-  (cherry picked from commit f46c1e506d199332b0f9741278c8ec35b3e39135)
-
-    On PCI Express, devices need to know their own bus number in order
-    to provide the correct source identification (aka RID) in upstream
-    packets they might send, such as error messages or DMAs.
-
-    However while devices know (and hard wire) their own device and
-    function number, they know nothing about bus numbers by default, those
-    are decoded by bridges for routing. All they know is that if their
-    parent bridge sends a "type 0" configuration access, they should decode
-    it provided the device and function numbers match.
-
-    The PCIe spec thus defines that when a device receive such a configuration
-    access and it's a write, it should "capture" the bus number in the source
-    field of the packet, and re-use as the originator bus number of all
-    subsequent outgoing requests.
-
-    In order to ensure that a device has this bus number firmly established
-    before it's likely to send error packets upstream, we should thus do a
-    dummy configuration write to it as soon as possible after probing.
-- Fix GCC 6 warning in backtrace code
-  (cherry picked from commit 793f6f5b32c96f2774bd955b6062c74a672317ca)
-- Backport of user visible typo fixes
-  partial cherry picked from 4c95b5e04e3c4f72e4005574f67cd6e365d3276f
-
-Utilities:
-- Fix ARM build failure with parallel make
diff --git a/doc/release-notes/skiboot-5.2.4.rst b/doc/release-notes/skiboot-5.2.4.rst
new file mode 100644
index 0000000..bedac01
--- /dev/null
+++ b/doc/release-notes/skiboot-5.2.4.rst
@@ -0,0 +1,27 @@
+skiboot-5.2.4
+-------------
+
+skiboot-5.2.4 was released on Tuesday July 12th, 2016.
+
+This is the 5th stable release of skiboot 5.2, the new stable release of
+skiboot (first release with 5.2.0 on March 16th 2016).
+
+Skiboot 5.2.4 replaces skiboot-5.2.3 as the current stable version, which was
+released on June 30th 2016. Over skiboot-5.2.3, skiboot 5.2.4 contains bug
+fixes to make skiboot more resilient to errors in the XSCOM engine and some
+build improvements for the pflash utility.
+
+skiboot-5.2.4 contains all bug fixes as of skiboot-5.1.16.
+
+This is the second release that will follow the (now documented) Skiboot
+stable rules - see doc/stable-skiboot-rules.txt.
+
+Over skiboot-5.2.3, the following fixes are included:
+
+All platforms:
+- Make the XSCOM engine code more resilient to errors:
+  - hw/xscom: Reset XSCOM engine after querying sleeping core FIR
+  - hw/xscom: Reset XSCOM engine after finite number of retries when busy
+
+Userspace utilities:
+- pflash build improvements
diff --git a/doc/release-notes/skiboot-5.2.4.txt b/doc/release-notes/skiboot-5.2.4.txt
deleted file mode 100644
index bedac01..0000000
--- a/doc/release-notes/skiboot-5.2.4.txt
+++ /dev/null
@@ -1,27 +0,0 @@
-skiboot-5.2.4
--------------
-
-skiboot-5.2.4 was released on Tuesday July 12th, 2016.
-
-This is the 5th stable release of skiboot 5.2, the new stable release of
-skiboot (first release with 5.2.0 on March 16th 2016).
-
-Skiboot 5.2.4 replaces skiboot-5.2.3 as the current stable version, which was
-released on June 30th 2016. Over skiboot-5.2.3, skiboot 5.2.4 contains bug
-fixes to make skiboot more resilient to errors in the XSCOM engine and some
-build improvements for the pflash utility.
-
-skiboot-5.2.4 contains all bug fixes as of skiboot-5.1.16.
-
-This is the second release that will follow the (now documented) Skiboot
-stable rules - see doc/stable-skiboot-rules.txt.
-
-Over skiboot-5.2.3, the following fixes are included:
-
-All platforms:
-- Make the XSCOM engine code more resilient to errors:
-  - hw/xscom: Reset XSCOM engine after querying sleeping core FIR
-  - hw/xscom: Reset XSCOM engine after finite number of retries when busy
-
-Userspace utilities:
-- pflash build improvements
-- 
2.7.4



More information about the Skiboot mailing list