btrfs: update function comments
authorDavid Sterba <dsterba@suse.com>
Thu, 27 Oct 2022 12:21:42 +0000 (14:21 +0200)
committerDavid Sterba <dsterba@suse.com>
Mon, 5 Dec 2022 17:00:45 +0000 (18:00 +0100)
commit43dd529abed2bcf1467f13cce83da1c8456587ea
treeb6655febd20e7bed9c102e7949b0dc6655312ae5
parent1751850fbd770c89347e14ae9590219bcd2f0649
btrfs: update function comments

Update, reformat or reword function comments. This also removes the kdoc
marker so we don't get reports when the function name is missing.

Changes made:

- remove kdoc markers
- reformat the brief description to be a proper sentence
- reword to imperative voice
- align parameter list
- fix typos

Signed-off-by: David Sterba <dsterba@suse.com>
20 files changed:
fs/btrfs/block-group.c
fs/btrfs/ctree.c
fs/btrfs/delalloc-space.c
fs/btrfs/delayed-ref.c
fs/btrfs/discard.c
fs/btrfs/extent_io.c
fs/btrfs/extent_map.c
fs/btrfs/file-item.c
fs/btrfs/free-space-cache.c
fs/btrfs/inode.c
fs/btrfs/ioctl.c
fs/btrfs/ordered-data.c
fs/btrfs/raid56.c
fs/btrfs/reflink.c
fs/btrfs/space-info.c
fs/btrfs/tree-log.c
fs/btrfs/ulist.c
fs/btrfs/volumes.c
fs/btrfs/zoned.c
fs/btrfs/zstd.c