ports.7: Add port files to FILES
ClosedPublic
Actions

Authored by ziaee on Feb 20 2026, 6:26 PM.

Details

Reviewers

adamw
dim
rene
kevans

Commits

rG0ebf602e1785: ports.7: Add port files to FILES
rG451f593194cb: ports.7: Add port files to FILES

Summary

I do not know that this is strictly accurate because I'm an extremely
casual user of ports, but I had this idea and I think this info needs
to be in here.

MFC after: 3 days

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

ziaee created this revision.Feb 20 2026, 6:26 PM

Herald added a subscriber: imp. · View Herald TranscriptFeb 20 2026, 6:26 PM

ziaee requested review of this revision.Feb 20 2026, 6:26 PM

Harbormaster completed remote builds in B70826: Diff 172330.Feb 20 2026, 6:26 PM

adamw added inline comments.Feb 20 2026, 7:47 PM

share/man/man7/ports.7
598	/usr/ports/distfiles: The directory where fetched files are stored.
618	Close, it's "The directory in which ${PORT} is built and staged."

I'm a big yes to this plan

adamw added inline comments.Feb 20 2026, 7:50 PM

share/man/man7/ports.7
612	This is accurate, but there are only two such directories. I'd leave this out; it'll probably confuse more people than it'll help.

Thanks @adamw! How's this? I tried to save a linebreak for work/

Harbormaster completed remote builds in B70864: Diff 172414.Feb 22 2026, 3:11 AM

Looks great! And your wording on work/ is much better than mine was. Others you can consider:

/usr/ports/UPDATING -- Important information for end-users about changes or gotchas when upgrading ports.
/etc/make.conf -- User settings to configure the ports tree.
I'd definitely suggest those first two.

/usr/ports/Mk/bsd.default-versions.mk -- A handy list of everything we support multiple versions of. To change one, put it in /etc/make.conf (above).
/usr/ports/CHANGES -- Ports framework changes, new features, and deprecations.
/usr/ports/Tools/scripts -- Grab-bag of tools for maintaining the ports tree.
/var/db/pkg/local.sqlite -- pkg's main database.

This revision is now accepted and ready to land.Feb 22 2026, 5:44 AM

Closed by commit rG451f593194cb: ports.7: Add port files to FILES (authored by ziaee). · Explain WhyFeb 22 2026, 7:44 AM

This revision was automatically updated to reflect the committed changes.

ziaee added a commit: rG451f593194cb: ports.7: Add port files to FILES.

ziaee added a commit: rG0ebf602e1785: ports.7: Add port files to FILES.Apr 10 2026, 6:31 PM