From: Jonathan Corbet <corbet@lwn.net>
To: Peter Zijlstra <peterz@infradead.org>
Cc: "Mauro Carvalho Chehab" <mchehab+samsung@kernel.org>,
"Daniel Vetter" <daniel@ffwll.ch>,
"Linux Doc Mailing List" <linux-doc@vger.kernel.org>,
"Mauro Carvalho Chehab" <mchehab@infradead.org>,
"Linux Kernel Mailing List" <linux-kernel@vger.kernel.org>,
"Johannes Berg" <johannes@sipsolutions.net>,
"Kurt Schwemmer" <kurt.schwemmer@microsemi.com>,
"Logan Gunthorpe" <logang@deltatee.com>,
"Bjorn Helgaas" <bhelgaas@google.com>,
"Alan Stern" <stern@rowland.harvard.edu>,
"Andrea Parri" <andrea.parri@amarulasolutions.com>,
"Will Deacon" <will.deacon@arm.com>,
"Boqun Feng" <boqun.feng@gmail.com>,
"Nicholas Piggin" <npiggin@gmail.com>,
"David Howells" <dhowells@redhat.com>,
"Jade Alglave" <j.alglave@ucl.ac.uk>,
"Luc Maranget" <luc.maranget@inria.fr>,
"Paul E. McKenney" <paulmck@linux.ibm.com>,
"Akira Yokosawa" <akiyks@gmail.com>,
"Daniel Lustig" <dlustig@nvidia.com>,
"Stuart Hayes" <stuart.w.hayes@gmail.com>,
"Thomas Gleixner" <tglx@linutronix.de>,
"Ingo Molnar" <mingo@redhat.com>,
"Darren Hart" <dvhart@infradead.org>,
"Kees Cook" <keescook@chromium.org>,
"Emese Revfy" <re.emese@gmail.com>,
"Ohad Ben-Cohen" <ohad@wizery.com>,
"Bjorn Andersson" <bjorn.andersson@linaro.org>,
"Corey Minyard" <minyard@acm.org>,
"Marc Zyngier" <marc.zyngier@arm.com>,
"William Breathitt Gray" <vilhelm.gray@gmail.com>,
"Jaroslav Kysela" <perex@perex.cz>,
"Greg Kroah-Hartman" <gregkh@linuxfoundation.org>,
"Rafael J. Wysocki" <rafael@kernel.org>,
"Naveen N. Rao" <naveen.n.rao@linux.ibm.com>,
"Anil S Keshavamurthy" <anil.s.keshavamurthy@intel.com>,
"David S. Miller" <davem@davemloft.net>,
"Masami Hiramatsu" <mhiramat@kernel.org>,
"Johannes Thumshirn" <morbidrsa@gmail.com>,
"Steffen Klassert" <steffen.klassert@secunet.com>,
"Sudip Mukherjee" <sudipm.mukherjee@gmail.com>,
"Andreas Färber" <afaerber@suse.de>,
"Manivannan Sadhasivam" <manivannan.sadhasivam@linaro.org>,
"Rodolfo Giometti" <giometti@enneenne.com>,
"Richard Cochran" <richardcochran@gmail.com>,
"Thierry Reding" <thierry.reding@gmail.com>,
"Sumit Semwal" <sumit.semwal@linaro.org>,
"Gustavo Padovan" <gustavo@padovan.org>,
"Jens Wiklander" <jens.wiklander@linaro.org>,
"Kirti Wankhede" <kwankhede@nvidia.com>,
"Alex Williamson" <alex.williamson@redhat.com>,
"Cornelia Huck" <cohuck@redhat.com>,
"Bartlomiej Zolnierkiewicz" <b.zolnierkie@samsung.com>,
"David Airlie" <airlied@linux.ie>,
"Maarten Lankhorst" <maarten.lankhorst@linux.intel.com>,
"Maxime Ripard" <maxime.ripard@bootlin.com>,
"Sean Paul" <sean@poorly.run>, "Farhan Ali" <alifm@linux.ibm.com>,
"Eric Farman" <farman@linux.ibm.com>,
"Halil Pasic" <pasic@linux.ibm.com>,
"Heiko Carstens" <heiko.carstens@de.ibm.com>,
"Vasily Gorbik" <gor@linux.ibm.com>,
"Christian Borntraeger" <borntraeger@de.ibm.com>,
"Harry Wei" <harryxiyou@gmail.com>,
"Alex Shi" <alex.shi@linux.alibaba.com>,
"Evgeniy Polyakov" <zbr@ioremap.net>,
"Jerry Hoemann" <jerry.hoemann@hpe.com>,
"Wim Van Sebroeck" <wim@linux-watchdog.org>,
"Guenter Roeck" <linux@roeck-us.net>,
"Guan Xuetao" <gxt@pku.edu.cn>, "Arnd Bergmann" <arnd@arndb.de>,
"Linus Walleij" <linus.walleij@linaro.org>,
"Bartosz Golaszewski" <bgolaszewski@baylibre.com>,
"Andy Shevchenko" <andy@infradead.org>,
"Jiri Slaby" <jslaby@suse.com>,
linux-wireless@vger.kernel.org,
"Linux PCI" <linux-pci@vger.kernel.org>,
"open list:GENERIC INCLUDE/A..." <linux-arch@vger.kernel.org>,
platform-driver-x86@vger.kernel.org,
linux-remoteproc@vger.kernel.org,
openipmi-developer@lists.sourceforge.net,
linux-crypto@vger.kernel.org,
"Linux ARM" <linux-arm-kernel@lists.infradead.org>,
netdev <netdev@vger.kernel.org>,
linux-pwm <linux-pwm@vger.kernel.org>,
dri-devel <dri-devel@lists.freedesktop.org>,
kvm@vger.kernel.org,
"Linux Fbdev development list" <linux-fbdev@vger.kernel.org>,
linux-s390@vger.kernel.org, linux-watchdog@vger.kernel.org,
linux-gpio <linux-gpio@vger.kernel.org>,
"Linux MM" <linux-mm@kvack.org>
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 [thread overview]
Message-ID: <20190619081353.75762028@lwn.net> (raw)
In-Reply-To: <20190619104239.GM3419@hirez.programming.kicks-ass.net>
On Wed, 19 Jun 2019 12:42:39 +0200
Peter Zijlstra <peterz@infradead.org> 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
next prev parent reply other threads:[~2019-06-19 14:13 UTC|newest]
Thread overview: 11+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <cover.1560890771.git.mchehab+samsung@kernel.org>
2019-06-18 20:53 ` [PATCH v1 12/22] docs: driver-api: add .rst files from the main dir Mauro Carvalho Chehab
2019-06-19 8:24 ` Thierry Reding
2019-06-19 9:05 ` Daniel Vetter
2019-06-19 10:22 ` Mauro Carvalho Chehab
2019-06-19 10:42 ` Peter Zijlstra
2019-06-19 14:13 ` Jonathan Corbet [this message]
2019-06-19 11:43 ` Peter Zijlstra
2019-06-19 11:45 ` Peter Zijlstra
2019-06-19 11:50 ` Peter Zijlstra
2019-06-19 12:50 ` Andrea Parri
[not found] <cover.1560891322.git.mchehab+samsung@kernel.org>
2019-06-18 21:05 ` Mauro Carvalho Chehab
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20190619081353.75762028@lwn.net \
--to=corbet@lwn.net \
--cc=afaerber@suse.de \
--cc=airlied@linux.ie \
--cc=akiyks@gmail.com \
--cc=alex.shi@linux.alibaba.com \
--cc=alex.williamson@redhat.com \
--cc=alifm@linux.ibm.com \
--cc=andrea.parri@amarulasolutions.com \
--cc=andy@infradead.org \
--cc=anil.s.keshavamurthy@intel.com \
--cc=arnd@arndb.de \
--cc=b.zolnierkie@samsung.com \
--cc=bgolaszewski@baylibre.com \
--cc=bhelgaas@google.com \
--cc=bjorn.andersson@linaro.org \
--cc=boqun.feng@gmail.com \
--cc=borntraeger@de.ibm.com \
--cc=cohuck@redhat.com \
--cc=daniel@ffwll.ch \
--cc=davem@davemloft.net \
--cc=dhowells@redhat.com \
--cc=dlustig@nvidia.com \
--cc=dri-devel@lists.freedesktop.org \
--cc=dvhart@infradead.org \
--cc=farman@linux.ibm.com \
--cc=giometti@enneenne.com \
--cc=gor@linux.ibm.com \
--cc=gregkh@linuxfoundation.org \
--cc=gustavo@padovan.org \
--cc=gxt@pku.edu.cn \
--cc=harryxiyou@gmail.com \
--cc=heiko.carstens@de.ibm.com \
--cc=j.alglave@ucl.ac.uk \
--cc=jens.wiklander@linaro.org \
--cc=jerry.hoemann@hpe.com \
--cc=johannes@sipsolutions.net \
--cc=jslaby@suse.com \
--cc=keescook@chromium.org \
--cc=kurt.schwemmer@microsemi.com \
--cc=kvm@vger.kernel.org \
--cc=kwankhede@nvidia.com \
--cc=linus.walleij@linaro.org \
--cc=linux-arch@vger.kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-crypto@vger.kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-fbdev@vger.kernel.org \
--cc=linux-gpio@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mm@kvack.org \
--cc=linux-pci@vger.kernel.org \
--cc=linux-pwm@vger.kernel.org \
--cc=linux-remoteproc@vger.kernel.org \
--cc=linux-s390@vger.kernel.org \
--cc=linux-watchdog@vger.kernel.org \
--cc=linux-wireless@vger.kernel.org \
--cc=linux@roeck-us.net \
--cc=logang@deltatee.com \
--cc=luc.maranget@inria.fr \
--cc=maarten.lankhorst@linux.intel.com \
--cc=manivannan.sadhasivam@linaro.org \
--cc=marc.zyngier@arm.com \
--cc=maxime.ripard@bootlin.com \
--cc=mchehab+samsung@kernel.org \
--cc=mchehab@infradead.org \
--cc=mhiramat@kernel.org \
--cc=mingo@redhat.com \
--cc=minyard@acm.org \
--cc=morbidrsa@gmail.com \
--cc=naveen.n.rao@linux.ibm.com \
--cc=netdev@vger.kernel.org \
--cc=npiggin@gmail.com \
--cc=ohad@wizery.com \
--cc=openipmi-developer@lists.sourceforge.net \
--cc=pasic@linux.ibm.com \
--cc=paulmck@linux.ibm.com \
--cc=perex@perex.cz \
--cc=peterz@infradead.org \
--cc=platform-driver-x86@vger.kernel.org \
--cc=rafael@kernel.org \
--cc=re.emese@gmail.com \
--cc=richardcochran@gmail.com \
--cc=sean@poorly.run \
--cc=steffen.klassert@secunet.com \
--cc=stern@rowland.harvard.edu \
--cc=stuart.w.hayes@gmail.com \
--cc=sudipm.mukherjee@gmail.com \
--cc=sumit.semwal@linaro.org \
--cc=tglx@linutronix.de \
--cc=thierry.reding@gmail.com \
--cc=vilhelm.gray@gmail.com \
--cc=will.deacon@arm.com \
--cc=wim@linux-watchdog.org \
--cc=zbr@ioremap.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).