All of lore.kernel.org
 help / color / mirror / Atom feed
From: Jonathan Corbet <corbet@lwn.net>
To: Steven Rostedt <rostedt@goodmis.org>
Cc: "Mark Rutland" <mark.rutland@arm.com>,
	linux-mips@linux-mips.org, linux-fbdev@vger.kernel.org,
	x86@kernel.org, kvm@vger.kernel.org, linux-doc@vger.kernel.org,
	"Peter Zijlstra" <peterz@infradead.org>,
	"James Hogan" <jhogan@kernel.org>,
	"Henrik Austad" <henrik@austad.us>,
	"Will Deacon" <will.deacon@arm.com>,
	dri-devel@lists.freedesktop.org,
	"Masahiro Yamada" <yamada.masahiro@socionext.com>,
	"Jan Kandziora" <jjj@gmx.de>, "Paul Mackerras" <paulus@samba.org>,
	"Henrik Austad" <haustad@cisco.com>,
	"Pavel Machek" <pavel@ucw.cz>, "H. Peter Anvin" <hpa@zytor.com>,
	"Evgeniy Polyakov" <zbr@ioremap.net>,
	linux-s390@vger.kernel.org, "Ian Kent" <raven@themaw.net>,
	linux-security-module@vger.kernel.org,
	"Paul Moore" <paul@paul-moore.com>,
	"Michael Ellerman" <mpe@ellerman.id.au>,
	"Helge Deller" <deller@gmx.de>,
	"Radim Krčmář" <rkrcmar@redhat.com>,
	"James E.J. Bottomley" <jejb@parisc-linux.org>
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)
_______________________________________________
dri-devel mailing list
dri-devel@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/dri-devel

WARNING: multiple messages have this Message-ID (diff)
From: Jonathan Corbet <corbet@lwn.net>
To: Steven Rostedt <rostedt@goodmis.org>
Cc: "Mark Rutland" <mark.rutland@arm.com>,
	linux-mips@linux-mips.org, linux-fbdev@vger.kernel.org,
	x86@kernel.org, kvm@vger.kernel.org, linux-doc@vger.kernel.org,
	"Peter Zijlstra" <peterz@infradead.org>,
	"James Hogan" <jhogan@kernel.org>,
	"Henrik Austad" <henrik@austad.us>,
	"Will Deacon" <will.deacon@arm.com>,
	dri-devel@lists.freedesktop.org,
	"Masahiro Yamada" <yamada.masahiro@socionext.com>,
	"Jan Kandziora" <jjj@gmx.de>, "Paul Mackerras" <paulus@samba.org>,
	"Henrik Austad" <haustad@cisco.com>,
	"Pavel Machek" <pavel@ucw.cz>, "H. Peter Anvin" <hpa@zytor.com>,
	"Evgeniy Polyakov" <zbr@ioremap.net>,
	linux-s390@vger.kernel.org, "Ian Kent" <raven@themaw.net>,
	linux-security-module@vger.kernel.org,
	"Paul Moore" <paul@paul-moore.com>,
	"Michael Ellerman" <mpe@ellerman.id.au>,
	"Helge Deller" <deller@gmx.de>,
	"Radim Krčmář" <rkrcmar@redhat.com>,
	"James E.J. Bottomley" <jejb@parisc-linux.org>
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>

T24gVHVlLCA0IFNlcCAyMDE4IDA5OjU5OjA4IC0wNDAwClN0ZXZlbiBSb3N0ZWR0IDxyb3N0ZWR0
QGdvb2RtaXMub3JnPiB3cm90ZToKCj4gT24gVHVlLCA0IFNlcCAyMDE4IDEzOjMwOjMwICswMjAw
Cj4gUGF2ZWwgTWFjaGVrIDxwYXZlbEB1Y3cuY3o+IHdyb3RlOgo+IAo+ID4gSSdkIHNheSB0aGlz
IGlzIHN0aWxsIHF1aXRlIHZhbHVlYWJsZSwgYW5kIGl0IG1pZ2h0IGJlIHdvcnRoIGZpeGluZywK
PiA+IHJhdGhlciB0aGVuIHJlbW92aW5nIGNvbXBsZXRlbHkuICAKPiAKPiBJIGFncmVlLiBQZXJo
YXBzIHdlIHNob3VsZCBoYXZlIGEgMDAtREVTQ1JJUFRJT04gZmlsZSBpbiBlYWNoCj4gZGlyZWN0
b3J5LCBhbmQgZWFjaCBmaWxlIGNvdWxkIHN0YXJ0IHdpdGggYToKPiAKPiAgREVTQ1JJUFRJT046
IDxvbmUgbGluZSBkZXNjcmlwdGlvbiBoZXJlPgo+IAo+IGFuZCB0aGVuIHRoZXNlIGZpbGVzIGNv
dWxkIGJlIGdlbmVyYXRlZCBieSB0aG9zZSB0aGF0IGhhdmUgdGhlc2UgdGFncy4KCkkgcmVhbGx5
IGRvbid0IHdhbnQgdG8gaGFjayB1cCB5ZXQgYW5vdGhlciBkb2N1bWVudGF0aW9uIHN5bnRheCBh
bmQKcHJvY2Vzc2luZyBzY2hlbWUuICBXZSBhbHJlYWR5IGhhdmUgb25lIHRoYXQgZG9lcyBhbGwg
b2YgdGhpcyBhbmQgbW9yZS4KVGhhdCBlbmVyZ3kgd291bGQgYmUgZmFyIGJldHRlciBzcGVudCBi
cmluZ2luZyB0aGUgZG9jcyBpbnRvIHRoZSBSU1QKaGllcmFyY2h5LCBJTU8uCgpUaGFua3MsCgpq
b24gICh3aG8gaXMgaW5jcmVhc2luZ2x5IGluY2xpbmVkIHRvIGFwcGx5IHRoaXMgcGF0Y2gpCl9f
X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBt
YWlsaW5nIGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3Rz
LmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAo=

WARNING: multiple messages have this Message-ID (diff)
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)

  reply	other threads:[~2018-09-06 15:58 UTC|newest]

Thread overview: 35+ 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-03 22:15 ` Henrik Austad
2018-09-03 22:15 ` Henrik Austad
2018-09-04  2:45 ` Josh Triplett
2018-09-04 10:41 ` Mark Brown
2018-09-04 10:41   ` Mark Brown
2018-09-04 11:30 ` Pavel Machek
2018-09-04 11:30   ` Pavel Machek
2018-09-04 13:59   ` Steven Rostedt
2018-09-04 13:59     ` Steven Rostedt
2018-09-04 13:59     ` Steven Rostedt
2018-09-06 15:58     ` Jonathan Corbet [this message]
2018-09-06 15:58       ` Jonathan Corbet
2018-09-06 15:58       ` Jonathan Corbet
2018-09-06 16:01       ` Steven Rostedt
2018-09-06 16:01         ` Steven Rostedt
2018-09-06 16:01         ` Steven Rostedt
2018-09-06 21:39         ` Daniel Vetter
2018-09-06 21:39           ` Daniel Vetter
2018-09-06 21:39           ` Daniel Vetter
2018-09-07  7:21           ` Greg Kroah-Hartman
2018-09-07  7:21             ` Greg Kroah-Hartman
2018-09-07  7:21             ` Greg Kroah-Hartman
2018-09-04 13:02 ` Paul E. McKenney
2018-09-04 13:02   ` Paul E. McKenney
2018-09-04 15:45 ` Jens Axboe
2018-09-04 15:45   ` Jens Axboe
2018-09-04 17:56 ` Mike Rapoport
2018-09-04 17:56   ` Mike Rapoport
2018-09-05 11:42 ` Paul Moore
2018-09-05 11:42   ` Paul Moore
2018-09-05 11:42   ` Paul Moore
2018-09-09 21:12 ` Jonathan Corbet
2018-09-09 21:12   ` Jonathan Corbet
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=deller@gmx.de \
    --cc=dri-devel@lists.freedesktop.org \
    --cc=haustad@cisco.com \
    --cc=henrik@austad.us \
    --cc=hpa@zytor.com \
    --cc=jejb@parisc-linux.org \
    --cc=jhogan@kernel.org \
    --cc=jjj@gmx.de \
    --cc=kvm@vger.kernel.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-fbdev@vger.kernel.org \
    --cc=linux-mips@linux-mips.org \
    --cc=linux-s390@vger.kernel.org \
    --cc=linux-security-module@vger.kernel.org \
    --cc=mark.rutland@arm.com \
    --cc=mpe@ellerman.id.au \
    --cc=paul@paul-moore.com \
    --cc=paulus@samba.org \
    --cc=pavel@ucw.cz \
    --cc=peterz@infradead.org \
    --cc=raven@themaw.net \
    --cc=rkrcmar@redhat.com \
    --cc=rostedt@goodmis.org \
    --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 an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.