smbfs(4): evaluate filesystems/smbnetfs

[grahamperrin]

RIP sysutils/fusefs-smbnetfs, one of 142 moves that arose from
freebsd/freebsd-ports#302 and
ports 6e2da9672f79 on 2024-11-06. This one involved a change of name
in addition to the change of category.

Instead, advise users to evaluate filesystems/smbnetfs.

MFC after: 1 week

[grahamperrin]

Plain text, with line breaks:

RIP sysutils/fusefs-smbnetfs, one of 142 moves that arose from
https://github.com/freebsd/freebsd-ports/pull/302 and
ports 6e2da9672f79 on 2024-11-06. This one involved a change of name
in addition to the change of category.

Instead, advise users to evaluate filesystems/smbnetfs.

MFC after:      1 week

[grahamperrin]

Sorry, I made a mistake in the commit log message at 9029293 (#1562):

base

– should have been:

ports

[grahamperrin]

The September PR in ports:

• Add new category fs for file systems freebsd-ports#302

The 2024-11-06 commit:

• filesystems: add new category for file systems and related utilities · freebsd/freebsd-ports@6e2da96
• https://cgit.freebsd.org/ports/commit/?id=6e2da9672f79f44048d597f0f61e4646cdeade9d

[grahamperrin]

From freebsd/freebsd-ports#302 (comment) (2024-11-13):

… This change hasn't even hit quarterly yet.

The suggested one-week MFC here (Friday 27th December, looking to Thursday 2nd January) is, partly, an allowance for the change in ports to reach quarterly.

[concussious]

Sorry to back track, but I only just now realized why the previous location was incorrect.

This could use a better commit message to make that more obvious. Suggest something like:

smbfs.4: Update smbnetfs location

A new "filesystems" ports category has been created,
and all filesystem ports have been moved there.
Update the smbnetfs manual to point to the new location.

PR:          the number of the bug you opened for this issue
Fixes:        ports#short-commit-hash(Commit title)
MFC after:    3 days

Key points: the .4 instead of (4) shows you're talking about the manual, not the driver itself.

The description explains why this change is happening without needing to follow links, and what is happening without having to look at everything. This is extremely important.

Please don't put hyperlinks in the middle of the text because it isn't legible. People need to read the description, and that gives them the context to decide to go look up the links.

You opened a bug to track this issue, using it makes that useful.

Additionally, but not my call, it's vastly preferred that everything in src/ effected by this should be one commit.

Thanks!

[concussious]

This can be closed, I did all the fallout in the src tree in one commit here ¹.

I'm about 1/3rd of the way through doing the same in the doc tree.

Footnotes

1. https://reviews.freebsd.org/D48406 ↩