From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Google-Smtp-Source: AB8JxZqqIQkvLZKqqqhf+ULvJwWe89BA7THVOEJwYJ4bn87c1QhjsrGZ42HhJWqsqNkmN8+SYFr3 ARC-Seal: i=1; a=rsa-sha256; t=1525893069; cv=none; d=google.com; s=arc-20160816; b=TvcWMEVAYMTsljPyGKH+BWGadx753WjX5Sp4NCvZRuXvbilUcKrytkQ4rv4axehHv8 j5e4WX1A4VQycLGqZLQTHeTC7C7tcebUPIgkMA2+irC41xnSM+cNfJDWQ9rT8WbKQ+qY jzTROK6vBnIKQNl7v1Uuba7rmUUQusxDmXvjEcZTH91iGXXeU8H5rSHHYSz1XuKsxScd 7P4UN+uua/VlcLbOGifvpIxZmznjNmMJgZWFMxetSA8c5Er3ry9BcLsvBkSLaX/c03Qc ga0do4zJc2UZrSU20BfWy35aMDAsj7lvvzPLtlPFmqOS6egiZrt4hwpzaK7hy9kLdOd6 442w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:message-id:in-reply-to:subject:cc:to:from:date :arc-authentication-results; bh=k5M9ZbLPskahdyKF3oB1wnE5kp6y19m1l7BmoGJo7Vg=; b=paEAbs9EHnPUGQCVgiHdD2MZJxZ5jsoYiOLQmHZmbZRKeT+k6D6ZNnrDxZmn7WKjZl uAC5BIzorHCyB68mlb4tkWgxxR7YFK7I2pyZ2tjrM+u3N1hu9URcnufa7lRxvc+ug3AN kk2vscmwzFJHy4Rsr6nPkZkvEfWjUMBYFYMpbXsLsOIQ4lw6LKugFex8o3De2c17o3Br avQEpY1UogoYkkPkE2KJNFLStynMs5vEcsgItMdQSb9lUItnZIrI+UyV9AWIfuX5Eypl EKM54g5jaHkmkuXCkDpzaugLWs5K2w7u12Zy72+o3ZkwCCou0/yK5o1gn6niQixs8lYw s9mA== ARC-Authentication-Results: i=1; mx.google.com; spf=neutral (google.com: 192.131.102.54 is neither permitted nor denied by best guess record for domain of stern+5af46fa8@rowland.harvard.edu) smtp.mailfrom=stern+5af46fa8@rowland.harvard.edu Authentication-Results: mx.google.com; spf=neutral (google.com: 192.131.102.54 is neither permitted nor denied by best guess record for domain of stern+5af46fa8@rowland.harvard.edu) smtp.mailfrom=stern+5af46fa8@rowland.harvard.edu Date: Wed, 9 May 2018 15:11:07 -0400 (EDT) From: Alan Stern X-X-Sender: stern@iolanthe.rowland.org To: Mauro Carvalho Chehab 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 In-Reply-To: <20180509152045.722f0c51@vento.lan> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: =?utf-8?q?1599992730865491295?= X-GMAIL-MSGID: =?utf-8?q?1600014851361472802?= X-Mailing-List: linux-kernel@vger.kernel.org List-ID: 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