[MacPorts] PortfileRecipes modified

[MacPorts]

Changed page "PortfileRecipes" by blb at macports.org from 75.163.188.200*
Page URL: <http://trac.macports.org/wiki/PortfileRecipes>
Diff URL: <http://trac.macports.org/wiki/PortfileRecipes?action=diff&version=6>
Revision 6
Comment: Add entry about dealing with stealth updates and dist_subdir

-------8<------8<------8<------8<------8<------8<------8<------8<--------
Index: PortfileRecipes
=========================================================================
--- PortfileRecipes (version: 5)
+++ PortfileRecipes (version: 6)
@@ -105,4 +105,9 @@
 For example, libpixman is known to work with Xcode 1.5 but fail with 1.1, so [changeset:45892 libpixman now requires Xcode 1.5] on Panther, even though compatibility with Xcode 1.2 was not tested.
 It is better to make a user upgrade to a newer Xcode than for a port maintainer to spend time testing old versions.
 
-
+== Dealing with stealth updates ==
+Some software may update their distfile with new changes without changing the version number (eg, it stays example-1.2.tar.gz); another case where this happens is when the distfile is unversioned (eg, example.tar.gz).  The safest way to deal with this is to keep the port's version unchanged (eg, stays at 1.2) while increasing the revision.  This however causes upgrade issues for those with it already as the update will include different checksums, but those who've already downloaded the distfile now have incorrect checksums.  To work around this, set dist_subdir so that it includes the version and revision:
+{{{
+dist_subdir   ${name}/${version}_${revision}
+}}}
+See for example the [browser:trunk/dports/lang/sicp/Portfile sicp Portfile].

-------8<------8<------8<------8<------8<------8<------8<------8<--------

* The IP shown here might not mean anything if the user or the server is
behind a proxy.

--
MacPorts <http://www.macports.org/>
Ports system for Mac OS

This is an automated message. Someone at http://www.macports.org/ added your email
address to be notified of changes on PortfileRecipes. If it was not you, please
report to .