[72884] trunk/doc-new/guide/xml

[mk at macports.org]

Revision: 72884
          http://trac.macports.org/changeset/72884
Author:   mk at macports.org
Date:     2010-10-29 13:05:50 -0700 (Fri, 29 Oct 2010)
Log Message:
-----------
guide: insert an introduction to port groups

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

Added Paths:
-----------
    trunk/doc-new/guide/xml/portgroups.xml

Modified: trunk/doc-new/guide/xml/portfileref.xml
===================================================================
--- trunk/doc-new/guide/xml/portfileref.xml	2010-10-29 18:10:03 UTC (rev 72883)
+++ trunk/doc-new/guide/xml/portfileref.xml	2010-10-29 20:05:50 UTC (rev 72884)
@@ -35,6 +35,9 @@
   <section id="reference.portgroup">
     <title>PortGroups</title>
 
+    <xi:include href="portgroups.xml"
+                xmlns:xi="http://www.w3.org/2001/XInclude" />
+
     <xi:include href="portgroup-gnustep.xml"
                 xmlns:xi="http://www.w3.org/2001/XInclude" />
 

Added: trunk/doc-new/guide/xml/portgroups.xml
===================================================================
--- trunk/doc-new/guide/xml/portgroups.xml	                        (rev 0)
+++ trunk/doc-new/guide/xml/portgroups.xml	2010-10-29 20:05:50 UTC (rev 72884)
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
+<section id="reference.portgroup.gnustep">
+
+  <title>PortGroup introduction</title>
+
+  <para>Port groups allow for efficient porting of open source software using the GNU objective-C runtime that defines options for the configuration, build, and destroot phases, and also defines some values for a specific software. A minimum Portfile using a PortGroup class needs to only define the fetch and the checksum phases.</para>
+  
+  <para>See the following folder for currently defined port groups:</para>
+  <filename>${prefix}/var/macports/sources/rsync.macports.org/release/ports/_resources/port1.0/group/</filename>
+
+  <para>This folder contains various tcl files which are describing all port groups. It follows an examplary (incomplete) listing:</para>
+
+    <programlisting><prompt>%%</prompt> <userinput>ls -1 /opt/local/var/macports/sources/rsync.macports.org/release/ports/_resources/port1.0/group/</userinput></programlisting>
+
+    <screen>archcheck-1.0.tcl
+            cmake-1.0.tcl
+            crossbinutils-1.0.tcl
+            gnustep-1.0.tcl
+            haskell-1.0.tcl
+            hocbinding-1.0.tcl
+            hunspelldict-1.0.tcl
+            kde4-1.0.tcl
+            kde4-1.1.tcl
+            .
+            .
+            .</screen>
+
+
+</section>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20101029/8cc2067c/attachment.html>