From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Date: Wed, 19 Jun 2019 08:13:53 -0600 From: Jonathan Corbet Subject: Re: [PATCH v1 12/22] docs: driver-api: add .rst files from the main dir Message-ID: <20190619081353.75762028@lwn.net> In-Reply-To: <20190619104239.GM3419@hirez.programming.kicks-ass.net> References: <20190619072218.4437f891@coco.lan> <20190619104239.GM3419@hirez.programming.kicks-ass.net> MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit To: Peter Zijlstra Cc: Mauro Carvalho Chehab , Daniel Vetter , Linux Doc Mailing List , Mauro Carvalho Chehab , Linux Kernel Mailing List , Johannes Berg , Kurt Schwemmer , Logan Gunthorpe , Bjorn Helgaas , Alan Stern , Andrea Parri , Will Deacon , 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?RsOkcmJl?= =?UTF-8?B?cg==?= , 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, 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, linux-gpio , Linux MM List-ID: On Wed, 19 Jun 2019 12:42:39 +0200 Peter Zijlstra wrote: > No, the other way around, Sphinx can recognize local files and treat > them special. That way we keep the text readable. > > Same with that :c:func:'foo' crap, that needs to die, and Sphinx needs > to be taught about foo(). I did a patch to make that latter part happen, but haven't been able to find the time to address the comments and get it out there. It definitely cleaned up the source files a lot and is worth doing. Will try to get back to it soon. The local file links should be easy to do; we shouldn't need to add any markup for those. jon From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jonathan Corbet Subject: Re: [PATCH v1 12/22] docs: driver-api: add .rst files from the main dir Date: Wed, 19 Jun 2019 08:13:53 -0600 Message-ID: <20190619081353.75762028@lwn.net> References: <20190619072218.4437f891@coco.lan> <20190619104239.GM3419@hirez.programming.kicks-ass.net> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20190619104239.GM3419@hirez.programming.kicks-ass.net> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Peter Zijlstra Cc: "Rafael J. Wysocki" , Farhan Ali , Will Deacon , dri-devel , Jaroslav Kysela , Mauro Carvalho Chehab , Evgeniy Polyakov , "open list:GENERIC INCLUDE/A..." , 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 linux List-Id: platform-driver-x86.vger.kernel.org T24gV2VkLCAxOSBKdW4gMjAxOSAxMjo0MjozOSArMDIwMApQZXRlciBaaWpsc3RyYSA8cGV0ZXJ6 QGluZnJhZGVhZC5vcmc+IHdyb3RlOgoKPiBObywgdGhlIG90aGVyIHdheSBhcm91bmQsIFNwaGlu eCBjYW4gcmVjb2duaXplIGxvY2FsIGZpbGVzIGFuZCB0cmVhdAo+IHRoZW0gc3BlY2lhbC4gVGhh dCB3YXkgd2Uga2VlcCB0aGUgdGV4dCByZWFkYWJsZS4KPiAKPiBTYW1lIHdpdGggdGhhdCA6Yzpm dW5jOidmb28nIGNyYXAsIHRoYXQgbmVlZHMgdG8gZGllLCBhbmQgU3BoaW54IG5lZWRzCj4gdG8g YmUgdGF1Z2h0IGFib3V0IGZvbygpLgoKSSBkaWQgYSBwYXRjaCB0byBtYWtlIHRoYXQgbGF0dGVy IHBhcnQgaGFwcGVuLCBidXQgaGF2ZW4ndCBiZWVuIGFibGUgdG8KZmluZCB0aGUgdGltZSB0byBh ZGRyZXNzIHRoZSBjb21tZW50cyBhbmQgZ2V0IGl0IG91dCB0aGVyZS4gIEl0IGRlZmluaXRlbHkK Y2xlYW5lZCB1cCB0aGUgc291cmNlIGZpbGVzIGEgbG90IGFuZCBpcyB3b3J0aCBkb2luZy4gIFdp bGwgdHJ5IHRvIGdldApiYWNrIHRvIGl0IHNvb24uCgpUaGUgbG9jYWwgZmlsZSBsaW5rcyBzaG91 bGQgYmUgZWFzeSB0byBkbzsgd2Ugc2hvdWxkbid0IG5lZWQgdG8gYWRkIGFueQptYXJrdXAgZm9y IHRob3NlLgoKam9uCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fCmRyaS1kZXZlbCBtYWlsaW5nIGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9y ZwpodHRwczovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZl bA==