From owner-svn-src-head@freebsd.org Wed Jul 11 13:53:45 2018 Return-Path: Delivered-To: svn-src-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 355DF103FB58; Wed, 11 Jul 2018 13:53:45 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id DB5B3729C8; Wed, 11 Jul 2018 13:53:44 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id BC7AE13970; Wed, 11 Jul 2018 13:53:44 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w6BDrikw025680; Wed, 11 Jul 2018 13:53:44 GMT (envelope-from trasz@FreeBSD.org) Received: (from trasz@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w6BDrieS025679; Wed, 11 Jul 2018 13:53:44 GMT (envelope-from trasz@FreeBSD.org) Message-Id: <201807111353.w6BDrieS025679@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: trasz set sender to trasz@FreeBSD.org using -f From: Edward Tomasz Napierala Date: Wed, 11 Jul 2018 13:53:44 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r336197 - head/share/man/man7 X-SVN-Group: head X-SVN-Commit-Author: trasz X-SVN-Commit-Paths: head/share/man/man7 X-SVN-Commit-Revision: 336197 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-head@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: SVN commit messages for the src tree for head/-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 11 Jul 2018 13:53:45 -0000 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.