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

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20170518200140.11982b12@vento.lan>
Date:   Thu, 18 May 2017 20:01:40 -0300
From:   Mauro Carvalho Chehab <mchehab@...pensource.com>
To:     Jonathan Corbet <corbet@....net>
Cc:     Linux Doc Mailing List <linux-doc@...r.kernel.org>,
        Mauro Carvalho Chehab <mchehab@...radead.org>,
        linux-kernel@...r.kernel.org,
        David Woodhouse <dwmw2@...radead.org>,
        Brian Norris <computersforpeace@...il.com>,
        Boris Brezillon <boris.brezillon@...e-electrons.com>,
        Marek Vasut <marek.vasut@...il.com>,
        Richard Weinberger <richard@....at>,
        Cyrille Pitchen <cyrille.pitchen@...el.com>,
        linux-mtd@...ts.infradead.org
Subject: Re: [PATCH v2 00/53] Get rid of Docbook

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

> On Tue, 16 May 2017 09:15:52 -0300
> Mauro Carvalho Chehab <mchehab@...pensource.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