Received: by 2002:ac0:a582:0:0:0:0:0 with SMTP id m2-v6csp1046839imm; Fri, 5 Oct 2018 17:13:56 -0700 (PDT) X-Google-Smtp-Source: ACcGV60ZcmZiuI9mMlEg1J8YPnNx1NsSIvYucCpjm9jlQWd0P3LDjF8wzaQmoE4JVyJgMbs/2VBj X-Received: by 2002:a62:c4c5:: with SMTP id h66-v6mr14260628pfk.39.1538784836868; Fri, 05 Oct 2018 17:13:56 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1538784836; cv=none; d=google.com; s=arc-20160816; b=mhcIn9mBXBSepUKIOpx7wnjF2ni6Js+sfbCBWt84pXHW6s6Dgrz2l7wWCVp7xNlZ+u Mto1kK2md3RbgbV7kLbN0sVgm3eaakPamJU4sTQG4ePp97s2DdblPOkosOOAmL91Kp3T e/t2B9WwflsG7AjYZcWOGIEdWuym19V3Lk//L65hl9U89YpG9HkbvLJICJBR3H8sVpZV frvAuhGWQbwNgETmMhQ02BrkjzCddabAcZQvQTfPDfcRqcWhJ9WxqA74366amMHRVuGi 3diHIFrW9Es/6yp09F8OURdr4Qmg4vxwnH0tXuJJ3RQk/xD/vCCXeyT70VUmWviIsry2 j2Xw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:message-id:user-agent:in-reply-to :content-disposition:mime-version:references:reply-to:subject:cc:to :from:date; bh=XQuwm1sOeki+8qhpmBUiwOt6qtdAIkPC5OEaUZsycZs=; b=aTmseujareUXQp0Hbj4N+J87CHOTl88IDdkHFYI0EvVQmGtfqugp29hzcea00NXqDS FohX0YLl0nyFHfBG1ZUKpWeNFPlt/RXSkJiOpCpTghZUue/EkY8FYLlaPI2Zruv4fZI/ WVPMI+t60QhLKFSznsymj06CtA4qojxwfyGuvaZxhaapLpV2lArzfjDQFRYLJp0uIJZ4 RwVMinBZTEzH9FYoBpRTI9Tsn3mCSpeIau/DQ7Qh8MKt9MPXqXds/cAg/LU/wC3ZVQAn HN87rziSHFY8CN4fK7zs68eAGJ5IcAbbxtEQQ+6j7w+xzOGn7vdZ36KTzbpxX9LCj9ps aXdw== 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; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id n15-v6si8664401pgk.103.2018.10.05.17.13.36; Fri, 05 Oct 2018 17:13:56 -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; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=ibm.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729116AbeJFHOi (ORCPT + 99 others); Sat, 6 Oct 2018 03:14:38 -0400 Received: from mx0b-001b2d01.pphosted.com ([148.163.158.5]:33654 "EHLO mx0a-001b2d01.pphosted.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1726505AbeJFHOi (ORCPT ); Sat, 6 Oct 2018 03:14:38 -0400 Received: from pps.filterd (m0098420.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w9608vvF127391 for ; Fri, 5 Oct 2018 20:13:31 -0400 Received: from e15.ny.us.ibm.com (e15.ny.us.ibm.com [129.33.205.205]) by mx0b-001b2d01.pphosted.com with ESMTP id 2mxf4sepyh-1 (version=TLSv1.2 cipher=AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 05 Oct 2018 20:13:31 -0400 Received: from localhost by e15.ny.us.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Fri, 5 Oct 2018 20:13:30 -0400 Received: from b01cxnp23034.gho.pok.ibm.com (9.57.198.29) by e15.ny.us.ibm.com (146.89.104.202) with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted; (version=TLSv1/SSLv3 cipher=AES256-GCM-SHA384 bits=256/256) Fri, 5 Oct 2018 20:13:27 -0400 Received: from b01ledav003.gho.pok.ibm.com (b01ledav003.gho.pok.ibm.com [9.57.199.108]) by b01cxnp23034.gho.pok.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id w960DQDS14876898 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Sat, 6 Oct 2018 00:13:26 GMT Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id CB301B206C; Fri, 5 Oct 2018 20:11:33 -0400 (EDT) Received: from b01ledav003.gho.pok.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id B5649B206E; Fri, 5 Oct 2018 20:11:33 -0400 (EDT) Received: from paulmck-ThinkPad-W541 (unknown [9.70.82.172]) by b01ledav003.gho.pok.ibm.com (Postfix) with ESMTP; Fri, 5 Oct 2018 20:11:33 -0400 (EDT) Received: by paulmck-ThinkPad-W541 (Postfix, from userid 1000) id CF05216C37CD; Fri, 5 Oct 2018 17:13:26 -0700 (PDT) Date: Fri, 5 Oct 2018 17:13:26 -0700 From: "Paul E. McKenney" To: "Joel Fernandes (Google)" Cc: linux-kernel@vger.kernel.org, Jonathan Corbet , Josh Triplett , Lai Jiangshan , linux-doc@vger.kernel.org, Mathieu Desnoyers , Steven Rostedt , pantin@google.com Subject: Re: [PATCH RFC 0/5] rcu doc updates for whatisRCU and checklist Reply-To: paulmck@linux.ibm.com References: <20181005231815.170433-1-joel@joelfernandes.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20181005231815.170433-1-joel@joelfernandes.org> User-Agent: Mutt/1.5.21 (2010-09-15) X-TM-AS-GCONF: 00 x-cbid: 18100600-0068-0000-0000-000003486AC7 X-IBM-SpamModules-Scores: X-IBM-SpamModules-Versions: BY=3.00009826; HX=3.00000242; KW=3.00000007; PH=3.00000004; SC=3.00000267; SDB=6.01098454; UDB=6.00568158; IPR=6.00878494; MB=3.00023634; MTD=3.00000008; XFM=3.00000015; UTC=2018-10-06 00:13:29 X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 18100600-0069-0000-0000-000045F9083E Message-Id: <20181006001326.GL2674@linux.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:,, definitions=2018-10-05_12:,, signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1807170000 definitions=main-1810060001 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Oct 05, 2018 at 04:18:09PM -0700, Joel Fernandes (Google) wrote: > Hi Paul, > > Here are this week's rcu doc updates based on combing through whatisRCU and > checklists. Hopefully you agree with them. I left several old _bh and _sched > API references as is, since I don't think its a good idea to remove them till > the APIs themselves are removed, however I did remove several of them as well > (like in the first patch in this series) since I feel its better to "encourage" > new users not to use the old API. > > Also do you think it makes sense for us to write coccinelle patches to check if > folks use them on new patches? Btw, I am new to coccinelle but I'd love to give > it a try, it looks exciting. I remember you saying you wanted to do that, so > that's something else you could potentially offload to me as you see fit ;-) > > Thank you very much! Good catches, applied and pushed, thank you! I updated the commit log and a couple of the patches a bit, so could you please double-check them? Thanx, Paul > Joel Fernandes (Google) (5): > doc: rcu: Update core and full API in whatisRCU > doc: rcu: Add more rationale for using rcu_read_lock_sched in > checklist > doc: rcu: Remove obsolete suggestion from checklist > doc: rcu: Remove obsolete checklist item about synchronize_rcu usage > doc: rcu: Encourage use of rcu_barrier in checklist > > Documentation/RCU/checklist.txt | 49 +++++++---------------------- > Documentation/RCU/whatisRCU.txt | 55 +++++++++++++++++---------------- > 2 files changed, 39 insertions(+), 65 deletions(-) > > -- > 2.19.0.605.g01d371f741-goog >