From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-5.8 required=5.0 tests=DKIM_INVALID,DKIM_SIGNED, MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI autolearn=ham autolearn_force=no version=3.4.2 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id 3EC107D04D for ; Tue, 16 Apr 2019 09:58:23 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728556AbfDPJ6W (ORCPT ); Tue, 16 Apr 2019 05:58:22 -0400 Received: from casper.infradead.org ([85.118.1.10]:50600 "EHLO casper.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726739AbfDPJ6W (ORCPT ); Tue, 16 Apr 2019 05:58:22 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:Content-Type: MIME-Version:References:In-Reply-To:Message-ID:Subject:Cc:To:From:Date:Sender :Reply-To:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help: List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=sP/+g+YITf4kSwQg6jWKcy9Hzpj2iP/E6kmV831FVp0=; b=HAJzIt/mkFcFrqyUTqPhMz19+S qUNhAAim90wx23B6Td7Tt9/eHtw864EtZnJHTrzoCGCP8wrNgHa6rnSr6BtSLffYZdI/prapQ1qpY YsUETnZQrTAiWiDQRJDZqMYtvmJFUA6W9wUjlztcZ/wgS/TtHY+fxty4NceZTXlcAzhLXXMayZ88b mglYrvJNY7UzQPNuYp/20u6QwQMmEn9gKLLmlcXLMdSZRDO1dXleSMLJBkkk8kXV2feXL1ybLYJT9 Oo6XiP2RruIYFJJModOKBkMA98EFcg68Y1cfxetbw6hf2kdGpqUS3Q03/q+tJs+WyN5VS6bugIgly OJuTmldw==; Received: from 177.205.118.176.dynamic.adsl.gvt.net.br ([177.205.118.176] helo=coco.lan) by casper.infradead.org with esmtpsa (Exim 4.90_1 #2 (Red Hat Linux)) id 1hGKr5-0004L4-TH; Tue, 16 Apr 2019 09:58:20 +0000 Date: Tue, 16 Apr 2019 06:58:15 -0300 From: Mauro Carvalho Chehab To: "Rafael J. Wysocki" Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , Linux Kernel Mailing List , Jonathan Corbet , "Rafael J. Wysocki" , Viresh Kumar , Linux PM Subject: Re: [PATCH 09/57] docs: cpu-freq: convert files to ReST Message-ID: <20190416065815.57fbdf2c@coco.lan> In-Reply-To: References: X-Mailer: Claws Mail 3.17.3 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org Em Tue, 16 Apr 2019 10:21:31 +0200 "Rafael J. Wysocki" escreveu: > On Tue, Apr 16, 2019 at 4:56 AM Mauro Carvalho Chehab > wrote: > > > > In order to be able to build html and pdf files, convert the > > documentation to ReST format. > > > > Signed-off-by: Mauro Carvalho Chehab > > Please don't convert these files. > > They need more work than just semi-automatic conversion Except for one exception (at patch 32/57), the ReST conversion on this patch set was manually made. I basically renamed the files to .rst, checked the errors and fixed, trying to preserve the original document style as much as possible, while providing a good visual for the html output. I suspect that trying to write a script for such kind of conversion is not an easy task, as some documents within the Kernel tree have their own personal style, (there was even one written in LaTeX at the CDROM docs), and I suspect that a script would end by adding extra unwanted markups. > and the material in them needs to go under driver-api. Yeah, those documents make sense to be at the driver-api set. The rationale why I placed the patch with actually renames on a separate patchset (already on my devel tree, but yet to be submitted) is that, this way, it should be easy for maintainers to pick the conversion patch, apply on their trees, and, if they're not ready yet, postpone the actual rename/move thing. > This is quite hight in my TODO list. OK. Feel free to use this patch as a starting point if you want. Regards, Mauro