Page MenuHomeFreeBSD

ports(7): Update instructions for package target
AbandonedPublic

Authored by debdrup on Feb 18 2021, 9:59 PM.

Details

Reviewers
rwatson
0mp
linimon
Group Reviewers
manpages
Summary

Packages default to ending up in a different location compared to the
documentation, so catch up to the implemtation by referring to the
location where packages can usually be found if no environment variables
have been set.

While here, also update the mention of the file extension to match the
txz format that packages use.

PR: 253179, 224370
Reported by: rwatson

Test Plan

igor and mandoc -Tlint, neither report issues with what I added.

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint OK
Unit
No Unit Test Coverage
Build Status
Buildable 37175
Build 34064: arc lint + arc unit

Event Timeline

yuripv added inline comments.
share/man/man7/ports.7
293

This does not seem to be correct, and current working directory is rather ambiguous.

Doing, e.g. make -C /usr/ports/textproc/utf8proc package will put the package to /usr/ports/textproc/utf8proc/work/pkg, and if WRKDIRPREFIX is redefined, the pkg will go there as well, i.e. WRKDIRPREFIX=/usr/obj make -C /usr/ports/textproc/utf8proc package will put the package to /usr/obj/usr/ports/textproc/utf8proc/work/pkg. None of those are related to CWD being e.g. /home/yuripv.

debdrup marked an inline comment as done.

Address feedback by @yuripv

share/man/man7/ports.7
293

I had written something to that effect initially, but convinced myself I remembered wrong.

share/man/man7/ports.7
293

The .Pa macro seems appropriate here.

Also, maybe it can be /usr/ports. That would be consistent with the rest of this manual page.

debdrup marked an inline comment as done.

Address feedback by @0mp

debdrup retitled this revision from ports(7): Update instructions to match implementation to ports(7): Update instructions for package target.Feb 19 2021, 5:09 AM

I forgot to use the tooling, and missed that the Differential revision field wasn't tagged.

This landed as https://cgit.freebsd.org/src/commit/?id=248a47a4c2fb229ae815fa61875b3f62a2d6856c