Received: by 2002:a05:6a10:206:0:0:0:0 with SMTP id 6csp280344pxj; Wed, 26 May 2021 23:14:08 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwtCPad432AAj1TEkdPzjTmgkwlqUXol2BbGJLFYyjrXKJI4cB0SPImCXn4Sv305dL2QMOi X-Received: by 2002:a05:6402:518:: with SMTP id m24mr2286071edv.133.1622096048255; Wed, 26 May 2021 23:14:08 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1622096048; cv=none; d=google.com; s=arc-20160816; b=RNWMzFopj/CQW5dcHgn4+6WkdcNuMrCl4ojBpkoulHmdpfgusC0VSx1w7KKIL5fiB9 v6RS1x8uB66gRUy8/gWM0n3E8dPXd3zBtv1w8PRgID1VY/cL0FES7uayNMc6nRTPk1XK NVhrR9kotnAy+0/+zDCgZN1f22kVruK+xZtwTZgBh6vDfeu/8fHFLpM8G/lOibTt8eLR /2zgG28IgPZ25XP7HJtFj5EcvAWkDIRSS7bYngnKuzxeJS/u86Lq9A3r7iZMmVtxJ4T3 JMUpx/qiNoEf5mtr4EfGLNZvsBv+8nX3t3LpoazUBxiRFWY5ymgoUiB3Z5JxFMyXYcTm zpKw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature; bh=w3LWi3pqlr3B4AlunE4XQO/yKeeRdh+JIp87c9hiyZo=; b=GYAyyW7169SADoexUxvz5qOpFVDQvAEMrkSG2JSV0h6jcWAAw0Cv/bPRDtEEBILBtJ OY7NR4nIBim4/872cbKlLfYAaaR2dZ4h9DfMkeDwNcxmvpnesm9vtehYne//N2mJakNm EDltZTNyWqgZiltvm+8VlbkyQsaabUDpl2nUVn4iZadgbqlC2tRkJTxcF3jc/+HioboT LW6WyiQsc765RofwlLc6KtIPsoxRLmaT69C/dHFkJC41J9419oE5yHZkPS4FsJZ8PsYx XvpTelEyaumaO7X4haU6+igT/F+VeTfho7XQbHBs8I127WWLFK1tVVpFUwQ5rmpmmoDp CI+w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=ISi8Q4CD; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 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. [23.128.96.18]) by mx.google.com with ESMTP id z16si15387edm.391.2021.05.26.23.13.44; Wed, 26 May 2021 23:14:08 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=ISi8Q4CD; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 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 S233099AbhE0Dcg (ORCPT + 99 others); Wed, 26 May 2021 23:32:36 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39914 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233717AbhE0Dce (ORCPT ); Wed, 26 May 2021 23:32:34 -0400 Received: from mail-io1-xd35.google.com (mail-io1-xd35.google.com [IPv6:2607:f8b0:4864:20::d35]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D3DEFC061574; Wed, 26 May 2021 20:31:00 -0700 (PDT) Received: by mail-io1-xd35.google.com with SMTP id k22so3358900ioa.9; Wed, 26 May 2021 20:31:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to; bh=w3LWi3pqlr3B4AlunE4XQO/yKeeRdh+JIp87c9hiyZo=; b=ISi8Q4CD6rbdfXzcoV0mi4T5raNiBIUZIsyxFzTMz6b+efBYqUsq59GLd5/jhvGeJY u3TJrU0zcb6Y10Y1XLDZjeWTQnUONB1tYT9PJPRSGqN88Jfflqx9XhUeOpz9M052KnVN WOWEuqQJH3/OfeSu4o6ENGoQb4rnYN1PGrbtV30P4OqgpAR9PnHvKxllz6CGc/VqdQ0t ZsHa/+tvfv4yZ474fYuLGvasWhlaLCo5hOwFIE5FDEEvSlBjIaPRW8hS6yuge8stWqmW J0JQp2/bA7Ni73i8ZWqP5KLFQI8Fl19WON2VYEEXaerQYHeWpq6/YXFGKYrgTXA+C2/s IVeA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:references :mime-version:content-disposition:in-reply-to; bh=w3LWi3pqlr3B4AlunE4XQO/yKeeRdh+JIp87c9hiyZo=; b=qWpK5gFWU5JYXJ3+UT+VQIIVJ26ZRH0oBCKyCS8pvJOSSdtvKGgKPAGI5T3TuQfutL Xnc2TwuTIp5fvDNAGtvubkmJidF5G+FkNG+xkLHYDyEGjnD1jfvuoeXoG9t+3uDfqXZc FLZyeBcNi91HoUbIITCOSlFm1UbRnj40uwomH5rkGD1bwSGWsQr9dHRqZcQI1S5qejk+ gVX9DLTR3dFssFwUodPhzt69XquxZTxKHDF8tAJLnytod+R/VTaVRpAAXFcMT7G7vGVl Ij2Izw7IFGlcn3yIEhgde1MG1Z9X3IqRA2//mtWcJ4CgPscf0M2jNgxX2PN0pXaWdcep fYlw== X-Gm-Message-State: AOAM531x9tuTST8cmj6Ch/a8egYqSCAyQ1MqOGoYLAln5X72dJIR8MYg B2EO+ea4P/sk3pANP4WioVo= X-Received: by 2002:a05:6602:1212:: with SMTP id y18mr1199110iot.189.1622086260183; Wed, 26 May 2021 20:31:00 -0700 (PDT) Received: from auth1-smtp.messagingengine.com (auth1-smtp.messagingengine.com. [66.111.4.227]) by smtp.gmail.com with ESMTPSA id n5sm492754ilq.14.2021.05.26.20.30.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 26 May 2021 20:30:59 -0700 (PDT) Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailauth.nyi.internal (Postfix) with ESMTP id AA47827C0054; Wed, 26 May 2021 23:30:58 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute5.internal (MEProxy); Wed, 26 May 2021 23:30:58 -0400 X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduledrvdekgedgieelucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucenucfjughrpeffhffvuffkfhggtggujgesthdtre dttddtvdenucfhrhhomhepuehoqhhunhcuhfgvnhhguceosghoqhhunhdrfhgvnhhgsehg mhgrihhlrdgtohhmqeenucggtffrrghtthgvrhhnpedvleeigedugfegveejhfejveeuve eiteejieekvdfgjeefudehfefhgfegvdegjeenucfkphepudefuddruddtjedruddrvdeh geenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhepmhgrihhlfhhrohhmpegsoh hquhhnodhmvghsmhhtphgruhhthhhpvghrshhonhgrlhhithihqdeiledvgeehtdeigedq udejjeekheehhedvqdgsohhquhhnrdhfvghngheppehgmhgrihhlrdgtohhmsehfihigmh gvrdhnrghmvg X-ME-Proxy: Received: from localhost (unknown [131.107.1.254]) by mail.messagingengine.com (Postfix) with ESMTPA; Wed, 26 May 2021 23:30:57 -0400 (EDT) Date: Thu, 27 May 2021 11:30:14 +0800 From: Boqun Feng To: Xiongwei Song Cc: peterz@infradead.org, mingo@redhat.com, will@kernel.org, longman@redhat.com, corbet@lwn.net, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Xiongwei Song Subject: Re: [PATCH] docs: lockdep-design: improve readability of the block matrix Message-ID: References: <1621868745-23311-1-git-send-email-sxwjean@me.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1621868745-23311-1-git-send-email-sxwjean@me.com> Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, May 24, 2021 at 11:05:45PM +0800, Xiongwei Song wrote: > From: Xiongwei Song > > The block condition matrix is using 'E' as the writer notation, however, > the writer reminder below the matrix is using 'W', to make them consistent > and make the matrix more readable, we'd better to use 'W' to represent > writer. > > Suggested-by: Waiman Long > Suggested-by: Boqun Feng > Signed-off-by: Xiongwei Song Reviewed-by: Boqun Feng Regards, Boqun > --- > Documentation/locking/lockdep-design.rst | 4 ++-- > 1 file changed, 2 insertions(+), 2 deletions(-) > > diff --git a/Documentation/locking/lockdep-design.rst b/Documentation/locking/lockdep-design.rst > index 9f3cfca..82f36ca 100644 > --- a/Documentation/locking/lockdep-design.rst > +++ b/Documentation/locking/lockdep-design.rst > @@ -453,9 +453,9 @@ There are simply four block conditions: > Block condition matrix, Y means the row blocks the column, and N means otherwise. > > +---+---+---+---+ > - | | E | r | R | > + | | W | r | R | > +---+---+---+---+ > - | E | Y | Y | Y | > + | W | Y | Y | Y | > +---+---+---+---+ > | r | Y | Y | N | > +---+---+---+---+ > -- > 2.7.4 >