d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Tweak ports(7) manual page to better explain the basics.

Browse Source 
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:
Edward Tomasz Napierala 2018-07-11 13:53:44 +00:00
parent 35b930cc2b
commit f1dd498487
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=336197
1 changed files with 23 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
share/man/man7/ports.7
View File

@ -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.