fs/namei: fix kernel-doc markup for dentry_create
PATCH 1/1 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".
--- fs/namei.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)
fs/namei.c +2 -2
@@ -4975,7 +4975,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 *
@@ -4986,7 +4986,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,
Signature · 1 line
2.46.4
Quoted 8 lines · Jay Winston
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 "anERR_PTR".Signed-off-by Jay Winston <[email protected]>
Looks good. Feel free to add:
Honza
Quoted 29 lines
--- fs/namei.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-)fs/namei.c +2
-2@@ -4975,7 +4975,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 * @@ -4986,7 +4986,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,Signature · 1 line
2.46.4
Signature · 2 lines
Jan Kara <[email protected]> SUSE Labs, CR
Quoted 8 lines · Jay Winston
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 "anERR_PTR".[...]
Applied to the vfs-6.20.atomic_open branch of the vfs/vfs.git tree. Patches in the vfs-6.20.atomic_open branch should appear in linux-next soon.
Please report any outstanding bugs that were missed during review in a new review to the original patch series allowing us to drop it.
It's encouraged to provide Acked-bys and Reviewed-bys even though the patch has now been applied. If possible patch trailers will be updated.
Note that commit hashes shown below are subject to change due to rebase, trailer updates or similar. If in doubt, please check the listed branch.
tree: https://git.kernel.org/pub/scm/linux/kernel/git/vfs/vfs.git branch: vfs-6.20.atomic_open
[1/1] fs/namei: fix kernel-doc markup for dentry_create
https://git.kernel.org/vfs/vfs/c/6ea258d1f689