fs: Reorganize kerneldoc parameter names

Reorganize kerneldoc parameter names to match the parameter
order in the function header.

Problems identified using Coccinelle.

Signed-off-by: Julia Lawall <Julia.Lawall@inria.fr>
Link: https://lore.kernel.org/r/20240930112121.95324-9-Julia.Lawall@inria.fr
Signed-off-by: Christian Brauner <brauner@kernel.org>

diff --git a/fs/char_dev.c b/fs/char_dev.c
index 57cc096c498a29fc3bc2278a142a494ffbe5f3fd..c2ddb998f3c94361c8af419684e593f4b295b8b1 100644 (file)
--- a/fs/char_dev.c
+++ b/fs/char_dev.c
@@ -562,8 +562,8 @@ int cdev_device_add(struct cdev *cdev, struct device *dev)
 
 /**
  * cdev_device_del() - inverse of cdev_device_add
- * @dev: the device structure
  * @cdev: the cdev structure
+ * @dev: the device structure
  *
  * cdev_device_del() is a helper function to call cdev_del and device_del.
  * It should be used whenever cdev_device_add is used.

diff --git a/fs/dcache.c b/fs/dcache.c
index 0d7d1bfa23bdf5137bdf60ea74209b4615ea88d6..0099077a2982651b53be90043a6ac718d9d69230 100644 (file)
--- a/fs/dcache.c
+++ b/fs/dcache.c
@@ -2049,8 +2049,8 @@ EXPORT_SYMBOL(d_obtain_root);
 
 /**
  * d_add_ci - lookup or allocate new dentry with case-exact name
- * @inode:  the inode case-insensitive lookup has found
  * @dentry: the negative dentry that was passed to the parent's lookup func
+ * @inode:  the inode case-insensitive lookup has found
  * @name:   the case-exact name to be associated with the returned dentry
  *
  * This is to avoid filling the dcache with case-insensitive names to the
@@ -2103,8 +2103,8 @@ EXPORT_SYMBOL(d_add_ci);
 
 /**
  * d_same_name - compare dentry name with case-exact name
- * @parent: parent dentry
  * @dentry: the negative dentry that was passed to the parent's lookup func
+ * @parent: parent dentry
  * @name:   the case-exact name to be associated with the returned dentry
  *
  * Return: true if names are same, or false

diff --git a/fs/seq_file.c b/fs/seq_file.c
index e676c8b0cf5d8af861724222c006c67d908c2849..8bbb1ad46335c3b8f50dd35d552f86767e62ead1 100644 (file)
--- a/fs/seq_file.c
+++ b/fs/seq_file.c
@@ -343,8 +343,8 @@ EXPORT_SYMBOL(seq_lseek);
 
 /**
  *     seq_release -   free the structures associated with sequential file.
- *     @file: file in question
  *     @inode: its inode
+ *     @file: file in question
  *
  *     Frees the structures associated with sequential file; can be used
  *     as ->f_op->release() if you don't have private data to destroy.