OSDN Git Service

Merge tag 'docs-5.5a' of git://git.lwn.net/linux
authorLinus Torvalds <torvalds@linux-foundation.org>
Mon, 2 Dec 2019 19:51:02 +0000 (11:51 -0800)
committerLinus Torvalds <torvalds@linux-foundation.org>
Mon, 2 Dec 2019 19:51:02 +0000 (11:51 -0800)
Pull Documentation updates from Jonathan Corbet:
 "Here are the main documentation changes for 5.5:

   - Various kerneldoc script enhancements.

   - More RST conversions; those are slowing down as we run out of
     things to convert, but we're a ways from done still.

   - Dan's "maintainer profile entry" work landed at last. Now we just
     need to get maintainers to fill in the profiles...

   - A reworking of the parallel build setup to work better with a
     variety of systems (and to not take over huge systems entirely in
     particular).

   - The MAINTAINERS file is now converted to RST during the build.
     Hopefully nobody ever tries to print this thing, or they will need
     to load a lot of paper.

   - A script and documentation making it easy for maintainers to add
     Link: tags at commit time.

  Also included is the removal of a bunch of spurious CR characters"

* tag 'docs-5.5a' of git://git.lwn.net/linux: (91 commits)
  docs: remove a bunch of stray CRs
  docs: fix up the maintainer profile document
  libnvdimm, MAINTAINERS: Maintainer Entry Profile
  Maintainer Handbook: Maintainer Entry Profile
  MAINTAINERS: Reclaim the P: tag for Maintainer Entry Profile
  docs, parallelism: Rearrange how jobserver reservations are made
  docs, parallelism: Do not leak blocking mode to other readers
  docs, parallelism: Fix failure path and add comment
  Documentation: Remove bootmem_debug from kernel-parameters.txt
  Documentation: security: core.rst: fix warnings
  Documentation/process/howto/kokr: Update for 4.x -> 5.x versioning
  Documentation/translation: Use Korean for Korean translation title
  docs/memory-barriers.txt: Remove remaining references to mmiowb()
  docs/memory-barriers.txt/kokr: Update I/O section to be clearer about CPU vs thread
  docs/memory-barriers.txt/kokr: Fix style, spacing and grammar in I/O section
  Documentation/kokr: Kill all references to mmiowb()
  docs/memory-barriers.txt/kokr: Rewrite "KERNEL I/O BARRIER EFFECTS" section
  docs: Add initial documentation for devfreq
  Documentation: Document how to get links with git am
  docs: Add request_irq() documentation
  ...

19 files changed:
1  2 
.mailmap
Documentation/admin-guide/cgroup-v2.rst
Documentation/admin-guide/iostats.rst
Documentation/admin-guide/kernel-parameters.txt
Documentation/admin-guide/perf/imx-ddr.rst
Documentation/core-api/printk-formats.rst
Documentation/devicetree/bindings/timer/ingenic,tcu.txt
Documentation/driver-api/gpio/driver.rst
Documentation/driver-api/index.rst
Documentation/index.rst
Documentation/networking/device_drivers/mellanox/mlx5.rst
Documentation/networking/devlink-trap.rst
Documentation/networking/phy.rst
Documentation/userspace-api/ioctl/ioctl-number.rst
MAINTAINERS
drivers/net/ethernet/faraday/ftgmac100.c
drivers/net/ethernet/pensando/ionic/ionic_if.h
drivers/platform/x86/Kconfig
fs/cifs/cifsfs.c

diff --cc .mailmap
Simple merge
Simple merge
@@@ -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.::
+   .. 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
 +        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.
Simple merge
Simple merge
Simple merge
diff --cc MAINTAINERS
@@@ -9436,8 -9343,10 +9444,9 @@@ LIBNVDIMM: NON-VOLATILE MEMORY DEVICE S
  M:    Dan Williams <dan.j.williams@intel.com>
  M:    Vishal Verma <vishal.l.verma@intel.com>
  M:    Dave Jiang <dave.jiang@intel.com>
 -M:    Keith Busch <keith.busch@intel.com>
  M:    Ira Weiny <ira.weiny@intel.com>
  L:    linux-nvdimm@lists.01.org
+ P:    Documentation/nvdimm/maintainer-entry-profile.rst
  Q:    https://patchwork.kernel.org/project/linux-nvdimm/list/
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/nvdimm/nvdimm.git
  S:    Supported
Simple merge
Simple merge