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=-2.4 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_PASS, USER_AGENT_MUTT 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 101AEC00449 for ; Sat, 6 Oct 2018 02:10:55 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id C6B6B20834 for ; Sat, 6 Oct 2018 02:10:54 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=joelfernandes.org header.i=@joelfernandes.org header.b="HUDKFKd2" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org C6B6B20834 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=joelfernandes.org Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729355AbeJFJMT (ORCPT ); Sat, 6 Oct 2018 05:12:19 -0400 Received: from mail-pl1-f194.google.com ([209.85.214.194]:34900 "EHLO mail-pl1-f194.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726505AbeJFJMS (ORCPT ); Sat, 6 Oct 2018 05:12:18 -0400 Received: by mail-pl1-f194.google.com with SMTP id f8-v6so7599269plb.2 for ; Fri, 05 Oct 2018 19:10:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=joelfernandes.org; s=google; h=date:from:to:cc:subject:message-id:references:mime-version :content-disposition:in-reply-to:user-agent; bh=bUNYlJGIjGCvXIhJkr6hq8hpy2plvFlAxJEvKFZicn4=; b=HUDKFKd2BDUlgS9EjaxcsnmhwREO1EsmWNuxQkIXvqB3jJOXSAA90ALvLLHX3QeMKZ O1OuXvwASl056bQNQJyhkj89F2ACOPxAwhdErSeG5+jNcxWhjjGm+AP5okpHI2r3/dvG fqvhIVYedDW2WWGnzSloY/kUavtdoztb3NaOI= 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:user-agent; bh=bUNYlJGIjGCvXIhJkr6hq8hpy2plvFlAxJEvKFZicn4=; b=BIpdfkDPraKEhV/MxhjUi5UEDnokxTEvIelBhaKHvg5QRVKztwHTd1XF1i3n8A3LKL PFTPjymaWqDuIw+YIl2jTDUvVIZ3U1UahUL6LoeNQNE7fQLrAxaAdnXU1FTkAsWsOEkI TSx14vSPBjbj4H2mubVQEVhw322/JPRuGmfcHIAQWOqE7clRv9j83JGqtvZVTCi9NNI7 IxtQ9xJxDpRROoJmog5RIt9fULgQ7hTWyv7mv5dC41LrHlxWLiwYoN+605Wwcq9ytHyn saIYaLgeW4phMHwoh61ISGMJhKbx9B/csUamnQq43vn2O3HO3jp9QcfbgMNxjLfT85kb DHHQ== X-Gm-Message-State: ABuFfoitwZn9CNsoemyk5i2JJz2g/gRM7CHSgaJ+jOZsxbWh6isycLO3 uhhinFBIciotWte0dBMy5xjISg== X-Google-Smtp-Source: ACcGV60+h+dEZWUbI4bCflzMtoOsCG9AnaE0IYRTVx2+O9S9dEygMo2MTTwj38Awz/lvY3T0skPtEA== X-Received: by 2002:a17:902:5c4:: with SMTP id f62-v6mr1195640plf.18.1538791852337; Fri, 05 Oct 2018 19:10:52 -0700 (PDT) Received: from localhost ([2620:0:1000:1601:3aef:314f:b9ea:889f]) by smtp.gmail.com with ESMTPSA id l2-v6sm9146111pgp.20.2018.10.05.19.10.50 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Fri, 05 Oct 2018 19:10:51 -0700 (PDT) Date: Fri, 5 Oct 2018 19:10:50 -0700 From: Joel Fernandes To: "Paul E. McKenney" 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 Message-ID: <20181006021050.GC204532@joelaf.mtv.corp.google.com> References: <20181005231815.170433-1-joel@joelfernandes.org> <20181006001326.GL2674@linux.ibm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20181006001326.GL2674@linux.ibm.com> User-Agent: Mutt/1.10.1 (2018-07-13) 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 05:13:26PM -0700, Paul E. McKenney wrote: > 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? Yes I checked and it looks good, thanks! - Joel