<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; }
#msg ul, pre { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[27395] trunk/doc/guide/new/xml/portfileref.xml</title>
</head>
<body>

<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.macosforge.org/projects/macports/changeset/27395">27395</a></dd>
<dt>Author</dt> <dd>markd@macports.org</dd>
<dt>Date</dt> <dd>2007-08-02 01:03:21 -0700 (Thu, 02 Aug 2007)</dd>
</dl>

<h3>Log Message</h3>
<pre>Reduce the section depth of the PortGroup section..</pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkdocguidenewxmlportfilerefxml">trunk/doc/guide/new/xml/portfileref.xml</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkdocguidenewxmlportfilerefxml"></a>
<div class="modfile"><h4>Modified: trunk/doc/guide/new/xml/portfileref.xml (27394 => 27395)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/doc/guide/new/xml/portfileref.xml        2007-08-02 07:38:52 UTC (rev 27394)
+++ trunk/doc/guide/new/xml/portfileref.xml        2007-08-02 08:03:21 UTC (rev 27395)
</span><span class="lines">@@ -450,7 +450,7 @@
</span><span class="cx">     &lt;/section&gt;
</span><span class="cx"> 
</span><span class="cx">     &lt;section&gt;
</span><del>-      &lt;title&gt;PortGroup&lt;/title&gt;
</del><ins>+      &lt;title&gt;PortGroup Variables&lt;/title&gt;
</ins><span class="cx"> 
</span><span class="cx">       &lt;para&gt;In addition to the general &lt;filename&gt;Portfile&lt;/filename&gt; type for
</span><span class="cx">       standard Unix applications and libraries, there are six optional
</span><span class="lines">@@ -483,160 +483,173 @@
</span><span class="cx">         &lt;/listitem&gt;
</span><span class="cx">       &lt;/itemizedlist&gt;
</span><span class="cx"> 
</span><del>-      &lt;para&gt;The common PortGroup variables are listed in the sections below
-      for perl5, python, and ruby. See the port Tcl group code in
-      &lt;filename&gt;${prefix}/share/macports/resources/port1.0/group&lt;/filename&gt;
-      for details on all PortGroups.&lt;/para&gt;
</del><ins>+      &lt;para&gt;Some PortGroups provide additional variables when the group is
+      declared within a Portfile. The additional variables provided by
+      PortGroups perl5, python, and ruby are listed below. You may view the
+      port Tcl code for each group in the
+      directory&lt;filename&gt;${prefix}/share/macports/resources/port1.0/group&lt;/filename&gt;.&lt;/para&gt;
</ins><span class="cx"> 
</span><del>-      &lt;section&gt;
-        &lt;title&gt;PortGroup perl5&lt;/title&gt;
</del><ins>+      &lt;variablelist&gt;
+        &lt;varlistentry&gt;
+          &lt;term&gt;PortGroup perl5&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-        &lt;para&gt;These are the variables available to a
-        &lt;filename&gt;Portfile&lt;/filename&gt; when the &lt;literal&gt;PortGroup
-        perl5&lt;/literal&gt; keyword is declared.&lt;/para&gt;
</del><ins>+          &lt;listitem&gt;
+            &lt;para&gt;Description: The variables available to a
+            &lt;filename&gt;Portfile&lt;/filename&gt; when the &lt;literal&gt;PortGroup
+            perl5&lt;/literal&gt; keyword is declared.&lt;/para&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;perl5.version&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;perl5.version&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;The MacPorts Perl version.&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;The MacPorts Perl version.&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;perl5.bin&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;perl5.bin&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;The Perl binary path (ie,
-              &lt;filename&gt;${prefix}/bin/perl&lt;/filename&gt;).&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;The Perl binary path (ie,
+                  &lt;filename&gt;${prefix}/bin/perl&lt;/filename&gt;).&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;perl5.lib&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;perl5.lib&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;Path to the Perl vendor directory.&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;Path to the Perl vendor directory.&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;perl5.archlib&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;perl5.archlib&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;Path to the Perl architecture-dependent modules
-              directory.&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
-      &lt;/section&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;Path to the Perl architecture-dependent modules
+                  directory.&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
+          &lt;/listitem&gt;
+        &lt;/varlistentry&gt;
+      &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-      &lt;section&gt;
-        &lt;title&gt;PortGroup python2x&lt;/title&gt;
</del><ins>+      &lt;variablelist&gt;
+        &lt;varlistentry&gt;
+          &lt;term&gt;PortGroup python2x&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-        &lt;para&gt;These are the variables available to a
-        &lt;filename&gt;Portfile&lt;/filename&gt; when the &lt;literal&gt;PortGroup
-        python2x&lt;/literal&gt; keyword is declared.&lt;/para&gt;
</del><ins>+          &lt;listitem&gt;
+            &lt;para&gt;Description: The variables available to a
+            &lt;filename&gt;Portfile&lt;/filename&gt; when the &lt;literal&gt;PortGroup
+            python2x&lt;/literal&gt; keyword is declared.&lt;/para&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;python.bin&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;python.bin&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;The MacPorts Python binary location.&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;The MacPorts Python binary location.&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;python.lib&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;python.lib&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;The Python dynamic library and path (ie,
-              &lt;filename&gt;${prefix}/lib/libpython2.x.dylib&lt;/filename&gt;).&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;The Python dynamic library and path (ie,
+                  &lt;filename&gt;${prefix}/lib/libpython2.x.dylib&lt;/filename&gt;).&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;python.pkgd&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;python.include&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;Path to the Python site-packages directory. (ie,
-              &lt;filename&gt;${prefix}/lib/python2.4/site-packages&lt;/filename&gt;).&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;Path to the Python include directory.&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;python.include&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;python.pkgd&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;Path to the Python include directory.&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
-      &lt;/section&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;Path to the Python site-packages directory. (ie,
+                  &lt;filename&gt;${prefix}/lib/python2.4/site-packages&lt;/filename&gt;).&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
+          &lt;/listitem&gt;
+        &lt;/varlistentry&gt;
+      &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-      &lt;section&gt;
-        &lt;title&gt;PortGroup ruby&lt;/title&gt;
</del><ins>+      &lt;variablelist&gt;
+        &lt;varlistentry&gt;
+          &lt;term&gt;PortGroup ruby&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-        &lt;para&gt;These are the variables available to a
-        &lt;filename&gt;Portfile&lt;/filename&gt; when the &lt;literal&gt;PortGroup
-        ruby&lt;/literal&gt; keyword is declared.&lt;/para&gt;
</del><ins>+          &lt;listitem&gt;
+            &lt;para&gt;Description: The variables available to a
+            &lt;filename&gt;Portfile&lt;/filename&gt; when the &lt;literal&gt;PortGroup
+            ruby&lt;/literal&gt; keyword is declared.&lt;/para&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;ruby.version&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;ruby.version&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;The MacPorts Ruby version.&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;The MacPorts Ruby version.&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;ruby.bin&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;ruby.bin&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;The Ruby binary location.&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;The Ruby binary location.&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;ruby.lib&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;ruby.lib&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;Path to the Ruby vendorlibdir directory (ie,
-              &lt;filename&gt;${prefix}/lib/ruby/vendor_ruby/${ruby.version}&lt;/filename&gt;)&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;Path to the Ruby vendorlibdir directory (ie,
+                  &lt;filename&gt;${prefix}/lib/ruby/vendor_ruby/${ruby.version}&lt;/filename&gt;)&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
</ins><span class="cx"> 
</span><del>-        &lt;variablelist&gt;
-          &lt;varlistentry&gt;
-            &lt;term&gt;ruby.archlib&lt;/term&gt;
</del><ins>+            &lt;variablelist&gt;
+              &lt;varlistentry&gt;
+                &lt;term&gt;ruby.archlib&lt;/term&gt;
</ins><span class="cx"> 
</span><del>-            &lt;listitem&gt;
-              &lt;para&gt;Path to the Ruby vendor archdir (ie,
-              &lt;filename&gt;${ruby.lib}/${ruby.arch}&lt;/filename&gt;).&lt;/para&gt;
-            &lt;/listitem&gt;
-          &lt;/varlistentry&gt;
-        &lt;/variablelist&gt;
-      &lt;/section&gt;
</del><ins>+                &lt;listitem&gt;
+                  &lt;para&gt;Path to the Ruby vendor archdir (ie,
+                  &lt;filename&gt;${ruby.lib}/${ruby.arch}&lt;/filename&gt;).&lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/varlistentry&gt;
+            &lt;/variablelist&gt;
+          &lt;/listitem&gt;
+        &lt;/varlistentry&gt;
+      &lt;/variablelist&gt;
</ins><span class="cx">     &lt;/section&gt;
</span><span class="cx">   &lt;/section&gt;
</span><span class="cx"> 
</span></span></pre>
</div>
</div>

</body>
</html>