Received: by 2002:ac0:98c7:0:0:0:0:0 with SMTP id g7-v6csp3796391imd; Mon, 29 Oct 2018 12:30:45 -0700 (PDT) X-Google-Smtp-Source: AJdET5eN6Hgus3dVio462TRqwstgOcBULUNHJ6X+JuHiUGN+M4JSpjadPe72TW5OcAkVCD5Wr+p0 X-Received: by 2002:a62:ab05:: with SMTP id p5-v6mr16453982pff.211.1540841445150; Mon, 29 Oct 2018 12:30:45 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1540841445; cv=none; d=google.com; s=arc-20160816; b=Cyqcv7fmkU8tEozKHUEtF+BE3c1qML3HGeGW16Jr9BmVWIdVbjzna6lmMlGVUnyg7C fPtg09vspTgiX5wHTzeSoqPYlIQCIo8XTOWx3I5obCXc+qGqlF1EC2fIhjChkzm93vjs Nvk11v9oYhWtESrvDohO3T532zTuXYVQbb0rdcoep63BYbEqsDvtJTBdM1/h293ozxeK 3Ea4XDtTI3f72ctV2bwO7OMJDe9168hAZOyY/FqICbI3vDodpaRGXYglCFuFH/EdA2kq HnVNTVaRiZ+lfN1srtD7H8aK24+vDuS/aF0s3f6c7XsDVE14KJtBHBuB6SzXhZ7L0jri mVAQ== 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 :content-language:in-reply-to:mime-version:user-agent:date :message-id:from:references:cc:to:subject:dkim-signature; bh=JBSrFj3O8LNxKuKz0PuGBw2F7O3AoE7ZdTVHGW8CSiY=; b=gKNPnZggq+yUIzO4CMESzfwaaWwT2gvcyCSMmqw53OrXyHPmuLaY0y1KjAJm+1QilN ajMwGzVnPAsiKE07pQUSFBapcBfG0bs+3GqQP37BYYVyluDthL0wUbeuwPJGQC0l95kj e4ap9I8yKBrh+Ei2zvX7gGAITpVXDEe+9Vj8IdEOv5UBri6YphsYVYlSTWGvr+BTHhkL QbsGlocmWkGzkzAGqc3EauWENW/4cvoo7VefDk+MwZvmmioNeSCuooVEJ5nZ9YMRGOJw wCzQMwN2V6veFRYY8rHWHDtZFMtQJc9tyGsI/U7i9jbdBLPIElHu/aq01cgUlb/1tRzg XEFA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=TSDfw0Ow; 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; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id 62-v6si5617542ply.423.2018.10.29.12.30.29; Mon, 29 Oct 2018 12:30:45 -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; dkim=pass header.i=@gmail.com header.s=20161025 header.b=TSDfw0Ow; 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; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729537AbeJ3ESV (ORCPT + 99 others); Tue, 30 Oct 2018 00:18:21 -0400 Received: from mail-lf1-f66.google.com ([209.85.167.66]:44091 "EHLO mail-lf1-f66.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1725781AbeJ3ESV (ORCPT ); Tue, 30 Oct 2018 00:18:21 -0400 Received: by mail-lf1-f66.google.com with SMTP id m18-v6so6970204lfl.11; Mon, 29 Oct 2018 12:28:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=JBSrFj3O8LNxKuKz0PuGBw2F7O3AoE7ZdTVHGW8CSiY=; b=TSDfw0OwfQAxcJlmIY4nTIl82Mq5rMVwdxCZlwAdBeMTudjDeD9iJJbL/9RhCo9l3P HSS6FkT1lOYQ3Xj58CO8ytl256mDUEL3BGe8ACR7uLgehvE0MXI4twNXrDNm2DTywOTx XPZjdrqRLtnQk/0IFoJUWqNX8WgOyoOx/zIvknXmL/iElmRszdVGB1YXd859CrWLiJiv mN0gT32pyVB0wYD0A18Yeuq5gUB/FfNOu+Ah03yx8KXlHLapFRnvYi+KUbwECd8o/r18 31JWo/tdOYt/90PiBmmp1ckmo6drXEE+xgGwYiznNSfajbnqVgdgJEK3CIgw+LjsZL2m nJ6Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=JBSrFj3O8LNxKuKz0PuGBw2F7O3AoE7ZdTVHGW8CSiY=; b=TXlBuLvQggYDg5Dc8lNQ9KqnufmMXzs6LRK7P1QA0OwMzOdYoMIj0eBTn/v6jmXp2Z GdGX/gVsZqdQ5aS/ffrK92VTK+ITKjK3N8xrYBaPzqxqaB4Xjekd6gwsgB0b4Nq4x6OL 54XE02R22rMoEue9uxYvJPBVWrm1fSk52/rMIMmaOLXZbXZLGKBfAIfm1a9VagbPw1pD hvs3L0vozZRwti/sz4sxoiuT3Ih34Qj//CI0s4t7AtUnd5tqjLuOovWxX3JuIhXYHMv8 3x+vvep5ca6SYsAehBqzQT4ubeLA0eShzz+O6ex9qFyKRvse9yKnytoX/xss4mB1CXHX PEXQ== X-Gm-Message-State: AGRZ1gJtdgdaE+or3D8//pPbGOREaaO4+mUl/BN5P2ilxlSwowGc0peR djrePV70989xGt4DgCem6bkcXzQMOjI= X-Received: by 2002:a19:978c:: with SMTP id z134mr7232lfd.109.1540841295393; Mon, 29 Oct 2018 12:28:15 -0700 (PDT) Received: from ?IPv6:2001:14bb:52:7be:f0bf:dd2d:f008:5213? (dmkd798g-7z2-yccwcp-4.rev.dnainternet.fi. [2001:14bb:52:7be:f0bf:dd2d:f008:5213]) by smtp.gmail.com with ESMTPSA id 75-v6sm1136016ljs.50.2018.10.29.12.28.13 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 29 Oct 2018 12:28:14 -0700 (PDT) Subject: Re: [PATCH 10/17] prmem: documentation To: Matthew Wilcox , Peter Zijlstra Cc: Mimi Zohar , Kees Cook , Dave Chinner , James Morris , Michal Hocko , kernel-hardening@lists.openwall.com, linux-integrity@vger.kernel.org, linux-security-module@vger.kernel.org, igor.stoppa@huawei.com, Dave Hansen , Jonathan Corbet , Laura Abbott , Randy Dunlap , Mike Rapoport , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org References: <20181023213504.28905-1-igor.stoppa@huawei.com> <20181023213504.28905-11-igor.stoppa@huawei.com> <20181026092609.GB3159@worktop.c.hoisthospitality.com> <20181026102009.GP25444@bombadil.infradead.org> From: Igor Stoppa Message-ID: <6f554454-ab8c-92be-a2b5-543e609dc351@gmail.com> Date: Mon, 29 Oct 2018 21:28:12 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.2.1 MIME-Version: 1.0 In-Reply-To: <20181026102009.GP25444@bombadil.infradead.org> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 26/10/2018 11:20, Matthew Wilcox wrote: > On Fri, Oct 26, 2018 at 11:26:09AM +0200, Peter Zijlstra wrote: >> Jon, >> >> So the below document is a prime example for why I think RST sucks. As a >> text document readability is greatly diminished by all the markup >> nonsense. >> >> This stuff should not become write-only content like html and other >> gunk. The actual text file is still the primary means of reading this. > > I think Igor neglected to read doc-guide/sphinx.rst: Guilty as charged :-/ > Specific guidelines for the kernel documentation > ------------------------------------------------ > > Here are some specific guidelines for the kernel documentation: > > * Please don't go overboard with reStructuredText markup. Keep it > simple. For the most part the documentation should be plain text with > just enough consistency in formatting that it can be converted to > other formats. > I agree that it's overly marked up. I'll fix it -- igor