Received: by 2002:a25:ab43:0:0:0:0:0 with SMTP id u61csp1352783ybi; Fri, 14 Jun 2019 13:11:04 -0700 (PDT) X-Google-Smtp-Source: APXvYqxHHjddEAr4pLJYGqxakNMUICbcz5kTqzF0X3NP6SItckkjTGl5CRh8TMa2n3P1d/9uVVZ5 X-Received: by 2002:a17:90a:dd42:: with SMTP id u2mr12944271pjv.118.1560543064691; Fri, 14 Jun 2019 13:11:04 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1560543064; cv=none; d=google.com; s=arc-20160816; b=tfkMFr+GKIFs/WAicXoThvxh0CXThmw8kZPEBbw67uBWA9g69CSgaLfnPW6mrLpn9v mAyeuyKtsjXNrZwa+A0Wmbbej4vXi0E22grsoroAmi4G9Ua7Lln69kJvr7YJ5sx+apsB sp4lLryt59XjadeLdRKM74N5msOjXYu9IO5DZWCiAzWGSplix9sMotoSJV/EoHf8TvMB sMIAcrcKyZuYlTmvDzAdNtnqRz3YnmlUnMcBSuL6EhUk/8gdGkQuCUsCtXjdtUrjK7jw oQH0doJQgcgusJwb6rfX+7u1llRNqqPTwK10HgZjAAkE9w0AEk2iCl/BwEUhcNMl4bO+ IwMQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date; bh=RvYUapyk5pTDDXtlNqyQ7Hh3UxcOtM9UFEzr6R5VMSo=; b=z3CJbVqp5WnXho+eWCsLfzhfIOGJ0Xz1v7NjPL7qHewdlOeLLKuOgXnuvk3uoZzYjb OL0vLZWZD6RONU8hJL3CWsSksG1EYmtNRxEmxIM5yxUlGwDdMsjnYd9trL9GHZiYgk6f ZLIQOv2bsQdYJeXF3a8y5/dW/JjbFQow4ssUPsPdhNWHagNqtosSdXwdpBIbh02cAIbE jSBmbZdF4uAuq5nXG26NKUfoP1kNxggxgwB97geysrRKI0/se8Kl5SrjdWvr++NxmVHV b+18VmjevW7MDErKM9bgjE8+fW/9brxh9k+1hjdIFabTyWmEhf8jMYss3H7TMUi3eq+4 6lfg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id w17si3460913pfj.69.2019.06.14.13.10.49; Fri, 14 Jun 2019 13:11:04 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726072AbfFNUKo (ORCPT + 99 others); Fri, 14 Jun 2019 16:10:44 -0400 Received: from ms.lwn.net ([45.79.88.28]:53872 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725802AbfFNUKn (ORCPT ); Fri, 14 Jun 2019 16:10:43 -0400 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id 8A9C6128A; Fri, 14 Jun 2019 20:10:42 +0000 (UTC) Date: Fri, 14 Jun 2019 14:10:41 -0600 From: Jonathan Corbet To: Mauro Carvalho Chehab Cc: Linux Doc Mailing List , Mauro Carvalho Chehab , linux-kernel@vger.kernel.org, Catalin Marinas , Will Deacon , Harry Wei , Alex Shi , Paolo Bonzini , Radim =?UTF-8?B?S3LEjW3DocWZ?= , Ard Biesheuvel , linux-arm-kernel@lists.infradead.org, kvm@vger.kernel.org, linux-efi@vger.kernel.org Subject: Re: [PATCH v4 02/28] docs: arm64: convert docs to ReST and rename to .rst Message-ID: <20190614141041.335a76e5@lwn.net> In-Reply-To: <8320e8e871660bf9fc426bc688f4808a1a7aa031.1560361364.git.mchehab+samsung@kernel.org> References: <8320e8e871660bf9fc426bc688f4808a1a7aa031.1560361364.git.mchehab+samsung@kernel.org> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Wed, 12 Jun 2019 14:52:38 -0300 Mauro Carvalho Chehab wrote: > The documentation is in a format that is very close to ReST format. > > The conversion is actually: > - add blank lines in order to identify paragraphs; > - fixing tables markups; > - adding some lists markups; > - marking literal blocks; > - adjust some title markups. > > At its new index.rst, let's add a :orphan: while this is not linked to > the main index.rst file, in order to avoid build warnings. This one doesn't apply to docs-next, since there's a bunch of stuff in linux-next that I don't have. I'd suggest that it either go by way of an ARM tree or send it my way again after the ARM changes go upstream. Thanks, jon