From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-5.7 required=5.0 tests=DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI, T_DKIM_INVALID autolearn=ham autolearn_force=no version=3.4.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id 8AECA7D87A for ; Wed, 29 Aug 2018 21:04:10 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1727859AbeH3BCt (ORCPT ); Wed, 29 Aug 2018 21:02:49 -0400 Received: from bombadil.infradead.org ([198.137.202.133]:52256 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727595AbeH3BCt (ORCPT ); Wed, 29 Aug 2018 21:02:49 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=In-Reply-To:Content-Type:MIME-Version :References:Message-ID:Subject:Cc:To:From:Date:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=y55IHZkqBenWSxLAokBXoxwcPJCN7xaIs0bfOip9KEc=; b=iEUXVHqPHQDirspJnE1EHvlkp hlNOZe3wV6Stupl5rGT1o5H6/L30hMwcqxQuuhHdaNHfoG+uX0OxefLxVe32FW2Q7Awg0UOVMMrvB 34iI9N2glxgPqqiGZq4C/1d/2IbTnQjjdXULqJLNkZXFtFFm0Xm4b3QLeyOmu7aPR88FbA08sPidu DHLD1q/rXP0uOSPctS+7cHxNM3uQOH7sCu/PUE1nX49qpg34UPzEDDOh0SO0z1kMH4f4P8SMS7SnW tGpALuz7N61/rAdZfJl9ocx1KH71ouJdKMJNbQYUFeLhGIULcj4B4v93iLzO0Hp574jy1u4TVxpfN cSp5NDaSA==; Received: from willy by bombadil.infradead.org with local (Exim 4.90_1 #2 (Red Hat Linux)) id 1fv7dE-0002HI-RM; Wed, 29 Aug 2018 21:04:04 +0000 Date: Wed, 29 Aug 2018 14:04:04 -0700 From: Matthew Wilcox To: "Paul E. McKenney" Cc: Andrew Morton , Waiman Long , Alexander Viro , Jonathan Corbet , linux-kernel@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-mm@kvack.org, linux-doc@vger.kernel.org, "Luis R. Rodriguez" , Kees Cook , Linus Torvalds , Jan Kara , Ingo Molnar , Miklos Szeredi , Larry Woodman , James Bottomley , "Wangkai (Kevin C)" , Michal Hocko Subject: Re: [PATCH 2/2] fs/dcache: Make negative dentries easier to be reclaimed Message-ID: <20180829210404.GA2925@bombadil.infradead.org> References: <1535476780-5773-1-git-send-email-longman@redhat.com> <1535476780-5773-3-git-send-email-longman@redhat.com> <20180828160150.9a45ee293c92708edb511eab@linux-foundation.org> <20180829175405.GA17337@linux.vnet.ibm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20180829175405.GA17337@linux.vnet.ibm.com> User-Agent: Mutt/1.9.2 (2017-12-15) Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Wed, Aug 29, 2018 at 10:54:05AM -0700, Paul E. McKenney wrote: > On Tue, Aug 28, 2018 at 04:01:50PM -0700, Andrew Morton wrote: > > People often use the term "the foo() function". I don't know why - > > just say "foo()"! > > For whatever it is worth... > > I tend to use "The foo() function ..." instead of "foo() ..." in order > to properly capitalize the first word of the sentence. So I might say > "The call_rcu() function enqueues an RCU callback." rather than something > like "call_rcu() enqueues an RCU callback." Or I might use some other > trick to keep "call_rcu()" from being the first word of the sentence. I tend to write 'Use call_rcu() to enqueue a callback." or "When call_rcu() returns, the callback will have been enqueued".