From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932624AbdERXBu (ORCPT ); Thu, 18 May 2017 19:01:50 -0400 Received: from ec2-52-27-115-49.us-west-2.compute.amazonaws.com ([52.27.115.49]:42824 "EHLO osg.samsung.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1753375AbdERXBt (ORCPT ); Thu, 18 May 2017 19:01:49 -0400 Date: Thu, 18 May 2017 20:01:40 -0300 From: Mauro Carvalho Chehab To: Jonathan Corbet Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, David Woodhouse , Brian Norris , Boris Brezillon , Marek Vasut , Richard Weinberger , Cyrille Pitchen , linux-mtd@lists.infradead.org Subject: Re: [PATCH v2 00/53] Get rid of Docbook Message-ID: <20170518200140.11982b12@vento.lan> In-Reply-To: <20170518112608.4f355068@lwn.net> References: <20170518112608.4f355068@lwn.net> Organization: Samsung X-Mailer: Claws Mail 3.14.1 (GTK+ 2.24.31; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Em Thu, 18 May 2017 11:26:08 -0600 Jonathan Corbet escreveu: > On Tue, 16 May 2017 09:15:52 -0300 > Mauro Carvalho Chehab 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