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