From: Borislav Petkov <bp@alien8.de>
To: Peter Zijlstra <peterz@infradead.org>
Cc: "Jonathan Corbet" <corbet@lwn.net>,
"Mike Snitzer" <snitzer@redhat.com>,
"Mauro Carvalho Chehab" <mchehab+samsung@kernel.org>,
"Linux Doc Mailing List" <linux-doc@vger.kernel.org>,
"Mauro Carvalho Chehab" <mchehab@infradead.org>,
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>,
"Alasdair Kergon" <agk@redhat.com>,
dm-devel@redhat.com, "Kishon Vijay Abraham I" <kishon@ti.com>,
"Rob Herring" <robh+dt@kernel.org>,
"Mark Rutland" <mark.rutland@arm.com>,
"Bartlomiej Zolnierkiewicz" <b.zolnierkie@samsung.com>,
"David Airlie" <airlied@linux.ie>,
"Daniel Vetter" <daniel@ffwll.ch>,
"Maarten Lankhorst" <maarten.lankhorst@linux.intel.com>,
"Maxime Ripard" <maxime.ripard@bootlin.com>,
"Sean Paul" <sean@poorly.run>, "Ning Sun" <ning.sun@intel.com>,
"Ingo Molnar" <mingo@redhat.com>,
"Will Deacon" <will.deacon@arm.com>,
"Alan Stern" <stern@rowland.harvard.edu>,
"Andrea Parri" <andrea.parri@amarulasolutions.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>,
"David S. Miller" <davem@davemloft.net>,
"Andreas Färber" <afaerber@suse.de>,
"Manivannan Sadhasivam" <manivannan.sadhasivam@linaro.org>,
"Cornelia Huck" <cohuck@redhat.com>,
"Farhan Ali" <alifm@linux.ibm.com>,
"Eric Farman" <farman@linux.ibm.com>,
"Halil Pasic" <pasic@linux.ibm.com>,
"Martin Schwidefsky" <schwidefsky@de.ibm.com>,
"Heiko Carstens" <heiko.carstens@de.ibm.com>,
"Harry Wei" <harryxiyou@gmail.com>,
"Alex Shi" <alex.shi@linux.alibaba.com>,
"Jerry Hoemann" <jerry.hoemann@hpe.com>,
"Wim Van Sebroeck" <wim@linux-watchdog.org>,
"Guenter Roeck" <linux@roeck-us.net>,
"Thomas Gleixner" <tglx@linutronix.de>,
"H. Peter Anvin" <hpa@zytor.com>,
x86@kernel.org, "Russell King" <linux@armlinux.org.uk>,
"Tony Luck" <tony.luck@intel.com>,
"Fenghua Yu" <fenghua.yu@intel.com>,
"James E.J. Bottomley" <James.Bottomley@HansenPartnership.com>,
"Helge Deller" <deller@gmx.de>,
"Yoshinori Sato" <ysato@users.sourceforge.jp>,
"Rich Felker" <dalias@libc.org>, "Guan Xuetao" <gxt@pku.edu.cn>,
"Jens Axboe" <axboe@kernel.dk>,
"Greg Kroah-Hartman" <gregkh@linuxfoundation.org>,
"Rafael J. Wysocki" <rafael@kernel.org>,
"Arnd Bergmann" <arnd@arndb.de>, "Matt Mackall" <mpm@selenic.com>,
"Herbert Xu" <herbert@gondor.apana.org.au>,
"Corey Minyard" <minyard@acm.org>,
"Sumit Semwal" <sumit.semwal@linaro.org>,
"Linus Walleij" <linus.walleij@linaro.org>,
"Bartosz Golaszewski" <bgolaszewski@baylibre.com>,
"Darren Hart" <dvhart@infradead.org>,
"Andy Shevchenko" <andy@infradead.org>,
"Stuart Hayes" <stuart.w.hayes@gmail.com>,
"Jaroslav Kysela" <perex@perex.cz>,
"Alex Williamson" <alex.williamson@redhat.com>,
"Kirti Wankhede" <kwankhede@nvidia.com>,
"Christoph Hellwig" <hch@lst.de>,
"Marek Szyprowski" <m.szyprowski@samsung.com>,
"Robin Murphy" <robin.murphy@arm.com>,
"Steffen Klassert" <steffen.klassert@secunet.com>,
"Kees Cook" <keescook@chromium.org>,
"Emese Revfy" <re.emese@gmail.com>,
"James Morris" <jmorris@namei.org>,
"Serge E. Hallyn" <serge@hallyn.com>,
linux-wireless@vger.kernel.org, linux-pci@vger.kernel.org,
devicetree@vger.kernel.org, dri-devel@lists.freedesktop.org,
linux-fbdev@vger.kernel.org, tboot-devel@lists.sourceforge.net,
linux-arch@vger.kernel.org, netdev@vger.kernel.org,
linux-arm-kernel@lists.infradead.org, linux-s390@vger.kernel.org,
kvm@vger.kernel.org, linux-watchdog@vger.kernel.org,
linux-ia64@vger.kernel.org, linux-parisc@vger.kernel.org,
linux-sh@vger.kernel.org, sparclinux@vger.kernel.org,
linux-block@vger.kernel.org, linux-crypto@vger.kernel.org,
openipmi-developer@lists.sourceforge.net,
linaro-mm-sig@lists.linaro.org, linux-gpio@vger.kernel.org,
platform-driver-x86@vger.kernel.org,
iommu@lists.linux-foundation.org, linux-mm@kvack.org,
kernel-hardening@lists.openwall.com,
linux-security-module@vger.kernel.org
Subject: Re: [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst
Date: Tue, 23 Apr 2019 19:20:06 +0200 [thread overview]
Message-ID: <20190423172006.GD16353@zn.tnic> (raw)
In-Reply-To: <20190423171158.GG12232@hirez.programming.kicks-ass.net>
On Tue, Apr 23, 2019 at 07:11:58PM +0200, Peter Zijlstra wrote:
> I know I'm an odd duck; but no. They're _less_ accessible for me, as
> both a reader and author. They look 'funny' when read as a text file
> (the only way it makes sense to read them; I spend 99% of my time on a
> computer looking at monospace text interfaces; mutt, vim and console, in
> that approximate order).
+1
It is probably fine to stare at them here
https://www.kernel.org/doc/html/latest/ and the end result is good
for showing them in browsers but after this conversion, it is
getting more and more painful to work with those files. For example,
Documentation/x86/x86_64/mm.txt we use a lot. I'd hate it if I had to go
sort out rest muck first just so that I can read it.
I think we can simply leave some text files be text files and be done
with it.
--
Regards/Gruss,
Boris.
Good mailing practices for 400: avoid top-posting and trim the reply.
next prev parent reply other threads:[~2019-04-23 17:20 UTC|newest]
Thread overview: 12+ messages / expand[flat|nested] mbox.gz Atom feed top
[not found] <cover.1555938375.git.mchehab+samsung@kernel.org>
2019-04-22 13:28 ` [PATCH v2 78/79] docs: sysctl: convert to ReST Mauro Carvalho Chehab
[not found] ` <cda57849a6462ccc72dcd360b30068ab6a1021c4.1555938376.git.mchehab+samsung@kernel.org>
2019-04-22 16:37 ` [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST files to *.rst Logan Gunthorpe
2019-04-23 8:31 ` Peter Zijlstra
2019-04-23 12:55 ` Mike Snitzer
2019-04-23 13:01 ` Peter Zijlstra
2019-04-23 13:21 ` Mike Snitzer
2019-04-23 16:30 ` Jonathan Corbet
2019-04-23 17:11 ` Peter Zijlstra
2019-04-23 17:20 ` Borislav Petkov [this message]
2019-04-23 17:53 ` Jonathan Corbet
2019-04-23 18:21 ` Peter Zijlstra
[not found] ` <20190423171944.7ac6db54@coco.lan>
2019-04-23 20:34 ` Jonathan Corbet
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=20190423172006.GD16353@zn.tnic \
--to=bp@alien8.de \
--cc=James.Bottomley@HansenPartnership.com \
--cc=afaerber@suse.de \
--cc=agk@redhat.com \
--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=arnd@arndb.de \
--cc=axboe@kernel.dk \
--cc=b.zolnierkie@samsung.com \
--cc=bgolaszewski@baylibre.com \
--cc=bhelgaas@google.com \
--cc=boqun.feng@gmail.com \
--cc=cohuck@redhat.com \
--cc=corbet@lwn.net \
--cc=dalias@libc.org \
--cc=daniel@ffwll.ch \
--cc=davem@davemloft.net \
--cc=deller@gmx.de \
--cc=devicetree@vger.kernel.org \
--cc=dhowells@redhat.com \
--cc=dlustig@nvidia.com \
--cc=dm-devel@redhat.com \
--cc=dri-devel@lists.freedesktop.org \
--cc=dvhart@infradead.org \
--cc=farman@linux.ibm.com \
--cc=fenghua.yu@intel.com \
--cc=gregkh@linuxfoundation.org \
--cc=gxt@pku.edu.cn \
--cc=harryxiyou@gmail.com \
--cc=hch@lst.de \
--cc=heiko.carstens@de.ibm.com \
--cc=herbert@gondor.apana.org.au \
--cc=hpa@zytor.com \
--cc=iommu@lists.linux-foundation.org \
--cc=j.alglave@ucl.ac.uk \
--cc=jerry.hoemann@hpe.com \
--cc=jmorris@namei.org \
--cc=johannes@sipsolutions.net \
--cc=keescook@chromium.org \
--cc=kernel-hardening@lists.openwall.com \
--cc=kishon@ti.com \
--cc=kurt.schwemmer@microsemi.com \
--cc=kvm@vger.kernel.org \
--cc=kwankhede@nvidia.com \
--cc=linaro-mm-sig@lists.linaro.org \
--cc=linus.walleij@linaro.org \
--cc=linux-arch@vger.kernel.org \
--cc=linux-arm-kernel@lists.infradead.org \
--cc=linux-block@vger.kernel.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-ia64@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mm@kvack.org \
--cc=linux-parisc@vger.kernel.org \
--cc=linux-pci@vger.kernel.org \
--cc=linux-s390@vger.kernel.org \
--cc=linux-security-module@vger.kernel.org \
--cc=linux-sh@vger.kernel.org \
--cc=linux-watchdog@vger.kernel.org \
--cc=linux-wireless@vger.kernel.org \
--cc=linux@armlinux.org.uk \
--cc=linux@roeck-us.net \
--cc=logang@deltatee.com \
--cc=luc.maranget@inria.fr \
--cc=m.szyprowski@samsung.com \
--cc=maarten.lankhorst@linux.intel.com \
--cc=manivannan.sadhasivam@linaro.org \
--cc=mark.rutland@arm.com \
--cc=maxime.ripard@bootlin.com \
--cc=mchehab+samsung@kernel.org \
--cc=mchehab@infradead.org \
--cc=mingo@redhat.com \
--cc=minyard@acm.org \
--cc=mpm@selenic.com \
--cc=netdev@vger.kernel.org \
--cc=ning.sun@intel.com \
--cc=npiggin@gmail.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=robh+dt@kernel.org \
--cc=robin.murphy@arm.com \
--cc=schwidefsky@de.ibm.com \
--cc=sean@poorly.run \
--cc=serge@hallyn.com \
--cc=snitzer@redhat.com \
--cc=sparclinux@vger.kernel.org \
--cc=steffen.klassert@secunet.com \
--cc=stern@rowland.harvard.edu \
--cc=stuart.w.hayes@gmail.com \
--cc=sumit.semwal@linaro.org \
--cc=tboot-devel@lists.sourceforge.net \
--cc=tglx@linutronix.de \
--cc=tony.luck@intel.com \
--cc=will.deacon@arm.com \
--cc=wim@linux-watchdog.org \
--cc=x86@kernel.org \
--cc=ysato@users.sourceforge.jp \
/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