From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Google-Smtp-Source: AB8JxZqvOf7tytt9144nYAcnGCxGBqRNHMqNhnniMXpY9VRrkoCUz8vWwbLdhN9IgtKMYqUMwMGk ARC-Seal: i=1; a=rsa-sha256; t=1525894986; cv=none; d=google.com; s=arc-20160816; b=rrHxoonYqKMaYCdM/P6QvVvNVqvCuxxoEFdmQClWwApVzJeUflqll0PW1RqlXNBWNd farUKq6j6CQPUoLY79+P9Dv1dtbBwgb6ueJ+U+7BhDM9gB97GGJWWb/pTFuHXM2kzrEu S1SPamTzbuPOc4L/kn1X7OQrvqh4yjXqXfqRDvFOIReiGgfkfGyBj/reoLG/5VKF8Uv/ aJrPQR2sABbcSAHnaHoVZ53vrU19fGxM9ZXPXD+xgKST4TualTajZgWtQpfI1l4uZ6Ej OQujmRliD7e1lslbGUPMm3o6ECgkybtYOvUnKpyxT1ialaBUHLZp9FE0fIJgY44GSCnz dOzQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:subject:cc:to:from:date:dkim-signature :arc-authentication-results; bh=jvRoYswcAvH6Qky7saWZp6Q/iF5eFMk5xuQmKgy5NIc=; b=zgg1JGKk1n4yDhby4RXdUTHQGm7/s4QrlJZxZ3SCj7V6OA5QR+PKVz5fkZvJdK255y Ym5p2gPidlqmivaMNz+xjmVGpmymr9W6DVhUgP89vh+Hx68WAXEBorpU29pFbk0jYjXt +0Wpre8eLhIDY3hOIa4YHhWnrwZ6R1yIhWVqud8otVNbb0f4f8XLBIj7rqFJjUu0t9v5 a5XXwYb9n/x9AGboO/F6fQQ+SB7g1hSFFhGn9g5Vhg/daHtRFci+ZgoHYb/cpA6VrJUO 0xLtRYO7CWt5UAcjSaiC0KiLZ6wIhpdguqLTGTGH8MfEZFxI+kLw1aJGPSnBi3rdPltB 04Gg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20170209 header.b=PNIfnQGu; spf=softfail (google.com: domain of transitioning mchehab+samsung@kernel.org does not designate 2607:7c80:54:e::133 as permitted sender) smtp.mailfrom=mchehab+samsung@kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20170209 header.b=PNIfnQGu; spf=softfail (google.com: domain of transitioning mchehab+samsung@kernel.org does not designate 2607:7c80:54:e::133 as permitted sender) smtp.mailfrom=mchehab+samsung@kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org 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> X-Mailer: Claws Mail 3.16.0 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: =?utf-8?q?1599992730865491295?= X-GMAIL-MSGID: =?utf-8?q?1600016862010510368?= X-Mailing-List: linux-kernel@vger.kernel.org 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