Received: by 2002:a05:6358:4e97:b0:b3:742d:4702 with SMTP id ce23csp2148770rwb; Sun, 14 Aug 2022 22:50:01 -0700 (PDT) X-Google-Smtp-Source: AA6agR4kzzRiNjAmy+5r/wO1p2zCkIaG2s2mfjIYA3HLIQoDi/9isewVN7NApw5eeV2t9Zb/eEO8 X-Received: by 2002:a17:907:6297:b0:72f:9aad:fcb with SMTP id nd23-20020a170907629700b0072f9aad0fcbmr9179988ejc.161.1660542601527; Sun, 14 Aug 2022 22:50:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1660542601; cv=none; d=google.com; s=arc-20160816; b=Jo0H6MSN/g3+twXqXdyNCtPIST+GwwO26i+68GOVRGo1M73Puzmr+VZTsrZmOaoESK mzPJqhMAMJCVhjA0lYRsjh415W1Ow4C3jmF+WN9yjGfObzAgTz3dQ68A5hYm4+kRbEc8 0QRRgZjmuCKC2B8JkXuA5SS3OBhrtKZtVjAJP9dPkp/mHH431ZNSeOTB/ZRQrVQuNqMH xvjZvXnAXfocfFyL5bmCBAXkecraCUDF/JWI6w8lbpCKeYb42WgU5u74U4AQHCZ33tjM d2qNR1C9v4qfyRApLjvVVNug99B15+FqC65p3HNLTkM3UceyHIdq6K/KlQcXoL0TUy1+ DVzg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=wKWYqqvfyZhCo8rx0GflUCC7bXqVIzbn+2HAgKCz4ys=; b=MIvMZFEs/eBF2Xqy0J62pN9cMmg7howg6zETJ/m0fqtzsOgsLGhEGt80iCnBQrjBaG YFOn3cyWr700YSGZ/U8DdObqoqfxkQdAKK9/kX8AWEdBB5MMFu+fOL4i4FZlGrhuYtOm cvT7ATgzoYpbcxR8qP7ZMlNABu48DsjqSlWuliBb5MGeiVsgo+rwMCKSktkxGdriuerV ZaJMdZDbXvrJQx32OyKX1IN3OE4CM3+hLNc1128e8zg/GLGpVWx1svLvbclSUdZMoEHL zAavn97CgXlfo1jlIc8kkorMaUNT4iWhKL6EDZVSrRqccH/1UbGYcxz5qVAhlVhbsRb3 UokQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id r7-20020a056402034700b0043d82809f0asi6563835edw.332.2022.08.14.22.49.35; Sun, 14 Aug 2022 22:50:01 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230495AbiHOFoY (ORCPT + 99 others); Mon, 15 Aug 2022 01:44:24 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:46012 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229460AbiHOFoV (ORCPT ); Mon, 15 Aug 2022 01:44:21 -0400 Received: from out30-42.freemail.mail.aliyun.com (out30-42.freemail.mail.aliyun.com [115.124.30.42]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id E509514081; Sun, 14 Aug 2022 22:44:18 -0700 (PDT) X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R591e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045176;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=5;SR=0;TI=SMTPD_---0VMDjRLc_1660542252; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0VMDjRLc_1660542252) by smtp.aliyun-inc.com; Mon, 15 Aug 2022 13:44:13 +0800 From: Yang Li To: viro@zeniv.linux.org.uk Cc: linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org, Yang Li , Abaci Robot Subject: [PATCH -next] fs/kernel_read_file: Fix some kernel-doc comments Date: Mon, 15 Aug 2022 13:44:11 +0800 Message-Id: <20220815054411.68818-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-9.9 required=5.0 tests=BAYES_00, ENV_AND_HDR_SPF_MATCH,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY, USER_IN_DEF_SPF_WL autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Add a colon between the parameter name and description to meet the scripts/kernel-doc. Link: https://bugzilla.openanolis.cn/show_bug.cgi?id=1901 Reported-by: Abaci Robot Signed-off-by: Yang Li --- fs/kernel_read_file.c | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/fs/kernel_read_file.c b/fs/kernel_read_file.c index 5d826274570c..c4fc84e6d099 100644 --- a/fs/kernel_read_file.c +++ b/fs/kernel_read_file.c @@ -8,16 +8,16 @@ /** * kernel_read_file() - read file contents into a kernel buffer * - * @file file to read from - * @offset where to start reading from (see below). - * @buf pointer to a "void *" buffer for reading into (if + * @file: file to read from + * @offset: where to start reading from (see below). + * @buf: pointer to a "void *" buffer for reading into (if * *@buf is NULL, a buffer will be allocated, and * @buf_size will be ignored) - * @buf_size size of buf, if already allocated. If @buf not + * @buf_size: size of buf, if already allocated. If @buf not * allocated, this is the largest size to allocate. - * @file_size if non-NULL, the full size of @file will be + * @file_size: if non-NULL, the full size of @file will be * written here. - * @id the kernel_read_file_id identifying the type of + * @id: the kernel_read_file_id identifying the type of * file contents being read (for LSMs to examine) * * @offset must be 0 unless both @buf and @file_size are non-NULL -- 2.20.1.7.g153144c