From clsung@FreeBSD.csie.nctu.edu.tw  Thu Jul  6 15:32:48 2006
Return-Path: <clsung@FreeBSD.csie.nctu.edu.tw>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 2590D16A4E0
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Jul 2006 15:32:48 +0000 (UTC)
	(envelope-from clsung@FreeBSD.csie.nctu.edu.tw)
Received: from FreeBSD.csie.nctu.edu.tw (freebsd.csie.nctu.edu.tw [140.113.17.209])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 9613343D83
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Jul 2006 15:32:38 +0000 (GMT)
	(envelope-from clsung@FreeBSD.csie.nctu.edu.tw)
Received: from localhost (localhost.csie.nctu.edu.tw [127.0.0.1])
	by FreeBSD.csie.nctu.edu.tw (Postfix) with ESMTP id 2EB047E90F
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  6 Jul 2006 23:34:22 +0800 (CST)
Received: from FreeBSD.csie.nctu.edu.tw ([127.0.0.1])
	by localhost (FreeBSD.csie.nctu.edu.tw [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id VyVBAW5h+wdk for <FreeBSD-gnats-submit@freebsd.org>;
	Thu,  6 Jul 2006 23:34:21 +0800 (CST)
Received: by FreeBSD.csie.nctu.edu.tw (Postfix, from userid 1038)
	id A5D9F7E911; Thu,  6 Jul 2006 23:34:21 +0800 (CST)
Message-Id: <20060706153421.A5D9F7E911@FreeBSD.csie.nctu.edu.tw>
Date: Thu,  6 Jul 2006 23:34:21 +0800 (CST)
From: Cheng-Lung Sung <clsung@FreeBSD.org>
Reply-To: Cheng-Lung Sung <clsung@FreeBSD.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] First introduce porttools to Porter's Handbook
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         99845
>Category:       docs
>Synopsis:       [patch] First introduce porttools to Porter's Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gabor
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jul 06 15:40:14 GMT 2006
>Closed-Date:    Tue Feb 20 15:43:18 GMT 2007
>Last-Modified:  Tue Feb 20 15:50:05 GMT 2007
>Originator:     Cheng-Lung Sung
>Release:        FreeBSD 6.1-PRERELEASE i386
>Organization:
FreeBSD @ Taiwan
>Environment:
System: FreeBSD.csie.nctu.edu.tw 6.1-STABLE FreeBSD 6.1-STABLE #9: Thu May 11 14:31:45 CST 2006     root@FreeBSD.csie.nctu.edu.tw:/home/usr.obj/usr/src/sys/FREEBSD  i386

>Description:
- devel/porttools is there. But Porter's Handbook didn't mention about it.
  - docs about porttools will be updated/add in the future.
>How-To-Repeat:
>Fix:


Index: book.sgml
===================================================================
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	6 Jul 2006 15:29:51 -0000
@@ -6777,6 +6777,22 @@
 	  doubt, the best thing to do is ask on &a.ports;.</para>
       </sect1>
 
+      <sect1 id="testing-porttools">
+	<title>Port Tools</title>
+
+	<para>The <filename role="package">devel/porttools</filename>
+          program is part of the ports collection.</para>
+
+	<para>The <command>port</command> is the front-end script,
+	  it can help you simplify the testing job. Whenever you want 
+	  to test a new port or update a port, 
+	  <command>port test</command> will automate the process of 
+	  port testing, including <link
+	  linkend="testing-portlint"><command>portlint</command></link>
+	  checking. This command also detects and lists any files not 
+	  listed in <filename>pkg-plist</filename>.</para>
+      </sect1>
+
       <sect1 id="porting-prefix">
 	<title><makevar>PREFIX</makevar></title>
 

>Release-Note:
>Audit-Trail:

From: Pav Lucistnik <pav@FreeBSD.org>
To: Cheng-Lung Sung <clsung@FreeBSD.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/99845: [patch] First introduce porttools to Porter's
	Handbook
Date: Thu, 06 Jul 2006 19:59:56 +0200

 --=-4mQ3rvzLGljLu/vFM75F
 Content-Type: text/plain; charset=ISO-8859-2
 Content-Transfer-Encoding: quoted-printable
 
 Cheng-Lung Sung p=ED=B9e v =E8t 06. 07. 2006 v 23:34 +0800:
 
 > 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	6 Jul 2006 15:29:51 -0000
 > @@ -6777,6 +6777,22 @@
 >  	  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 <filename role=3D"package">devel/porttools</filename>
 > +          program is part of the ports collection.</para>
 > +
 > +	<para>The <command>port</command> is the front-end script,
 > +	  it can help you simplify the testing job. Whenever you want=20
 > +	  to test a new port or update a port,=20
 > +	  <command>port test</command> will automate the process of=20
 > +	  port testing, including <link
 > +	  linkend=3D"testing-portlint"><command>portlint</command></link>
 > +	  checking. This command also detects and lists any files not=20
 > +	  listed in <filename>pkg-plist</filename>.</para>
 > +      </sect1>
 > +
 >        <sect1 id=3D"porting-prefix">
 >  	<title><makevar>PREFIX</makevar></title>
 
 I don't particularly like the English of this text.
 
 
 --=20
 Pav Lucistnik <pav@oook.cz>
               <pav@FreeBSD.org>
 
 Like 'Do Notte Buye Betamacks.' That was a prediction for 1972.
 
 --=-4mQ3rvzLGljLu/vFM75F
 Content-Type: application/pgp-signature; name=signature.asc
 Content-Description: Toto je =?UTF-8?Q?digit=C3=A1ln=C4=9B?=
 	=?ISO-8859-1?Q?_podepsan=E1?= =?UTF-8?Q?_=C4=8D=C3=A1st?=
 	=?ISO-8859-1?Q?_zpr=E1vy?=
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.4 (FreeBSD)
 
 iD8DBQBErU+bntdYP8FOsoIRAnkNAJ9nk+a6WeVfn+r3g3v0gY9/CSrEqgCfZUqz
 WOs1fayEP3lcyPD03VTFdkQ=
 =MYsY
 -----END PGP SIGNATURE-----
 
 --=-4mQ3rvzLGljLu/vFM75F--

From: Cheng-Lung Sung <clsung@FreeBSD.org>
To: Pav Lucistnik <pav@FreeBSD.org>
Cc: FreeBSD-gnats-submit@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--
Responsible-Changed-From-To: freebsd-doc->gabor 
Responsible-Changed-By: gabor 
Responsible-Changed-When: Sun Feb 18 00:25:57 UTC 2007 
Responsible-Changed-Why:  
Take. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=99845 
State-Changed-From-To: open->closed 
State-Changed-By: gabor 
State-Changed-When: Tue Feb 20 15:42:44 UTC 2007 
State-Changed-Why:  
I committed a slightly different text. Thanks for the contribution! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=99845 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/99845: commit references a PR
Date: Tue, 20 Feb 2007 15:44:55 +0000 (UTC)

 gabor       2007-02-20 15:44:47 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/porters-handbook book.sgml 
   Log:
   - Add some basic info about porttools
   
   PR:             docs/99845
   Submitted by:   clsung
   Approved by:    keramida (mentor)
   
   Revision  Changes    Path
   1.802     +18 -0     doc/en_US.ISO8859-1/books/porters-handbook/book.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
