Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-18 Thread Christoph Hellwig
On Thu, Aug 18, 2016 at 05:46:30PM -0600, Jonathan Corbet wrote: > So would the old hats be happier with a patch that looks like this? The > quality of the formatted output suffers slightly, but it's not a big > deal... I think this a major improvement. The only thing that still strikes me as ra

Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-18 Thread Jonathan Corbet
On Tue, 9 Aug 2016 01:31:06 -0700 Christoph Hellwig wrote: > On Tue, Aug 09, 2016 at 10:28:38AM +0200, Daniel Vetter wrote: > > The point is to make the docs more discoverable by being able to > > cross-link them. Old hats like us don't need that, but it definitely > > has value in bringing new f

Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-09 Thread Jonathan Corbet
On Tue, 9 Aug 2016 01:31:06 -0700 Christoph Hellwig wrote: > On Tue, Aug 09, 2016 at 10:28:38AM +0200, Daniel Vetter wrote: > > The point is to make the docs more discoverable by being able to > > cross-link them. Old hats like us don't need that, but it definitely > > has value in bringing new f

Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-09 Thread Daniel Vetter
On Tue, Aug 9, 2016 at 10:31 AM, Christoph Hellwig wrote: > On Tue, Aug 09, 2016 at 10:28:38AM +0200, Daniel Vetter wrote: >> The point is to make the docs more discoverable by being able to >> cross-link them. Old hats like us don't need that, but it definitely >> has value in bringing new folks

Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-09 Thread Christoph Hellwig
On Tue, Aug 09, 2016 at 10:28:38AM +0200, Daniel Vetter wrote: > The point is to make the docs more discoverable by being able to > cross-link them. Old hats like us don't need that, but it definitely > has value in bringing new folks on board. But do that in a way that keeps the old hats happy.

Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-09 Thread Daniel Vetter
On Tue, Aug 9, 2016 at 10:22 AM, Christoph Hellwig wrote: > On Tue, Aug 09, 2016 at 11:19:50AM +0300, Jani Nikula wrote: >> On Tue, 09 Aug 2016, Christoph Hellwig wrote: >> > The ugly format is a major regression over a proper simple text >> > file. What's the point? >> >> Major regression? Plea

Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-09 Thread Christoph Hellwig
On Tue, Aug 09, 2016 at 11:19:50AM +0300, Jani Nikula wrote: > On Tue, 09 Aug 2016, Christoph Hellwig wrote: > > The ugly format is a major regression over a proper simple text > > file. What's the point? > > Major regression? Please be reasonable. > > I think the changes are rather small, and

Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-09 Thread Jani Nikula
On Tue, 09 Aug 2016, Christoph Hellwig wrote: > The ugly format is a major regression over a proper simple text > file. What's the point? Major regression? Please be reasonable. I think the changes are rather small, and it's a fair compromise between a simple text file and one that can be used

Re: [PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-09 Thread Christoph Hellwig
The ugly format is a major regression over a proper simple text file. What's the point? -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html

[PATCH 03/10] docs: sphinxify sparse.txt and move to dev-tools

2016-08-08 Thread Jonathan Corbet
Fold the sparse document into the development tools set; no changes to the text itself beyond formatting. Signed-off-by: Jonathan Corbet --- Documentation/{sparse.txt => dev-tools/sparse.rst} | 61 +- Documentation/dev-tools/tools.rst | 1 + 2 files changed,