From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mauro Carvalho Chehab Subject: Re: [PATCH v2 09/11] docs: Fix some broken references Date: Wed, 9 May 2018 16:41:53 -0300 Message-ID: <20180509164153.5b9ab9db@vento.lan> References: <20180509152045.722f0c51@vento.lan> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Alan Stern Cc: Catalin Marinas , Will Deacon , dri-devel@lists.freedesktop.org, Jaroslav Kysela , Eric Paris , linux-clk@vger.kernel.org, James Morris , xen-devel@lists.xenproject.org, Boqun Feng , Nicholas Piggin , Thomas Gleixner , Antoine Jacquet , Greg Kroah-Hartman , linux-usb@vger.kernel.org, linux-kernel@vger.kernel.org, Li Zefan , linux-crypto@vger.kernel.org, Mark Rutland , alsa-devel@alsa-project.org, Linux Doc Mailing List , David Airlie , Max Filippov , Harry Wei , selinux@tycho.nsa.gov, Paul Moore , Anil List-Id: alsa-devel@alsa-project.org RW0gV2VkLCA5IE1heSAyMDE4IDE1OjExOjA3IC0wNDAwIChFRFQpCkFsYW4gU3Rlcm4gPHN0ZXJu QHJvd2xhbmQuaGFydmFyZC5lZHU+IGVzY3JldmV1OgoKPiBPbiBXZWQsIDkgTWF5IDIwMTgsIE1h dXJvIENhcnZhbGhvIENoZWhhYiB3cm90ZToKPiAKPiA+IEVtIFdlZCwgOSBNYXkgMjAxOCAxOTox NTowMSArMDIwMAo+ID4gQW5kcmVhIFBhcnJpIDxwYXJyaS5hbmRyZWFAZ21haWwuY29tPiBlc2Ny ZXZldTogIAo+IAo+ID4gPiA+ICB0b29scy9tZW1vcnktbW9kZWwvUkVBRE1FICAgICAgICAgICAg ICAgICAgICAgfCAxMCArKysrKy0tLS0tICAgIAo+ID4gPiAKPiA+ID4gQXMgbWVudGlvbmVkIGlu IHRoZSBwcmV2aW91cyB0aHJlYWQsIEkgYW0gZm9yIGtlZXBpbmcgdGhlIGN1cnJlbnQKPiA+ID4g cmVmZXJlbmNlczogdGhlIFJFQU1ERSBpcyBsaXN0aW5nIHRoZSBkb2MgZmlsZXMsIGFzIHdlbGwg YXMgb3RoZXIKPiA+ID4gZmlsZXMgaW4gdG9vbHMvbWVtb3J5LW1vZGVsLywgcmVsYXRpdmVseSB0 byB0aGF0IGRpcmVjdG9yeS4gIAo+ID4gCj4gPiBZZWFoLCBhdCBsZWFzdCB0aGlzIGh1bmsgZGVz ZXJ2ZXMgc29tZSByZXdvcmssIGFzIG5vdyBzb21lCj4gPiByZWZlcmVuY2VzIGFyZSBEb2N1bWVu dGF0aW9uLy4uLi9mb28sIHdoaWxlIG90aGVycyBhcmUganVzdAo+ID4gYmFyLgo+ID4gCj4gPiBB cyBvbiAoYWxtb3N0KSBhbGwgb3RoZXIgcGxhY2VzIChleGNlcHQgZm9yIHRvb2xzL21lbW9yeS1t b2RlbC9SRUFETUUpLAo+ID4gdGhlIHJlZmVyZW5jZXMgYXJlIGFsd2F5cyBmcm9tIHRoZSBtYWlu IGRpcmVjdG9yeSwgSSB3b3VsZCBtYWtlIGFsbAo+ID4gcGF0Y2hlcyB0aGVyZSBhbHNvIHJlbGF0 aXZlIHRvIG1haW4gZGlyLiBJZiB5b3UncmUgYWZyYWlkIG9mCj4gPiBub3QgYmVpbmcgdG9vIGNs ZWFyZXIsIHdlIGNvdWxkIHByZWZpeCBhbGwgb2YgdGhlbSB3aXRoIHNvbWV0aGluZwo+ID4gbGlr ZToKPiA+IAo+ID4gCSR7TElOVVh9L3Rvb2xzL21lbW9yeS1tb2RlbC8uLi4KPiA+IAo+ID4ganVz dCBsaWtlIHNvbWUgRFQgYmluZGluZyBmaWxlcyBkbzoKPiA+IAo+ID4gCURvY3VtZW50YXRpb24v ZGV2aWNldHJlZS9iaW5kaW5ncy9zb3VuZC9hdWRpby1ncmFwaC1jYXJkLnR4dDpzZWUgJHtMSU5V WH0vRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL2dyYXBoLnR4dAo+ID4gCj4gPiBB IGJvbnVzIG9mIGRvaW5nIHRoYXQgaXMgdGhhdCB0aGUgYnJva2VuIHJlZmVyZW5jZSBkZXRlY3Qg c2NyaXB0IGNhbgo+ID4ga2VlcCBwYXJzaW5nIGl0IHdpdGhvdXQgY2hhbmdlcyAod2VsbCwgaXQg d291bGRuJ3QgYmUgaGFyZCB0byBtYWtlCj4gPiBpdCBhbHNvIGFjY2VwdCBhIHJlbGF0aXZlIGZp bGUsIGJ1dCBkb2luZyB0aGF0IGp1c3QgZHVlIHRvIAo+ID4gdG9vbHMvbWVtb3J5LW1vZGVsL1JF QURNRSBzZWVtcyBvdmVya2lsbCkuCj4gPiAKPiA+IEFub3RoZXIgYWR2YW50YWdlIGlzIHRoYXQg aXQgd291bGQgYWxsb3cgdG8gZWFzaWx5IGFkZCByZWZlcmVuY2VzCj4gPiB0aGVyZSBmcm9tIHRo ZSBtYWluIGtlcm5lbCBEb2N1bWVudGF0aW9uLCBpZiBuZWVkZWQgaW4gdGhlIGZ1dHVyZSwKPiA+ IHdpdGhvdXQgbWVzc2luZyB3aXRoIGxvY2FsIHggbm9uLWxvY2FsIHJlbGF0aXZlIG5hbWVzcGFj ZS4gIAo+IAo+IEhvdyBhYm91dCBjaGFuZ2luZyB0aGUgcmVsYXRpdmUgcmVmZXJlbmNlcyBzbyB0 aGF0IHNvbWV0aGluZyBsaWtlCj4gRG9jdW1lbnRhdGlvbi9yZWNpcGVzLnR4dCBiZWNvbWVzIC4v RG9jdW1lbnRhdGlvbi9yZWNpcGVzLnR4dD8KClNvdW5kcyBhIGdvb2QgaWRlYSB0byBtZS4gQW5k cmVhPwoKVGhhbmtzLApNYXVybwpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fXwpkcmktZGV2ZWwgbWFpbGluZyBsaXN0CmRyaS1kZXZlbEBsaXN0cy5mcmVlZGVz a3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9k cmktZGV2ZWwK From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Date: Wed, 9 May 2018 16:41:53 -0300 From: Mauro Carvalho Chehab To: Alan Stern Cc: Andrea Parri , Linux Doc Mailing List , Mauro Carvalho Chehab , , Jonathan Corbet , Dmitry Torokhov , Rob Herring , Mark Rutland , Linus Walleij , Ananth N Mavinakayanahalli , Anil S Keshavamurthy , "David S. Miller" , Masami Hiramatsu , Mathieu Poirier , Alexander Shishkin , Harry Wei , Russell King , Catalin Marinas , Will Deacon , Michal Simek , Jeff Dike , Richard Weinberger , Guan Xuetao , Thomas Gleixner , Ingo Molnar , "H. Peter Anvin" , , Chris Zankel , Max Filippov , Jens Axboe , David Howells , David Woodhouse , Herbert Xu , Arnd Bergmann , Greg Kroah-Hartman , Michael Turquette , Stephen Boyd , David Airlie , Gustavo Padovan , Maarten Lankhorst , Sean Paul , Pali =?UTF-8?B?Um9ow6Fy?= , Matias Bjorling , Michael Lyle , Kent Overstreet , Malcolm Priestley , Antoine Jacquet , Sudip Mukherjee , Steven Rostedt , "Paul E. McKenney" , Josh Triplett , Mathieu Desnoyers , Lai Jiangshan , Boris Ostrovsky , Juergen Gross , Li Zefan , Paul Moore , Stephen Smalley , Eric Paris , James Morris , "Serge E. Hallyn" , Jaroslav Kysela , Takashi Iwai , Peter Zijlstra , Boqun Feng , Nicholas Piggin , Jade Alglave , Luc Maranget , Akira Yokosawa , Arnaldo Carvalho de Melo , Jiri Olsa , Namhyung Kim , , , , , , , , , , , , , , , , , , , , , , Subject: Re: [PATCH v2 09/11] docs: Fix some broken references Message-ID: <20180509164153.5b9ab9db@vento.lan> In-Reply-To: References: <20180509152045.722f0c51@vento.lan> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII List-ID: 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 From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mauro Carvalho Chehab Subject: Re: [PATCH v2 09/11] docs: Fix some broken references Date: Wed, 9 May 2018 16:41:53 -0300 Message-ID: <20180509164153.5b9ab9db@vento.lan> References: <20180509152045.722f0c51@vento.lan> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Cc: Catalin Marinas , Will Deacon , dri-devel@lists.freedesktop.org, Jaroslav Kysela , Eric Paris , linux-clk@vger.kernel.org, James Morris , xen-devel@lists.xenproject.org, Boqun Feng , Nicholas Piggin , Thomas Gleixner , Antoine Jacquet , Greg Kroah-Hartman , linux-usb@vger.kernel.org, linux-kernel@vger.kernel.org, Li Zefan , linux-crypto@vger.kernel.org, Mark Rutland , alsa-devel@alsa-project.org, Linux Doc Mailing List , David Airlie , Max Filippov , Harry Wei , selinux@tycho.nsa.gov, Paul Moore , Anil S Keshavamu To: Alan Stern Return-path: In-Reply-To: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" List-Id: linux-crypto.vger.kernel.org RW0gV2VkLCA5IE1heSAyMDE4IDE1OjExOjA3IC0wNDAwIChFRFQpCkFsYW4gU3Rlcm4gPHN0ZXJu QHJvd2xhbmQuaGFydmFyZC5lZHU+IGVzY3JldmV1OgoKPiBPbiBXZWQsIDkgTWF5IDIwMTgsIE1h dXJvIENhcnZhbGhvIENoZWhhYiB3cm90ZToKPiAKPiA+IEVtIFdlZCwgOSBNYXkgMjAxOCAxOTox NTowMSArMDIwMAo+ID4gQW5kcmVhIFBhcnJpIDxwYXJyaS5hbmRyZWFAZ21haWwuY29tPiBlc2Ny ZXZldTogIAo+IAo+ID4gPiA+ICB0b29scy9tZW1vcnktbW9kZWwvUkVBRE1FICAgICAgICAgICAg ICAgICAgICAgfCAxMCArKysrKy0tLS0tICAgIAo+ID4gPiAKPiA+ID4gQXMgbWVudGlvbmVkIGlu IHRoZSBwcmV2aW91cyB0aHJlYWQsIEkgYW0gZm9yIGtlZXBpbmcgdGhlIGN1cnJlbnQKPiA+ID4g cmVmZXJlbmNlczogdGhlIFJFQU1ERSBpcyBsaXN0aW5nIHRoZSBkb2MgZmlsZXMsIGFzIHdlbGwg YXMgb3RoZXIKPiA+ID4gZmlsZXMgaW4gdG9vbHMvbWVtb3J5LW1vZGVsLywgcmVsYXRpdmVseSB0 byB0aGF0IGRpcmVjdG9yeS4gIAo+ID4gCj4gPiBZZWFoLCBhdCBsZWFzdCB0aGlzIGh1bmsgZGVz ZXJ2ZXMgc29tZSByZXdvcmssIGFzIG5vdyBzb21lCj4gPiByZWZlcmVuY2VzIGFyZSBEb2N1bWVu dGF0aW9uLy4uLi9mb28sIHdoaWxlIG90aGVycyBhcmUganVzdAo+ID4gYmFyLgo+ID4gCj4gPiBB cyBvbiAoYWxtb3N0KSBhbGwgb3RoZXIgcGxhY2VzIChleGNlcHQgZm9yIHRvb2xzL21lbW9yeS1t b2RlbC9SRUFETUUpLAo+ID4gdGhlIHJlZmVyZW5jZXMgYXJlIGFsd2F5cyBmcm9tIHRoZSBtYWlu IGRpcmVjdG9yeSwgSSB3b3VsZCBtYWtlIGFsbAo+ID4gcGF0Y2hlcyB0aGVyZSBhbHNvIHJlbGF0 aXZlIHRvIG1haW4gZGlyLiBJZiB5b3UncmUgYWZyYWlkIG9mCj4gPiBub3QgYmVpbmcgdG9vIGNs ZWFyZXIsIHdlIGNvdWxkIHByZWZpeCBhbGwgb2YgdGhlbSB3aXRoIHNvbWV0aGluZwo+ID4gbGlr ZToKPiA+IAo+ID4gCSR7TElOVVh9L3Rvb2xzL21lbW9yeS1tb2RlbC8uLi4KPiA+IAo+ID4ganVz dCBsaWtlIHNvbWUgRFQgYmluZGluZyBmaWxlcyBkbzoKPiA+IAo+ID4gCURvY3VtZW50YXRpb24v ZGV2aWNldHJlZS9iaW5kaW5ncy9zb3VuZC9hdWRpby1ncmFwaC1jYXJkLnR4dDpzZWUgJHtMSU5V WH0vRG9jdW1lbnRhdGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL2dyYXBoLnR4dAo+ID4gCj4gPiBB IGJvbnVzIG9mIGRvaW5nIHRoYXQgaXMgdGhhdCB0aGUgYnJva2VuIHJlZmVyZW5jZSBkZXRlY3Qg c2NyaXB0IGNhbgo+ID4ga2VlcCBwYXJzaW5nIGl0IHdpdGhvdXQgY2hhbmdlcyAod2VsbCwgaXQg d291bGRuJ3QgYmUgaGFyZCB0byBtYWtlCj4gPiBpdCBhbHNvIGFjY2VwdCBhIHJlbGF0aXZlIGZp bGUsIGJ1dCBkb2luZyB0aGF0IGp1c3QgZHVlIHRvIAo+ID4gdG9vbHMvbWVtb3J5LW1vZGVsL1JF QURNRSBzZWVtcyBvdmVya2lsbCkuCj4gPiAKPiA+IEFub3RoZXIgYWR2YW50YWdlIGlzIHRoYXQg aXQgd291bGQgYWxsb3cgdG8gZWFzaWx5IGFkZCByZWZlcmVuY2VzCj4gPiB0aGVyZSBmcm9tIHRo ZSBtYWluIGtlcm5lbCBEb2N1bWVudGF0aW9uLCBpZiBuZWVkZWQgaW4gdGhlIGZ1dHVyZSwKPiA+ IHdpdGhvdXQgbWVzc2luZyB3aXRoIGxvY2FsIHggbm9uLWxvY2FsIHJlbGF0aXZlIG5hbWVzcGFj ZS4gIAo+IAo+IEhvdyBhYm91dCBjaGFuZ2luZyB0aGUgcmVsYXRpdmUgcmVmZXJlbmNlcyBzbyB0 aGF0IHNvbWV0aGluZyBsaWtlCj4gRG9jdW1lbnRhdGlvbi9yZWNpcGVzLnR4dCBiZWNvbWVzIC4v RG9jdW1lbnRhdGlvbi9yZWNpcGVzLnR4dD8KClNvdW5kcyBhIGdvb2QgaWRlYSB0byBtZS4gQW5k cmVhPwoKVGhhbmtzLApNYXVybwpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fXwpkcmktZGV2ZWwgbWFpbGluZyBsaXN0CmRyaS1kZXZlbEBsaXN0cy5mcmVlZGVz a3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9k cmktZGV2ZWwK