[27771] trunk/doc/guide/new/xml/portfileref.xml

[source_changes at macosforge.org]

Revision: 27771
          http://trac.macosforge.org/projects/macports/changeset/27771
Author:   markd at macports.org
Date:     2007-08-13 21:28:14 -0700 (Mon, 13 Aug 2007)

Log Message:
-----------
Change the Tcl primitives section intro.

Modified Paths:
--------------
    trunk/doc/guide/new/xml/portfileref.xml

Modified: trunk/doc/guide/new/xml/portfileref.xml
===================================================================
--- trunk/doc/guide/new/xml/portfileref.xml	2007-08-14 04:21:59 UTC (rev 27770)
+++ trunk/doc/guide/new/xml/portfileref.xml	2007-08-14 04:28:14 UTC (rev 27771)
@@ -1445,12 +1445,15 @@
   </section>
 
   <section>
-    <title>Tcl Primitives</title>
+    <title>Tcl Code and Primitives</title>
 
     <para>A MacPorts <filename>Portfile</filename> is a Tcl script, so it may
-    contain Tcl code anywhere within it, whether in the global section or a
-    phase. The Tcl primitives listed below are defined within the MacPorts
-    base code for use in Portfiles.</para>
+    contain any arbitrary Tcl code you may learn about in a <ulink
+    url="http://tmml.sourceforge.net/doc/tcl/">Tcl reference manual</ulink>.
+    However, few authors will use arbitrary Tcl code; the vast majority will
+    use Tcl primitives that were coded within MacPorts for performing the most
+    common tasks needed for Portfiles. The list below is an exhaustive list of
+    Tcl primitives provided by MacPorts base.</para>
 
     <variablelist>
       <varlistentry>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20070813/f369a7e2/attachment.html