[Skiboot] [RFC PATCH 11/23] release-notes/skiboot-5.2.x: Fix ReStructured Text syntax

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


Signed-off-by: Stewart Smith <stewart at linux.vnet.ibm.com>
---
 doc/release-notes/skiboot-5.2.0-rc1.rst | 120 +++++++++++++++++-------
 doc/release-notes/skiboot-5.2.0-rc2.rst |  37 ++++++--
 doc/release-notes/skiboot-5.2.0.rst     | 158 +++++++++++++++++++++++---------
 doc/release-notes/skiboot-5.2.1.rst     |  70 +++++++++++---
 doc/release-notes/skiboot-5.2.2.rst     |   6 +-
 doc/release-notes/skiboot-5.2.3.rst     |  14 ++-
 doc/release-notes/skiboot-5.2.4.rst     |  11 ++-
 7 files changed, 311 insertions(+), 105 deletions(-)

diff --git a/doc/release-notes/skiboot-5.2.0-rc1.rst b/doc/release-notes/skiboot-5.2.0-rc1.rst
index 44283a3..388947c 100644
--- a/doc/release-notes/skiboot-5.2.0-rc1.rst
+++ b/doc/release-notes/skiboot-5.2.0-rc1.rst
@@ -1,5 +1,5 @@
 skiboot-5.2.0-rc1
------------------
+=================
 
 skiboot-5.2.0-rc1 was released on Friday Feb 26th, 2016.
 
@@ -15,9 +15,14 @@ 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.
 
+New Features
+^^^^^^^^^^^^
+
 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
@@ -34,18 +39,25 @@ Over skiboot-5.1, the following features have been added:
 - Added support to read the V2 format of the OCC-OPAL memory region,
   which supports Workload Optimized Frequency (WOF)
 
-Changes in behavior:
+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:
+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
+
+**NOTE**: It is planned that skiboot-5.2 will be the last release supporting
 POWER7 machines.
 
-Bugs fixed:
+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".
@@ -59,7 +71,9 @@ Bugs fixed:
 - p8-i2c: send stop bit on timeouts.
   Some devices can otherwise leave the bus in a held state.
 
-Other improvements include:
+Other improvements
+^^^^^^^^^^^^^^^^^^
+
 - many fixes of compiler and static analysis warnings
 - increased unit test coverage
 - Unit test of "boot debian jessie installer"
@@ -85,10 +99,13 @@ 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.
@@ -102,6 +119,9 @@ Processed 334 csets from 27 developers
 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%)
@@ -129,48 +149,65 @@ 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%)
+
+
+========================== =============
+========================== =============
+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%)
@@ -181,19 +218,31 @@ 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%)
@@ -203,9 +252,14 @@ 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
index 4052cee..a6d9524 100644
--- a/doc/release-notes/skiboot-5.2.0-rc2.rst
+++ b/doc/release-notes/skiboot-5.2.0-rc2.rst
@@ -1,5 +1,5 @@
 skiboot-5.2.0-rc2
------------------
+=================
 
 skiboot-5.2.0-rc2 was released on Wednesday March 9th, 2016.
 
@@ -18,36 +18,55 @@ 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:
+Generic
+^^^^^^^
+
 - hw/p8-i2c: Speed up SMBUS_WRITE
 - Fix early backtraces
 
-FSP Platforms:
+FSP Platforms
+^^^^^^^^^^^^^
+
 - fsp-sensor: rework device tree for sensors
 - platforms/firenze: Fix I2C clock source frequency
 
-Simics simulator:
+Simics simulator
+^^^^^^^^^^^^^^^^
+
 - Enable Simics UART console
 
-Mambo simulator:
+Mambo simulator
+^^^^^^^^^^^^^^^
+
 - platforms/mambo: Add terminate callback
+
   - fix hang in multi-threaded mambo
   - add multithreaded mambo tests
 
-IPMI:
+IPMI
+^^^^
+
 - hw/ipmi: fix event data 1 for System Firmware Progress sensor
 - ipmi: Log exact NetFn value in OPAL logs
 
-AST BMC based platforms:
+AST BMC based platforms
+^^^^^^^^^^^^^^^^^^^^^^^
+
 - hw/bt: allow BT driver to use different buffer size
 
-opal-prd utility:
+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:
+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
index 45af203..fce611b 100644
--- a/doc/release-notes/skiboot-5.2.0.rst
+++ b/doc/release-notes/skiboot-5.2.0.rst
@@ -1,5 +1,5 @@
 skiboot-5.2.0
--------------
+=============
 
 skiboot-5.2.0 was released on Wednesday March 16th, 2016.
 
@@ -12,50 +12,77 @@ 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.
 
+Changes since rc2
+-----------------
 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
 
+Changes since rc1
+-----------------
 Over skiboot-5.2.0-rc1, we have the following changes:
+
 - Add Barreleye platform
 
-Generic:
+Generic
+^^^^^^^
+
 - hw/p8-i2c: Speed up SMBUS_WRITE
 - Fix early backtraces
 
-FSP Platforms:
+FSP Platforms
+^^^^^^^^^^^^^
+
 - fsp-sensor: rework device tree for sensors
 - platforms/firenze: Fix I2C clock source frequency
 
-Simics simulator:
+Simics simulator
+^^^^^^^^^^^^^^^^
+
 - Enable Simics UART console
 
-Mambo simulator:
+Mambo simulator
+^^^^^^^^^^^^^^^
+
 - platforms/mambo: Add terminate callback
+
   - fix hang in multi-threaded mambo
   - add multithreaded mambo tests
 
-IPMI:
+IPMI
+^^^^
+
 - hw/ipmi: fix event data 1 for System Firmware Progress sensor
 - ipmi: Log exact NetFn value in OPAL logs
 
-AST BMC based platforms:
+AST BMC based platforms
+^^^^^^^^^^^^^^^^^^^^^^^
+
 - hw/bt: allow BT driver to use different buffer size
 
-opal-prd utility:
+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:
+getscom utility
+^^^^^^^^^^^^^^^
+
 - Add Naples chip support
 
+New Features
+^^^^^^^^^^^^
 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
@@ -72,18 +99,25 @@ Over skiboot-5.1, the following features have been added:
 - Added support to read the V2 format of the OCC-OPAL memory region,
   which supports Workload Optimized Frequency (WOF)
 
-Changes in behavior:
+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:
+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
+
+**NOTE**: It is planned that skiboot-5.2 will be the last release supporting
 POWER7 machines.
 
-Bugs fixed:
+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".
@@ -97,7 +131,9 @@ Bugs fixed:
 - p8-i2c: send stop bit on timeouts.
   Some devices can otherwise leave the bus in a held state.
 
-Other improvements include:
+Other improvements
+^^^^^^^^^^^^^^^^^^
+
 - many fixes of compiler and static analysis warnings
 - increased unit test coverage
 - Unit test of "boot debian jessie installer"
@@ -123,10 +159,13 @@ 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.
@@ -140,6 +179,9 @@ Processed 334 csets from 27 developers
 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%)
@@ -167,48 +209,65 @@ 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%)
+
+
+========================== =============
+========================== =============
+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%)
@@ -219,19 +278,31 @@ 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%)
@@ -241,9 +312,14 @@ 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
index efa6e35..22e7f7a 100644
--- a/doc/release-notes/skiboot-5.2.1.rst
+++ b/doc/release-notes/skiboot-5.2.1.rst
@@ -1,5 +1,5 @@
 skiboot-5.2.1
--------------
+=============
 
 skiboot-5.2.1 was released on Wednesday April 27th, 2016.
 
@@ -12,18 +12,26 @@ 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.
 
+Changes
+-------
 Over skiboot-5.2.0, the following fixes are included:
 
-pflash:
+pflash
+^^^^^^
+
 - Allow building under yocto.
   Makefile fixes to enable building as part of an OpenBMC build.
 
-Garrison platform:
+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):
+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
@@ -49,20 +57,24 @@ PHB3 (all POWER8 platforms):
   what we wanted the new generation count to be if the update was
   successful.
 
-FSP platforms:
+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
+^^^^^^^
 
-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
+  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
 
@@ -74,6 +86,9 @@ 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%)
@@ -81,8 +96,12 @@ 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%)
@@ -90,11 +109,19 @@ 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%)
@@ -103,19 +130,36 @@ 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
index 3c65e11..f23e0cf 100644
--- a/doc/release-notes/skiboot-5.2.2.rst
+++ b/doc/release-notes/skiboot-5.2.2.rst
@@ -1,5 +1,5 @@
 skiboot-5.2.2
--------------
+=============
 
 skiboot-5.2.2 was released on Thursday May 5th, 2016.
 
@@ -18,7 +18,9 @@ stable rules - see doc/stable-skiboot-rules.txt.
 
 Over skiboot-5.2.1, the following fixes are included:
 
-P8NVL/Garrison:
+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
diff --git a/doc/release-notes/skiboot-5.2.3.rst b/doc/release-notes/skiboot-5.2.3.rst
index 6de7f99..d7978fb 100644
--- a/doc/release-notes/skiboot-5.2.3.rst
+++ b/doc/release-notes/skiboot-5.2.3.rst
@@ -1,5 +1,5 @@
 skiboot-5.2.3
--------------
+=============
 
 skiboot-5.2.3 was released on Thursday June 30th, 2016.
 
@@ -19,14 +19,18 @@ stable rules - see doc/stable-skiboot-rules.txt.
 
 Over skiboot-5.2.2, the following fixes are included:
 
-OpenPOWER platforms:
+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:
+General
+^^^^^^^
+
 - pci: Do a dummy config write to devices to establish bus number
   (cherry picked from commit f46c1e506d199332b0f9741278c8ec35b3e39135)
 
@@ -53,5 +57,7 @@ General:
 - Backport of user visible typo fixes
   partial cherry picked from 4c95b5e04e3c4f72e4005574f67cd6e365d3276f
 
-Utilities:
+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
index bedac01..46cadb4 100644
--- a/doc/release-notes/skiboot-5.2.4.rst
+++ b/doc/release-notes/skiboot-5.2.4.rst
@@ -1,5 +1,5 @@
 skiboot-5.2.4
--------------
+=============
 
 skiboot-5.2.4 was released on Tuesday July 12th, 2016.
 
@@ -18,10 +18,15 @@ stable rules - see doc/stable-skiboot-rules.txt.
 
 Over skiboot-5.2.3, the following fixes are included:
 
-All platforms:
+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:
+Userspace utilities
+^^^^^^^^^^^^^^^^^^^
+
 - pflash build improvements
-- 
2.7.4



More information about the Skiboot mailing list