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

Deprecate references to portsnap.

Browse source 
FreeBSD versions newer than 12.1 won't use portsnap anymore, so advise to use
Subversion instead.

While here, fix an errand plural.

Submitted by:	pauamma_gundo.com
Approved by:	bcr
Differential Revision: https://reviews.freebsd.org/D25801
This commit is contained in:
Benedict Reuschling 2020-08-05 11:09:22 +00:00
parent 3ceca207f0
commit 196173d069
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=54396
1 changed files with 21 additions and 25 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

46
en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml
View file

@ -471,7 +471,7 @@ SVN_HOST=svn.FreeBSD.org</programlisting>
kernels can build and run older jails. For instance, a
<literal>13.0-CURRENT</literal> kernel can build and run a
<literal>11.3-STABLE</literal>
<application>Poudriere</application> jails if the
<application>Poudriere</application> jail if the
<literal>COMPAT_FREEBSD11</literal> kernel option was
compiled in (on by default in
<literal>13.0-CURRENT</literal>
@ -534,19 +534,27 @@ JAILNAME VERSION ARCH METHOD
<application>Poudriere</application>. The most
straightforward way is to have
<application>Poudriere</application> create a default ports
tree for itself:</para>
tree for itself, using either &man.portsnap.8; (if running
&os;&nbsp;&rel121.current; or &rel114.current;) or
<application>Subversion</application> (if running
&os.current;):</para>
<screen>&prompt.root; <userinput>poudriere ports -c</userinput></screen>
<screen>&prompt.root; <userinput>poudriere ports -c -m portsnap</userinput></screen>
<para>This command creates
<para>or</para>
<screen>&prompt.root; <userinput>poudriere ports -c -m svn+https</userinput></screen>
<para>These commands create
<literal>tank/poudriere/ports/default</literal>, mount it on
<filename>/poudriere/ports/default</filename>, and populate it
using &man.portsnap.8;. Afterward it is included in the list
of known ports trees:</para>
using either &man.portsnap.8; or
<application>Subversion</application>. Afterward it is
included in the list of known ports trees:</para>
<screen>&prompt.root; <userinput>poudriere ports -l</userinput>
PORTSTREE METHOD PATH
default portsnap /poudriere/ports/default</screen>
PORTSTREE METHOD TIMESTAMP PATH
default svn+https 2020-07-20 04:23:56 /poudriere/ports/default</screen>
<note>
<para>Note that the <quote>default</quote> ports tree is
@ -564,9 +572,8 @@ default portsnap /poudriere/ports/default</screen>
use a different method for creating the ports tree. To add an
additional ports tree for testing local modifications and
ports development, checking out the tree via
<application>Subversion</application> is possible:</para>
<screen>&prompt.root; <userinput>poudriere ports -c -m svn+https -p subversive</userinput></screen>
<application>Subversion</application> (as described above)
is preferable.</para>
<note>
<para>The <acronym>http</acronym> and <acronym>https</acronym>
@ -575,17 +582,6 @@ default portsnap /poudriere/ports/default</screen>
is enabled by default.</para>
</note>
<para>Creates <literal>tank/poudriere/ports/subversive</literal>
and mounts it on
<filename>/poudriere/ports/subversive</filename>. It is then
populated using <application>Subversion</application>.
Finally, it is added to the list of known ports trees:</para>
<screen>&prompt.root; <userinput>poudriere ports -l</userinput>
PORTSTREE METHOD PATH
default portsnap /poudriere/ports/default
subversive svn+https /poudriere/ports/subversive</screen>
<tip>
<para>The <literal>svn</literal> method allows extra
qualifiers to tell <application>Subversion</application>
@ -625,11 +621,11 @@ subversive svn+https /poudriere/ports/subversive</screen>
<para>This will be listed in the table of known trees:</para>
<screen>&prompt.root; <userinput>poudriere ports -l</userinput>
PORTSTREE METHOD PATH
development - /work/ports</screen>
PORTSTREE METHOD TIMESTAMP PATH
development null 2020-07-20 05:06:33 /work/ports</screen>
<note>
<para>The dash in the <literal>METHOD</literal> column means
<para>The dash or <literal>null</literal> in the <literal>METHOD</literal> column means
that <application>Poudriere</application> will not update or
change this ports tree, ever. It is completely up to the
user to maintain this tree, including all local