Bug 99845

Summary: [patch] First introduce porttools to Porter's Handbook
Product: Documentation Reporter: Cheng-Lung Sung <clsung>
Component: Books & ArticlesAssignee: Gabor Kovesdan <gabor>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description Cheng-Lung Sung freebsd_committer freebsd_triage 2006-07-06 16:40:14 UTC
- devel/porttools is there. But Porter's Handbook didn't mention about it.
  - docs about porttools will be updated/add in the future.
Comment 1 Pav Lucistnik freebsd_committer freebsd_triage 2006-07-06 18:59:56 UTC
Cheng-Lung Sung pí¹e v èt 06. 07. 2006 v 23:34 +0800:

> 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>


I don't particularly like the English of this text.


-- 
Pav Lucistnik <pav@oook.cz>
              <pav@FreeBSD.org>

Like 'Do Notte Buye Betamacks.' That was a prediction for 1972.
Comment 2 Cheng-Lung Sung freebsd_committer freebsd_triage 2006-07-07 03:35:32 UTC
On Thu, Jul 06, 2006 at 07:59:56PM +0200, Pav Lucistnik wrote:
> 
> I don't particularly like the English of this text.
> 


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	7 Jul 2006 02:33:07 -0000
@@ -6777,6 +6777,43 @@
 	  doubt, the best thing to do is ask on &a.ports;.</para>
       </sect1>
 
+      <sect1 id="testing-porttools">
+	<title>Port Tools</title>
+
+	<para>The <command>port</command> is the front-end script of
+	  the <filename role="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 
+	  <command>portlin -abt</command>, and then
+	  check for any errors or warnings via the following steps:</para>
+	  
+	<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 
+	  listed in <filename>pkg-plist</filename>.</para>
+      </sect1>
+
       <sect1 id="porting-prefix">
 	<title><makevar>PREFIX</makevar></title>
 
-- 
Cheng-Lung Sung - clsung@
Comment 3 Gabor Kovesdan freebsd_committer freebsd_triage 2007-02-18 00:25:57 UTC
Responsible Changed
From-To: freebsd-doc->gabor

Take.
Comment 4 Gabor Kovesdan freebsd_committer freebsd_triage 2007-02-20 15:42:44 UTC
State Changed
From-To: open->closed

I committed a slightly different text. Thanks for the contribution!
Comment 5 dfilter service freebsd_committer freebsd_triage 2007-02-20 15:44:55 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"