docs/99845: [patch] First introduce porttools to Porter's Handbook

[Cheng-Lung Sung]

The following reply was made to PR docs/99845; it has been noted by GNATS.

From: Cheng-Lung Sung <clsung at FreeBSD.org>
To: Pav Lucistnik <pav at FreeBSD.org>
Cc: FreeBSD-gnats-submit at FreeBSD.org
Subject: Re: docs/99845: [patch] First introduce porttools to Porter's Handbook
Date: Fri, 7 Jul 2006 10:35:32 +0800

 --J/dobhs11T7y2rNN
 Content-Type: text/plain; charset=big5
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On Thu, Jul 06, 2006 at 07:59:56PM +0200, Pav Lucistnik wrote:
 >=20
 > I don't particularly like the English of this text.
 >=20
 
 Index: book.sgml
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
 retrieving revision 1.728
 diff -u -r1.728 book.sgml
 --- book.sgml	6 Jul 2006 06:35:21 -0000	1.728
 +++ book.sgml	7 Jul 2006 02:33:07 -0000
 @@ -6777,6 +6777,43 @@
  	  doubt, the best thing to do is ask on &a.ports;.</para>
        </sect1>
 =20
 +      <sect1 id=3D"testing-porttools">
 +	<title>Port Tools</title>
 +
 +	<para>The <command>port</command> is the front-end script of
 +	  the <filename role=3D"package">devel/porttools</filename>
 +	  tool.</para>
 +	<para>When the user runs <command>port test</command>, the
 +	  script will first check for any common errors via=20
 +	  <command>portlin -abt</command>, and then
 +	  check for any errors or warnings via the following steps:</para>
 +	 =20
 +	<procedure>
 +	  <step>
 +	    <para><command>make clean</command></para>
 +	  </step>
 +
 +	  <step>
 +	    <para><command>make build</command></para>
 +	  </step>
 +
 +	  <step>
 +	    <para><command>make install</command></para>
 +	  </step>
 +
 +	  <step>
 +	    <para><command>make package</command></para>
 +	  </step>
 +
 +	  <step>
 +	    <para><command>make deinstall</command></para>
 +	  </step>
 +	</procedure>
 +
 +	<para>Finally, it will also detect and list any files or diectories not=
 =20
 +	  listed in <filename>pkg-plist</filename>.</para>
 +      </sect1>
 +
        <sect1 id=3D"porting-prefix">
  	<title><makevar>PREFIX</makevar></title>
 =20
 --=20
 Cheng-Lung Sung - clsung@
 
 --J/dobhs11T7y2rNN
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.4 (FreeBSD)
 
 iD8DBQFErchz+AeJ85Vui8ERAlgfAJ91WOBamVTE/sWEJrGD5lBpeQSybACgkbNg
 mFaycN5aCR5lkheethUJX4M=
 =TPD7
 -----END PGP SIGNATURE-----
 
 --J/dobhs11T7y2rNN--