From: Jay Winston Date: Sun, 18 Jan 2026 11:04:01 +0000 (+0200) Subject: fs/namei: fix kernel-doc markup for dentry_create X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6ea258d1f6895c61af212473b51477d39b8c99d2;p=thirdparty%2Flinux.git 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: Jay Winston Link: https://patch.msgid.link/20260118110401.2651-1-jaybenjaminwinston@gmail.com Reviewed-by: Jan Kara Signed-off-by: Christian Brauner --- diff --git a/fs/namei.c b/fs/namei.c index aefb21bc0944e..45dd897a03939 100644 --- a/fs/namei.c +++ b/fs/namei.c @@ -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,