[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [Xen-devel] [PATCH v2 09/11] docs: Fix some broken references
- To: Alan Stern <stern@xxxxxxxxxxxxxxxxxxx>
- From: Mauro Carvalho Chehab <mchehab+samsung@xxxxxxxxxx>
- Date: Wed, 9 May 2018 16:41:53 -0300
- Cc: Catalin Marinas <catalin.marinas@xxxxxxx>, Linus Walleij <linus.walleij@xxxxxxxxxx>, Will Deacon <will.deacon@xxxxxxx>, dri-devel@xxxxxxxxxxxxxxxxxxxxx, Jaroslav Kysela <perex@xxxxxxxx>, Eric Paris <eparis@xxxxxxxxxxxxxx>, linux-clk@xxxxxxxxxxxxxxx, James Morris <jmorris@xxxxxxxxx>, xen-devel@xxxxxxxxxxxxxxxxxxxx, Boqun Feng <boqun.feng@xxxxxxxxx>, Nicholas Piggin <npiggin@xxxxxxxxx>, Sean Paul <seanpaul@xxxxxxxxxxxx>, Thomas Gleixner <tglx@xxxxxxxxxxxxx>, Antoine Jacquet <royale@xxxxxxxxxx>, Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx>, linux-usb@xxxxxxxxxxxxxxx, linux-kernel@xxxxxxxxxxxxxxx, Li Zefan <lizefan@xxxxxxxxxx>, linux-crypto@xxxxxxxxxxxxxxx, Mark Rutland <mark.rutland@xxxxxxx>, alsa-devel@xxxxxxxxxxxxxxxx, Linux Doc Mailing List <linux-doc@xxxxxxxxxxxxxxx>, David Airlie <airlied@xxxxxxxx>, Gustavo Padovan <gustavo@xxxxxxxxxxx>, Max Filippov <jcmvbkbc@xxxxxxxxx>, Harry Wei <harryxiyou@xxxxxxxxx>, selinux@xxxxxxxxxxxxx, Paul Moore <paul@xxxxxxxxxxxxxx>, Anil S Keshavamurthy <anil.s.keshavamurthy@xxxxxxxxx>, Masami Hiramatsu <mhiramat@xxxxxxxxxx>, Andrea Parri <parri.andrea@xxxxxxxxx>, linux-xtensa@xxxxxxxxxxxxxxxx, Mauro Carvalho Chehab <mchehab@xxxxxxxxxxxxx>, linux-gpio@xxxxxxxxxxxxxxx, cgroups@xxxxxxxxxxxxxxx, Boris Ostrovsky <boris.ostrovsky@xxxxxxxxxx>, linux-arm-kernel@xxxxxxxxxxxxxxxxxxx, Chris Zankel <chris@xxxxxxxxxx>, Mathieu Poirier <mathieu.poirier@xxxxxxxxxx>, Stephen Boyd <sboyd@xxxxxxxxxx>, "David S. Miller" <davem@xxxxxxxxxxxxx>, Rob Herring <robh+dt@xxxxxxxxxx>, Alexander Shishkin <alexander.shishkin@xxxxxxxxxxxxxxx>, Michael Turquette <mturquette@xxxxxxxxxxxx>, Akira Yokosawa <akiyks@xxxxxxxxx>, Lai Jiangshan <jiangshanlai@xxxxxxxxx>, Jonathan Corbet <corbet@xxxxxxx>, linux-input@xxxxxxxxxxxxxxx, "Paul E. McKenney" <paulmck@xxxxxxxxxxxxxxxxxx>, Stephen Smalley <sds@xxxxxxxxxxxxx>, Kent Overstreet <kent.overstreet@xxxxxxxxx>, "Serge E. Hallyn" <serge@xxxxxxxxxx>, Jens Axboe <axboe@xxxxxxxxx>, Arnd Bergmann <arnd@xxxxxxxx>, Malcolm Priestley <tvboxspy@xxxxxxxxx>, Jeff Dike <jdike@xxxxxxxxxxx>, Josh Triplett <josh@xxxxxxxxxxxxxxxx>, Steven Rostedt <rostedt@xxxxxxxxxxx>, Mathieu Desnoyers <mathieu.desnoyers@xxxxxxxxxxxx>, Luc Maranget <luc.maranget@xxxxxxxx>, Guan Xuetao <gxt@xxxxxxxxxx>, Jade Alglave <j.alglave@xxxxxxxxx>, Dmitry Torokhov <dmitry.torokhov@xxxxxxxxx>, keyrings@xxxxxxxxxxxxxxx, linux-kernel@xxxxxxxxxxxxx, Pali Rohár <pali.rohar@xxxxxxxxx>, Sudip Mukherjee <sudipm.mukherjee@xxxxxxxxx>, Michael Lyle <mlyle@xxxxxxxx>, Peter Zijlstra <peterz@xxxxxxxxxxxxx>, David Howells <dhowells@xxxxxxxxxx>, "H. Peter Anvin" <hpa@xxxxxxxxx>, Jiri Olsa <jolsa@xxxxxxxxxx>, devel@xxxxxxxxxxxxxxxxxxxx, Herbert Xu <herbert@xxxxxxxxxxxxxxxxxxx>, Richard Weinberger <richard@xxxxxx>, x86@xxxxxxxxxx, Russell King <linux@xxxxxxxxxxxxxxx>, Ingo Molnar <mingo@xxxxxxxxxx>, Matias Bjorling <mb@xxxxxxxxxxx>, devicetree@xxxxxxxxxxxxxxx, user-mode-linux-devel@xxxxxxxxxxxxxxxxxxxxx, Maarten Lankhorst <maarten.lankhorst@xxxxxxxxxxxxxxx>, linux-block@xxxxxxxxxxxxxxx, linux-bcache@xxxxxxxxxxxxxxx, Ananth N Mavinakayanahalli <ananth@xxxxxxxxxxxxxxxxxx>, Arnaldo Carvalho de Melo <acme@xxxxxxxxxx>, user-mode-linux-user@xxxxxxxxxxxxxxxxxxxxx, Namhyung Kim <namhyung@xxxxxxxxxx>, Juergen Gross <jgross@xxxxxxxx>, Michal Simek <monstr@xxxxxxxxx>, patches@xxxxxxxxxxxxxxxxxxxxx, Takashi Iwai <tiwai@xxxxxxxx>, linux-security-module@xxxxxxxxxxxxxxx, David Woodhouse <dwmw2@xxxxxxxxxxxxx>
- Delivery-date: Wed, 09 May 2018 19:44:01 +0000
- List-id: Xen developer discussion <xen-devel.lists.xenproject.org>
Em Wed, 9 May 2018 15:11:07 -0400 (EDT)
Alan Stern <stern@xxxxxxxxxxxxxxxxxxx> escreveu:
> On Wed, 9 May 2018, Mauro Carvalho Chehab wrote:
>
> > Em Wed, 9 May 2018 19:15:01 +0200
> > Andrea Parri <parri.andrea@xxxxxxxxx> 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
_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxxx
https://lists.xenproject.org/mailman/listinfo/xen-devel
|
