From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.1 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,MENTIONS_GIT_HOSTING,SPF_HELO_NONE,SPF_PASS, T_DKIMWL_WL_HIGH autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 9D8E9C2BCA1 for ; Sun, 9 Jun 2019 12:29:56 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 773C0208E4 for ; Sun, 9 Jun 2019 12:29:56 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1560083396; bh=V2I7JzBy6GpkLeFVFEd49U4hCJqclC8mWxGbOiPSGro=; h=Date:From:To:Cc:Subject:In-Reply-To:References:List-ID:From; b=IIBYpJ8oJp/1MVWcqHZfFfKi+d+nMCm+7d2U1HogmNYIoR90EPX1K4lE32ukCJLK6 2u4rgRb0ty5n/gbkDi2CBNI+/FmS35KRmYReGN2Y26NC9yYQ2aQokdt/Uf7upcGe06 eCNF3rVa4aaHOcUo6YVZMNKSWOWWVp6+bdIyf0G4= Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728189AbfFIM3w (ORCPT ); Sun, 9 Jun 2019 08:29:52 -0400 Received: from bombadil.infradead.org ([198.137.202.133]:47188 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726874AbfFIM3v (ORCPT ); Sun, 9 Jun 2019 08:29:51 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.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=IuqsoxISFrOZKKS3BhELU3uFgb2g53uAyNxYwZgCHEU=; b=DyEjWJ7vQLo8VkwXgyJHdBfxK GXjBapuN3ZK4cyYsNPgwtUt1PuGj2p1y4RKHqrLUVRgytFyHZPaeutkBpamadM5HQ2WZbx+0w0eBT hP1ZPe18WIxTRmIr7mzU6BkDpUDmqKwWWHXDMGhJn29QS+iAa5SRaoVvxOIsEg2gYqhhtGmA12xcI 3zsWJF7ZJ5C8SGXK2oQOuJrUQMFxQEqomlUY/lV8HR3Hb/1GoZ2NRafLYwtlBlj4QMywNtmHRvBoG SK4ufeZwOR6U8cJAB8e51GrzYN93/+3zpxzJIANm0n5cAqgkmLQLuv/KIsysCMJwlFNegGmuTOcn8 3H35bjE5A==; Received: from 179.176.115.133.dynamic.adsl.gvt.net.br ([179.176.115.133] helo=recife.lan) by bombadil.infradead.org with esmtpsa (Exim 4.92 #3 (Red Hat Linux)) id 1hZwxI-0002Wx-RD; Sun, 09 Jun 2019 12:29:49 +0000 Date: Sun, 9 Jun 2019 09:29:40 -0300 From: Mauro Carvalho Chehab To: Heiko Carstens Cc: Mauro Carvalho Chehab , Linux Doc Mailing List , linux-kernel@vger.kernel.org, Jonathan Corbet , Palmer Dabbelt , Albert Ou , Alexei Starovoitov , Daniel Borkmann , Martin KaFai Lau , Song Liu , Yonghong Song , Greentime Hu , Vincent Chen , linux-riscv@lists.infradead.org, netdev@vger.kernel.org, bpf@vger.kernel.org Subject: Re: [PATCH v3 00/33] Convert files to ReST - part 1 Message-ID: <20190609092940.5e34e3b0@recife.lan> In-Reply-To: <20190609091642.GA3705@osiris> References: <20190609091642.GA3705@osiris> 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: bpf-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: bpf@vger.kernel.org Em Sun, 9 Jun 2019 11:16:43 +0200 Heiko Carstens escreveu: > On Sat, Jun 08, 2019 at 11:26:50PM -0300, Mauro Carvalho Chehab wrote: > > This is the first part of a series I wrote sometime ago where I manually > > convert lots of files to be properly parsed by Sphinx as ReST files. > > > > As it touches on lot of stuff, this series is based on today's docs-next > > + linux-next, at tag next-20190607. > > > > I have right now about 85 patches with this undergoing work. That's > > because I opted to do ~1 patch per converted directory. > > > > That sounds too much to be send on a single round. So, I'm opting to split > > it on 3 parts. Those patches should probably be good to be merged > > either by subsystem maintainers or via the docs tree. > > > > I opted to mark new files not included yet to the main index.rst (directly or > > indirectly ) with the :orphan: tag, in order to avoid adding warnings to the > > build system. This should be removed after we find a "home" for all > > the converted files within the new document tree arrangement. > > > > Both this series and the next parts are on my devel git tree, > > at: > > > > https://git.linuxtv.org/mchehab/experimental.git/log/?h=convert_rst_renames_v4 > > > > The final output in html (after all patches I currently have, including > > the upcoming series) can be seen at: > > > > https://www.infradead.org/~mchehab/rst_conversion/ > > Will there be a web page (e.g. kernel.org), which contains always the > latest upstream version? Yes: https://www.kernel.org/doc/html/latest/ I guess this one is based on Linus tree. Jon also maintains a version at: https://static.lwn.net/kerneldoc/ I guess that one is based on docs-next branch from the Docs tree. Btw, if you want to build it for yourself, you could use: make htmldocs If your system doesn't have all dependencies, it will give the hints about how to install them. > > > docs: Debugging390.txt: convert table to ascii artwork > > docs: s390: convert docs to ReST and rename to *.rst > > s390: include/asm/debug.h add kerneldoc markups > > I can pick these up for s390. Or do you want to send the whole series > in one go upstream? Yeah, feel free to pick them via the s390 tree. Regards, Mauro Thanks, Mauro Thanks, Mauro From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.0 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, MAILING_LIST_MULTI,MENTIONS_GIT_HOSTING,SPF_HELO_NONE,SPF_PASS, T_DKIMWL_WL_HIGH autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id A8921C468BE for ; Sun, 9 Jun 2019 12:29:54 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 81ED62146E for ; Sun, 9 Jun 2019 12:29:54 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (2048-bit key) header.d=lists.infradead.org header.i=@lists.infradead.org header.b="ErqWco7z" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 81ED62146E Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-riscv-bounces+infradead-linux-riscv=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-ID:Subject:To:From:Date:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=uBReffpFbUbOvmLpSh4dG+8xiV9JbDoOsYRaAl6Mw2E=; b=ErqWco7zz7FTn9 dOYL/iZnp8Wed7wQycfjkSDsRMp7twdK2dgeOMo/M0PVpeOeKbYa9yjMSaJIZh2c/HtPfZE11AKvU 6aG9XfjlDkvcR8CIp3U6QF8dxvhlmKMe1hWL4U1jnFISM9ZXGULTF7GkPYxz972wfk4JRxM8onoPR 2kaRGXacW0iyX/sn/8k7mvW4pNWzbcJfS52+gJjLRb0WUfMtM1gSdz633VLlLgJRbQ4ADU5DkKmYr Qo9FkSVrsNRgSfxuqWU77hC9vQRAT9gWwCbvzz+7zw0QXDdymoyoF05fW+HTwIXAqvKk7kYlYPVnl Lro6+l4JxeFguGQWSvag==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.92 #3 (Red Hat Linux)) id 1hZwxL-0002kJ-MW; Sun, 09 Jun 2019 12:29:51 +0000 Received: from 179.176.115.133.dynamic.adsl.gvt.net.br ([179.176.115.133] helo=recife.lan) by bombadil.infradead.org with esmtpsa (Exim 4.92 #3 (Red Hat Linux)) id 1hZwxI-0002Wx-RD; Sun, 09 Jun 2019 12:29:49 +0000 Date: Sun, 9 Jun 2019 09:29:40 -0300 From: Mauro Carvalho Chehab To: Heiko Carstens Subject: Re: [PATCH v3 00/33] Convert files to ReST - part 1 Message-ID: <20190609092940.5e34e3b0@recife.lan> In-Reply-To: <20190609091642.GA3705@osiris> References: <20190609091642.GA3705@osiris> X-Mailer: Claws Mail 3.17.3 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 X-BeenThere: linux-riscv@lists.infradead.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Song Liu , Albert Ou , bpf@vger.kernel.org, Daniel Borkmann , Jonathan Corbet , netdev@vger.kernel.org, Palmer Dabbelt , Linux Doc Mailing List , linux-kernel@vger.kernel.org, Alexei Starovoitov , Greentime Hu , Mauro Carvalho Chehab , Yonghong Song , linux-riscv@lists.infradead.org, Vincent Chen , Martin KaFai Lau Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-riscv" Errors-To: linux-riscv-bounces+infradead-linux-riscv=archiver.kernel.org@lists.infradead.org Em Sun, 9 Jun 2019 11:16:43 +0200 Heiko Carstens escreveu: > On Sat, Jun 08, 2019 at 11:26:50PM -0300, Mauro Carvalho Chehab wrote: > > This is the first part of a series I wrote sometime ago where I manually > > convert lots of files to be properly parsed by Sphinx as ReST files. > > > > As it touches on lot of stuff, this series is based on today's docs-next > > + linux-next, at tag next-20190607. > > > > I have right now about 85 patches with this undergoing work. That's > > because I opted to do ~1 patch per converted directory. > > > > That sounds too much to be send on a single round. So, I'm opting to split > > it on 3 parts. Those patches should probably be good to be merged > > either by subsystem maintainers or via the docs tree. > > > > I opted to mark new files not included yet to the main index.rst (directly or > > indirectly ) with the :orphan: tag, in order to avoid adding warnings to the > > build system. This should be removed after we find a "home" for all > > the converted files within the new document tree arrangement. > > > > Both this series and the next parts are on my devel git tree, > > at: > > > > https://git.linuxtv.org/mchehab/experimental.git/log/?h=convert_rst_renames_v4 > > > > The final output in html (after all patches I currently have, including > > the upcoming series) can be seen at: > > > > https://www.infradead.org/~mchehab/rst_conversion/ > > Will there be a web page (e.g. kernel.org), which contains always the > latest upstream version? Yes: https://www.kernel.org/doc/html/latest/ I guess this one is based on Linus tree. Jon also maintains a version at: https://static.lwn.net/kerneldoc/ I guess that one is based on docs-next branch from the Docs tree. Btw, if you want to build it for yourself, you could use: make htmldocs If your system doesn't have all dependencies, it will give the hints about how to install them. > > > docs: Debugging390.txt: convert table to ascii artwork > > docs: s390: convert docs to ReST and rename to *.rst > > s390: include/asm/debug.h add kerneldoc markups > > I can pick these up for s390. Or do you want to send the whole series > in one go upstream? Yeah, feel free to pick them via the s390 tree. Regards, Mauro Thanks, Mauro Thanks, Mauro _______________________________________________ linux-riscv mailing list linux-riscv@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-riscv