From patchwork Sat Dec 27 20:43:02 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Simon Glass X-Patchwork-Id: 1084 Return-Path: X-Original-To: u-boot-concept@u-boot.org Delivered-To: u-boot-concept@u-boot.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1766868263; bh=zSIVmfve2s8b5XUO3unAa18DGbfBYjD7P8TZqih+obw=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=FfjfT3FofzMvdzQb8jVR3ar3qB4ajxN61ZSxAPKKAKl+mn1O+psGwOzXVnczM0OmY 5aLbz0j+BN67BrKQToILfpFoQKFuLFcYyv4BObCq4710U4T/8zE/5OMQdFz81nQmeJ neJyX6fCzTyTm6m8+V57Y+lRXEjNBiu3dAnbRQSBBu1+9Mbqn2/tkcxC0mqDY8C43i UWNk2/6+r6FUUkgsw5OA1hj0VjUVTlclqXnOeB/dCpPZ0ePEBz63fTQDgpRXK5TWoN GOzxcErVakh8OM/V4pTyVASzbzXx2jRm+9c8lue7ElLG08Y5nr8jMmJt7zKdhj1PPL /Bm6Uab6dRQYg== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 3358A64E44 for ; Sat, 27 Dec 2025 13:44:23 -0700 (MST) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10024) with ESMTP id MmB_nDQ-cZPm for ; Sat, 27 Dec 2025 13:44:23 -0700 (MST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1766868263; bh=zSIVmfve2s8b5XUO3unAa18DGbfBYjD7P8TZqih+obw=; h=From:To:Date:In-Reply-To:References:CC:Subject:List-Id: List-Archive:List-Help:List-Owner:List-Post:List-Subscribe: List-Unsubscribe:From; b=FfjfT3FofzMvdzQb8jVR3ar3qB4ajxN61ZSxAPKKAKl+mn1O+psGwOzXVnczM0OmY 5aLbz0j+BN67BrKQToILfpFoQKFuLFcYyv4BObCq4710U4T/8zE/5OMQdFz81nQmeJ neJyX6fCzTyTm6m8+V57Y+lRXEjNBiu3dAnbRQSBBu1+9Mbqn2/tkcxC0mqDY8C43i UWNk2/6+r6FUUkgsw5OA1hj0VjUVTlclqXnOeB/dCpPZ0ePEBz63fTQDgpRXK5TWoN GOzxcErVakh8OM/V4pTyVASzbzXx2jRm+9c8lue7ElLG08Y5nr8jMmJt7zKdhj1PPL /Bm6Uab6dRQYg== Received: from mail.u-boot.org (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id 21B7B64E61 for ; Sat, 27 Dec 2025 13:44:23 -0700 (MST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1766868260; bh=rHk6jZc6jhK6Ws6Dp7fhm0emHMiiKcrQP5jbURGv9sw=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=rLmWo7VifkiMd4p1GDdUi7Ntz9V9BVFOzJQyqM3h93kxXR72qp17NnGNO3xgJkvlr 5++efqt+H0g9A2bEQF1c4RkGo21BltTUDfWL1rMr4rD6N9PEBgwjOwD9lwNnX849Jk 5hQR7W8PsIQXn9mlHrej62eivIvxrWwwgzrAjbd/BJzSyt6QjmMoW/PYjPMKg9vZWa Oz8NGo4/3N+VMY/DM13J4/x/g5pusO0ADF5lMqdejBHDT9gEWqEMQ19n4qUvMzqBAm 5o1kVIu8LvXZnjuicEJ+R7aKSnzLJPqLdzUejXFRJ4JxiIy9F61BzAUVfBp5a20yqM DbfbGfTDtp+cg== Received: from localhost (localhost [127.0.0.1]) by mail.u-boot.org (Postfix) with ESMTP id AAD1464E4D; Sat, 27 Dec 2025 13:44:20 -0700 (MST) X-Virus-Scanned: Debian amavis at Received: from mail.u-boot.org ([127.0.0.1]) by localhost (mail.u-boot.org [127.0.0.1]) (amavis, port 10026) with ESMTP id om-wO5bO9h4a; Sat, 27 Dec 2025 13:44:20 -0700 (MST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=u-boot.org; s=default; t=1766868255; bh=vHpYPqE6A5QjRMJczI0EG6JkcRvlLtuceysnubCLWTs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=YEgDCDBBlxeG9B0ljbSQpz7MjqXsQ12D8Y8J7jAU3u1K0HwbZ+pI6WlyXaUdNsyfa 5IPEcs71ruL1oK81u2nVVTEjihz3++8eGHyQ8f4go5xUJLGy0AQ1YIdgMvJ0M7IzW/ a/ItOeYkBpjiy5w3k4dO2oDNMXPX9VKbuIHWCATNglcbZjcuwtlBmG28W8yaPIakLk C7Qytc5Afn/8wdy8wnFhxLuSS6EhPz9ZRP5a9f4pguIMyqmRcSUbRSwLoGM4O4wioc 2FILZcUchpsaNhq0zr0uDUb4tnzmdq/jnzgH6xZHPlTa3rRBOi0tNsFRvN+Kx1l8uy EWr7HbTPhJp0A== Received: from u-boot.org (unknown [73.34.74.121]) by mail.u-boot.org (Postfix) with ESMTPSA id 5092064E1F; Sat, 27 Dec 2025 13:44:15 -0700 (MST) From: Simon Glass To: U-Boot Concept Date: Sat, 27 Dec 2025 13:43:02 -0700 Message-ID: <20251227204318.886983-8-sjg@u-boot.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20251227204318.886983-1-sjg@u-boot.org> References: <20251227204318.886983-1-sjg@u-boot.org> MIME-Version: 1.0 Message-ID-Hash: 3I7ZZXABATGLCAYLZMVTULN7Z5HC5N24 X-Message-ID-Hash: 3I7ZZXABATGLCAYLZMVTULN7Z5HC5N24 X-MailFrom: sjg@u-boot.org X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Heinrich Schuchardt , Simon Glass , Claude X-Mailman-Version: 3.3.10 Precedence: list Subject: [Concept] [PATCH 07/16] ext4l: Fix comment formatting List-Id: Discussion and patches related to U-Boot Concept Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Simon Glass Add blank line after function doc titles per kernel-doc style. Co-developed-by: Claude Signed-off-by: Simon Glass --- fs/ext4l/interface.c | 9 +++++++++ include/ext4l.h | 2 ++ 2 files changed, 11 insertions(+) diff --git a/fs/ext4l/interface.c b/fs/ext4l/interface.c index b897f30c223..6e146f246bd 100644 --- a/fs/ext4l/interface.c +++ b/fs/ext4l/interface.c @@ -42,6 +42,7 @@ static char ext4l_msg_data[EXT4L_MSG_BUF_SIZE]; /** * ext4l_get_blk_dev() - Get the current block device + * * Return: Block device descriptor or NULL if not mounted */ struct blk_desc *ext4l_get_blk_dev(void) @@ -53,6 +54,7 @@ struct blk_desc *ext4l_get_blk_dev(void) /** * ext4l_get_partition() - Get the current partition info + * * Return: Partition info pointer */ struct disk_partition *ext4l_get_partition(void) @@ -62,6 +64,7 @@ struct disk_partition *ext4l_get_partition(void) /** * ext4l_get_uuid() - Get the filesystem UUID + * * @uuid: Buffer to receive the 16-byte UUID * Return: 0 on success, -ENODEV if not mounted */ @@ -75,6 +78,7 @@ int ext4l_get_uuid(u8 *uuid) /** * ext4l_set_blk_dev() - Set the block device for ext4l operations + * * @blk_dev: Block device descriptor * @partition: Partition info (can be NULL for whole disk) */ @@ -110,6 +114,7 @@ static void ext4l_msg_init(void) /** * ext4l_record_msg() - Record a message in the buffer + * * @msg: Message string to record * @len: Length of message */ @@ -304,6 +309,7 @@ err_exit_es: /** * ext4l_read_symlink() - Read the target of a symlink inode + * * @inode: Symlink inode * @target: Buffer to store target * @max_len: Maximum length of target buffer @@ -350,6 +356,7 @@ static int ext4l_resolve_path_internal(const char *path, struct inode **inodep, /** * ext4l_resolve_path() - Resolve path to inode + * * @path: Path to resolve * @inodep: Output inode pointer * Return: 0 on success, negative on error @@ -361,6 +368,7 @@ static int ext4l_resolve_path(const char *path, struct inode **inodep) /** * ext4l_resolve_path_internal() - Resolve path with symlink following + * * @path: Path to resolve * @inodep: Output inode pointer * @depth: Current recursion depth (for symlink loop detection) @@ -551,6 +559,7 @@ static int ext4l_resolve_path_internal(const char *path, struct inode **inodep, /** * ext4l_dir_actor() - Directory entry callback for ext4_readdir + * * @ctx: Directory context * @name: Entry name * @namelen: Length of name diff --git a/include/ext4l.h b/include/ext4l.h index e6ca11c163a..333d9db139c 100644 --- a/include/ext4l.h +++ b/include/ext4l.h @@ -30,6 +30,7 @@ void ext4l_close(void); /** * ext4l_ls() - List directory contents + * * @dirname: Directory path to list * Return: 0 on success, negative on error */ @@ -37,6 +38,7 @@ int ext4l_ls(const char *dirname); /** * ext4l_get_uuid() - Get the filesystem UUID + * * @uuid: Buffer to receive the 16-byte UUID * Return: 0 on success, -ENODEV if not mounted */