From patchwork Thu Dec 1 07:03:31 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 28215 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:f944:0:0:0:0:0 with SMTP id q4csp121486wrr; Wed, 30 Nov 2022 23:24:19 -0800 (PST) X-Google-Smtp-Source: AA0mqf6OOI/3ccWYIGie8asIGCfhcX/r+cfv2IzDzdHqtwCkNlJjk6C5MMS8z0aspSq9MF90TT5B X-Received: by 2002:a63:fc0a:0:b0:434:7885:6ade with SMTP id j10-20020a63fc0a000000b0043478856ademr44388830pgi.243.1669879459067; Wed, 30 Nov 2022 23:24:19 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1669879459; cv=none; d=google.com; s=arc-20160816; b=cHrAjmyuewDC4qUKtY39k2aRqMMxHsABxZi+a7uERudzhey7oj4B9sOvMPZE5wXYYE 7O2TKmusfKk0cD6/9GaxH+6qvfUqr1qcXshhFNkZat2Id1FaEZIZEboy8IysbhZQlJqg hGFkmzKa3SgWk1B0zelIzWqsr1LhvRgFY9Z7BSDpN2/Lo3nROXALQ8xDkXVdL3V1acaf +zo8ZzyMPbRmZ1spFzKLzvNQ0R+3f6LHmIXgSeezV1A0OOQw/fPgHBz3c2olSoqZkFqS PD/qH5DyY0NGVhOMYjHCrK08Yw6h1fcEfAegAEdN8s2h7rLIWqKfaL1ptWsWBzC7pjmy eFCA== 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:dkim-signature; bh=aL3Yz2hAwe0+hwM7my9v/xKV7aioeozADAd4sMrcP+I=; b=swBwArCeojn5wmSdwo38yv3JHaXvs5QE0us2b/JlGmymoDOpupSh8WPnpYEmZs1jTx 3GV3SY8N3dCzf2cqcN6RHluj7UY7i4j/rSrUDGoOAfxorCXtUROrFmNP1Zk2Xe1E8Q3I SpD/CiGwuOXSSFjjSIWxy/OW+xLtOCvtiEMZ8KXvjvAUqPICtHYhKaIWQOhRfev/a5UO otxV4oqASoRYNm9L9Qi5lMW5ZJlt9PTSkTTicS2bBaBTFNsJNkNU0AQcGzH6yqBSC0zc qK7GNsOvMOxEWLIBXbpt/dZ9iyVJQwvXfeMHNm8p+IVjIJbqjcBWcorjSxJLCOx12oLo YPJw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@infradead.org header.s=casper.20170209 header.b=Llp8bU0L; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id i14-20020a17090332ce00b00186f035eda3si4035272plr.579.2022.11.30.23.24.05; Wed, 30 Nov 2022 23:24:19 -0800 (PST) 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; dkim=pass header.i=@infradead.org header.s=casper.20170209 header.b=Llp8bU0L; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229866AbiLAHDp (ORCPT + 99 others); Thu, 1 Dec 2022 02:03:45 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57148 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229869AbiLAHDl (ORCPT ); Thu, 1 Dec 2022 02:03:41 -0500 Received: from casper.infradead.org (casper.infradead.org [IPv6:2001:8b0:10b:1236::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A2BBE87C85; Wed, 30 Nov 2022 23:03:38 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=casper.20170209; h=Content-Transfer-Encoding:MIME-Version: Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type:Content-ID: Content-Description:In-Reply-To:References; bh=aL3Yz2hAwe0+hwM7my9v/xKV7aioeozADAd4sMrcP+I=; b=Llp8bU0LERX1OZ+AvZZVRp+fTy b4YZ+HD7ddl779OegdEuUoOWVx6Fx92KcC5ZmwySvYwU8p3R7HX7SVAtsYhJ6EOmp/kfb/2uwhlEd 50gAK1Y0RD/YGn76IseNMpxlCGGDYfLnDwj/dEhQi0ILYBZZzaFDHQCQ6BZwJSz5KCEtniXXNzqO6 in331cahNPs1VVUiYV8bJc5BcQTQg6PWzQGRtobtIuYDYCuX7hzXtsAducoe3JzotMzK3T22gasmu OJGag367jYs4xDxCNvxauewbZNh0c7/UXVVcJrNItlrXUgloQEVGToUg0+XggQQKL/oZWiOImZTRE 6jAnJ4CQ==; Received: from [2601:1c2:d80:3110::a2e7] (helo=casper.infradead.org) by casper.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1p0dbj-00FioH-1y; Thu, 01 Dec 2022 07:03:43 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Jens Axboe , linux-block@vger.kernel.org Subject: [PATCH] block: bdev & blktrace: use consistent function doc. notation Date: Wed, 30 Nov 2022 23:03:31 -0800 Message-Id: <20221201070331.25685-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.38.1 MIME-Version: 1.0 X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_MED,SPF_HELO_NONE, SPF_NONE 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 X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1750995523454814230?= X-GMAIL-MSGID: =?utf-8?q?1750995523454814230?= Use only one hyphen in kernel-doc notation between the function name and its short description. The is the documented kerenl-doc format. It also fixes the HTML presentation to be consistent with other functions. Signed-off-by: Randy Dunlap Cc: Jens Axboe Cc: linux-block@vger.kernel.org --- block/bdev.c | 4 ++-- kernel/trace/blktrace.c | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff -- a/block/bdev.c b/block/bdev.c --- a/block/bdev.c +++ b/block/bdev.c @@ -224,7 +224,7 @@ int fsync_bdev(struct block_device *bdev EXPORT_SYMBOL(fsync_bdev); /** - * freeze_bdev -- lock a filesystem and force it into a consistent state + * freeze_bdev - lock a filesystem and force it into a consistent state * @bdev: blockdevice to lock * * If a superblock is found on this device, we take the s_umount semaphore @@ -268,7 +268,7 @@ done: EXPORT_SYMBOL(freeze_bdev); /** - * thaw_bdev -- unlock filesystem + * thaw_bdev - unlock filesystem * @bdev: blockdevice to unlock * * Unlocks the filesystem and marks it writeable again after freeze_bdev(). diff -- a/kernel/trace/blktrace.c b/kernel/trace/blktrace.c --- a/kernel/trace/blktrace.c +++ b/kernel/trace/blktrace.c @@ -721,7 +721,7 @@ EXPORT_SYMBOL_GPL(blk_trace_startstop); */ /** - * blk_trace_ioctl: - handle the ioctls associated with tracing + * blk_trace_ioctl - handle the ioctls associated with tracing * @bdev: the block device * @cmd: the ioctl cmd * @arg: the argument data, if any @@ -769,7 +769,7 @@ int blk_trace_ioctl(struct block_device } /** - * blk_trace_shutdown: - stop and cleanup trace structures + * blk_trace_shutdown - stop and cleanup trace structures * @q: the request queue associated with the device * **/