Re: [PATCH v2 00/53] Get rid of Docbook

Mauro Carvalho Chehab
2017-05-18T23:01:50Z

Em Thu, 18 May 2017 11:26:08 -0600
Jonathan Corbet <corbet@lwn.net> escreveu:

> On Tue, 16 May 2017 09:15:52 -0300
> Mauro Carvalho Chehab <mchehab@s-opensource.com> wrote:
>
> > This patch series convert the remaining DocBooks to ReST.
>
> Gotta love this:
>
> > 124 files changed, 7469 insertions(+), 10511 deletions(-)

Heh, yeah, lots of stuff changed :-)

> I've just pulled the whole set from your experimental.git repo. There are
> certainly a few rough edges, but that means it will fit into the rest of
> the docs just fine :)

:-)

> There are a few loose ends, but, rather than complaining about them, I'll
> just see what's to be done about them.

Yeah, a change like that will likely have a few loose ends. One of them
is with regards to Documentation/kernel-doc-nano-HOWTO.txt: we may
think on removing it soon, as I guess the important stuff there is
already under Documentation/doc-guide.

> Thanks for pushing this through, this is a nice milestone.

Anytime!

Btw, it seems I didn't have much to do this week[1]... I produced a
changeset series with 90+ patches that standardize the
Documentation/*.txt files, making them parseable by Sphinx. I
opted to keep the files where they are, and don't update
anything else but the text format, as I'm pretty sure that
some of the files there are really outdated.

The rationale for doing that is that it would minimize the
risk of someone add a new text document under Documentation
using some other random format, as at least the documents
on the main documentation dir will all have the same format.

I'll be mailbombing them soon (perhaps splitting into 3
series with ~30 patches each).

[1] The reality is that I moved to another place, and didn't
have time yet to unpack the machines and media test boards yet...
So, I decided to have some fun with docs ;)

Thanks,
Mauro