Date: Wed, 11 Jul 2018 13:53:44 +0000 (UTC) From: Edward Tomasz Napierala <trasz@FreeBSD.org> To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r336197 - head/share/man/man7 Message-ID: <201807111353.w6BDrieS025679@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: trasz Date: Wed Jul 11 13:53:44 2018 New Revision: 336197 URL: https://svnweb.freebsd.org/changeset/base/336197 Log: 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 Modified: head/share/man/man7/ports.7 Modified: head/share/man/man7/ports.7 ============================================================================== --- head/share/man/man7/ports.7 Wed Jul 11 12:12:49 2018 (r336196) +++ head/share/man/man7/ports.7 Wed Jul 11 13:53:44 2018 (r336197) @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd July 5, 2018 +.Dd July 11, 2018 .Dt PORTS 7 .Os .Sh NAME @@ -35,28 +35,33 @@ The .Fx Ports Collection -offers a simple way for users and -administrators to install applications. -It is also used to build the packages, to be installed using +offers a simple way to compile and install third party applications. +It is also used to build packages, to be installed using .Xr pkg 8 . -Each -.Em port -contains any patches necessary to make the original -application source code compile and run on +It can be installed and updated using +.Xr portsnap 8 . +.Pp +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 . Compiling an application is as simple as typing .Nm make Cm build -in the port directory! +in the port directory. The .Pa Makefile automatically fetches the -application source code, either from a local disk or via FTP, unpacks it -on your system, applies the patches, and compiles it. -If all goes well, -simply type +application source code, either from a local disk or the network, unpacks it, +applies the patches, and compiles it. +It also recursively handles dependencies \(em other pieces of software +the port depends on in order to build and work. +Afterwards, .Nm make Cm install -to install the application. +installs the application. .Pp For more information about using ports, see the .Dq "Packages and Ports" section @@ -65,12 +70,14 @@ in .Pp .Lk https://www.FreeBSD.org/doc/en/books/handbook/ports.html .Pp -For information about creating new ports, see: +For information about creating new ports, see .%B "The Porter's Handbook": .Pp .Lk https://www.FreeBSD.org/doc/en/books/porters-handbook/ .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 .Dq Li biology ports.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201807111353.w6BDrieS025679>