linux-kernel - Re: [PATCH 0/7] Fix broken references to files under Documentation/*

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <04794d40-0b39-0223-c91e-03b46cb6e2db@wdc.com>
Date:   Fri, 26 Jul 2019 12:55:36 -0700
From:   Atish Patra <atish.patra@....com>
To:     Mauro Carvalho Chehab <mchehab+samsung@...nel.org>
Cc:     "linux-doc@...r.kernel.org" <linux-doc@...r.kernel.org>,
        "linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
        Łukasz Stelmach <l.stelmach@...sung.com>,
        Rob Herring <robh+dt@...nel.org>
Subject: Re: [PATCH 0/7] Fix broken references to files under Documentation/*

On 7/26/19 4:47 AM, Mauro Carvalho Chehab wrote:
> Solves most of the pending broken references upstream, except for two of
> them:
> 
> 	$ ./scripts/documentation-file-ref-check
> 	Documentation/riscv/boot-image-header.txt: Documentation/riscv/booting.txt
> 	MAINTAINERS: Documentation/devicetree/bindings/rng/samsung,exynos5250-trng.txt
> 
> As written at boot-image-header.txt, it is waiting for the addition of
> a future file:
> 
> 	"The complete booting guide will be available at
> 	  Documentation/riscv/booting.txt."
> 

Yeah. We don't have complete booting guide defined in RISC-V land.
Documentation/riscv/booting.txt will be available once we have that.

In the mean time, do we need to convert boot-image-header.txt to 
boot-image-header.rst and fix the reference to 
Documentation/riscv/booting.rst as well ?

> The second is due to this patch, pending to be merged:
> 	https://lore.kernel.org/patchwork/patch/994210/
> 
> I'm not a DT expert, but I can't see any issue with this patch, except
> for a missing acked-by a DT maintainer, and a possible conversion to
> yaml. IMO, the best fix for this would be to merge the DT patch.
> 
> Patch 1 was already submitted before, together with the v1 of
> my PDF fix series.
> 
> Mauro Carvalho Chehab (7):
>    docs: fix broken doc references due to renames
>    docs: generic-counter.rst: fix broken references for ABI file
>    MAINTAINERS: fix reference to net phy ABI file
>    MAINTAINERS: fix a renamed DT reference
>    docs: cgroup-v1/blkio-controller.rst: remove a CFQ left over
>    docs: zh_CN: howto.rst: fix a broken reference
>    docs: dt: fix a sound binding broken reference
> 
>   Documentation/RCU/rculist_nulls.txt                |  2 +-
>   .../admin-guide/cgroup-v1/blkio-controller.rst     |  6 ------
>   .../devicetree/bindings/arm/idle-states.txt        |  2 +-
>   .../devicetree/bindings/sound/sun8i-a33-codec.txt  |  2 +-
>   Documentation/driver-api/generic-counter.rst       |  4 ++--
>   Documentation/locking/spinlocks.rst                |  4 ++--
>   Documentation/memory-barriers.txt                  |  2 +-
>   .../translations/ko_KR/memory-barriers.txt         |  2 +-
>   Documentation/translations/zh_CN/process/howto.rst |  2 +-
>   Documentation/watchdog/hpwdt.rst                   |  2 +-
>   MAINTAINERS                                        | 14 +++++++-------
>   drivers/gpu/drm/drm_modes.c                        |  2 +-
>   drivers/i2c/busses/i2c-nvidia-gpu.c                |  2 +-
>   drivers/scsi/hpsa.c                                |  4 ++--
>   14 files changed, 22 insertions(+), 28 deletions(-)
> 


-- 
Regards,
Atish