[GIT PULL] fs helper kernel-doc update

From: Christian Brauner
Date: Tue Apr 27 2021 - 07:39:37 EST

Hi Linus,

/* Summary */
After last cycles changes we missed to update the kernel-docs in some places
that were changed during the idmapped mount work. Lukas and Randy took the
chance to not just fixup those places but also fixup and expand kernel-docs for
some additional helpers.

There are no functional changes in this PR which is why I split it out from the
following one.

The following changes since commit a38fd8748464831584a19438cbb3082b5a2dab15:

Linux 5.12-rc2 (2021-03-05 17:33:41 -0800)

are available in the Git repository at:

git@xxxxxxxxxxxxxxxxxxx:pub/scm/linux/kernel/git/brauner/linux tags/fs.idmapped.docs.v5.13

for you to fetch changes up to 92cb01c74ef13ca01e1af836236b140634967b82:

fs: update kernel-doc for vfs_rename() (2021-03-23 11:20:26 +0100)

/* Testing */
All patches are based on v5.12-rc2 and have been sitting in linux-next. No
build failures or warnings were observed. All old and new tests are passing.

ubuntu@f2-vm:~/src/git/xfstests$ sudo ./check -g idmapped
FSTYP -- xfs (debug)
PLATFORM -- Linux/x86_64 f2-vm 5.12.0-rc6-idmapped-cfebad8730dd #387 SMP PREEMPT Tue Apr 27 10:39:29 UTC 2021
MKFS_OPTIONS -- -f -bsize=4096 /dev/loop1
MOUNT_OPTIONS -- /dev/loop1 /mnt/scratch

generic/633 files ... 27s
xfs/152 files ... 68s
xfs/153 files ... 36s
Ran: generic/633 xfs/152 xfs/153
Passed all 3 tests

/* Conflicts */
At the time of creating this PR no merge conflicts were reported from
linux-next and no merge conflicts showed up doing a test-merge with current

(Note, in case you care about this at all I changed my tag naming pattern
simply because I ran into limitations with branch naming in git using "/"
separators and I like to have a 1:1 correspondence between the branch and the
tag name.)

Please consider pulling these changes from the signed fs.idmapped.docs.v5.13 tag.



Christian Brauner (1):
fs: update kernel-doc for vfs_rename()

Lukas Bulwahn (1):
fs: turn some comments into kernel-doc

Randy Dunlap (3):
libfs: fix kernel-doc for mnt_userns
namei: fix kernel-doc for struct renamedata and more
xattr: fix kernel-doc for mnt_userns and vfs xattr helpers

fs/libfs.c | 1 +
fs/namei.c | 14 +++-----------
fs/xattr.c | 14 ++++++++------
include/linux/fs.h | 17 ++++++++++++++---
4 files changed, 26 insertions(+), 20 deletions(-)