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=-13.8 required=3.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS 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 D565DC433DB for ; Tue, 23 Mar 2021 07:28:01 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 168FC619BB for ; Tue, 23 Mar 2021 07:28:00 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 168FC619BB Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linux.ibm.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 286F56B00FF; Tue, 23 Mar 2021 03:28:00 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 25C996B0101; Tue, 23 Mar 2021 03:28:00 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 0FE866B0107; Tue, 23 Mar 2021 03:28:00 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0062.hostedemail.com [216.40.44.62]) by kanga.kvack.org (Postfix) with ESMTP id E67F36B00FF for ; Tue, 23 Mar 2021 03:27:59 -0400 (EDT) Received: from smtpin32.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay04.hostedemail.com (Postfix) with ESMTP id 9AABD1DF2 for ; Tue, 23 Mar 2021 07:27:59 +0000 (UTC) X-FDA: 77950309878.32.A9DC98A Received: from mx0a-001b2d01.pphosted.com (mx0b-001b2d01.pphosted.com [148.163.158.5]) by imf01.hostedemail.com (Postfix) with ESMTP id 9DA825001528 for ; Tue, 23 Mar 2021 07:27:58 +0000 (UTC) Received: from pps.filterd (m0098419.ppops.net [127.0.0.1]) by mx0b-001b2d01.pphosted.com (8.16.0.43/8.16.0.43) with SMTP id 12N73mH0138602; Tue, 23 Mar 2021 03:27:50 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=date : from : to : cc : subject : message-id : references : mime-version : content-type : in-reply-to; s=pp1; bh=RiU7OaAejRFyLq5g2GXCFoSZkUM9W2r4kcger7vGJt8=; b=hY3/0iCYpdAotsHwwrumTSB0SlOMOsYyA9wckTg2QEsWRCKzWhqczIYXY4H2d6kX2SXk ove4w4rXc9pSrwfZsR4Hsr7JZ+FW/fFWxTyv4yP2g0KXbJuuN1AAke4a/lFu3CMWoa/P gWp0ZB5cGvLTmuzoXiSsKBMmmgTi5tp9JhNk6Zd65n0XGwhx31KTZwd/h4mxQADN5/xA FMZYqfzL4p5xMujwRyhGNiC+ruFaAFTe8mnrZw15jlt5efjBp6013Ra8s9TMI6rbbUna pHdzneXdGRw20rvvnl6f6mGpNlspPNWqgo3p9F8PZaFoH1G1/YHvHH6w37YqHit7KzDv sw== Received: from ppma03ams.nl.ibm.com (62.31.33a9.ip4.static.sl-reverse.com [169.51.49.98]) by mx0b-001b2d01.pphosted.com with ESMTP id 37effma6wb-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 23 Mar 2021 03:27:50 -0400 Received: from pps.filterd (ppma03ams.nl.ibm.com [127.0.0.1]) by ppma03ams.nl.ibm.com (8.16.0.43/8.16.0.43) with SMTP id 12N7NT45022127; Tue, 23 Mar 2021 07:27:48 GMT Received: from b06avi18626390.portsmouth.uk.ibm.com (b06avi18626390.portsmouth.uk.ibm.com [9.149.26.192]) by ppma03ams.nl.ibm.com with ESMTP id 37df68ap5t-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Tue, 23 Mar 2021 07:27:48 +0000 Received: from b06wcsmtp001.portsmouth.uk.ibm.com (b06wcsmtp001.portsmouth.uk.ibm.com [9.149.105.160]) by b06avi18626390.portsmouth.uk.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id 12N7RSDx25690458 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Tue, 23 Mar 2021 07:27:28 GMT Received: from b06wcsmtp001.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 0E58EA4054; Tue, 23 Mar 2021 07:27:46 +0000 (GMT) Received: from b06wcsmtp001.portsmouth.uk.ibm.com (unknown [127.0.0.1]) by IMSVA (Postfix) with ESMTP id 50181A4060; Tue, 23 Mar 2021 07:27:45 +0000 (GMT) Received: from linux.ibm.com (unknown [9.145.165.64]) by b06wcsmtp001.portsmouth.uk.ibm.com (Postfix) with ESMTPS; Tue, 23 Mar 2021 07:27:45 +0000 (GMT) Date: Tue, 23 Mar 2021 09:27:43 +0200 From: Mike Rapoport To: "Matthew Wilcox (Oracle)" Cc: linux-mm@kvack.org, Andrew Morton , linux-doc@vger.kernel.org, John Hubbard Subject: Re: [PATCH 1/4] mm/doc: Fix fault_flag_allow_retry_first kerneldoc Message-ID: References: <20210322195022.2143603-1-willy@infradead.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20210322195022.2143603-1-willy@infradead.org> X-TM-AS-GCONF: 00 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.369,18.0.761 definitions=2021-03-23_02:2021-03-22,2021-03-23 signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 bulkscore=0 lowpriorityscore=0 mlxlogscore=849 spamscore=0 adultscore=0 clxscore=1011 suspectscore=0 malwarescore=0 priorityscore=1501 impostorscore=0 mlxscore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2009150000 definitions=main-2103230044 X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 9DA825001528 X-Stat-Signature: dtuup3jfprqm94yjhr9ieonc3wjpsqq7 Received-SPF: none (linux.ibm.com>: No applicable sender policy available) receiver=imf01; identity=mailfrom; envelope-from=""; helo=mx0a-001b2d01.pphosted.com; client-ip=148.163.158.5 X-HE-DKIM-Result: pass/pass X-HE-Tag: 1616484478-698809 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: On Mon, Mar 22, 2021 at 07:50:19PM +0000, Matthew Wilcox (Oracle) wrote: > make htmldocs reports: > > ./include/linux/mm.h:496: warning: Function parameter or member 'flags' not described in 'fault_flag_allow_retry_first' > > Add a description. > > Signed-off-by: Matthew Wilcox (Oracle) Acked-by: Mike Rapoport > --- > include/linux/mm.h | 1 + > 1 file changed, 1 insertion(+) > > diff --git a/include/linux/mm.h b/include/linux/mm.h > index cb1e191da319..9c149e945bf9 100644 > --- a/include/linux/mm.h > +++ b/include/linux/mm.h > @@ -482,6 +482,7 @@ extern pgprot_t protection_map[16]; > > /** > * fault_flag_allow_retry_first - check ALLOW_RETRY the first time > + * @flags: Fault flags. > * > * This is mostly used for places where we want to try to avoid taking > * the mmap_lock for too long a time when waiting for another condition > -- > 2.30.2 > -- Sincerely yours, Mike.