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

[Tobias Kortkamp]

Author: tobik (ports committer)
Date: Mon Aug 19 13:26:11 2019
New Revision: 53309
URL: https://svnweb.freebsd.org/changeset/doc/53309

Log:
  Porter's Handbook: Suggest using Poudriere in using-cargo section
  
  Also improve section title.
  
  Approved by:	mat
  Differential Revision:	https://reviews.freebsd.org/D21253

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Mon Aug 19 10:01:13 2019	(r53308)
+++ head/en_US.ISO8859-1/books/porters-handbook/special/chapter.xml	Mon Aug 19 13:26:11 2019	(r53309)
@@ -819,7 +819,8 @@ CMAKE_OFF=	VAR3</programlisting>
     </sect2>
 
     <sect2 xml:id="using-cargo">
-      <title>Using <command>cargo</command></title>
+      <title>Building <application>Rust</application> Applications
+	with <command>cargo</command></title>
 
       <para>For ports that use <application>Cargo</application>,
 	define <literal>USES=cargo</literal>.</para>
@@ -1105,19 +1106,13 @@ rust/crates/atty-0.2.9.tar.gz                 100% of 
 => rust/crates/bitflags-1.0.1.tar.gz doesn't seem to exist in /usr/ports/distfiles/.
 [...]</screen>
 
-	<para>The working directory currently only contains the
-	  application sources we extracted as part of the
-	  <command>make cargo-crates</command> step.  Before
-	  attempting to build the port the working directory
-	  must be cleaned, so that the crate sources can be
-	  extracted into <varname>CARGO_VENDOR_DIR</varname>:</para>
-
-	<screen>&prompt.user; <userinput>make clean</userinput>
-===> Cleaning for tokei-7.0.2</screen>
-
 	<para>The port is now ready for a test build and further
 	  adjustments like creating a plist, writing a description,
 	  adding license information, options, etc. as normal.</para>
+
+	<para>If you are not testing your port in a clean environment
+	  like with <application>Poudriere</application>, remember to
+	  run <command>make clean</command> before any testing.</para>
       </example>
 
       <example xml:id="cargo-ex2">