Merge tag 'docs-broken-links' of git://linuxtv.org/mchehab/experimental
authorLinus Torvalds <torvalds@linux-foundation.org>
Sat, 16 Jun 2018 20:25:18 +0000 (05:25 +0900)
committerLinus Torvalds <torvalds@linux-foundation.org>
Sat, 16 Jun 2018 20:25:18 +0000 (05:25 +0900)
Pull documentation fixes from Mauro Carvalho Chehab:
 "This solves a series of broken links for files under Documentation,
  and improves a script meant to detect such broken links (see
  scripts/documentation-file-ref-check).

  The changes on this series are:

   - can.rst: fix a footnote reference;

   - crypto_engine.rst: Fix two parsing warnings;

   - Fix a lot of broken references to Documentation/*;

   - improve the scripts/documentation-file-ref-check script, in order
     to help detecting/fixing broken references, preventing
     false-positives.

  After this patch series, only 33 broken references to doc files are
  detected by scripts/documentation-file-ref-check"

* tag 'docs-broken-links' of git://linuxtv.org/mchehab/experimental: (26 commits)
  fix a series of Documentation/ broken file name references
  Documentation: rstFlatTable.py: fix a broken reference
  ABI: sysfs-devices-system-cpu: remove a broken reference
  devicetree: fix a series of wrong file references
  devicetree: fix name of pinctrl-bindings.txt
  devicetree: fix some bindings file names
  MAINTAINERS: fix location of DT npcm files
  MAINTAINERS: fix location of some display DT bindings
  kernel-parameters.txt: fix pointers to sound parameters
  bindings: nvmem/zii: Fix location of nvmem.txt
  docs: Fix more broken references
  scripts/documentation-file-ref-check: check tools/*/Documentation
  scripts/documentation-file-ref-check: get rid of false-positives
  scripts/documentation-file-ref-check: hint: dash or underline
  scripts/documentation-file-ref-check: add a fix logic for DT
  scripts/documentation-file-ref-check: accept more wildcards at filenames
  scripts/documentation-file-ref-check: fix help message
  media: max2175: fix location of driver's companion documentation
  media: v4l: fix broken video4linux docs locations
  media: dvb: point to the location of the old README.dvb-usb file
  ...

1  2 
MAINTAINERS

diff --combined MAINTAINERS
index 97b65e4eaaeec92f956be7cffade9ec9a7cf618e,fd3fc63f275956e841ba6fc37b208c7bc0505437..9d5eeff51b5fd32979f64d288375b6489ff25712
@@@ -1732,7 -1732,8 +1732,8 @@@ F:      arch/arm/mach-npcm
  F:    arch/arm/boot/dts/nuvoton-npcm*
  F:    include/dt-bindings/clock/nuvoton,npcm7xx-clks.h
  F:    drivers/*/*npcm*
- F:    Documentation/*/*npcm*
+ F:    Documentation/devicetree/bindings/*/*npcm*
+ F:    Documentation/devicetree/bindings/*/*/*npcm*
  
  ARM/NUVOTON W90X900 ARM ARCHITECTURE
  M:    Wan ZongShun <mcuos.com@gmail.com>
@@@ -3079,7 -3080,7 +3080,7 @@@ M:      Clemens Ladisch <clemens@ladisch.de
  L:    alsa-devel@alsa-project.org (moderated for non-subscribers)
  T:    git git://git.alsa-project.org/alsa-kernel.git
  S:    Maintained
- F:    Documentation/sound/alsa/Bt87x.txt
+ F:    Documentation/sound/cards/bt87x.rst
  F:    sound/pci/bt87x.c
  
  BT8XXGPIO DRIVER
@@@ -3375,7 -3376,7 +3376,7 @@@ M:      David Howells <dhowells@redhat.com
  M:    David Woodhouse <dwmw2@infradead.org>
  L:    keyrings@vger.kernel.org
  S:    Maintained
- F:    Documentation/module-signing.txt
+ F:    Documentation/admin-guide/module-signing.rst
  F:    certs/
  F:    scripts/sign-file.c
  F:    scripts/extract-cert.c
@@@ -4513,7 -4514,7 +4514,7 @@@ DRM DRIVER FOR ILITEK ILI9225 PANEL
  M:    David Lechner <david@lechnology.com>
  S:    Maintained
  F:    drivers/gpu/drm/tinydrm/ili9225.c
- F:    Documentation/devicetree/bindings/display/ili9225.txt
+ F:    Documentation/devicetree/bindings/display/ilitek,ili9225.txt
  
  DRM DRIVER FOR INTEL I810 VIDEO CARDS
  S:    Orphan / Obsolete
@@@ -4599,13 -4600,13 +4600,13 @@@ DRM DRIVER FOR SITRONIX ST7586 PANEL
  M:    David Lechner <david@lechnology.com>
  S:    Maintained
  F:    drivers/gpu/drm/tinydrm/st7586.c
- F:    Documentation/devicetree/bindings/display/st7586.txt
+ F:    Documentation/devicetree/bindings/display/sitronix,st7586.txt
  
  DRM DRIVER FOR SITRONIX ST7735R PANELS
  M:    David Lechner <david@lechnology.com>
  S:    Maintained
  F:    drivers/gpu/drm/tinydrm/st7735r.c
- F:    Documentation/devicetree/bindings/display/st7735r.txt
+ F:    Documentation/devicetree/bindings/display/sitronix,st7735r.txt
  
  DRM DRIVER FOR TDFX VIDEO CARDS
  S:    Orphan / Obsolete
@@@ -4638,7 -4639,6 +4639,6 @@@ F:      drivers/gpu/drm
  F:    drivers/gpu/vga/
  F:    Documentation/devicetree/bindings/display/
  F:    Documentation/devicetree/bindings/gpu/
- F:    Documentation/devicetree/bindings/video/
  F:    Documentation/gpu/
  F:    include/drm/
  F:    include/uapi/drm/
@@@ -4683,7 -4683,7 +4683,7 @@@ M:      Boris Brezillon <boris.brezillon@boo
  L:    dri-devel@lists.freedesktop.org
  S:    Supported
  F:    drivers/gpu/drm/atmel-hlcdc/
- F:    Documentation/devicetree/bindings/drm/atmel/
+ F:    Documentation/devicetree/bindings/display/atmel/
  T:    git git://anongit.freedesktop.org/drm/drm-misc
  
  DRM DRIVERS FOR BRIDGE CHIPS
@@@ -4714,7 -4714,7 +4714,7 @@@ S:      Supporte
  F:    drivers/gpu/drm/fsl-dcu/
  F:    Documentation/devicetree/bindings/display/fsl,dcu.txt
  F:    Documentation/devicetree/bindings/display/fsl,tcon.txt
- F:    Documentation/devicetree/bindings/display/panel/nec,nl4827hc19_05b.txt
+ F:    Documentation/devicetree/bindings/display/panel/nec,nl4827hc19-05b.txt
  
  DRM DRIVERS FOR FREESCALE IMX
  M:    Philipp Zabel <p.zabel@pengutronix.de>
@@@ -4824,7 -4824,7 +4824,7 @@@ M:      Eric Anholt <eric@anholt.net
  S:    Supported
  F:    drivers/gpu/drm/v3d/
  F:    include/uapi/drm/v3d_drm.h
- F:    Documentation/devicetree/bindings/display/brcm,bcm-v3d.txt
+ F:    Documentation/devicetree/bindings/gpu/brcm,bcm-v3d.txt
  T:    git git://anongit.freedesktop.org/drm/drm-misc
  
  DRM DRIVERS FOR VC4
@@@ -5735,7 -5735,7 +5735,7 @@@ M:      Madalin Bucur <madalin.bucur@nxp.com
  L:    netdev@vger.kernel.org
  S:    Maintained
  F:    drivers/net/ethernet/freescale/fman
- F:    Documentation/devicetree/bindings/powerpc/fsl/fman.txt
+ F:    Documentation/devicetree/bindings/net/fsl-fman.txt
  
  FREESCALE QORIQ PTP CLOCK DRIVER
  M:    Yangbo Lu <yangbo.lu@nxp.com>
@@@ -6501,7 -6501,7 +6501,7 @@@ L:      linux-mm@kvack.or
  S:    Maintained
  F:    mm/hmm*
  F:    include/linux/hmm*
- F:    Documentation/vm/hmm.txt
+ F:    Documentation/vm/hmm.rst
  
  HOST AP DRIVER
  M:    Jouni Malinen <j@w1.fi>
@@@ -6966,7 -6966,7 +6966,7 @@@ IIO MULTIPLEXE
  M:    Peter Rosin <peda@axentia.se>
  L:    linux-iio@vger.kernel.org
  S:    Maintained
- F:    Documentation/devicetree/bindings/iio/multiplexer/iio-mux.txt
+ F:    Documentation/devicetree/bindings/iio/multiplexer/io-channel-mux.txt
  F:    drivers/iio/multiplexer/iio-mux.c
  
  IIO SUBSYSTEM AND DRIVERS
@@@ -7401,7 -7401,7 +7401,7 @@@ F:      drivers/platform/x86/intel-wmi-thund
  INTEL(R) TRACE HUB
  M:    Alexander Shishkin <alexander.shishkin@linux.intel.com>
  S:    Supported
- F:    Documentation/trace/intel_th.txt
+ F:    Documentation/trace/intel_th.rst
  F:    drivers/hwtracing/intel_th/
  
  INTEL(R) TRUSTED EXECUTION TECHNOLOGY (TXT)
@@@ -7425,7 -7425,7 +7425,7 @@@ M:      Linus Walleij <linus.walleij@linaro.
  L:    linux-iio@vger.kernel.org
  S:    Maintained
  F:    drivers/iio/gyro/mpu3050*
- F:    Documentation/devicetree/bindings/iio/gyroscope/inv,mpu3050.txt
+ F:    Documentation/devicetree/bindings/iio/gyroscope/invensense,mpu3050.txt
  
  IOC3 ETHERNET DRIVER
  M:    Ralf Baechle <ralf@linux-mips.org>
@@@ -8700,7 -8700,7 +8700,7 @@@ M:      Guenter Roeck <linux@roeck-us.net
  L:    linux-hwmon@vger.kernel.org
  S:    Maintained
  F:    Documentation/hwmon/max6697
- F:    Documentation/devicetree/bindings/i2c/max6697.txt
+ F:    Documentation/devicetree/bindings/hwmon/max6697.txt
  F:    drivers/hwmon/max6697.c
  F:    include/linux/platform_data/max6697.h
  
@@@ -9080,7 -9080,7 +9080,7 @@@ M:      Martin Donnelly <martin.donnelly@ge.
  M:    Martyn Welch <martyn.welch@collabora.co.uk>
  S:    Maintained
  F:    drivers/gpu/drm/bridge/megachips-stdpxxxx-ge-b850v3-fw.c
- F:    Documentation/devicetree/bindings/video/bridge/megachips-stdpxxxx-ge-b850v3-fw.txt
+ F:    Documentation/devicetree/bindings/display/bridge/megachips-stdpxxxx-ge-b850v3-fw.txt
  
  MEGARAID SCSI/SAS DRIVERS
  M:    Kashyap Desai <kashyap.desai@broadcom.com>
@@@ -9665,7 -9665,7 +9665,7 @@@ F:      include/uapi/linux/mmc
  MULTIPLEXER SUBSYSTEM
  M:    Peter Rosin <peda@axentia.se>
  S:    Maintained
- F:    Documentation/ABI/testing/mux/sysfs-class-mux*
+ F:    Documentation/ABI/testing/sysfs-class-mux*
  F:    Documentation/devicetree/bindings/mux/
  F:    include/linux/dt-bindings/mux/
  F:    include/linux/mux/
@@@ -9696,7 -9696,7 +9696,7 @@@ MXSFB DRM DRIVE
  M:    Marek Vasut <marex@denx.de>
  S:    Supported
  F:    drivers/gpu/drm/mxsfb/
- F:    Documentation/devicetree/bindings/display/mxsfb-drm.txt
+ F:    Documentation/devicetree/bindings/display/mxsfb.txt
  
  MYRICOM MYRI-10G 10GbE DRIVER (MYRI10GE)
  M:    Chris Lee <christopher.lee@cspi.com>
@@@ -10244,7 -10244,7 +10244,7 @@@ F:   arch/powerpc/include/asm/pnv-ocxl.
  F:    drivers/misc/ocxl/
  F:    include/misc/ocxl*
  F:    include/uapi/misc/ocxl.h
- F:    Documentation/accelerators/ocxl.txt
+ F:    Documentation/accelerators/ocxl.rst
  
  OMAP AUDIO SUPPORT
  M:    Peter Ujfalusi <peter.ujfalusi@ti.com>
@@@ -10273,16 -10273,18 +10273,16 @@@ F:        arch/arm/boot/dts/*am5
  F:    arch/arm/boot/dts/*dra7*
  
  OMAP DISPLAY SUBSYSTEM and FRAMEBUFFER SUPPORT (DSS2)
 -M:    Tomi Valkeinen <tomi.valkeinen@ti.com>
  L:    linux-omap@vger.kernel.org
  L:    linux-fbdev@vger.kernel.org
 -S:    Maintained
 +S:    Orphan
  F:    drivers/video/fbdev/omap2/
  F:    Documentation/arm/OMAP/DSS
  
  OMAP FRAMEBUFFER SUPPORT
 -M:    Tomi Valkeinen <tomi.valkeinen@ti.com>
  L:    linux-fbdev@vger.kernel.org
  L:    linux-omap@vger.kernel.org
 -S:    Maintained
 +S:    Orphan
  F:    drivers/video/fbdev/omap/
  
  OMAP GENERAL PURPOSE MEMORY CONTROLLER SUPPORT
@@@ -10726,7 -10728,7 +10726,7 @@@ PARALLEL LCD/KEYPAD PANEL DRIVE
  M:    Willy Tarreau <willy@haproxy.com>
  M:    Ksenija Stanojevic <ksenija.stanojevic@gmail.com>
  S:    Odd Fixes
- F:    Documentation/misc-devices/lcd-panel-cgram.txt
+ F:    Documentation/auxdisplay/lcd-panel-cgram.txt
  F:    drivers/misc/panel.c
  
  PARALLEL PORT SUBSYSTEM
@@@ -10883,7 -10885,7 +10883,7 @@@ M:   Will Deacon <will.deacon@arm.com
  L:    linux-pci@vger.kernel.org
  L:    linux-arm-kernel@lists.infradead.org (moderated for non-subscribers)
  S:    Maintained
- F:    Documentation/devicetree/bindings/pci/controller-generic-pci.txt
+ F:    Documentation/devicetree/bindings/pci/host-generic-pci.txt
  F:    drivers/pci/controller/pci-host-common.c
  F:    drivers/pci/controller/pci-host-generic.c
  
@@@ -11064,7 -11066,7 +11064,7 @@@ M:   Xiaowei Song <songxiaowei@hisilicon.
  M:    Binghui Wang <wangbinghui@hisilicon.com>
  L:    linux-pci@vger.kernel.org
  S:    Maintained
- F:    Documentation/devicetree/bindings/pci/pcie-kirin.txt
+ F:    Documentation/devicetree/bindings/pci/kirin-pcie.txt
  F:    drivers/pci/controller/dwc/pcie-kirin.c
  
  PCIE DRIVER FOR HISILICON STB
@@@ -12177,7 -12179,7 +12177,7 @@@ F:   drivers/mtd/nand/raw/r852.
  
  RISC-V ARCHITECTURE
  M:    Palmer Dabbelt <palmer@sifive.com>
 -M:    Albert Ou <albert@sifive.com>
 +M:    Albert Ou <aou@eecs.berkeley.edu>
  L:    linux-riscv@lists.infradead.org
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/palmer/riscv-linux.git
  S:    Supported
@@@ -12455,7 -12457,7 +12455,7 @@@ L:   linux-crypto@vger.kernel.or
  L:    linux-samsung-soc@vger.kernel.org
  S:    Maintained
  F:    drivers/crypto/exynos-rng.c
- F:    Documentation/devicetree/bindings/crypto/samsung,exynos-rng4.txt
+ F:    Documentation/devicetree/bindings/rng/samsung,exynos4-rng.txt
  
  SAMSUNG EXYNOS TRUE RANDOM NUMBER GENERATOR (TRNG) DRIVER
  M:    Ćukasz Stelmach <l.stelmach@samsung.com>
@@@ -12937,14 -12939,6 +12937,14 @@@ F: drivers/media/usb/siano
  F:    drivers/media/usb/siano/
  F:    drivers/media/mmc/siano/
  
 +SIFIVE DRIVERS
 +M:    Palmer Dabbelt <palmer@sifive.com>
 +L:    linux-riscv@lists.infradead.org
 +T:    git git://git.kernel.org/pub/scm/linux/kernel/git/palmer/riscv-linux.git
 +S:    Supported
 +K:    sifive
 +N:    sifive
 +
  SILEAD TOUCHSCREEN DRIVER
  M:    Hans de Goede <hdegoede@redhat.com>
  L:    linux-input@vger.kernel.org
@@@ -13297,7 -13291,7 +13297,7 @@@ M:   Vinod Koul <vkoul@kernel.org
  L:    alsa-devel@alsa-project.org (moderated for non-subscribers)
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/tiwai/sound.git
  S:    Supported
- F:    Documentation/sound/alsa/compress_offload.txt
+ F:    Documentation/sound/designs/compress-offload.rst
  F:    include/sound/compress_driver.h
  F:    include/uapi/sound/compress_*
  F:    sound/core/compress_offload.c
@@@ -13318,7 -13312,7 +13318,7 @@@ L:   alsa-devel@alsa-project.org (moderat
  W:    http://alsa-project.org/main/index.php/ASoC
  S:    Supported
  F:    Documentation/devicetree/bindings/sound/
- F:    Documentation/sound/alsa/soc/
+ F:    Documentation/sound/soc/
  F:    sound/soc/
  F:    include/sound/soc*
  
@@@ -13577,7 -13571,7 +13577,7 @@@ F:   drivers/*/stm32-*timer
  F:    drivers/pwm/pwm-stm32*
  F:    include/linux/*/stm32-*tim*
  F:    Documentation/ABI/testing/*timer-stm32
- F:    Documentation/devicetree/bindings/*/stm32-*timer
+ F:    Documentation/devicetree/bindings/*/stm32-*timer*
  F:    Documentation/devicetree/bindings/pwm/pwm-stm32*
  
  STMMAC ETHERNET DRIVER
@@@ -13800,7 -13794,7 +13800,7 @@@ SYSTEM TRACE MODULE CLAS
  M:    Alexander Shishkin <alexander.shishkin@linux.intel.com>
  S:    Maintained
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/ash/stm.git
- F:    Documentation/trace/stm.txt
+ F:    Documentation/trace/stm.rst
  F:    drivers/hwtracing/stm/
  F:    include/linux/stm.h
  F:    include/uapi/linux/stm.h
@@@ -14477,7 -14471,7 +14477,7 @@@ M:   Steven Rostedt <rostedt@goodmis.org
  M:    Ingo Molnar <mingo@redhat.com>
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/tip/tip.git perf/core
  S:    Maintained
- F:    Documentation/trace/ftrace.txt
+ F:    Documentation/trace/ftrace.rst
  F:    arch/*/*/*/ftrace.h
  F:    arch/*/kernel/ftrace.c
  F:    include/*/ftrace.h
@@@ -14946,7 -14940,7 +14946,7 @@@ M:   Heikki Krogerus <heikki.krogerus@lin
  L:    linux-usb@vger.kernel.org
  S:    Maintained
  F:    Documentation/ABI/testing/sysfs-class-typec
- F:    Documentation/usb/typec.rst
+ F:    Documentation/driver-api/usb/typec.rst
  F:    drivers/usb/typec/
  F:    include/linux/usb/typec.h
  
@@@ -15013,7 -15007,8 +15013,7 @@@ F:   drivers/media/usb/zr364xx
  USER-MODE LINUX (UML)
  M:    Jeff Dike <jdike@addtoit.com>
  M:    Richard Weinberger <richard@nod.at>
 -L:    user-mode-linux-devel@lists.sourceforge.net
 -L:    user-mode-linux-user@lists.sourceforge.net
 +L:    linux-um@lists.infradead.org
  W:    http://user-mode-linux.sourceforge.net
  T:    git git://git.kernel.org/pub/scm/linux/kernel/git/rw/uml.git
  S:    Maintained
@@@ -15775,7 -15770,7 +15775,7 @@@ YEALINK PHONE DRIVE
  M:    Henk Vergonet <Henk.Vergonet@gmail.com>
  L:    usbb2k-api-dev@nongnu.org
  S:    Maintained
- F:    Documentation/input/yealink.rst
+ F:    Documentation/input/devices/yealink.rst
  F:    drivers/input/misc/yealink.*
  
  Z8530 DRIVER FOR AX.25