From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Date: Wed, 19 Jun 2019 07:22:18 -0300 From: Mauro Carvalho Chehab Subject: Re: [PATCH v1 12/22] docs: driver-api: add .rst files from the main dir Message-ID: <20190619072218.4437f891@coco.lan> In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit To: Daniel Vetter Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Linux Kernel Mailing List , Jonathan Corbet , Johannes Berg , Kurt Schwemmer , Logan Gunthorpe , Bjorn Helgaas , Alan Stern , Andrea Parri , Will Deacon , Peter Zijlstra , Boqun Feng , Nicholas Piggin , David Howells , Jade Alglave , Luc Maranget , "Paul E. McKenney" , Akira Yokosawa , Daniel Lustig , Stuart Hayes , Thomas Gleixner , Ingo Molnar , Darren Hart , Kees Cook , Emese Revfy , Ohad Ben-Cohen , Bjorn Andersson , Corey Minyard , Marc Zyngier , William Breathitt Gray , Jaroslav Kysela , Greg Kroah-Hartman , "Rafael J. Wysocki" , "Naveen N. Rao" , Anil S Keshavamurthy , "David S. Miller" , Masami Hiramatsu , Johannes Thumshirn , Steffen Klassert , Sudip Mukherjee , Andreas =?UTF-8?B?RsOkcmJlcg==?= , Manivannan Sadhasivam , Rodolfo Giometti , Richard Cochran , Thierry Reding , Sumit Semwal , Gustavo Padovan , Jens Wiklander , Kirti Wankhede , Alex Williamson , Cornelia Huck , Bartlomiej Zolnierkiewicz , David Airlie , Maarten Lankhorst , Maxime Ripard , Sean Paul , Farhan Ali , Eric Farman , Halil Pasic , Heiko Carstens , Vasily Gorbik , Christian Borntraeger , Harry Wei , Alex Shi , Evgeniy Polyakov , Jerry Hoemann , Wim Van Sebroeck , Guenter Roeck , Guan Xuetao , Arnd Bergmann , Linus Walleij , Bartosz Golaszewski , Andy Shevchenko , Jiri Slaby , linux-wireless@vger.kernel.org, Linux PCI , "open list:GENERIC INCLUDE/A..." , platform-driver-x86@vger.kernel.org, Kernel Hardening , linux-remoteproc@vger.kernel.org, openipmi-developer@lists.sourceforge.net, linux-crypto@vger.kernel.org, Linux ARM , netdev , linux-pwm , dri-devel , kvm@vger.kernel.org, Linux Fbdev development list , linux-s390@vger.kernel.org, linux-watchdog@vger.kernel.org, "moderated list:DMA BUFFER SHARING FRAMEWORK , linux-gpio" , Linux MM List-ID: Hi Daniel, Em Wed, 19 Jun 2019 11:05:57 +0200 Daniel Vetter escreveu: > On Tue, Jun 18, 2019 at 10:55 PM Mauro Carvalho Chehab > wrote: > > diff --git a/Documentation/gpu/drm-mm.rst b/Documentation/gpu/drm-mm.rst > > index fa30dfcfc3c8..b0f948d8733b 100644 > > --- a/Documentation/gpu/drm-mm.rst > > +++ b/Documentation/gpu/drm-mm.rst > > @@ -320,7 +320,7 @@ struct :c:type:`struct file_operations ` get_unmapped_area > > field with a pointer on :c:func:`drm_gem_cma_get_unmapped_area`. > > > > More detailed information about get_unmapped_area can be found in > > -Documentation/nommu-mmap.rst > > +Documentation/driver-api/nommu-mmap.rst > > Random drive-by comment: Could we convert these into hyperlinks within > sphinx somehow, without making them less useful as raw file references > (with vim I can just type 'gf' and it works, emacs probably the same). > -Daniel Short answer: I don't know how vim/emacs would recognize Sphinx tags. There are two ways of doing hyperlinks to local files. The first one is to add a label at the other file and use a reference to such label, e. g. at nommu-mmap.rst, you would add a label like: .. _drm_nommu-mmap: at the beginning of the file. Then, at drm-mm.rst, you would use :ref:`drm_nommu-mmap` (there are a few other alternative tags that would work the same way). The advantage is that you could move/rename documents anytime, without needing to take care of it. Perhaps it could be possible a tool like cscope to parse those in order to provide such automation for Sphinx. I dunno. - The other way is to use: :doc:`nommu-mmap.rst` (if both files are at the same dir) The :doc: path is the current directory. So, if a file at, let's say, Documentation/gpu wants to refer another file at driver-api, it would need to write it as: :doc:`../driver-api/nommu-mmap.rst` I'm not sure if vim/emacs recognizes this syntax, though. Perhaps this tag could be used as: :doc:`Documentation/driver-api/nommu-mmap.rst <../driver-api/nommu-map.rst` But that looks too ugly to my taste. - On this conversion, I opted to not touch this. We may consider trying to replace those Thanks, Mauro From mboxrd@z Thu Jan 1 00:00:00 1970 From: Mauro Carvalho Chehab Subject: Re: [PATCH v1 12/22] docs: driver-api: add .rst files from the main dir Date: Wed, 19 Jun 2019 07:22:18 -0300 Message-ID: <20190619072218.4437f891@coco.lan> References: 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: Daniel Vetter Cc: Kernel Hardening , Farhan Ali , Will Deacon , dri-devel , Jaroslav Kysela , Evgeniy Polyakov , "open list:GENERIC INCLUDE/A..." , "Rafael J. Wysocki" , Halil Pasic , Alan Stern , Jiri Slaby , Guenter Roeck , Ohad Ben-Cohen , Marc Zyngier , Boqun Feng , Nicholas Piggin , Alex Williamson , Thomas Gleixner , Sean Paul , Greg Kroah-Hartman , linux-wireless@vger.kernel.org, Linux Kernel Mailing List l List-Id: platform-driver-x86.vger.kernel.org SGkgRGFuaWVsLAoKRW0gV2VkLCAxOSBKdW4gMjAxOSAxMTowNTo1NyArMDIwMApEYW5pZWwgVmV0 dGVyIDxkYW5pZWxAZmZ3bGwuY2g+IGVzY3JldmV1OgoKPiBPbiBUdWUsIEp1biAxOCwgMjAxOSBh dCAxMDo1NSBQTSBNYXVybyBDYXJ2YWxobyBDaGVoYWIKPiA8bWNoZWhhYitzYW1zdW5nQGtlcm5l bC5vcmc+IHdyb3RlOgo+ID4gZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vZ3B1L2RybS1tbS5y c3QgYi9Eb2N1bWVudGF0aW9uL2dwdS9kcm0tbW0ucnN0Cj4gPiBpbmRleCBmYTMwZGZjZmMzYzgu LmIwZjk0OGQ4NzMzYiAxMDA2NDQKPiA+IC0tLSBhL0RvY3VtZW50YXRpb24vZ3B1L2RybS1tbS5y c3QKPiA+ICsrKyBiL0RvY3VtZW50YXRpb24vZ3B1L2RybS1tbS5yc3QKPiA+IEBAIC0zMjAsNyAr MzIwLDcgQEAgc3RydWN0IDpjOnR5cGU6YHN0cnVjdCBmaWxlX29wZXJhdGlvbnMgPGZpbGVfb3Bl cmF0aW9ucz5gIGdldF91bm1hcHBlZF9hcmVhCj4gPiAgZmllbGQgd2l0aCBhIHBvaW50ZXIgb24g OmM6ZnVuYzpgZHJtX2dlbV9jbWFfZ2V0X3VubWFwcGVkX2FyZWFgLgo+ID4KPiA+ICBNb3JlIGRl dGFpbGVkIGluZm9ybWF0aW9uIGFib3V0IGdldF91bm1hcHBlZF9hcmVhIGNhbiBiZSBmb3VuZCBp bgo+ID4gLURvY3VtZW50YXRpb24vbm9tbXUtbW1hcC5yc3QKPiA+ICtEb2N1bWVudGF0aW9uL2Ry aXZlci1hcGkvbm9tbXUtbW1hcC5yc3QgIAo+IAo+IFJhbmRvbSBkcml2ZS1ieSBjb21tZW50OiBD b3VsZCB3ZSBjb252ZXJ0IHRoZXNlIGludG8gaHlwZXJsaW5rcyB3aXRoaW4KPiBzcGhpbnggc29t ZWhvdywgd2l0aG91dCBtYWtpbmcgdGhlbSBsZXNzIHVzZWZ1bCBhcyByYXcgZmlsZSByZWZlcmVu Y2VzCj4gKHdpdGggdmltIEkgY2FuIGp1c3QgdHlwZSAnZ2YnIGFuZCBpdCB3b3JrcywgZW1hY3Mg cHJvYmFibHkgdGhlIHNhbWUpLgo+IC1EYW5pZWwKClNob3J0IGFuc3dlcjogSSBkb24ndCBrbm93 IGhvdyB2aW0vZW1hY3Mgd291bGQgcmVjb2duaXplIFNwaGlueCB0YWdzLgoKVGhlcmUgYXJlIHR3 byB3YXlzIG9mIGRvaW5nIGh5cGVybGlua3MgdG8gbG9jYWwgZmlsZXMuIFRoZSBmaXJzdCBvbmUg aXMgdG8gCmFkZCBhIGxhYmVsIGF0IHRoZSBvdGhlciBmaWxlIGFuZCB1c2UgYSByZWZlcmVuY2Ug dG8gc3VjaCBsYWJlbCwgZS4gZy4gYXQKbm9tbXUtbW1hcC5yc3QsIHlvdSB3b3VsZCBhZGQgYSBs YWJlbCBsaWtlOgoKCS4uIF9kcm1fbm9tbXUtbW1hcDoKCmF0IHRoZSBiZWdpbm5pbmcgb2YgdGhl IGZpbGUuCgpUaGVuLCBhdCBkcm0tbW0ucnN0LCB5b3Ugd291bGQgdXNlIDpyZWY6YGRybV9ub21t dS1tbWFwYCAodGhlcmUgYXJlIGEKZmV3IG90aGVyIGFsdGVybmF0aXZlIHRhZ3MgdGhhdCB3b3Vs ZCB3b3JrIHRoZSBzYW1lIHdheSkuCgpUaGUgYWR2YW50YWdlIGlzIHRoYXQgeW91IGNvdWxkIG1v dmUvcmVuYW1lIGRvY3VtZW50cyBhbnl0aW1lLCB3aXRob3V0Cm5lZWRpbmcgdG8gdGFrZSBjYXJl IG9mIGl0LgoKUGVyaGFwcyBpdCBjb3VsZCBiZSBwb3NzaWJsZSBhIHRvb2wgbGlrZSBjc2NvcGUg dG8gcGFyc2UgdGhvc2UgaW4Kb3JkZXIgdG8gcHJvdmlkZSBzdWNoIGF1dG9tYXRpb24gZm9yIFNw aGlueC4gSSBkdW5uby4KCi0KClRoZSBvdGhlciB3YXkgaXMgdG8gdXNlOgoKCTpkb2M6YG5vbW11 LW1tYXAucnN0YCAoaWYgYm90aCBmaWxlcyBhcmUgYXQgdGhlIHNhbWUgZGlyKQoKVGhlIDpkb2M6 IHBhdGggaXMgdGhlIGN1cnJlbnQgZGlyZWN0b3J5LiBTbywgaWYgYSBmaWxlIGF0LCBsZXQncyBz YXksCkRvY3VtZW50YXRpb24vZ3B1IHdhbnRzIHRvIHJlZmVyIGFub3RoZXIgZmlsZSBhdCBkcml2 ZXItYXBpLCBpdCB3b3VsZApuZWVkIHRvIHdyaXRlIGl0IGFzOgoKCTpkb2M6YC4uL2RyaXZlci1h cGkvbm9tbXUtbW1hcC5yc3RgCgpJJ20gbm90IHN1cmUgaWYgdmltL2VtYWNzIHJlY29nbml6ZXMg dGhpcyBzeW50YXgsIHRob3VnaC4KClBlcmhhcHMgdGhpcyB0YWcgY291bGQgYmUgdXNlZCBhczoK Cgk6ZG9jOmBEb2N1bWVudGF0aW9uL2RyaXZlci1hcGkvbm9tbXUtbW1hcC5yc3QgPC4uL2RyaXZl ci1hcGkvbm9tbXUtbWFwLnJzdGAKCkJ1dCB0aGF0IGxvb2tzIHRvbyB1Z2x5IHRvIG15IHRhc3Rl LgoKLQoKT24gdGhpcyBjb252ZXJzaW9uLCBJIG9wdGVkIHRvIG5vdCB0b3VjaCB0aGlzLiBXZSBt YXkgY29uc2lkZXIgdHJ5aW5nCnRvIHJlcGxhY2UgdGhvc2UgCgoKVGhhbmtzLApNYXVybwpfX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpkcmktZGV2ZWwgbWFp bGluZyBsaXN0CmRyaS1kZXZlbEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5m cmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9kcmktZGV2ZWw= From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-3.8 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 37EF3C31E49 for ; Wed, 19 Jun 2019 10:26:52 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id D17C2208CB for ; Wed, 19 Jun 2019 10:26:51 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="jUOdYjXb" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org D17C2208CB Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 699FF6B0003; Wed, 19 Jun 2019 06:26:51 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 622F98E0002; Wed, 19 Jun 2019 06:26:51 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 49D5C8E0001; Wed, 19 Jun 2019 06:26:51 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from mail-wr1-f71.google.com (mail-wr1-f71.google.com [209.85.221.71]) by kanga.kvack.org (Postfix) with ESMTP id E86756B0003 for ; Wed, 19 Jun 2019 06:26:50 -0400 (EDT) Received: by mail-wr1-f71.google.com with SMTP id d15so1139564wrx.5 for ; Wed, 19 Jun 2019 03:26:50 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:dkim-signature:date:from:to:cc:subject :message-id:in-reply-to:references:mime-version :content-transfer-encoding; bh=YFOuuDPHS3QNn8VKFuojZaSfGLUUo0b1zU6yyzH4L70=; b=p2btEJ3XVSgUCoIKErxySap01uk4t+YTOMUd2Z/QzqI+6Q1KxeMimY2Rg6iNXcc2nv V4sWJxNC3HKc0/OQcLhu4YUYdbeRZN0OOKRHgy3+X2O3gczklskE+KR59K57KqFbiQHH UiYSQ9VZF9Oe5qwqJLhMSOYjvmGhZQ0l/+uubAZ8dM5b1RY3fLiyx3od4jmfYgXTJQe5 1omAWqFKaxYZaqulUY56Csxf0Ed1EZ/oakYjN+1VEqSD9IzENG7ZWEq0VfD09uthNJdF 8vTJfXRCZhOWQyYgVKV56QyPy+Vqi6fxc70VmJ8iQ8DO/bGzXdyhZFZnn4ECnr2vLctQ lY5w== X-Gm-Message-State: APjAAAWHGdAYdkn1yVBjEKz+yoZLj7D3igl9vfh70rRNbuKxq0nGbklD 135o4KbX6uqGGocp1RkEL2GYYkL6ChO083iBfUvWSRNR2X4c864Y6aPpK6blP+v2qCigA80vXJR yxq3XdRGdKLDdIe+OzEuFAO14/U0dzI1ZL3KFMv2BY/E/wglWLlPubSPNiQazqOI= X-Received: by 2002:a5d:56c1:: with SMTP id m1mr2429228wrw.26.1560940010514; Wed, 19 Jun 2019 03:26:50 -0700 (PDT) X-Google-Smtp-Source: APXvYqwwVM9qMFO7RgFL2mNZQTXsAdoN+4WXAVQDjEhfSd10Qu4fukik4XFwqlEzGjsOE+bduc2a X-Received: by 2002:a5d:56c1:: with SMTP id m1mr2429166wrw.26.1560940009599; Wed, 19 Jun 2019 03:26:49 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1560940009; cv=none; d=google.com; s=arc-20160816; b=QNWiA1+oIBRxEHsBcyET4UTsq5Kx/WCrHhBWqJoDjkVXWBKSMqE+vvicEvzAEr8UQ0 AjRa3Gw6255pmPAD2KfUT7KtcKHE/J9LxeLIT637Kn+YDpQAC8M6Cw1lE4tg77VWbjpb 4/PFg161ErX8zTZ/qj+NCwHi7s1taajXfpPQu17nAbzJFN1aqCMSGDw78RCVf+rVVY9/ V/jYu2XFR0eJsOgas1iMcFQLoH0tOuoUjFDavSPjendsSvFEXprzhI1vIHWKsnFZ8c94 1KI1JqNuBgh/nQBDPoOQiKk1wO65yYvtSdOE1or031NhSXZmAAVkhcH2WW9pAlAWPkGm ZwNA== 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; bh=YFOuuDPHS3QNn8VKFuojZaSfGLUUo0b1zU6yyzH4L70=; b=bYa8tOsD8eHliLVyUihuLahu/01CnPw2TkybOOwi7L9clVmaGrrq1Zn/ZZjtEXv1M2 VnePP0+2a6XATdVaM3lsBd6zMxndpGIaG8KE5rO6DcAZ/5AcZgh6F5kRZvU1bRvK7/Cg aD+Xu47HHSyudKwWE/DTlQlD9+OPxY39W2vOGVK2qjpWS+OcmgOpJaeuQx7aKmkJr7XT +4pA2NNXMRKr3tyNKPhUzazACfGtabQJmKISllor6loIUIEZdhKGoaGzt1zqjlJQSiYE pmutaoIu+Ers3A+7kbsvOMX5QWkn2U0X+mSpikswnyoLpmQmFuIysJjdw6MJ6Q7iX5Aa qLTg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=casper.20170209 header.b=jUOdYjXb; spf=softfail (google.com: domain of transitioning mchehab+samsung@kernel.org does not designate 85.118.1.10 as permitted sender) smtp.mailfrom=mchehab+samsung@kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from casper.infradead.org (casper.infradead.org. [85.118.1.10]) by mx.google.com with ESMTPS id j21si843629wmh.157.2019.06.19.03.26.49 for (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Wed, 19 Jun 2019 03:26:49 -0700 (PDT) Received-SPF: softfail (google.com: domain of transitioning mchehab+samsung@kernel.org does not designate 85.118.1.10 as permitted sender) client-ip=85.118.1.10; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=casper.20170209 header.b=jUOdYjXb; spf=softfail (google.com: domain of transitioning mchehab+samsung@kernel.org does not designate 85.118.1.10 as permitted sender) smtp.mailfrom=mchehab+samsung@kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=kernel.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:Content-Type: MIME-Version:References:In-Reply-To:Message-ID:Subject:Cc:To:From:Date:Sender :Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help: List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=YFOuuDPHS3QNn8VKFuojZaSfGLUUo0b1zU6yyzH4L70=; b=jUOdYjXbPDpIqxwy+em4PxKM0J xkdPx5H7WoOJmCChJicEuS8Dw2vGo7mwneAjeyi/LT8ATPVb5S+ALOXm5/Rzu/m/bwxiNabowOpId KTNbE0GjSU9RtfDT+1PQcqgQun5phOiqhIxET9CZjXTzuGBuEwZDsnS3H6c2LYMh2oOiNmhFWz4QI 5LpiOvcGTG0XtZtaCQLIVUZgfoYZriCL5J7XK54Z/NAaIsvntp4qlD7U9stNDGJMYfNjWdO4E24E6 pE61p2yrvQvZslNH6L8H9NPDI9f0qIvVnf5BvnYePk9zRpaO9pe2QH39CgKVXQtIf0orgbPicFQeU WxI16YxA==; Received: from 177.133.86.196.dynamic.adsl.gvt.net.br ([177.133.86.196] helo=coco.lan) by casper.infradead.org with esmtpsa (Exim 4.92 #3 (Red Hat Linux)) id 1hdXjq-0002py-Ny; Wed, 19 Jun 2019 10:22:47 +0000 Date: Wed, 19 Jun 2019 07:22:18 -0300 From: Mauro Carvalho Chehab To: Daniel Vetter Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Linux Kernel Mailing List , Jonathan Corbet , Johannes Berg , Kurt Schwemmer , Logan Gunthorpe , Bjorn Helgaas , Alan Stern , Andrea Parri , Will Deacon , Peter Zijlstra , Boqun Feng , Nicholas Piggin , David Howells , Jade Alglave , Luc Maranget , "Paul E. McKenney" , Akira Yokosawa , Daniel Lustig , Stuart Hayes , Thomas Gleixner , Ingo Molnar , Darren Hart , Kees Cook , Emese Revfy , Ohad Ben-Cohen , Bjorn Andersson , Corey Minyard , Marc Zyngier , William Breathitt Gray , Jaroslav Kysela , Greg Kroah-Hartman , "Rafael J. Wysocki" , "Naveen N. Rao" , Anil S Keshavamurthy , "David S. Miller" , Masami Hiramatsu , Johannes Thumshirn , Steffen Klassert , Sudip Mukherjee , Andreas =?UTF-8?B?RsOkcmJlcg==?= , Manivannan Sadhasivam , Rodolfo Giometti , Richard Cochran , Thierry Reding , Sumit Semwal , Gustavo Padovan , Jens Wiklander , Kirti Wankhede , Alex Williamson , Cornelia Huck , Bartlomiej Zolnierkiewicz , David Airlie , Maarten Lankhorst , Maxime Ripard , Sean Paul , Farhan Ali , Eric Farman , Halil Pasic , Heiko Carstens , Vasily Gorbik , Christian Borntraeger , Harry Wei , Alex Shi , Evgeniy Polyakov , Jerry Hoemann , Wim Van Sebroeck , Guenter Roeck , Guan Xuetao , Arnd Bergmann , Linus Walleij , Bartosz Golaszewski , Andy Shevchenko , Jiri Slaby , linux-wireless@vger.kernel.org, Linux PCI , "open list:GENERIC INCLUDE/A..." , platform-driver-x86@vger.kernel.org, Kernel Hardening , linux-remoteproc@vger.kernel.org, openipmi-developer@lists.sourceforge.net, linux-crypto@vger.kernel.org, Linux ARM , netdev , linux-pwm , dri-devel , kvm@vger.kernel.org, Linux Fbdev development list , linux-s390@vger.kernel.org, linux-watchdog@vger.kernel.org, "moderated list:DMA BUFFER SHARING FRAMEWORK" , linux-gpio , Linux MM Subject: Re: [PATCH v1 12/22] docs: driver-api: add .rst files from the main dir Message-ID: <20190619072218.4437f891@coco.lan> In-Reply-To: References: X-Mailer: Claws Mail 3.17.3 (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-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: Hi Daniel, Em Wed, 19 Jun 2019 11:05:57 +0200 Daniel Vetter escreveu: > On Tue, Jun 18, 2019 at 10:55 PM Mauro Carvalho Chehab > wrote: > > diff --git a/Documentation/gpu/drm-mm.rst b/Documentation/gpu/drm-mm.rst > > index fa30dfcfc3c8..b0f948d8733b 100644 > > --- a/Documentation/gpu/drm-mm.rst > > +++ b/Documentation/gpu/drm-mm.rst > > @@ -320,7 +320,7 @@ struct :c:type:`struct file_operations ` get_unmapped_area > > field with a pointer on :c:func:`drm_gem_cma_get_unmapped_area`. > > > > More detailed information about get_unmapped_area can be found in > > -Documentation/nommu-mmap.rst > > +Documentation/driver-api/nommu-mmap.rst > > Random drive-by comment: Could we convert these into hyperlinks within > sphinx somehow, without making them less useful as raw file references > (with vim I can just type 'gf' and it works, emacs probably the same). > -Daniel Short answer: I don't know how vim/emacs would recognize Sphinx tags. There are two ways of doing hyperlinks to local files. The first one is to add a label at the other file and use a reference to such label, e. g. at nommu-mmap.rst, you would add a label like: .. _drm_nommu-mmap: at the beginning of the file. Then, at drm-mm.rst, you would use :ref:`drm_nommu-mmap` (there are a few other alternative tags that would work the same way). The advantage is that you could move/rename documents anytime, without needing to take care of it. Perhaps it could be possible a tool like cscope to parse those in order to provide such automation for Sphinx. I dunno. - The other way is to use: :doc:`nommu-mmap.rst` (if both files are at the same dir) The :doc: path is the current directory. So, if a file at, let's say, Documentation/gpu wants to refer another file at driver-api, it would need to write it as: :doc:`../driver-api/nommu-mmap.rst` I'm not sure if vim/emacs recognizes this syntax, though. Perhaps this tag could be used as: :doc:`Documentation/driver-api/nommu-mmap.rst <../driver-api/nommu-map.rst` But that looks too ugly to my taste. - On this conversion, I opted to not touch this. We may consider trying to replace those Thanks, Mauro