Date: Mon, 28 Oct 2013 18:54:37 +0000 (UTC) From: Eitan Adler <eadler@FreeBSD.org> 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 Message-ID: <201310281854.r9SIsbIl086377@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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/oneko</programlistin <maketarget>fetch</maketarget> cannot find the required files in <makevar>DISTDIR</makevar> it will look up the URL <makevar>MASTER_SITES</makevar>, which is set in the - Makefile, as well as our main FTP site at <ulink - url="ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/"></ulink>, - 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 <makevar>FETCH</makevar>, assuming that the requesting site has direct access to the Internet. If that succeeds, @@ -568,9 +567,21 @@ PLIST_DIRS= lib/X11/oneko</programlistin <para>The <maketarget>build</maketarget> target is run. This is responsible for descending into the port's private working directory (<makevar>WRKSRC</makevar>) and building - it. If <makevar>USES= gmake</makevar> is set, GNU - <command>make</command> will be used, otherwise the system - <command>make</command> will be used.</para> + it.</para> + </step> + + <step> + <para>The <maketarget>stage</maketarget> target is run. + This puts the final set of built files into a temporary + directory (<makevar>STAGEDIR</makevar>). The hierarchy of + this directory mirrors that of the system on which the + package will be installed.</para> + </step> + + <step> + <para>The <maketarget>install</maketarget> target is run. + This copies the files listed in the port's pkg-plist to + the host system.</para> </step> </procedure> @@ -620,7 +631,7 @@ PLIST_DIRS= lib/X11/oneko</programlistin </note> <para>Now that you understand what goes on when the user types - <command>make</command>, let us go through the recommended + <command>make <maketarget>install</maketarget></command>, let us go through the recommended steps to create the perfect port.</para> </sect1>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201310281854.r9SIsbIl086377>