From owner-svn-doc-head@FreeBSD.ORG Mon Oct 28 18:54:37 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 6B348D22; Mon, 28 Oct 2013 18:54:37 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 3DD112567; Mon, 28 Oct 2013 18:54:37 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.7/8.14.7) with ESMTP id r9SIsbY0086378; Mon, 28 Oct 2013 18:54:37 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.7/8.14.5/Submit) id r9SIsbIl086377; Mon, 28 Oct 2013 18:54:37 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201310281854.r9SIsbIl086377@svn.freebsd.org> From: Eitan Adler Date: Mon, 28 Oct 2013 18:54:37 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43049 - head/en_US.ISO8859-1/books/porters-handbook X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 28 Oct 2013 18:54:37 -0000 Author: eadler Date: Mon Oct 28 18:54:36 2013 New Revision: 43049 URL: http://svnweb.freebsd.org/changeset/doc/43049 Log: Mention staging as early as possible. Expand a bit on how the ports system operates. Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Mon Oct 28 16:35:02 2013 (r43048) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Mon Oct 28 18:54:36 2013 (r43049) @@ -514,9 +514,8 @@ PLIST_DIRS= lib/X11/onekofetch cannot find the required files in DISTDIR it will look up the URL MASTER_SITES, which is set in the - Makefile, as well as our main FTP site at , - where we put sanctioned distfiles as backup. It will then + Makefile, as well as our FTP mirrors + where we put distfiles as backup. It will then attempt to fetch the named distribution file with FETCH, assuming that the requesting site has direct access to the Internet. If that succeeds, @@ -568,9 +567,21 @@ PLIST_DIRS= lib/X11/onekoThe build target is run. This is responsible for descending into the port's private working directory (WRKSRC) and building - it. If USES= gmake is set, GNU - make will be used, otherwise the system - make will be used. + it. + + + + The stage target is run. + This puts the final set of built files into a temporary + directory (STAGEDIR). The hierarchy of + this directory mirrors that of the system on which the + package will be installed. + + + + The install target is run. + This copies the files listed in the port's pkg-plist to + the host system. @@ -620,7 +631,7 @@ PLIST_DIRS= lib/X11/oneko Now that you understand what goes on when the user types - make, let us go through the recommended + make install, let us go through the recommended steps to create the perfect port.