Subject: linux-next: manual merge of the jc_docs tree with the arm-perf tree

From: Stephen Rothwell <[email-masked]>
Date: Tue, 5 Nov 2019 11:37:26 +1100

Hi all,

Today's linux-next merge of the jc_docs tree got a conflict in:

  Documentation/admin-guide/perf/imx-ddr.rst

between commits:

  76d835fcd429 ("docs/perf: Add explanation for DDR_CAP_AXI_ID_FILTER_ENHANCED quirk")
  ed0207a33add ("docs/perf: Add AXI ID filter capabilities information")

from the arm-perf tree and commit:

  0522e130b00a ("docs: perf: Add imx-ddr to documentation index")

from the jc_docs tree.

I fixed it up (see below) and can carry the fix as necessary. This
is now fixed as far as linux-next is concerned, but any non trivial
conflicts should be mentioned to your upstream maintainer when your tree
is submitted for merging.  You may also want to consider cooperating
with the maintainer of the conflicting tree to minimise any particularly
complex conflicts.

-- 
Cheers,
Stephen Rothwell

diff --cc Documentation/admin-guide/perf/imx-ddr.rst
index 90056e4e8859,92900b851f5d..000000000000
--- a/Documentation/admin-guide/perf/imx-ddr.rst
+++ b/Documentation/admin-guide/perf/imx-ddr.rst
@@@ -17,9 -17,10 +17,11 @@@ The "format" directory describes forma
  (AXI filtering) fields of the perf_event_attr structure, see /sys/bus/event_source/
  devices/imx8_ddr0/format/. The "events" directory describes the events types
  hardware supported that can be used with perf tool, see /sys/bus/event_source/
 -devices/imx8_ddr0/events/.
 +devices/imx8_ddr0/events/. The "caps" directory describes filter features implemented
 +in DDR PMU, see /sys/bus/events_source/devices/imx8_ddr0/caps/.
-   e.g.::
+ 
+     .. code-block:: bash
+ 
          perf stat -a -e imx8_ddr0/cycles/ cmd
          perf stat -a -e imx8_ddr0/read/,imx8_ddr0/write/ cmd
  
@@@ -45,17 -44,18 +48,23 @@@ value 1 for supported
  
    This filter doesn't support filter different AXI ID for axid-read and axid-write
    event at the same time as this filter is shared between counters.
-   e.g.::
-         perf stat -a -e imx8_ddr0/axid-read,axi_mask=0xMMMM,axi_id=0xDDDD/ cmd
-         perf stat -a -e imx8_ddr0/axid-write,axi_mask=0xMMMM,axi_id=0xDDDD/ cmd
- 
-   NOTE: axi_mask is inverted in userspace(i.e. set bits are bits to mask), and
-   it will be reverted in driver automatically. so that the user can just specify
-   axi_id to monitor a specific id, rather than having to specify axi_mask.
-   e.g.::
-         perf stat -a -e imx8_ddr0/axid-read,axi_id=0x12/ cmd, which will monitor ARID=0x12
+ 
+   .. code-block:: bash
+ 
+       perf stat -a -e imx8_ddr0/axid-read,axi_mask=0xMMMM,axi_id=0xDDDD/ cmd
+       perf stat -a -e imx8_ddr0/axid-write,axi_mask=0xMMMM,axi_id=0xDDDD/ cmd
+ 
+   .. note::
+ 
+       axi_mask is inverted in userspace(i.e. set bits are bits to mask), and
+       it will be reverted in driver automatically. so that the user can just specify
+       axi_id to monitor a specific id, rather than having to specify axi_mask.
+ 
+   .. code-block:: bash
+ 
+       perf stat -a -e imx8_ddr0/axid-read,axi_id=0x12/ cmd, which will monitor ARID=0x12
 +
 +* With DDR_CAP_AXI_ID_FILTER_ENHANCED quirk(filter: 1, enhanced_filter: 1).
 +  This is an extension to the DDR_CAP_AXI_ID_FILTER quirk which permits
 +  counting the number of bytes (as opposed to the number of bursts) from DDR
 +  read and write transactions concurrently with another set of data counters.