Follow @Openwall on Twitter for new release announcements and other news
[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Date: Wed, 24 Apr 2019 11:19:06 +0200
From: Borislav Petkov <>
To: Jonathan Corbet <>
Cc: Mauro Carvalho Chehab <>,
	Peter Zijlstra <>,
	Mike Snitzer <>,
	Linux Doc Mailing List <>,
	Mauro Carvalho Chehab <>,,
	Johannes Berg <>,
	Kurt Schwemmer <>,
	Logan Gunthorpe <>,
	Bjorn Helgaas <>,
	Alasdair Kergon <>,,
	Kishon Vijay Abraham I <>,
	Rob Herring <>,
	Mark Rutland <>,
	Bartlomiej Zolnierkiewicz <>,
	David Airlie <>, Daniel Vetter <>,
	Maarten Lankhorst <>,
	Maxime Ripard <>,
	Sean Paul <>, Ning Sun <>,
	Ingo Molnar <>, Will Deacon <>,
	Alan Stern <>,
	Andrea Parri <>,
	Boqun Feng <>,
	Nicholas Piggin <>,
	David Howells <>,
	Jade Alglave <>,
	Luc Maranget <>,
	"Paul E. McKenney" <>,
	Akira Yokosawa <>,
	Daniel Lustig <>,
	"David S. Miller" <>,
	Andreas Färber <>,
	Manivannan Sadhasivam <>,
	Cornelia Huck <>, Farhan Ali <>,
	Eric Farman <>,
	Halil Pasic <>,
	Martin Schwidefsky <>,
	Heiko Carstens <>,
	Harry Wei <>,
	Alex Shi <>,
	Jerry Hoemann <>,
	Wim Van Sebroeck <>,
	Guenter Roeck <>,
	Thomas Gleixner <>,
	"H. Peter Anvin" <>,,
	Russell King <>,
	Tony Luck <>, Fenghua Yu <>,
	"James E.J. Bottomley" <>,
	Helge Deller <>,
	Yoshinori Sato <>,
	Rich Felker <>, Guan Xuetao <>,
	Jens Axboe <>,
	Greg Kroah-Hartman <>,
	"Rafael J. Wysocki" <>,
	Arnd Bergmann <>, Matt Mackall <>,
	Herbert Xu <>,
	Corey Minyard <>,
	Sumit Semwal <>,
	Linus Walleij <>,
	Bartosz Golaszewski <>,
	Darren Hart <>,
	Andy Shevchenko <>,
	Stuart Hayes <>,
	Jaroslav Kysela <>,
	Alex Williamson <>,
	Kirti Wankhede <>,
	Christoph Hellwig <>,
	Marek Szyprowski <>,
	Robin Murphy <>,
	Steffen Klassert <>,
	Kees Cook <>, Emese Revfy <>,
	James Morris <>,
	"Serge E. Hallyn" <>,,,,,,,,,,,,,,,,,,,,,,,,,,,
	Changbin Du <>
Subject: Re: [PATCH v2 56/79] docs: Documentation/*.txt: rename all ReST
 files to *.rst

On Tue, Apr 23, 2019 at 04:06:40PM -0600, Jonathan Corbet wrote:
> Remember that most of our docs are 99% RST even though they were written
> by people who had never even heard of RST.  I really don't think it's a
> big deal - a far smaller cognitive load than trying to keep up with any
> given subsystem's variable-declaration-ordering rules, for example :)

Tztztz, this thing seems to have hit a nerve with people. Which means, I
will enforce that even more now so that I annoy submitters more! :-P

See, I can do my own "RST" too. :-P

Srsly: ok, good. Sounds like we're on the same page then.

>  I'm trying to do the same in Documentation/, with an attempt to be
> sympathetic toward our readers, sort things by intended audience,
> and create (someday) a coherent whole. I agree that moving docs is
> a short-term annoyance, but I'm hoping that it brings a long-term
> benefit.

Ok, that's fair. I've been moving files too, in the past.

> Minimal markup is the policy (it's even documented :).  Automating stuff
> that can be automated is an area that has definitely not received
> enough attention; hopefully some things can be done there in the very
> near future.

Sounds nice, thanks Jon!


Good mailing practices for 400: avoid top-posting and trim the reply.

Powered by blists - more mailing lists

Confused about mailing lists and their use? Read about mailing lists on Wikipedia and check out these guidelines on proper formatting of your messages.