Received: by 2002:ac0:a5b6:0:0:0:0:0 with SMTP id m51-v6csp3220205imm; Tue, 29 May 2018 03:24:58 -0700 (PDT) X-Google-Smtp-Source: AB8JxZokZ9AisN20QsnJgXjttU91h4cqcxJJsPcbViaqc7tfe4QEmp11qn9zVPjP8UKAHUv0b516 X-Received: by 2002:a17:902:3081:: with SMTP id v1-v6mr17408959plb.266.1527589498249; Tue, 29 May 2018 03:24:58 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1527589498; cv=none; d=google.com; s=arc-20160816; b=V3oYDbX1SnoAfEyU5O4AJ4Bu8qHp44DNvIj2POYQXLiPLSQkHn/S4BPxCntw7zWpXV nvaDjZpsgkFb8Zp0S9xLJAdAh/R5gWV/NohOhOjg9YGBLqdf1SN5GwzbrIyBHruKXP/m TU6XiEUKEIsBLS2vKIGV67DwD1QeN3uw9EDH4A2YLpw1XWKBuXTVPRHbMIbRNHrB2E0I hfh352iUHJoyNoOm1Ze1ZnK+vu3974EPgMAqBsqt7UZf0mGhbq/sP0eaK4RM9+ObfY1Y 4fMoHm6YkPmXszWgyX6/7Ebi8wIh6OdAQM+nZtHmh9D4AY3rEHba8VCfB7l+sfSZtwjC EnFw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:in-reply-to :content-disposition:mime-version:references:message-id:subject:cc :to:from:date:arc-authentication-results; bh=Wb582MidCFQLEGRlRz5tZmDTuRIWE/rmDPGOa9jv1Ek=; b=SnWkg2yNMsGSEJZSMO5W6SL/duIp9m5OjtMa+rU3r9BaEhUF3Hxi+pRtYOLTe2rgv6 ht+pTXTaX4BsvK6H/BOYLEcCAPFswVMWN6BZGvYCoALJXqTVhWs1QArfiu7YpYhPeWSI nUVz6RCdNod99xs/IZfCmfj7KtE/MYCvrqXM67POUXqWtdXdN3XpH9pGx4Frl3ID2JMJ Jzn7pf22jrdIyBPn4dEVrsUMc0R27OrsmXxGhzWtRYL0dlXX2gjCnZFKy7NJJUkzCv+B y1GZHAvfkf19YbDnRfki+cRufu7ByfqTYUUMetKEATAKRTcZIj6iEqvZgFmnqOlpEqGl WX+g== 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 Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id 91-v6si31795953ply.55.2018.05.29.03.24.44; Tue, 29 May 2018 03:24:58 -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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S933105AbeE2KXA (ORCPT + 99 others); Tue, 29 May 2018 06:23:00 -0400 Received: from ipmail06.adl2.internode.on.net ([150.101.137.129]:61807 "EHLO ipmail06.adl2.internode.on.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S932476AbeE2KWT (ORCPT ); Tue, 29 May 2018 06:22:19 -0400 Received: from ppp59-167-129-252.static.internode.on.net (HELO dastard) ([59.167.129.252]) by ipmail06.adl2.internode.on.net with ESMTP; 29 May 2018 19:52:17 +0930 Received: from dave by dastard with local (Exim 4.80) (envelope-from ) id 1fNblf-0008PL-KQ; Tue, 29 May 2018 20:22:15 +1000 Date: Tue, 29 May 2018 20:22:15 +1000 From: Dave Chinner To: Michal Hocko Cc: Jonathan Corbet , Randy Dunlap , Mike Rapoport , LKML , linux-fsdevel@vger.kernel.org, linux-mm@kvack.org, Michal Hocko Subject: Re: [PATCH v2] doc: document scope NOFS, NOIO APIs Message-ID: <20180529102215.GL23861@dastard> References: <20180524114341.1101-1-mhocko@kernel.org> <20180529082644.26192-1-mhocko@kernel.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20180529082644.26192-1-mhocko@kernel.org> User-Agent: Mutt/1.5.21 (2010-09-15) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, May 29, 2018 at 10:26:44AM +0200, Michal Hocko wrote: > From: Michal Hocko > > Although the api is documented in the source code Ted has pointed out > that there is no mention in the core-api Documentation and there are > people looking there to find answers how to use a specific API. > > Changes since v1 > - add kerneldoc for the api - suggested by Johnatan > - review feedback from Dave and Johnatan > - feedback from Dave about more general critical context rather than > locking > - feedback from Mike > - typo fixed - Randy, Dave > > Requested-by: "Theodore Y. Ts'o" > Signed-off-by: Michal Hocko We could bikeshed forever about the exact wording, but it covers everything I think needs to be documented. Reviewed-by: Dave Chinner -- Dave Chinner david@fromorbit.com