Changeset View
Changeset View
Standalone View
Standalone View
share/man/man7/ports.7
Show All 19 Lines | |||||
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | ||||
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | ||||
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | ||||
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | ||||
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd February 12, 2019 | .Dd March 11, 2019 | ||||
.Dt PORTS 7 | .Dt PORTS 7 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm ports | .Nm ports | ||||
.Nd contributed applications | .Nd contributed applications | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Fx | .Fx | ||||
▲ Show 20 Lines • Show All 545 Lines • ▼ Show 20 Lines | |||||
.Pp | .Pp | ||||
The following command builds and installs Emacs. | The following command builds and installs Emacs. | ||||
.Bd -literal -offset 2n | .Bd -literal -offset 2n | ||||
.Li # Ic cd /usr/ports/editors/emacs | .Li # Ic cd /usr/ports/editors/emacs | ||||
.Li # Ic make install | .Li # Ic make install | ||||
.Ed | .Ed | ||||
.It Sy Example 2\&: No Installing Dependencies with Xr pkg 8 | .It Sy Example 2\&: No Installing Dependencies with Xr pkg 8 | ||||
.Pp | .Pp | ||||
The following examples shows how to build and install a port without having to | The following example shows how to build and install a port without having to | ||||
build its dependencies. | build its dependencies. | ||||
Instead, the dependencies are downloaded via | Instead, the dependencies are downloaded via | ||||
.Xr pkg 8 . | .Xr pkg 8 . | ||||
.Bd -literal -offset 2n | .Bd -literal -offset 2n | ||||
.Li # Ic make missing | xargs pkg install --automatic --yes | .Li # Ic make missing | xargs pkg install --automatic --yes | ||||
.Li # Ic make install | .Li # Ic make install | ||||
.Ed | .Ed | ||||
.Pp | .Pp | ||||
It is especially useful, when the dependencies are costly | It is especially useful, when the dependencies are costly | ||||
in time and resources to build | in time and resources to build | ||||
.Pq like Pa lang/rust . | .Pq like Pa lang/rust . | ||||
The drawback is that | The drawback is that | ||||
.Xr pkg 8 | .Xr pkg 8 | ||||
offers only packages built with the default set of | offers only packages built with the default set of | ||||
.Va OPTIONS . | .Va OPTIONS . | ||||
.It Sy Example 3\&: No Building a Non-Default Flavor of a Port | |||||
.Pp | |||||
The following command builds a non-default flavor of a port. | |||||
bcr: s/examples/example/ | |||||
(In this case | |||||
Done Inline Actions
For example, "The following command …. of a port. (In this case... support.)"
(In this case, .Pa www/py-django is going to be built with Python 3.7 support.) cem: 1. Doc style suggestion: split it into two sentences. We prefer direct, simple sentences in… | |||||
.Pa devel/py-pip | |||||
Done Inline Actionswww/py-django was deprecated and then undeprecated last week -- it's quite likely that it will disappear in the relatively near future. Maybe choose a different example port? matthew: www/py-django was deprecated and then undeprecated last week -- it's quite likely that it will… | |||||
is going to be built with Python 3.7 support.) | |||||
.Bd -literal -offset 2n | |||||
.Li # Ic cd /usr/ports/devel/py-pip | |||||
.Li # Ic env FLAVOR=py37 make build | |||||
Done Inline ActionsLooking at how FLAVOR is passed to sub-makes in bsd.port.mk, I wonder if it should not be: env FLAVOR=py37 make build mat: Looking at how FLAVOR is passed to sub-makes in bsd.port.mk, I wonder if it should not be:
```… | |||||
.Ed | |||||
.El | .El | ||||
.Sh SEE ALSO | .Sh SEE ALSO | ||||
.Xr make 1 , | .Xr make 1 , | ||||
.Xr make.conf 5 , | .Xr make.conf 5 , | ||||
.Xr pkg 7 , | .Xr pkg 7 , | ||||
.Xr portsnap 8 | .Xr portsnap 8 | ||||
.Pp | .Pp | ||||
Additional developer documentation: | Additional developer documentation: | ||||
Show All 36 Lines |
s/examples/example/