Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-30 Thread Mauro Carvalho Chehab
Em Thu, 30 Jun 2016 11:25:11 +0200 Markus Heiser escreveu: > Am 29.06.2016 um 22:57 schrieb Mauro Carvalho Chehab > : > > > Em Wed, 29 Jun 2016 11:52:09 -0600 > > Jonathan Corbet escreveu: > > > >>> 2. What is the best way to ship these migrations > >>> > >>> or better I asked, what is you

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-30 Thread Markus Heiser
Am 29.06.2016 um 22:57 schrieb Mauro Carvalho Chehab : > Em Wed, 29 Jun 2016 11:52:09 -0600 > Jonathan Corbet escreveu: > >>> 2. What is the best way to ship these migrations >>> >>> or better I asked, what is your recommendation for a >>> migration strategy. Jani says, that this better belong

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-30 Thread Markus Heiser
Hi Jonathan, Am 29.06.2016 um 19:52 schrieb Jonathan Corbet : > On Wed, 29 Jun 2016 19:35:46 +0200 > Markus Heiser wrote: > >>> I would love it if you would take the flat-table and man-page work, >>> separate them out, and make them work with the *existing* Sphinx-based >>> scheme. If you can

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-29 Thread Mauro Carvalho Chehab
Em Wed, 29 Jun 2016 11:52:09 -0600 Jonathan Corbet escreveu: > > 2. What is the best way to ship these migrations > > > > or better I asked, what is your recommendation for a > > migration strategy. Jani says, that this better belongs > > to authors, but I have a doubt that we end with the > > m

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-29 Thread Jonathan Corbet
On Wed, 29 Jun 2016 19:35:46 +0200 Markus Heiser wrote: > > I would love it if you would take the flat-table and man-page work, > > separate them out, and make them work with the *existing* Sphinx-based > > scheme. If you can do it soon, we can maybe get it into 4.8. Can you > > focus on that f

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-29 Thread Markus Heiser
Hi Jonathan, Am 29.06.2016 um 18:24 schrieb Jonathan Corbet : > Hi, Markus, > > I was glad to hear from you, but I have to agree with Jani: this is not > how things are done. Consider this one line: > >> 706 files changed, 123369 insertions(+), 752 deletions(-) > > Something like that will be

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-29 Thread Markus Heiser
Am 29.06.2016 um 15:15 schrieb Jani Nikula : > On Wed, 29 Jun 2016, Markus Heiser wrote: >> Am 28.06.2016 um 21:05 schrieb Jani Nikula : >>> Perhaps you misunderstood, I don't know. When we ask you to rebase your >>> work on something, in this case docs-next, it generally means, accept >>> what

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-29 Thread Jonathan Corbet
Hi, Markus, I was glad to hear from you, but I have to agree with Jani: this is not how things are done. Consider this one line: > 706 files changed, 123369 insertions(+), 752 deletions(-) Something like that will be a huge red flag to any kernel maintainer! In the kernel community, we have sp

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-29 Thread Jani Nikula
On Wed, 29 Jun 2016, Markus Heiser wrote: > Am 28.06.2016 um 21:05 schrieb Jani Nikula : >> Perhaps you misunderstood, I don't know. When we ask you to rebase your >> work on something, in this case docs-next, it generally means, accept >> what is there, and iteratively build and extend upon it, *

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-29 Thread Markus Heiser
Am 28.06.2016 um 21:05 schrieb Jani Nikula : > On Tue, 28 Jun 2016, Markus Heiser wrote: >> Hi Jonathan, hi Mauro, >> >> here is my DocBook to reST movement on top of Jon's docs-next branch. It >> includes: >> >> * kernel-doc parser & directive >> * flat-table directive >> * man page builder

Re: [GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-28 Thread Jani Nikula
On Tue, 28 Jun 2016, Markus Heiser wrote: > Hi Jonathan, hi Mauro, > > here is my DocBook to reST movement on top of Jon's docs-next branch. It > includes: > > * kernel-doc parser & directive > * flat-table directive > * man page builder 'kernel-doc-man' > * the kernel-doc-HOWTO > * guides for st

[GIT PULL] doc: sphinx-4.8 DocBook to reST movement on Jon's docs-next

2016-06-28 Thread Markus Heiser
Hi Jonathan, hi Mauro, here is my DocBook to reST movement on top of Jon's docs-next branch. It includes: * kernel-doc parser & directive * flat-table directive * man page builder 'kernel-doc-man' * the kernel-doc-HOWTO * guides for starters (reST-nano-HOWTO.rst & template-book) * A index-page