Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 02 Feb 2021 15:32:34 +0000
From:      bugzilla-noreply@freebsd.org
To:        bugs@FreeBSD.org
Subject:   [Bug 253179] ports(7) man page description of 'packages' target is out of date
Message-ID:  <bug-253179-227@https.bugs.freebsd.org/bugzilla/>

next in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D253179

            Bug ID: 253179
           Summary: ports(7) man page description of 'packages' target is
                    out of date
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Severity: Affects Some People
          Priority: ---
         Component: Manual Pages
          Assignee: bugs@FreeBSD.org
          Reporter: rwatson@FreeBSD.org
                CC: doc@FreeBSD.org

In attempting to build packages locally, I read the documentation, and was
confused by the following pieces of text from ports(7):

...
     package              Make a binary package for the port.  The port will
                          be installed if it has not already been.  The
                          package is a .tbz file that you can use to install
                          the port on other machines with pkg-add(8).  If t=
he
                          directory specified by PACKAGES does not exist, t=
he
                          package will be put into the current directory.  =
See
                          PKGREPOSITORY and PKGFILE.
...
     PACKAGES          Used only for the package target; the base directory
                       for the packages tree, normally packages/ in PORTSDI=
R.
                       If this directory exists, the package tree will be
                       (partially) constructed.  This directory does not ha=
ve
                       to exist; if it does not, packages will be placed in=
to
                       the current directory, or you can define one of

                       PKGREPOSITORY      Directory to put the package in.

                       PKGFILE            The full path to the package.
...

When I attempted to build a package, I was surprised not to find it in my
current working directory (the root of the port), as I hadn't specified
PACKAGES on the command line. It turns out that it is not in the current
working directory, but in work/pkg relative to the current working director=
y.
This probably needs updating.

When I ran find(1) to try and find the package, I was further surprised not=
 to
find any, having used the pattern '*.tbz' as suggested by the text "a .tbz
file". In fact, ports are now .txz files.  This probably needs updating.

--=20
You are receiving this mail because:
You are the assignee for the bug.=



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-253179-227>