Tweak ports(7) manual page to better explain the basics.
Reviewed by: allanjude@ (earlier version) MFC after: 2 weeks Sponsored by: DARPA, AFRL Differential Revision: https://reviews.freebsd.org/D16149
This commit is contained in:
parent
35b930cc2b
commit
f1dd498487
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=336197
@ -25,7 +25,7 @@
|
|||||||
.\"
|
.\"
|
||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd July 5, 2018
|
.Dd July 11, 2018
|
||||||
.Dt PORTS 7
|
.Dt PORTS 7
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
@ -35,28 +35,33 @@
|
|||||||
The
|
The
|
||||||
.Fx
|
.Fx
|
||||||
Ports Collection
|
Ports Collection
|
||||||
offers a simple way for users and
|
offers a simple way to compile and install third party applications.
|
||||||
administrators to install applications.
|
It is also used to build packages, to be installed using
|
||||||
It is also used to build the packages, to be installed using
|
|
||||||
.Xr pkg 8 .
|
.Xr pkg 8 .
|
||||||
Each
|
It can be installed and updated using
|
||||||
.Em port
|
.Xr portsnap 8 .
|
||||||
contains any patches necessary to make the original
|
.Pp
|
||||||
application source code compile and run on
|
The ports tree, typically located at
|
||||||
|
.Pa /usr/ports ,
|
||||||
|
consists of subdirectories, one for each category; those in turn contain
|
||||||
|
individual ports.
|
||||||
|
Each port is a directory with metadata and patches necessary to make
|
||||||
|
the original application source code compile and run on
|
||||||
.Fx .
|
.Fx .
|
||||||
Compiling an
|
Compiling an
|
||||||
application is as simple as typing
|
application is as simple as typing
|
||||||
.Nm make Cm build
|
.Nm make Cm build
|
||||||
in the port directory!
|
in the port directory.
|
||||||
The
|
The
|
||||||
.Pa Makefile
|
.Pa Makefile
|
||||||
automatically fetches the
|
automatically fetches the
|
||||||
application source code, either from a local disk or via FTP, unpacks it
|
application source code, either from a local disk or the network, unpacks it,
|
||||||
on your system, applies the patches, and compiles it.
|
applies the patches, and compiles it.
|
||||||
If all goes well,
|
It also recursively handles dependencies \(em other pieces of software
|
||||||
simply type
|
the port depends on in order to build and work.
|
||||||
|
Afterwards,
|
||||||
.Nm make Cm install
|
.Nm make Cm install
|
||||||
to install the application.
|
installs the application.
|
||||||
.Pp
|
.Pp
|
||||||
For more information about using ports, see the
|
For more information about using ports, see the
|
||||||
.Dq "Packages and Ports" section
|
.Dq "Packages and Ports" section
|
||||||
@ -65,12 +70,14 @@ in
|
|||||||
.Pp
|
.Pp
|
||||||
.Lk https://www.FreeBSD.org/doc/en/books/handbook/ports.html
|
.Lk https://www.FreeBSD.org/doc/en/books/handbook/ports.html
|
||||||
.Pp
|
.Pp
|
||||||
For information about creating new ports, see:
|
For information about creating new ports, see
|
||||||
.%B "The Porter's Handbook":
|
.%B "The Porter's Handbook":
|
||||||
.Pp
|
.Pp
|
||||||
.Lk https://www.FreeBSD.org/doc/en/books/porters-handbook/
|
.Lk https://www.FreeBSD.org/doc/en/books/porters-handbook/
|
||||||
.Sh TARGETS
|
.Sh TARGETS
|
||||||
Some of the targets work recursively through subdirectories.
|
Some of the
|
||||||
|
.Xr make 1
|
||||||
|
targets work recursively through subdirectories.
|
||||||
This lets you, for example, install all of the
|
This lets you, for example, install all of the
|
||||||
.Dq Li biology
|
.Dq Li biology
|
||||||
ports.
|
ports.
|
||||||
|
Loading…
Reference in New Issue
Block a user