Re: [PATCH 1/3] btrfs: add a comment describing block-rsvs

David Sterba
2020-02-07T15:11:56Z

On Tue, Feb 04, 2020 at 01:18:54PM -0500, Josef Bacik wrote:
> This is a giant comment at the top of block-rsv.c describing generally
> how block rsvs work. It is purely about the block rsv's themselves, and
> nothing to do with how the actual reservation system works.

>
> Signed-off-by: Josef Bacik <josef@toxicpanda.com>
> ---
> fs/btrfs/block-rsv.c | 91 ++++++++++++++++++++++++++++++++++++++++++++
> 1 file changed, 91 insertions(+)
>
> diff --git a/fs/btrfs/block-rsv.c b/fs/btrfs/block-rsv.c
> index d07bd41a7c1e..c3843a0001cb 100644
> --- a/fs/btrfs/block-rsv.c
> +++ b/fs/btrfs/block-rsv.c
> @@ -6,6 +6,97 @@
> #include "space-info.h"
> #include "transaction.h"
>
> +/*
> + * HOW DO BLOCK RSVS WORK

For documentation please try to avoid abbreviations unless they're at
least somehow explained or can be infered from the previous.

RSVS = RESERVES