Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 27 Dec 2020 13:33:10 -0800
From:      Mark Millard <marklmi@yahoo.com>
To:        "mjg@freebsd.org " <mjg@FreeBSD.org>, dev-commits-src-main@freebsd.org
Subject:   Re: git: abd7ded451c0 - main - cache: modification and last entry filling  support in lockless lookup v2
Message-ID:  <B62E8470-65FD-4587-A50D-E79714AADE96@yahoo.com>
References:  <B62E8470-65FD-4587-A50D-E79714AADE96.ref@yahoo.com>

next in thread | previous in thread | raw e-mail | index | archive | help

Mateusz Guzik mjg at FreeBSD.org wrote on
Sun Dec 27 21:05:01 UTC 2020 :

> The branch main has been updated by mjg:
> 
> URL: 
> https://cgit.FreeBSD.org/src/commit/?id=abd7ded451c0ddda2188b31826dc911cd22da9db
> 
> 
> commit abd7ded451c0ddda2188b31826dc911cd22da9db
> Author:     Mateusz Guzik <
> mjg at FreeBSD.org
> >
> AuthorDate: 2020-12-27 19:19:43 +0000
> Commit:     Mateusz Guzik <
> mjg at FreeBSD.org
> >
> CommitDate: 2020-12-27 21:03:18 +0000
> 
>     cache: modification and last entry filling support in lockless lookup v2
> 
> . . .


I probably would have an easier time interpreting the following
adjusted text ("vfs_" added) on https://cgit.freebsd.org/src/ :

Branch	Commit message	Author	Age
main	vfs_cache: modification and last entry filling support in lockless lookup v2	Mateusz Guzik	9 min.

instead of what actually displays:

Branch	Commit message	Author	Age
main	cache: modification and last entry filling support in lockless lookup v2	Mateusz Guzik	9 min.

All the following are not automatically very specific when I read such, even
in combination:

cache
modification
last entry fulling support
lockless lookup

so the "vfs" would have helped me.

Unfortunately, it just looks difficult to consistently have one line summaries
that well narrow down things. It is too easy to presume context not shared with
those that are just reading the text or having to make character-count tradeoffs.
If I were a committer I'd have the exact same difficulty.

===
Mark Millard
marklmi at yahoo.com
( dsl-only.net went
away in early 2018-Mar)




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?B62E8470-65FD-4587-A50D-E79714AADE96>