freebsd-base.7: Add a DIAGNOSTICS section
AbandonedPublic
Actions

Authored by ziaee on Dec 3 2025, 8:31 PM.

Details

Reviewers

None

Group Reviewers

pkgbase
releng
manpages

Summary

Explain pkg repos conflicting, how to diagnose, and how to resolve.

I don't feel strongly about where this needs to go. The best place would
be pkgbasify(8), but we don't have that. Maybe UPDATING? I'm not sure we
shouldn't modify this a bit and put this in top level pkg(8)?

I also removed some trivial typos mandoc complains about in this commit.

MFC after: 3 days

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Skipped

Unit

Tests Skipped

Build Status

Buildable 69024
Build 65907: arc lint + arc unit

Event Timeline

ziaee created this revision.Dec 3 2025, 8:31 PM

Herald added a subscriber: imp. · View Herald TranscriptDec 3 2025, 8:31 PM

ziaee requested review of this revision.Dec 3 2025, 8:31 PM

Harbormaster completed remote builds in B69024: Diff 167497.Dec 3 2025, 8:31 PM

ivy added a subscriber: ivy.Dec 3 2025, 8:45 PM

ivy added inline comments.

share/man/man7/freebsd-base.7
194	it's not possible for a base package to conflict with a ports package, because they never install files in the same place. also, i'm not sure how the proposed fix matches the problem. if this is about the `FreeBSD` repository being renamed to `FreeBSD-ports`, it doesn't belong in this manpage, which is about the base system. (i've also never seen this particular problem before -- is there a mailing list post or something that describes it in more detail?)

ziaee added inline comments.Dec 3 2025, 8:52 PM

share/man/man7/freebsd-base.7
194	it's not possible for a base package to conflict with a ports package, because they never install files in the same place. also, i'm not sure how the proposed fix matches the problem. if this is about the `FreeBSD` repository being renamed to `FreeBSD-ports`, it doesn't belong in this manpage, which is about the base system. Yeah, that's fair, like I said I think it really belongs in pkgbasify (8) but we don't have that. (i've also never seen this particular problem before -- is there a mailing list post or something that describes it in more detail?) https://www.reddit.com/r/freebsd/comments/1pck71p/150release_pkg_integrity_check_warnings/ There was also another one but it was deleted.

ivy added inline comments.Dec 3 2025, 9:00 PM

share/man/man7/freebsd-base.7
194	like I said I think it really belongs in pkgbasify (8) but we don't have that. but this is nothing to do with pkgbase, it's about ports packages. also, this user's issue seems to be specific to their misconfiguration and not the only cause of this (fairly generic) error message. if anything, this should be documented somewhere in the pkg(8) manpages.

Yeah this is probably bloat

Revision Contents
Changeset List

Path

Size

share/

man/

man7/

freebsd-base.7

23 lines

Diff 167497

View Options

share/man/man7/freebsd-base.7

freebsd-base.7: Add a DIAGNOSTICS sectionAbandonedPublicActions