From: Bagas Sanjaya Sphinx reports htmldocs warnings: Documentation/filesystems/api-summary:56: fs/namei.c:4952: WARNING: Inline emphasis start-string without end-string. [docutils] Documentation/filesystems/api-summary:56: fs/namei.c:4942: ERROR: Unknown target name: "o". [docutils] Fix them up. Fixes: 977de00dfcf87e ("VFS: move dentry_create() from fs/open.c to fs/namei.c") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20251216115252.709078e8@canb.auug.org.au/ Signed-off-by: Bagas Sanjaya --- Changes in v2: - Add ellipsis placeholder on @flags description (Al Viro) - Phrase return value struct (Al Viro) - Link to v1: https://lore.kernel.org/r/20251218-dentry-inline-v1-1-0107f4cd8246@gmail.com --- fs/namei.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/fs/namei.c b/fs/namei.c index aefb21bc0944e3..ad6a9930dc68b5 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, return a pointer to opened file. Otherwise a ERR_PTR * is returned. */ struct file *dentry_create(struct path *path, int flags, umode_t mode, --- base-commit: 981be27a72d163610e8e1c342373930bae80ac99 change-id: 20251218-dentry-inline-4091feeae685 Best regards, -- Bagas Sanjaya