From: David R. M. <dr...@fi...> - 2007-06-17 22:47:45
|
Begin forwarded message: > From: "David R. Morrison" <dm...@us...> > Date: June 17, 2007 3:44:12 PM PDT > To: fin...@li... > Subject: [cvs] web/xml/packaging packaging.en.xml,1.95,1.96 > Reply-To: fin...@li... > > Update of /cvsroot/fink/web/xml/packaging > In directory sc8-pr-cvs17:/tmp/cvs-serv10817 > > Modified Files: > packaging.en.xml > Log Message: > document the Distribution field > > > Index: packaging.en.xml > =================================================================== > RCS file: /cvsroot/fink/web/xml/packaging/packaging.en.xml,v > retrieving revision 1.95 > retrieving revision 1.96 > diff -u -d -r1.95 -r1.96 > --- packaging.en.xml 4 Mar 2007 22:11:38 -0000 1.95 > +++ packaging.en.xml 17 Jun 2007 22:44:10 -0000 1.96 > @@ -1634,13 +1634,83 @@ > <codeblock> > Package: foo-pm%type_pkg[perl] > Type: perl (5.8.1 5.8.4 5.8.6) > - Architecture: (%type_pkg[perl] = 581) powerpc > + Architecture: (%type_pkg[perl] = 581) powerpc, (%type_pkg[perl] = > 584) powerpc > +</codeblock> > +<p> > +will result in the field for the foo-pm581 and foo-pm584 variants > +being <code>powerpc</code> and the field being blank for the foo- > pm586 > +variant. Remember that when the field is blank, all architectures > +are permitted. > +</p> > +<p>The example above gives a very common use of this field: since > +perl 5.8.1 and perl 5.8.4 are only available on powerpc hardware, > +this field is necessary for any multiple-type perl package under the > +10.4 distribution and later. > +</p> > +</itemd></item> > + > +<item><itemt>Distribution</itemt> > +<itemd> > +<p> > +A comma-separated list of distribution(s) for which the package > +(and any splitoff packages) are intended. > +At present, the only valid values for distribution are <code>10.3</ > code>, > +<code>10.4</code>, > +and <code>10.5</code>. If this field is present and not blank after > +conditional handling, fink will ignore the package description(s) if > +the local machine distribution is not listed. If the field is omitted > +or the value is blank, all distributions are assumed. > +(Introduced in fink 0.26.0.) > +</p> > +<p> > +Since Fink's <code>10.4</code> and <code>10.5</code> distributions > share > +a common set of finkinfo files, the most common use of this field > will be for > +packages which are suitable for one of those distributions but not > the > +other. Since package maintainers may wish to use identical files for > +the 10.3 and 10.4/10.5 trees, the value <code>10.3</code> is often > +included in the distribution field. > +</p> > +<p> > +This field supports the standard conditional syntax for any value in > +the value list and percent-expansions can be used (see > +the <code>Depends</code> field for more information). In this manner, > +certain variants can be restricted to certain architectures. For > +example: > +</p> > +<codeblock> > + Package: foo-pm%type_pkg[perl] > + Type: perl (5.8.1 5.8.6) > + Distribution: (%type_pkg[perl] = 581) 10.3, (%type_pkg[perl] = > 581) 10.4 > </codeblock> > <p> > will result in the field for the foo-pm581 variant > -being <code>powerpc</code> and the field being blank for all other > -variants. Remember that omitting a certain architecture value does > not > -mean that the package is not for that architecture. > +being <code>10.3, 10.4</code> and the field being blank for the > +foo-pm586 variant. > +</p> > +<p>Since python 2.3 is not availble in the 10.5 distribution, and the > +available perl packages vary by distribution, these package types > provide > +a common use of this field. For reference, we note the availabilty > of > +various perl versions in the 10.3, 10.4 and 10.5 distributions: > +</p> > +<codeblock> > + perl 5.6.0: 10.3 > + perl 5.8.0: 10.3 > + perl 5.8.1: 10.3, 10.4 > + perl 5.8.4: 10.3, 10.4 > + perl 5.8.6: 10.3, 10.4, 10.5 > + perl 5.8.8: 10.4, 10.5 > +</codeblock> > +<p>A way to include all variants in a single finkinfo file is as > follows. > +</p> > +<codeblock> > + Package: foo-pm%type_pkg[perl] > + Type: perl (5.6.0 5.8.0 5.8.1 5.8.4 5.8.6 5.8.8) > + Distribution: (%type_pkg[perl] = 560) 10.3, (%type_pkg[perl] = > 580) 10.3, (%type_pkg[perl] = 581) 10.3, (%type_pkg[perl] = 581) > 10.4, (%type_pkg[perl] = 584) 10.3, (%type_pkg[perl] = 584) 10.4, > (%type_pkg[perl] = 588) 10.4, (%type_pkg[perl] = 588) 10.5 > +</codeblock> > +<p>Note that there is no restriction placed on foo-pm586 since perl > 5.8.6 is > +available in all distributions. Also note that we do not include old > +distributions, such as 10.2 or 10.4-transitional, since the > versions of > +fink which are relevant for them do not recognize this field. > </p> > </itemd></item> > > > > ------------------------------------------------------------------------- > This SF.net email is sponsored by DB2 Express > Download DB2 Express C - the FREE version of DB2 express and take > control of your XML. No limits. Just data. Click to get it now. > http://sourceforge.net/powerbar/db2/ > _______________________________________________ > Fink-commits mailing list > Fin...@li... > https://lists.sourceforge.net/lists/listinfo/fink-commits |