Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Mauro Carvalho Chehab
Em Fri, 23 Sep 2016 09:26:34 -0700 Joe Perches escreveu: > On Fri, 2016-09-23 at 12:07 -0300, Mauro Carvalho Chehab wrote: > > So, let's use an unusual approach: manually convert the > > text at the MAINTAINERS file head, adding it at a new > >

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Mauro Carvalho Chehab
Em Fri, 23 Sep 2016 09:26:34 -0700 Joe Perches escreveu: > On Fri, 2016-09-23 at 12:07 -0300, Mauro Carvalho Chehab wrote: > > So, let's use an unusual approach: manually convert the > > text at the MAINTAINERS file head, adding it at a new > > Documentation/user/MAINTAINERS.rst, and include, as

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Markus Heiser
Am 23.09.2016 um 17:35 schrieb Mauro Carvalho Chehab : > Em Fri, 23 Sep 2016 09:15:01 -0600 > Jonathan Corbet escreveu: >> I'm not sure I see the value of including it in >> the docs? What am I missing here? > > It is part of the REPORTING-BUGS

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Markus Heiser
Am 23.09.2016 um 17:35 schrieb Mauro Carvalho Chehab : > Em Fri, 23 Sep 2016 09:15:01 -0600 > Jonathan Corbet escreveu: >> I'm not sure I see the value of including it in >> the docs? What am I missing here? > > It is part of the REPORTING-BUGS procedure to check MAINTAINERS and > find to

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Joe Perches
On Fri, 2016-09-23 at 12:07 -0300, Mauro Carvalho Chehab wrote: > So, let's use an unusual approach: manually convert the > text at the MAINTAINERS file head, adding it at a new > Documentation/user/MAINTAINERS.rst, and include, as a code > block, the rest of MAINTAINERS contents, with only the >

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Joe Perches
On Fri, 2016-09-23 at 12:07 -0300, Mauro Carvalho Chehab wrote: > So, let's use an unusual approach: manually convert the > text at the MAINTAINERS file head, adding it at a new > Documentation/user/MAINTAINERS.rst, and include, as a code > block, the rest of MAINTAINERS contents, with only the >

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Mauro Carvalho Chehab
Em Fri, 23 Sep 2016 09:15:01 -0600 Jonathan Corbet escreveu: > On Fri, 23 Sep 2016 12:07:33 -0300 > Mauro Carvalho Chehab wrote: > > > including MAINTAINERS using ReST is tricky, because all > > maintainer's entries are like: > > So I'm generally in

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Mauro Carvalho Chehab
Em Fri, 23 Sep 2016 09:15:01 -0600 Jonathan Corbet escreveu: > On Fri, 23 Sep 2016 12:07:33 -0300 > Mauro Carvalho Chehab wrote: > > > including MAINTAINERS using ReST is tricky, because all > > maintainer's entries are like: > > So I'm generally in favor of moving things over to RST, but I

[RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Mauro Carvalho Chehab
including MAINTAINERS using ReST is tricky, because all maintainer's entries are like: FOO SUBSYSTEM: M: My Name L: mailing@list S: Maintained F: foo/bar On ReST, this would be displayed on a single line. Using alias, like |M|, |L|, ... won't solve, as an alias in Sphinx doesn't accept

[RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Mauro Carvalho Chehab
including MAINTAINERS using ReST is tricky, because all maintainer's entries are like: FOO SUBSYSTEM: M: My Name L: mailing@list S: Maintained F: foo/bar On ReST, this would be displayed on a single line. Using alias, like |M|, |L|, ... won't solve, as an alias in Sphinx doesn't accept breaking

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Jonathan Corbet
On Fri, 23 Sep 2016 12:07:33 -0300 Mauro Carvalho Chehab wrote: > including MAINTAINERS using ReST is tricky, because all > maintainer's entries are like: So I'm generally in favor of moving things over to RST, but I have to ask: what's the payoff for doing that with

Re: [RFC PATCH v3] docs-rst: user: add MAINTAINERS

2016-09-23 Thread Jonathan Corbet
On Fri, 23 Sep 2016 12:07:33 -0300 Mauro Carvalho Chehab wrote: > including MAINTAINERS using ReST is tricky, because all > maintainer's entries are like: So I'm generally in favor of moving things over to RST, but I have to ask: what's the payoff for doing that with the MAINTAINERS file? I