From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Date: Wed, 19 Jun 2019 12:42:39 +0200 From: Peter Zijlstra Subject: Re: [PATCH v1 12/22] docs: driver-api: add .rst files from the main dir Message-ID: <20190619104239.GM3419@hirez.programming.kicks-ass.net> References: <20190619072218.4437f891@coco.lan> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20190619072218.4437f891@coco.lan> To: Mauro Carvalho Chehab Cc: Daniel Vetter , 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 , 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 =?iso-8859-1?Q?F=E4rber?= , 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: On Wed, Jun 19, 2019 at 07:22:18AM -0300, Mauro Carvalho Chehab wrote: > 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. 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().