Unverified Commit 6ea258d1 authored by Jay Winston's avatar Jay Winston Committed by Christian Brauner
Browse files

fs/namei: fix kernel-doc markup for dentry_create 



O_ is interpreted as a broken hyperlink target. Escape _ with a backslash.

The asterisk in "struct file *" is interpreted as an opening emphasis
string that never closes. Replace double quotes with rST backticks.

Change "a ERR_PTR" to "an ERR_PTR".

Signed-off-by: default avatarJay Winston <jaybenjaminwinston@gmail.com>
Link: https://patch.msgid.link/20260118110401.2651-1-jaybenjaminwinston@gmail.com


Reviewed-by: default avatarJan Kara <jack@suse.cz>
Signed-off-by: default avatarChristian Brauner <brauner@kernel.org>
parent 1c921baf

fs/namei.c

+2 −2
Original line number Diff line number Diff line
@@ -4939,7 +4939,7 @@ EXPORT_SYMBOL(start_creating_user_path); 
/**

 * dentry_create - Create and open a file

 * @path: path to create

 * @flags: O_ flags

 * @flags: O\_ flags

 * @mode: mode bits for new file

 * @cred: credentials to use

 *
@@ -4950,7 +4950,7 @@ EXPORT_SYMBOL(start_creating_user_path); 
 * the new file is to be created. The parent directory and the

 * negative dentry must reside on the same filesystem instance.

 *

 * On success, returns a "struct file *". Otherwise a ERR_PTR

 * On success, returns a ``struct file *``. Otherwise an ERR_PTR

 * is returned.

 */

struct file *dentry_create(struct path *path, int flags, umode_t mode,