svn commit: r43049 - head/en_US.ISO8859-1/books/porters-handbook

[Eitan Adler]

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>