Revision: 105460 https://trac.macports.org/changeset/105460 Author: mk@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">