Changes between Version 15 and Version 16 of PortfileRecipes

Timestamp:

Jan 30, 2010, 10:08:54 AM (14 years ago)

Author:

ryandesign (Ryan Carsten Schmidt)

Comment:

Split unversioned distfiles section out of stealth upgrades section

PortfileRecipes

@@ -141 +141 @@
 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 == #stealth-updates
-Some software may update their distfile with new changes without changing the version number (e.g., it stays example-1.2.tar.gz); another case where this happens is when the distfile is unversioned (e.g., example.tar.gz).  The safest way to deal with this is to keep the port's version unchanged (e.g., stays at 1.2) while increasing the revision.  This however will cause a checksum mismatch for those who already have the previous distfile.  To work around this, set dist_subdir so that it includes the version and revision:
+== Stealth updates == #stealth-updates
+Some software may update their distfile with new changes without changing the version number (e.g., it stays example-1.2.tar.gz). The safest way to deal with this is to keep the port's version unchanged (e.g., stays at 1.2) while increasing the revision.  This however will cause a checksum mismatch for those who already have the previous distfile.  The correct solution to this problem is to change dist_subdir. By default, dist_subdir is ${name}; change it so that it includes a subdirectory named for the version and revision:
 {{{
 dist_subdir   ${name}/${version}_${revision}
 }}}
-See for example the [browser:trunk/dports/lang/sicp/Portfile sicp Portfile].
+This example is from the [browser:trunk/dports/lang/sicp/Portfile sicp Portfile].
+
+See also the next entry on [#unversioned-distfiles unversioned distfiles].
+
+== Unversioned distfiles == #unversioned-distfiles
+Some software may distribute their distfile with a filename that does not contain the version number (e.g. example.tar.gz); such a port will likely change distname from its default ${name}-${version} to just ${name}. But when updating the port version, the old version's distfile will get in the way, since it has the same name.  The correct solution to this problem is to change dist_subdir. By default, dist_subdir is ${name}; change it so that it includes a subdirectory named for the version:
+{{{
+dist_subdir   ${name}/${version}
+}}}
+This example is from the [browser:trunk/dports/x11/winetricks/Portfile winetricks Portfile].
+
+See also the previous entry on [#stealth-updates stealth updates].
 
 == Proper handling for a port's config files == #configfiles