From: Jonathan Corbet <corbet@lwn.net>
To: Steven Rostedt <rostedt@goodmis.org>
Cc: "Pavel Machek" <pavel@ucw.cz>, "Henrik Austad" <henrik@austad.us>,
linux-doc@vger.kernel.org, "Bjorn Helgaas" <bhelgaas@google.com>,
"Paul E. McKenney" <paulmck@linux.vnet.ibm.com>,
"Josh Triplett" <josh@joshtriplett.org>,
"Mathieu Desnoyers" <mathieu.desnoyers@efficios.com>,
"Lai Jiangshan" <jiangshanlai@gmail.com>,
"Jens Axboe" <axboe@kernel.dk>,
"Rob Herring" <robh+dt@kernel.org>,
"Mark Rutland" <mark.rutland@arm.com>,
"Bartlomiej Zolnierkiewicz" <b.zolnierkie@samsung.com>,
"Linus Walleij" <linus.walleij@linaro.org>,
"David S. Miller" <davem@davemloft.net>,
"Karsten Keil" <isdn@linux-pingi.de>,
"Masahiro Yamada" <yamada.masahiro@socionext.com>,
"Michal Marek" <michal.lkml@markovi.net>,
"Peter Zijlstra" <peterz@infradead.org>,
"Ingo Molnar" <mingo@redhat.com>,
"Will Deacon" <will.deacon@arm.com>,
"Ralf Baechle" <ralf@linux-mips.org>,
"Paul Burton" <paul.burton@mips.com>,
"James Hogan" <jhogan@kernel.org>,
"Paul Moore" <paul@paul-moore.com>,
"James E.J. Bottomley" <jejb@parisc-linux.org>,
"Helge Deller" <deller@gmx.de>,
"Rafael J. Wysocki" <rjw@rjwysocki.net>,
"Len Brown" <len.brown@intel.com>,
"Benjamin Herrenschmidt" <benh@kernel.crashing.org>,
"Paul Mackerras" <paulus@samba.org>,
"Michael Ellerman" <mpe@ellerman.id.au>,
"Martin Schwidefsky" <schwidefsky@de.ibm.com>,
"Heiko Carstens" <heiko.carstens@de.ibm.com>,
"Greg Kroah-Hartman" <gregkh@linuxfoundation.org>,
"Jiri Slaby" <jslaby@suse.com>, "Mark Brown" <broonie@kernel.org>,
"Thomas Gleixner" <tglx@linutronix.de>,
"Paolo Bonzini" <pbonzini@redhat.com>,
"Radim Krčmář" <rkrcmar@redhat.com>,
"Evgeniy Polyakov" <zbr@ioremap.net>,
"H. Peter Anvin" <hpa@zytor.com>,
x86@kernel.org, "Andrew Morton" <akpm@linux-foundation.org>,
"Ian Kent" <raven@themaw.net>,
"Jacek Anaszewski" <jacek.anaszewski@gmail.com>,
"Mike Rapoport" <rppt@linux.vnet.ibm.com>,
"Jan Kandziora" <jjj@gmx.de>,
linux-kernel@vger.kernel.org, linux-pci@vger.kernel.org,
devicetree@vger.kernel.org, dri-devel@lists.freedesktop.org,
linux-fbdev@vger.kernel.org, linux-gpio@vger.kernel.org,
linux-ide@vger.kernel.org, netdev@vger.kernel.org,
linux-kbuild@vger.kernel.org, linux-mips@linux-mips.org,
linux-security-module@vger.kernel.org,
linux-parisc@vger.kernel.org, linux-pm@vger.kernel.org,
linuxppc-dev@lists.ozlabs.org, linux-s390@vger.kernel.org,
linux-spi@vger.kernel.org, kvm@vger.kernel.org,
"Henrik Austad" <haustad@cisco.com>
Subject: Re: [PATCH] [RFC v2] Drop all 00-INDEX files from Documentation/
Date: Thu, 6 Sep 2018 09:58:04 -0600 [thread overview]
Message-ID: <20180906095804.5ab2716f@lwn.net> (raw)
In-Reply-To: <20180904095908.13298b3d@gandalf.local.home>
On Tue, 4 Sep 2018 09:59:08 -0400
Steven Rostedt <rostedt@goodmis.org> wrote:
> On Tue, 4 Sep 2018 13:30:30 +0200
> Pavel Machek <pavel@ucw.cz> wrote:
>
> > I'd say this is still quite valueable, and it might be worth fixing,
> > rather then removing completely.
>
> I agree. Perhaps we should have a 00-DESCRIPTION file in each
> directory, and each file could start with a:
>
> DESCRIPTION: <one line description here>
>
> and then these files could be generated by those that have these tags.
I really don't want to hack up yet another documentation syntax and
processing scheme. We already have one that does all of this and more.
That energy would be far better spent bringing the docs into the RST
hierarchy, IMO.
Thanks,
jon (who is increasingly inclined to apply this patch)
next prev parent reply other threads:[~2018-09-06 15:59 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-09-03 22:15 [PATCH] [RFC v2] Drop all 00-INDEX files from Documentation/ Henrik Austad
2018-09-04 10:41 ` Mark Brown
2018-09-04 11:30 ` Pavel Machek
2018-09-04 13:59 ` Steven Rostedt
2018-09-06 15:58 ` Jonathan Corbet [this message]
2018-09-06 16:01 ` Steven Rostedt
2018-09-06 21:39 ` Daniel Vetter
2018-09-07 7:21 ` Greg Kroah-Hartman
2018-09-04 13:02 ` Paul E. McKenney
2018-09-04 15:45 ` Jens Axboe
2018-09-04 17:56 ` Mike Rapoport
2018-09-05 11:42 ` Paul Moore
2018-09-09 21:12 ` 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=20180906095804.5ab2716f@lwn.net \
--to=corbet@lwn.net \
--cc=akpm@linux-foundation.org \
--cc=axboe@kernel.dk \
--cc=b.zolnierkie@samsung.com \
--cc=benh@kernel.crashing.org \
--cc=bhelgaas@google.com \
--cc=broonie@kernel.org \
--cc=davem@davemloft.net \
--cc=deller@gmx.de \
--cc=devicetree@vger.kernel.org \
--cc=dri-devel@lists.freedesktop.org \
--cc=gregkh@linuxfoundation.org \
--cc=haustad@cisco.com \
--cc=heiko.carstens@de.ibm.com \
--cc=henrik@austad.us \
--cc=hpa@zytor.com \
--cc=isdn@linux-pingi.de \
--cc=jacek.anaszewski@gmail.com \
--cc=jejb@parisc-linux.org \
--cc=jhogan@kernel.org \
--cc=jiangshanlai@gmail.com \
--cc=jjj@gmx.de \
--cc=josh@joshtriplett.org \
--cc=jslaby@suse.com \
--cc=kvm@vger.kernel.org \
--cc=len.brown@intel.com \
--cc=linus.walleij@linaro.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-fbdev@vger.kernel.org \
--cc=linux-gpio@vger.kernel.org \
--cc=linux-ide@vger.kernel.org \
--cc=linux-kbuild@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mips@linux-mips.org \
--cc=linux-parisc@vger.kernel.org \
--cc=linux-pci@vger.kernel.org \
--cc=linux-pm@vger.kernel.org \
--cc=linux-s390@vger.kernel.org \
--cc=linux-security-module@vger.kernel.org \
--cc=linux-spi@vger.kernel.org \
--cc=linuxppc-dev@lists.ozlabs.org \
--cc=mark.rutland@arm.com \
--cc=mathieu.desnoyers@efficios.com \
--cc=michal.lkml@markovi.net \
--cc=mingo@redhat.com \
--cc=mpe@ellerman.id.au \
--cc=netdev@vger.kernel.org \
--cc=paul.burton@mips.com \
--cc=paul@paul-moore.com \
--cc=paulmck@linux.vnet.ibm.com \
--cc=paulus@samba.org \
--cc=pavel@ucw.cz \
--cc=pbonzini@redhat.com \
--cc=peterz@infradead.org \
--cc=ralf@linux-mips.org \
--cc=raven@themaw.net \
--cc=rjw@rjwysocki.net \
--cc=rkrcmar@redhat.com \
--cc=robh+dt@kernel.org \
--cc=rostedt@goodmis.org \
--cc=rppt@linux.vnet.ibm.com \
--cc=schwidefsky@de.ibm.com \
--cc=tglx@linutronix.de \
--cc=will.deacon@arm.com \
--cc=x86@kernel.org \
--cc=yamada.masahiro@socionext.com \
--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).