os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Mention staging as early as possible. Expand a bit on how the ports system operates.

Browse source
This commit is contained in:
Eitan Adler 2013-10-28 18:54:36 +00:00
parent c3131c7b40
commit c614eae518
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=43049
1 changed files with 18 additions and 7 deletions

25
en_US.ISO8859-1/books/porters-handbook/book.xml
View file

@ -514,9 +514,8 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
<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</programlisting>
<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</programlisting>
</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>