Re: [PATCH] fs: remove stale log entries from fs/namei.c

[Christian Brauner <brauner@kernel.org>]

On Tue, Apr 01, 2025 at 02:28:08PM +0200, Mateusz Guzik wrote:
> On Tue, Apr 1, 2025 at 12:49 PM Christian Brauner <brauner@kernel.org> wrote:
> >
> > On Tue, 01 Apr 2025 07:08:46 +0200, Mateusz Guzik wrote:
> > >
> >
> > I have zero attachment to these comments so I'm inclined to agree and
> > remove them. Please anyone who really really thinks we need them speak
> > up!
> 
> ouch man
> 
> this submission was a joke, which is why I only sent it to the list
> and skipped the maintainers as direct recipients
> 
> it *adds* the following:
> >  /*[Apr 1 2024 Mateusz Guzik] Removed stale log entries.
> 
> I can't tell if this actually landed because the url:
> > [1/1] fs: remove stale log entries from fs/namei.c
> >       https://git.kernel.org/vfs/vfs/c/3dddecbd2b47
> 
> says "bad object id" at the moment.
> 
> I very much support removal of this kind of commentary, but this could
> be very flamewar inducing and I did not want to spend time on a
> non-tech discussion about it.
> 
> However, if actually doing this, there is more to whack and I'll be
> happy to do a real submission with more files.
> 
> Even in this file alone:
> > /* In order to reduce some races, while at the same time doing additional
> > * checking and hopefully speeding things up, we copy filenames to the
> > * kernel data space before using them..
> 
> I think this comment also needs to get whacked. Copying the path is
> not optional.

I'm thoroughly confused how this would be a meaningful April fools joke?

The comments in that file are literally 20+ years old and no one has
ever bothered to add new updates there even though Al, Neil, Jeff,
myself and a lot of others probably rewrote that file a gazillion number
of times together or significantly or at least subtly changed the rules.

So should we have added comments to the top of the file each time?
And since we didn't does it really serve as an interesting historical log?

The proper place for that has been
Documentation/filesystems/{locking.rst,porting.rst,path_lookup.rst}
for a long time now.

The comments are historical artifacts. At best they serve as a
humble-brag about who massaged what. I venture a guess and think that no
one needs that comment to figure out who has made a significant impact
here.