Thread (12 messages) 12 messages, 8 authors, 2018-05-16

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

From: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Date: 2018-05-09 19:41:53
Also in: alsa-devel, cgroups, dri-devel, linux-bcache, linux-block, linux-clk, linux-crypto, linux-devicetree, linux-gpio, lkml

Em Wed, 9 May 2018 15:11:07 -0400 (EDT)
Alan Stern [off-list ref] escreveu:
On Wed, 9 May 2018, Mauro Carvalho Chehab wrote:
quoted
Em Wed, 9 May 2018 19:15:01 +0200
Andrea Parri [off-list ref] escreveu:  
quoted
quoted
quoted
 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
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help