[105460] trunk/doc-new/guide/xml/portfiledev.xml
mk at macports.org
mk at macports.org
Sun Apr 21 06:03:22 PDT 2013
Revision: 105460
https://trac.macports.org/changeset/105460
Author: mk at macports.org
Date: 2013-04-21 06:03:22 -0700 (Sun, 21 Apr 2013)
Log Message:
-----------
Guide: describe portgroup obsolete
Modified Paths:
--------------
trunk/doc-new/guide/xml/portfiledev.xml
Modified: trunk/doc-new/guide/xml/portfiledev.xml
===================================================================
--- trunk/doc-new/guide/xml/portfiledev.xml 2013-04-21 12:59:05 UTC (rev 105459)
+++ trunk/doc-new/guide/xml/portfiledev.xml 2013-04-21 13:03:22 UTC (rev 105460)
@@ -874,6 +874,12 @@
unnecessary due to the fact that skrooge's developers currently prefer a
distribution via port <quote>skrooge</quote> instead. </para>
+ <para>At the end of this section the use of the obsolete PortGroup is suggested
+ as an even shorter approach to the below described workflow.</para>
+
+ <section id="development.replaced_by">
+ <title>The long way</title>
+
<para>Skrooge's original devel port file looked like this:</para>
<programlisting># -*- coding: utf-8; mode: tcl; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; truncate-lines: t -*- vim:fenc=utf-8:et:sw=4:ts=4:sts=4
@@ -1042,7 +1048,34 @@
Error: Status 1 encountered during processing.
To report a bug, see <http://guide.macports.org/#project.tickets></screen>
+ </section>
+
+ <section id="development.obsolete-portgroup">
+ <title>The shortcut: PortGroup obsolete</title>
+
+ <para>Using the PortGroup obsolete makes the task described in the previous subsection
+ much easier:</para>
+
+ <programlisting>
+# -*- coding: utf-8; mode: tcl; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; truncate-lines: t -*- vim:fenc=utf-8:et:sw=4:ts=4:sts=4
+# $Id$
+PortSystem 1.0
+replaced_by skrooge
+PortGroup obsolete 1.0
+name skrooge-devel
+svn.revision 1215845
+version 0.8.0-${svn.revision}
+revision 2</programlisting>
+
+ <para>The PortGroup defines a number of reasonable defaults for a port that is only
+ there to inform users that they should uninstall it and install something else
+ instead. You might want to override some of the defaults though. For details have
+ a look at the PortGroup's source code in
+ <filename>${prefix}/var/macports/sources/rsync.macports.org/release/ports/_resources/port1.0/group/obsolete-1.0.tcl</filename>.</para>
+
</section>
+
+ </section>
<section id="development.practices.removing-port">
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20130421/948ac74f/attachment.html>
More information about the macports-changes
mailing list