Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-17 Thread Charles Keepax 
On Wed, May 09, 2018 at 10:18:52AM -0300, Mauro Carvalho Chehab wrote:
> As we move stuff around, some doc references are broken. Fix some of
> them via this script:
>   ./scripts/documentation-file-ref-check --fix-rst
> 
> Manually checked if the produced result is valid, removing a few
> false-positives.
> 
> Signed-off-by: Mauro Carvalho Chehab 
> ---
>  drivers/input/touchscreen/wm97xx-core.c   |  2 +-

Acked-by: Charles Keepax 

Thanks,
Charles
___
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-17 Thread Mathieu Poirier 
On 9 May 2018 at 07:18, Mauro Carvalho Chehab
 wrote:
> As we move stuff around, some doc references are broken. Fix some of
> them via this script:
> ./scripts/documentation-file-ref-check --fix-rst
>
> Manually checked if the produced result is valid, removing a few
> false-positives.
>
> Signed-off-by: Mauro Carvalho Chehab 
> ---

>
> diff --git a/Documentation/trace/coresight.txt 
> b/Documentation/trace/coresight.txt
> index 1d74ad0202b6..efbc832146e7 100644
> --- a/Documentation/trace/coresight.txt
> +++ b/Documentation/trace/coresight.txt
> @@ -426,5 +426,5 @@ root@genericarmv8:~#
>  Details on how to use the generic STM API can be found here [2].
>
>  [1]. Documentation/ABI/testing/sysfs-bus-coresight-devices-stm
> -[2]. Documentation/trace/stm.txt
> +[2]. Documentation/trace/stm.rst
>  [3]. https://github.com/Linaro/perf-opencsd

Acked-by: Mathieu Poirier 
___
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-15 Thread Stephen Boyd 
Quoting Mauro Carvalho Chehab (2018-05-09 06:18:52)
> As we move stuff around, some doc references are broken. Fix some of
> them via this script:
> ./scripts/documentation-file-ref-check --fix-rst
> 
> Manually checked if the produced result is valid, removing a few
> false-positives.
> 
> Signed-off-by: Mauro Carvalho Chehab 
> ---

>  drivers/clk/clk.c |  4 ++--
>  drivers/clk/ingenic/cgu.h |  2 +-

Acked-by: Stephen Boyd 
___
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-14 Thread Masami Hiramatsu 
On Wed,  9 May 2018 10:18:52 -0300
Mauro Carvalho Chehab  wrote:

> As we move stuff around, some doc references are broken. Fix some of
> them via this script:
>   ./scripts/documentation-file-ref-check --fix-rst
> 
> Manually checked if the produced result is valid, removing a few
> false-positives.

The part of kprobes and trace_kprobe changes look good to me :)

Acked-by: Masami Hiramatsu 

Thank you,

> 
> Signed-off-by: Mauro Carvalho Chehab 
> ---
>  .../admin-guide/kernel-parameters.txt |  4 ++--
>  .../bindings/input/rotary-encoder.txt |  2 +-
>  Documentation/driver-api/gpio/consumer.rst|  2 +-
>  Documentation/kprobes.txt |  4 ++--
>  Documentation/trace/coresight.txt |  2 +-
>  Documentation/trace/events.rst|  2 +-
>  Documentation/trace/ftrace-uses.rst   |  2 +-
>  Documentation/trace/histogram.txt |  2 +-
>  Documentation/trace/intel_th.rst  |  2 +-
>  Documentation/trace/tracepoint-analysis.rst   |  6 +++---
>  Documentation/translations/ja_JP/howto.rst|  4 ++--
>  .../translations/zh_CN/magic-number.txt   |  4 ++--
>  .../zh_CN/video4linux/omap3isp.txt|  4 ++--
>  MAINTAINERS   | 20 +--
>  arch/Kconfig  |  2 +-
>  arch/arm/include/asm/cacheflush.h |  2 +-
>  arch/arm64/include/asm/cacheflush.h   |  2 +-
>  arch/microblaze/include/asm/cacheflush.h  |  2 +-
>  arch/um/Kconfig.um|  2 +-
>  arch/unicore32/include/asm/cacheflush.h   |  2 +-
>  arch/x86/entry/vsyscall/vsyscall_64.c |  2 +-
>  arch/xtensa/include/asm/cacheflush.h  |  4 ++--
>  block/Kconfig |  2 +-
>  certs/Kconfig |  2 +-
>  crypto/asymmetric_keys/asymmetric_type.c  |  2 +-
>  crypto/asymmetric_keys/signature.c|  2 +-
>  drivers/char/Kconfig  |  2 +-
>  drivers/clk/clk.c |  4 ++--
>  drivers/clk/ingenic/cgu.h |  2 +-
>  drivers/gpu/vga/Kconfig   |  2 +-
>  drivers/gpu/vga/vgaarb.c  |  2 +-
>  drivers/input/joystick/Kconfig| 10 +-
>  drivers/input/joystick/iforce/Kconfig |  2 +-
>  drivers/input/joystick/walkera0701.c  |  2 +-
>  drivers/input/misc/Kconfig|  4 ++--
>  drivers/input/misc/rotary_encoder.c   |  2 +-
>  drivers/input/mouse/Kconfig   |  6 +++---
>  drivers/input/mouse/alps.c|  2 +-
>  drivers/input/touchscreen/wm97xx-core.c   |  2 +-
>  drivers/lightnvm/pblk-rb.c|  2 +-
>  drivers/md/bcache/Kconfig |  2 +-
>  drivers/md/bcache/btree.c |  2 +-
>  drivers/md/bcache/extents.c   |  2 +-
>  drivers/media/dvb-core/dvb_ringbuffer.c   |  2 +-
>  drivers/media/pci/meye/Kconfig|  2 +-
>  drivers/media/platform/pxa_camera.c   |  4 ++--
>  .../soc_camera/sh_mobile_ceu_camera.c |  2 +-
>  drivers/media/radio/Kconfig   |  2 +-
>  drivers/media/radio/si470x/Kconfig|  2 +-
>  drivers/media/usb/dvb-usb-v2/lmedm04.c|  2 +-
>  drivers/media/usb/zr364xx/Kconfig |  2 +-
>  drivers/parport/Kconfig   |  6 +++---
>  drivers/staging/media/bcm2048/TODO|  2 +-
>  include/keys/asymmetric-subtype.h |  2 +-
>  include/keys/asymmetric-type.h|  2 +-
>  include/linux/assoc_array.h   |  2 +-
>  include/linux/assoc_array_priv.h  |  2 +-
>  include/linux/circ_buf.h  |  2 +-
>  include/linux/ftrace.h|  2 +-
>  include/linux/rculist_nulls.h |  2 +-
>  include/uapi/linux/prctl.h|  2 +-
>  include/xen/interface/io/kbdif.h  |  2 +-
>  kernel/cgroup/cpuset.c|  2 +-
>  kernel/trace/Kconfig  | 16 +++
>  lib/Kconfig   |  2 +-
>  security/selinux/hooks.c  |  2 +-
>  sound/core/Kconfig|  4 ++--
>  sound/drivers/Kconfig |  4 ++--
>  sound/pci/Kconfig | 10 +-
>  tools/include/uapi/linux/prctl.h  |  2 +-
>  tools/lib/api/fs/fs.c |  2 +-
>  tools/memory-model/README | 10 +-
>  tools/perf/util/bpf-prologue.c|  2 +-
>  .../config/custom-timeline-functions.cfg  |  4 ++--
>  74 files changed, 120 insertions(+), 120 deletions(-)
> 


-- 
Masami Hiramatsu

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-13 Thread Takashi Iwai 
On Wed, 09 May 2018 15:18:52 +0200,
Mauro Carvalho Chehab wrote:
> 
> As we move stuff around, some doc references are broken. Fix some of
> them via this script:
>   ./scripts/documentation-file-ref-check --fix-rst
> 
> Manually checked if the produced result is valid, removing a few
> false-positives.
> 
> Signed-off-by: Mauro Carvalho Chehab 

For sound stuff, feel free to take my ack (if it's not too late):
  Acked-by: Takashi Iwai 


thanks,

Takashi
___
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-10 Thread Andrea Parri 
On Wed, May 09, 2018 at 04:41:53PM -0300, Mauro Carvalho Chehab wrote:
> Em Wed, 9 May 2018 15:11:07 -0400 (EDT)
> Alan Stern  escreveu:
> 
> > On Wed, 9 May 2018, Mauro Carvalho Chehab wrote:
> > 
> > > Em Wed, 9 May 2018 19:15:01 +0200
> > > Andrea Parri  escreveu:  
> > 
> > > > >  tools/memory-model/README | 10 +-
> > > > 
> > > > As mentioned in the previous thread, I am for keeping the current
> > > > references: the REAMDE is listing the doc files, as well as other
> > > > files in tools/memory-model/, relatively to that directory.  
> > > 
> > > Yeah, at least this hunk deserves some rework, as now some
> > > references are Documentation/.../foo, while others are just
> > > bar.
> > > 
> > > As on (almost) all other places (except for tools/memory-model/README),
> > > the references are always from the main directory, I would make all
> > > patches there also relative to main dir. If you're afraid of
> > > not being too clearer, we could prefix all of them with something
> > > like:
> > > 
> > >   ${LINUX}/tools/memory-model/...
> > > 
> > > just like some DT binding files do:
> > > 
> > >   Documentation/devicetree/bindings/sound/audio-graph-card.txt:see 
> > > ${LINUX}/Documentation/devicetree/bindings/graph.txt
> > > 
> > > A bonus of doing that is that the broken reference detect script can
> > > keep parsing it without changes (well, it wouldn't be hard to make
> > > it also accept a relative file, but doing that just due to 
> > > tools/memory-model/README seems overkill).
> > > 
> > > Another advantage is that it would allow to easily add references
> > > there from the main kernel Documentation, if needed in the future,
> > > without messing with local x non-local relative namespace.  
> > 
> > How about changing the relative references so that something like
> > Documentation/recipes.txt becomes ./Documentation/recipes.txt?
> 
> Sounds a good idea to me. Andrea?

Counterintuitive ;-)  Documentation/abc.txt vs. ./Documentation/abc.txt
But let me sleep over this ;-)  for the time being, I renew my vote for
"just don't commit these changes (and keep checking automated changes)".

  Andrea


> 
> Thanks,
> Mauro
___
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-10 Thread Andrea Parri 
On Wed, May 09, 2018 at 10:18:52AM -0300, Mauro Carvalho Chehab wrote:
> As we move stuff around, some doc references are broken. Fix some of
> them via this script:
>   ./scripts/documentation-file-ref-check --fix-rst
> 
> Manually checked if the produced result is valid, removing a few
> false-positives.
> 
> Signed-off-by: Mauro Carvalho Chehab 

Thank you again for doing this,


> ---
>  .../admin-guide/kernel-parameters.txt |  4 ++--
>  .../bindings/input/rotary-encoder.txt |  2 +-
>  Documentation/driver-api/gpio/consumer.rst|  2 +-
>  Documentation/kprobes.txt |  4 ++--
>  Documentation/trace/coresight.txt |  2 +-
>  Documentation/trace/events.rst|  2 +-
>  Documentation/trace/ftrace-uses.rst   |  2 +-
>  Documentation/trace/histogram.txt |  2 +-
>  Documentation/trace/intel_th.rst  |  2 +-
>  Documentation/trace/tracepoint-analysis.rst   |  6 +++---
>  Documentation/translations/ja_JP/howto.rst|  4 ++--
>  .../translations/zh_CN/magic-number.txt   |  4 ++--
>  .../zh_CN/video4linux/omap3isp.txt|  4 ++--
>  MAINTAINERS   | 20 +--
>  arch/Kconfig  |  2 +-
>  arch/arm/include/asm/cacheflush.h |  2 +-
>  arch/arm64/include/asm/cacheflush.h   |  2 +-
>  arch/microblaze/include/asm/cacheflush.h  |  2 +-
>  arch/um/Kconfig.um|  2 +-
>  arch/unicore32/include/asm/cacheflush.h   |  2 +-
>  arch/x86/entry/vsyscall/vsyscall_64.c |  2 +-
>  arch/xtensa/include/asm/cacheflush.h  |  4 ++--
>  block/Kconfig |  2 +-
>  certs/Kconfig |  2 +-
>  crypto/asymmetric_keys/asymmetric_type.c  |  2 +-
>  crypto/asymmetric_keys/signature.c|  2 +-
>  drivers/char/Kconfig  |  2 +-
>  drivers/clk/clk.c |  4 ++--
>  drivers/clk/ingenic/cgu.h |  2 +-
>  drivers/gpu/vga/Kconfig   |  2 +-
>  drivers/gpu/vga/vgaarb.c  |  2 +-
>  drivers/input/joystick/Kconfig| 10 +-
>  drivers/input/joystick/iforce/Kconfig |  2 +-
>  drivers/input/joystick/walkera0701.c  |  2 +-
>  drivers/input/misc/Kconfig|  4 ++--
>  drivers/input/misc/rotary_encoder.c   |  2 +-
>  drivers/input/mouse/Kconfig   |  6 +++---
>  drivers/input/mouse/alps.c|  2 +-
>  drivers/input/touchscreen/wm97xx-core.c   |  2 +-
>  drivers/lightnvm/pblk-rb.c|  2 +-
>  drivers/md/bcache/Kconfig |  2 +-
>  drivers/md/bcache/btree.c |  2 +-
>  drivers/md/bcache/extents.c   |  2 +-
>  drivers/media/dvb-core/dvb_ringbuffer.c   |  2 +-
>  drivers/media/pci/meye/Kconfig|  2 +-
>  drivers/media/platform/pxa_camera.c   |  4 ++--
>  .../soc_camera/sh_mobile_ceu_camera.c |  2 +-
>  drivers/media/radio/Kconfig   |  2 +-
>  drivers/media/radio/si470x/Kconfig|  2 +-
>  drivers/media/usb/dvb-usb-v2/lmedm04.c|  2 +-
>  drivers/media/usb/zr364xx/Kconfig |  2 +-
>  drivers/parport/Kconfig   |  6 +++---
>  drivers/staging/media/bcm2048/TODO|  2 +-
>  include/keys/asymmetric-subtype.h |  2 +-
>  include/keys/asymmetric-type.h|  2 +-
>  include/linux/assoc_array.h   |  2 +-
>  include/linux/assoc_array_priv.h  |  2 +-
>  include/linux/circ_buf.h  |  2 +-
>  include/linux/ftrace.h|  2 +-
>  include/linux/rculist_nulls.h |  2 +-
>  include/uapi/linux/prctl.h|  2 +-
>  include/xen/interface/io/kbdif.h  |  2 +-
>  kernel/cgroup/cpuset.c|  2 +-
>  kernel/trace/Kconfig  | 16 +++
>  lib/Kconfig   |  2 +-
>  security/selinux/hooks.c  |  2 +-
>  sound/core/Kconfig|  4 ++--
>  sound/drivers/Kconfig |  4 ++--
>  sound/pci/Kconfig | 10 +-
>  tools/include/uapi/linux/prctl.h  |  2 +-
>  tools/lib/api/fs/fs.c |  2 +-
>  tools/memory-model/README | 10 +-

As mentioned in the previous thread, I am for keeping the current
references: the REAMDE is listing the doc files, as well as other
files in tools/memory-model/, relatively to that directory.

  Andrea
___
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-10 Thread Andrea Parri 
On Wed, May 09, 2018 at 03:20:45PM -0300, Mauro Carvalho Chehab wrote:
> Em Wed, 9 May 2018 19:15:01 +0200
> Andrea Parri  escreveu:
> 
> > On Wed, May 09, 2018 at 10:18:52AM -0300, Mauro Carvalho Chehab wrote:
> > > As we move stuff around, some doc references are broken. Fix some of
> > > them via this script:
> > >   ./scripts/documentation-file-ref-check --fix-rst
> > > 
> > > Manually checked if the produced result is valid, removing a few
> > > false-positives.
> > > 
> > > Signed-off-by: Mauro Carvalho Chehab   
> > 
> > Thank you again for doing this,
> > 
> > 
> > > ---
> > >  .../admin-guide/kernel-parameters.txt |  4 ++--
> > >  .../bindings/input/rotary-encoder.txt |  2 +-
> > >  Documentation/driver-api/gpio/consumer.rst|  2 +-
> > >  Documentation/kprobes.txt |  4 ++--
> > >  Documentation/trace/coresight.txt |  2 +-
> > >  Documentation/trace/events.rst|  2 +-
> > >  Documentation/trace/ftrace-uses.rst   |  2 +-
> > >  Documentation/trace/histogram.txt |  2 +-
> > >  Documentation/trace/intel_th.rst  |  2 +-
> > >  Documentation/trace/tracepoint-analysis.rst   |  6 +++---
> > >  Documentation/translations/ja_JP/howto.rst|  4 ++--
> > >  .../translations/zh_CN/magic-number.txt   |  4 ++--
> > >  .../zh_CN/video4linux/omap3isp.txt|  4 ++--
> > >  MAINTAINERS   | 20 +--
> > >  arch/Kconfig  |  2 +-
> > >  arch/arm/include/asm/cacheflush.h |  2 +-
> > >  arch/arm64/include/asm/cacheflush.h   |  2 +-
> > >  arch/microblaze/include/asm/cacheflush.h  |  2 +-
> > >  arch/um/Kconfig.um|  2 +-
> > >  arch/unicore32/include/asm/cacheflush.h   |  2 +-
> > >  arch/x86/entry/vsyscall/vsyscall_64.c |  2 +-
> > >  arch/xtensa/include/asm/cacheflush.h  |  4 ++--
> > >  block/Kconfig |  2 +-
> > >  certs/Kconfig |  2 +-
> > >  crypto/asymmetric_keys/asymmetric_type.c  |  2 +-
> > >  crypto/asymmetric_keys/signature.c|  2 +-
> > >  drivers/char/Kconfig  |  2 +-
> > >  drivers/clk/clk.c |  4 ++--
> > >  drivers/clk/ingenic/cgu.h |  2 +-
> > >  drivers/gpu/vga/Kconfig   |  2 +-
> > >  drivers/gpu/vga/vgaarb.c  |  2 +-
> > >  drivers/input/joystick/Kconfig| 10 +-
> > >  drivers/input/joystick/iforce/Kconfig |  2 +-
> > >  drivers/input/joystick/walkera0701.c  |  2 +-
> > >  drivers/input/misc/Kconfig|  4 ++--
> > >  drivers/input/misc/rotary_encoder.c   |  2 +-
> > >  drivers/input/mouse/Kconfig   |  6 +++---
> > >  drivers/input/mouse/alps.c|  2 +-
> > >  drivers/input/touchscreen/wm97xx-core.c   |  2 +-
> > >  drivers/lightnvm/pblk-rb.c|  2 +-
> > >  drivers/md/bcache/Kconfig |  2 +-
> > >  drivers/md/bcache/btree.c |  2 +-
> > >  drivers/md/bcache/extents.c   |  2 +-
> > >  drivers/media/dvb-core/dvb_ringbuffer.c   |  2 +-
> > >  drivers/media/pci/meye/Kconfig|  2 +-
> > >  drivers/media/platform/pxa_camera.c   |  4 ++--
> > >  .../soc_camera/sh_mobile_ceu_camera.c |  2 +-
> > >  drivers/media/radio/Kconfig   |  2 +-
> > >  drivers/media/radio/si470x/Kconfig|  2 +-
> > >  drivers/media/usb/dvb-usb-v2/lmedm04.c|  2 +-
> > >  drivers/media/usb/zr364xx/Kconfig |  2 +-
> > >  drivers/parport/Kconfig   |  6 +++---
> > >  drivers/staging/media/bcm2048/TODO|  2 +-
> > >  include/keys/asymmetric-subtype.h |  2 +-
> > >  include/keys/asymmetric-type.h|  2 +-
> > >  include/linux/assoc_array.h   |  2 +-
> > >  include/linux/assoc_array_priv.h  |  2 +-
> > >  include/linux/circ_buf.h  |  2 +-
> > >  include/linux/ftrace.h|  2 +-
> > >  include/linux/rculist_nulls.h |  2 +-
> > >  include/uapi/linux/prctl.h|  2 +-
> > >  include/xen/interface/io/kbdif.h  |  2 +-
> > >  kernel/cgroup/cpuset.c|  2 +-
> > >  kernel/trace/Kconfig  | 16 +++
> > >  lib/Kconfig   |  2 +-
> > >  security/selinux/hooks.c  |  2 +-
> > >  sound/core/Kconfig|  4 ++--
> > >  sound/drivers/Kconfig |  4 ++--
> > >  sound/pci/Kconfig | 10 +-
> > >  tools/include/uapi/linux/prctl.h  |  2 +-
> > >

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-09 Thread Mauro Carvalho Chehab 
Em Wed, 9 May 2018 15:11:07 -0400 (EDT)
Alan Stern  escreveu:

> On Wed, 9 May 2018, Mauro Carvalho Chehab wrote:
> 
> > Em Wed, 9 May 2018 19:15:01 +0200
> > Andrea Parri  escreveu:  
> 
> > > >  tools/memory-model/README | 10 +-
> > > 
> > > As mentioned in the previous thread, I am for keeping the current
> > > references: the REAMDE is listing the doc files, as well as other
> > > files in tools/memory-model/, relatively to that directory.  
> > 
> > Yeah, at least this hunk deserves some rework, as now some
> > references are Documentation/.../foo, while others are just
> > bar.
> > 
> > As on (almost) all other places (except for tools/memory-model/README),
> > the references are always from the main directory, I would make all
> > patches there also relative to main dir. If you're afraid of
> > not being too clearer, we could prefix all of them with something
> > like:
> > 
> > ${LINUX}/tools/memory-model/...
> > 
> > just like some DT binding files do:
> > 
> > Documentation/devicetree/bindings/sound/audio-graph-card.txt:see 
> > ${LINUX}/Documentation/devicetree/bindings/graph.txt
> > 
> > A bonus of doing that is that the broken reference detect script can
> > keep parsing it without changes (well, it wouldn't be hard to make
> > it also accept a relative file, but doing that just due to 
> > tools/memory-model/README seems overkill).
> > 
> > Another advantage is that it would allow to easily add references
> > there from the main kernel Documentation, if needed in the future,
> > without messing with local x non-local relative namespace.  
> 
> How about changing the relative references so that something like
> Documentation/recipes.txt becomes ./Documentation/recipes.txt?

Sounds a good idea to me. Andrea?

Thanks,
Mauro
___
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-09 Thread Alan Stern 
On Wed, 9 May 2018, Mauro Carvalho Chehab wrote:

> Em Wed, 9 May 2018 19:15:01 +0200
> Andrea Parri  escreveu:

> > >  tools/memory-model/README | 10 +-  
> > 
> > As mentioned in the previous thread, I am for keeping the current
> > references: the REAMDE is listing the doc files, as well as other
> > files in tools/memory-model/, relatively to that directory.
> 
> Yeah, at least this hunk deserves some rework, as now some
> references are Documentation/.../foo, while others are just
> bar.
> 
> As on (almost) all other places (except for tools/memory-model/README),
> the references are always from the main directory, I would make all
> patches there also relative to main dir. If you're afraid of
> not being too clearer, we could prefix all of them with something
> like:
> 
>   ${LINUX}/tools/memory-model/...
> 
> just like some DT binding files do:
> 
>   Documentation/devicetree/bindings/sound/audio-graph-card.txt:see 
> ${LINUX}/Documentation/devicetree/bindings/graph.txt
> 
> A bonus of doing that is that the broken reference detect script can
> keep parsing it without changes (well, it wouldn't be hard to make
> it also accept a relative file, but doing that just due to 
> tools/memory-model/README seems overkill).
> 
> Another advantage is that it would allow to easily add references
> there from the main kernel Documentation, if needed in the future,
> without messing with local x non-local relative namespace.

How about changing the relative references so that something like
Documentation/recipes.txt becomes ./Documentation/recipes.txt?

Alan Stern

___
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

Re: [PATCH v2 09/11] docs: Fix some broken references

2018-05-09 Thread Mauro Carvalho Chehab 
Em Wed, 9 May 2018 19:15:01 +0200
Andrea Parri  escreveu:

> On Wed, May 09, 2018 at 10:18:52AM -0300, Mauro Carvalho Chehab wrote:
> > As we move stuff around, some doc references are broken. Fix some of
> > them via this script:
> > ./scripts/documentation-file-ref-check --fix-rst
> > 
> > Manually checked if the produced result is valid, removing a few
> > false-positives.
> > 
> > Signed-off-by: Mauro Carvalho Chehab   
> 
> Thank you again for doing this,
> 
> 
> > ---
> >  .../admin-guide/kernel-parameters.txt |  4 ++--
> >  .../bindings/input/rotary-encoder.txt |  2 +-
> >  Documentation/driver-api/gpio/consumer.rst|  2 +-
> >  Documentation/kprobes.txt |  4 ++--
> >  Documentation/trace/coresight.txt |  2 +-
> >  Documentation/trace/events.rst|  2 +-
> >  Documentation/trace/ftrace-uses.rst   |  2 +-
> >  Documentation/trace/histogram.txt |  2 +-
> >  Documentation/trace/intel_th.rst  |  2 +-
> >  Documentation/trace/tracepoint-analysis.rst   |  6 +++---
> >  Documentation/translations/ja_JP/howto.rst|  4 ++--
> >  .../translations/zh_CN/magic-number.txt   |  4 ++--
> >  .../zh_CN/video4linux/omap3isp.txt|  4 ++--
> >  MAINTAINERS   | 20 +--
> >  arch/Kconfig  |  2 +-
> >  arch/arm/include/asm/cacheflush.h |  2 +-
> >  arch/arm64/include/asm/cacheflush.h   |  2 +-
> >  arch/microblaze/include/asm/cacheflush.h  |  2 +-
> >  arch/um/Kconfig.um|  2 +-
> >  arch/unicore32/include/asm/cacheflush.h   |  2 +-
> >  arch/x86/entry/vsyscall/vsyscall_64.c |  2 +-
> >  arch/xtensa/include/asm/cacheflush.h  |  4 ++--
> >  block/Kconfig |  2 +-
> >  certs/Kconfig |  2 +-
> >  crypto/asymmetric_keys/asymmetric_type.c  |  2 +-
> >  crypto/asymmetric_keys/signature.c|  2 +-
> >  drivers/char/Kconfig  |  2 +-
> >  drivers/clk/clk.c |  4 ++--
> >  drivers/clk/ingenic/cgu.h |  2 +-
> >  drivers/gpu/vga/Kconfig   |  2 +-
> >  drivers/gpu/vga/vgaarb.c  |  2 +-
> >  drivers/input/joystick/Kconfig| 10 +-
> >  drivers/input/joystick/iforce/Kconfig |  2 +-
> >  drivers/input/joystick/walkera0701.c  |  2 +-
> >  drivers/input/misc/Kconfig|  4 ++--
> >  drivers/input/misc/rotary_encoder.c   |  2 +-
> >  drivers/input/mouse/Kconfig   |  6 +++---
> >  drivers/input/mouse/alps.c|  2 +-
> >  drivers/input/touchscreen/wm97xx-core.c   |  2 +-
> >  drivers/lightnvm/pblk-rb.c|  2 +-
> >  drivers/md/bcache/Kconfig |  2 +-
> >  drivers/md/bcache/btree.c |  2 +-
> >  drivers/md/bcache/extents.c   |  2 +-
> >  drivers/media/dvb-core/dvb_ringbuffer.c   |  2 +-
> >  drivers/media/pci/meye/Kconfig|  2 +-
> >  drivers/media/platform/pxa_camera.c   |  4 ++--
> >  .../soc_camera/sh_mobile_ceu_camera.c |  2 +-
> >  drivers/media/radio/Kconfig   |  2 +-
> >  drivers/media/radio/si470x/Kconfig|  2 +-
> >  drivers/media/usb/dvb-usb-v2/lmedm04.c|  2 +-
> >  drivers/media/usb/zr364xx/Kconfig |  2 +-
> >  drivers/parport/Kconfig   |  6 +++---
> >  drivers/staging/media/bcm2048/TODO|  2 +-
> >  include/keys/asymmetric-subtype.h |  2 +-
> >  include/keys/asymmetric-type.h|  2 +-
> >  include/linux/assoc_array.h   |  2 +-
> >  include/linux/assoc_array_priv.h  |  2 +-
> >  include/linux/circ_buf.h  |  2 +-
> >  include/linux/ftrace.h|  2 +-
> >  include/linux/rculist_nulls.h |  2 +-
> >  include/uapi/linux/prctl.h|  2 +-
> >  include/xen/interface/io/kbdif.h  |  2 +-
> >  kernel/cgroup/cpuset.c|  2 +-
> >  kernel/trace/Kconfig  | 16 +++
> >  lib/Kconfig   |  2 +-
> >  security/selinux/hooks.c  |  2 +-
> >  sound/core/Kconfig|  4 ++--
> >  sound/drivers/Kconfig |  4 ++--
> >  sound/pci/Kconfig | 10 +-
> >  tools/include/uapi/linux/prctl.h  |  2 +-
> >  tools/lib/api/fs/fs.c |  2 +-


> >  tools/memory-model/README | 10 +-  
> 
> As mentioned in the previous thread, I am for keeping the current
> references: the REAMDE is listing the doc files,

[PATCH v2 09/11] docs: Fix some broken references

2018-05-09 Thread Mauro Carvalho Chehab 
As we move stuff around, some doc references are broken. Fix some of
them via this script:
./scripts/documentation-file-ref-check --fix-rst

Manually checked if the produced result is valid, removing a few
false-positives.

Signed-off-by: Mauro Carvalho Chehab 
---
 .../admin-guide/kernel-parameters.txt |  4 ++--
 .../bindings/input/rotary-encoder.txt |  2 +-
 Documentation/driver-api/gpio/consumer.rst|  2 +-
 Documentation/kprobes.txt |  4 ++--
 Documentation/trace/coresight.txt |  2 +-
 Documentation/trace/events.rst|  2 +-
 Documentation/trace/ftrace-uses.rst   |  2 +-
 Documentation/trace/histogram.txt |  2 +-
 Documentation/trace/intel_th.rst  |  2 +-
 Documentation/trace/tracepoint-analysis.rst   |  6 +++---
 Documentation/translations/ja_JP/howto.rst|  4 ++--
 .../translations/zh_CN/magic-number.txt   |  4 ++--
 .../zh_CN/video4linux/omap3isp.txt|  4 ++--
 MAINTAINERS   | 20 +--
 arch/Kconfig  |  2 +-
 arch/arm/include/asm/cacheflush.h |  2 +-
 arch/arm64/include/asm/cacheflush.h   |  2 +-
 arch/microblaze/include/asm/cacheflush.h  |  2 +-
 arch/um/Kconfig.um|  2 +-
 arch/unicore32/include/asm/cacheflush.h   |  2 +-
 arch/x86/entry/vsyscall/vsyscall_64.c |  2 +-
 arch/xtensa/include/asm/cacheflush.h  |  4 ++--
 block/Kconfig |  2 +-
 certs/Kconfig |  2 +-
 crypto/asymmetric_keys/asymmetric_type.c  |  2 +-
 crypto/asymmetric_keys/signature.c|  2 +-
 drivers/char/Kconfig  |  2 +-
 drivers/clk/clk.c |  4 ++--
 drivers/clk/ingenic/cgu.h |  2 +-
 drivers/gpu/vga/Kconfig   |  2 +-
 drivers/gpu/vga/vgaarb.c  |  2 +-
 drivers/input/joystick/Kconfig| 10 +-
 drivers/input/joystick/iforce/Kconfig |  2 +-
 drivers/input/joystick/walkera0701.c  |  2 +-
 drivers/input/misc/Kconfig|  4 ++--
 drivers/input/misc/rotary_encoder.c   |  2 +-
 drivers/input/mouse/Kconfig   |  6 +++---
 drivers/input/mouse/alps.c|  2 +-
 drivers/input/touchscreen/wm97xx-core.c   |  2 +-
 drivers/lightnvm/pblk-rb.c|  2 +-
 drivers/md/bcache/Kconfig |  2 +-
 drivers/md/bcache/btree.c |  2 +-
 drivers/md/bcache/extents.c   |  2 +-
 drivers/media/dvb-core/dvb_ringbuffer.c   |  2 +-
 drivers/media/pci/meye/Kconfig|  2 +-
 drivers/media/platform/pxa_camera.c   |  4 ++--
 .../soc_camera/sh_mobile_ceu_camera.c |  2 +-
 drivers/media/radio/Kconfig   |  2 +-
 drivers/media/radio/si470x/Kconfig|  2 +-
 drivers/media/usb/dvb-usb-v2/lmedm04.c|  2 +-
 drivers/media/usb/zr364xx/Kconfig |  2 +-
 drivers/parport/Kconfig   |  6 +++---
 drivers/staging/media/bcm2048/TODO|  2 +-
 include/keys/asymmetric-subtype.h |  2 +-
 include/keys/asymmetric-type.h|  2 +-
 include/linux/assoc_array.h   |  2 +-
 include/linux/assoc_array_priv.h  |  2 +-
 include/linux/circ_buf.h  |  2 +-
 include/linux/ftrace.h|  2 +-
 include/linux/rculist_nulls.h |  2 +-
 include/uapi/linux/prctl.h|  2 +-
 include/xen/interface/io/kbdif.h  |  2 +-
 kernel/cgroup/cpuset.c|  2 +-
 kernel/trace/Kconfig  | 16 +++
 lib/Kconfig   |  2 +-
 security/selinux/hooks.c  |  2 +-
 sound/core/Kconfig|  4 ++--
 sound/drivers/Kconfig |  4 ++--
 sound/pci/Kconfig | 10 +-
 tools/include/uapi/linux/prctl.h  |  2 +-
 tools/lib/api/fs/fs.c |  2 +-
 tools/memory-model/README | 10 +-
 tools/perf/util/bpf-prologue.c|  2 +-
 .../config/custom-timeline-functions.cfg  |  4 ++--
 74 files changed, 120 insertions(+), 120 deletions(-)

diff --git a/Documentation/admin-guide/kernel-parameters.txt 
b/Documentation/admin-guide/kernel-parameters.txt
index 42f3e2884e7c..a7c4dfb573df 100644
--- a/Documentation/admin-guide/kernel-parameters.txt
+++ b/Documentation/admin-guide/kernel-parameters.txt
@@ -4259,7 +4259,7 @@
[FTRACE] Set and start specified trace events in order
to facilitate early boot debugging. The event-list is a
comma separated