Update of /cvsroot/fink/web/doc/packaging
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv6934/web/doc/packaging
Modified Files:
format.en.php fslayout.en.php index.en.php intro.en.php
packaging.en.html policy.en.php reference.en.php
Log Message:
Notes about Revision field increment and misuse of Depends on multiple
major verions of a library.
Index: intro.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/intro.en.php,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -d -r1.37 -r1.38
--- intro.en.php 7 Sep 2004 09:59:14 -0000 1.37
+++ intro.en.php 7 Sep 2004 11:54:33 -0000 1.38
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Intro";
$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/09/07 09:57:30';
+$cvs_date = 'Date: 2004/09/07 11:52:24';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="format.php?phpLang=en" title="Package
Descriptions"><link rel="prev" href="index.php?phpLang=en" title="Packaging
Contents">';
Index: format.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/format.en.php,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -d -r1.37 -r1.38
--- format.en.php 7 Sep 2004 09:59:14 -0000 1.37
+++ format.en.php 7 Sep 2004 11:54:33 -0000 1.38
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Package Descriptions";
$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/09/07 09:57:30';
+$cvs_date = 'Date: 2004/09/07 11:52:24';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="policy.php?phpLang=en" title="Packaging Policy"><link
rel="prev" href="intro.php?phpLang=en" title="Introduction">';
Index: policy.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/policy.en.php,v
retrieving revision 1.38
retrieving revision 1.39
diff -u -d -r1.38 -r1.39
--- policy.en.php 7 Sep 2004 09:59:14 -0000 1.38
+++ policy.en.php 7 Sep 2004 11:54:33 -0000 1.39
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Policy";
$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/09/07 09:57:30';
+$cvs_date = 'Date: 2004/09/07 11:52:24';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="fslayout.php?phpLang=en" title="Filesystem
Layout"><link rel="prev" href="format.php?phpLang=en" title="Package Descriptions">';
Index: reference.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/reference.en.php,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -d -r1.39 -r1.40
--- reference.en.php 7 Sep 2004 09:59:14 -0000 1.39
+++ reference.en.php 7 Sep 2004 11:54:33 -0000 1.40
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Reference";
$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/09/07 09:57:30';
+$cvs_date = 'Date: 2004/09/07 11:52:24';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="prev" href="fslayout.php?phpLang=en" title="Filesystem Layout">';
@@ -109,6 +109,20 @@
Revision numbers start at 1.
Required field.
</p>
+<p>
+ Fink's policy is that <b>any</b> time you make a change to the
+ <code>.info</code> file that results in changes to the
+ binary (compiled) form of a package (the <code>.deb</code>
+ file), you <b>must</b> increase <code>Revision</code>. This
+ includes changing the <code>Depends</code> or other package lists,
+ with the exception of<code>BuildDepends</code>, and adding,
+ removing, or renaming splitoff packages or shifting files among
+ them. When migrating a package to a new tree (from 10.2 to 10.3, for
+ example) involves such changes, you should
+ increase <code>Revision</code> by 10 in the newer tree in order to
+ leave space space for future updates to the package in the older
+ tree.
+</p>
</td></tr><tr valign="top"><td>Epoch</td><td>
<p>
<b>Introduced in fink 0.12.0.</b>
@@ -310,6 +324,32 @@
would set the package x11 as a dependency for the nethack-x11 variant
but not for the nethack variant.
</p>
+<p>
+ Note that when using Depends/BuildDepends for shared library packages
+ for which more than one major-version is available, you must
+ <b>not</b> do the following:
+</p>
+<pre>
+ Package: foo
+ Depends: id3lib3.7-shlibs | id3lib3.7-shlibs
+ BuildDepends: id3lib3.7-dev | id3lib4-dev
+</pre>
+<p>
+ even if your package could work with either library. Pick one
+ (preferably the highest version that can be used successfully) and
+ use it consistently in your package.
+</p>
+<p>
+ As explained in the <a href="policy.php?phpLang=en#sharedlibs">Shared Library
Policy</a>, only one of the
+ -dev packages can be installed at a time, and each has links of the
+ same name that could point to different filenames in the associated
+ -shlibs package. When compiling package foo, the actual filename (in
+ the -shlibs package) gets hard-coded into the foo binary. That means
+ the resulting package needs the specific -shlibs package associated
+ with the -dev that was installed at compile-time. As a result, one
+ cannot have a <code>Depends</code> that indicates that either one
+ will suffice.
+</p>
</td></tr><tr valign="top"><td>BuildDepends</td><td>
<p>
<b>Introduced in fink 0.9.0.</b>
Index: fslayout.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/fslayout.en.php,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -d -r1.37 -r1.38
--- fslayout.en.php 7 Sep 2004 09:59:14 -0000 1.37
+++ fslayout.en.php 7 Sep 2004 11:54:33 -0000 1.38
@@ -1,7 +1,7 @@
<?
$title = "Packaging - FS Layout";
$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/09/07 09:57:30';
+$cvs_date = 'Date: 2004/09/07 11:52:24';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="reference.php?phpLang=en" title="Reference"><link
rel="prev" href="policy.php?phpLang=en" title="Packaging Policy">';
Index: packaging.en.html
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/packaging.en.html,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -d -r1.43 -r1.44
--- packaging.en.html 7 Sep 2004 09:59:14 -0000 1.43
+++ packaging.en.html 7 Sep 2004 11:54:33 -0000 1.44
@@ -1170,6 +1170,20 @@
Revision numbers start at 1.
Required field.
</p>
+<p>
+ Fink's policy is that <b>any</b> time you make a change to the
+ <tt style="white-space: nowrap;">.info</tt> file that results in changes to the
+ binary (compiled) form of a package (the <tt style="white-space: nowrap;">.deb</tt>
+ file), you <b>must</b> increase <tt style="white-space: nowrap;">Revision</tt>. This
+ includes changing the <tt style="white-space: nowrap;">Depends</tt> or other
package lists,
+ with the exception of<tt style="white-space: nowrap;">BuildDepends</tt>, and adding,
+ removing, or renaming splitoff packages or shifting files among
+ them. When migrating a package to a new tree (from 10.2 to 10.3, for
+ example) involves such changes, you should
+ increase <tt style="white-space: nowrap;">Revision</tt> by 10 in the newer tree in
order to
+ leave space space for future updates to the package in the older
+ tree.
+</p>
</td></tr><tr valign="top"><td>Epoch</td><td>
<p>
<b>Introduced in fink 0.12.0.</b>
@@ -1371,6 +1385,32 @@
would set the package x11 as a dependency for the nethack-x11 variant
but not for the nethack variant.
</p>
+<p>
+ Note that when using Depends/BuildDepends for shared library packages
+ for which more than one major-version is available, you must
+ <b>not</b> do the following:
+</p>
+<pre>
+ Package: foo
+ Depends: id3lib3.7-shlibs | id3lib3.7-shlibs
+ BuildDepends: id3lib3.7-dev | id3lib4-dev
+</pre>
+<p>
+ even if your package could work with either library. Pick one
+ (preferably the highest version that can be used successfully) and
+ use it consistently in your package.
+</p>
+<p>
+ As explained in the <a href="#policy.sharedlibs">Shared Library Policy</a>, only
one of the
+ -dev packages can be installed at a time, and each has links of the
+ same name that could point to different filenames in the associated
+ -shlibs package. When compiling package foo, the actual filename (in
+ the -shlibs package) gets hard-coded into the foo binary. That means
+ the resulting package needs the specific -shlibs package associated
+ with the -dev that was installed at compile-time. As a result, one
+ cannot have a <tt style="white-space: nowrap;">Depends</tt> that indicates that
either one
+ will suffice.
+</p>
</td></tr><tr valign="top"><td>BuildDepends</td><td>
<p>
<b>Introduced in fink 0.9.0.</b>
@@ -2260,4 +2300,4 @@
You may distribute this document in print for private purposes,
provided the document and this copyright notice remain complete and
unmodified. Any commercial reproduction and any online publication
-requires the explicit consent of the author.</p><hr><p>Generated from <i>$Fink:
packaging.en.xml,v 1.47 2004/09/07 09:57:30 dmacks Exp $</i></p></body></html>
+requires the explicit consent of the author.</p><hr><p>Generated from <i>$Fink:
packaging.en.xml,v 1.48 2004/09/07 11:52:24 dmacks Exp $</i></p></body></html>
Index: index.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/index.en.php,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -d -r1.37 -r1.38
--- index.en.php 7 Sep 2004 09:59:14 -0000 1.37
+++ index.en.php 7 Sep 2004 11:54:33 -0000 1.38
@@ -1,7 +1,7 @@
<?
$title = "Packaging";
$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/09/07 09:57:30';
+$cvs_date = 'Date: 2004/09/07 11:52:24';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="intro.php?phpLang=en" title="Introduction">';
@@ -29,7 +29,7 @@
currently has no maintainer.</a>
</p>
<h2><? echo FINK_CONTENTS ; ?></h2><ul>
- <li><a href="intro.php?phpLang=en"><b>1 Introduction</b></a><ul><li><a
href="intro.php?phpLang=en#def1">1.1 What is a Package?</a></li><li><a
href="intro.php?phpLang=en#ident">1.2 Identifying a Package</a></li></ul></li><li><a
href="format.php?phpLang=en"><b>2 Package Descriptions</b></a><ul><li><a
href="format.php?phpLang=en#trees">2.1 Tree Layout</a></li><li><a
href="format.php?phpLang=en#format">2.2 File Format</a></li><li><a
href="format.php?phpLang=en#percent">2.3 Percent Expansion</a></li></ul></li><li><a
href="policy.php?phpLang=en"><b>3 Packaging Policy</b></a><ul><li><a
href="policy.php?phpLang=en#licenses">3.1 Package Licenses</a></li><li><a
href="policy.php?phpLang=en#prefix">3.2 Base System Interference</a></li><li><a
href="policy.php?phpLang=en#sharedlibs">3.3 Shared Libraries</a></li><li><a
href="policy.php?phpLang=en#perlmods">3.4 Perl Modules</a></li><li><a
href="policy.php?phpLang=en#emacs">3.5 Emacs Policy</a></li></ul></li><li><a
href="fslayout.php?phpLang=en"><b>4 Filesystem Layout</b></a><ul><li><a
href="fslayout.php?phpLang=en#fhs">4.1 The Filesystem Hierarchy
Standard</a></li><li><a href="fslayout.php?phpLang=en#dirs">4.2 The
Directories</a></li><li><a href="fslayout.php?phpLang=en#avoid">4.3 Things to
Avoid</a></li></ul></li><li><a href="reference.php?phpLang=en"><b>5
Reference</b></a><ul><li><a href="reference.php?phpLang=en#build">5.1 The Build
Process</a></li><li><a href="reference.php?phpLang=en#fields">5.2
Fields</a></li><li><a href="reference.php?phpLang=en#splitoffs">5.3
SplitOffs</a></li><li><a href="reference.php?phpLang=en#scripts">5.4
Scripts</a></li><li><a href="reference.php?phpLang=en#patches">5.5
Patches</a></li><li><a href="reference.php?phpLang=en#profile.d">5.6 Profile.d
scripts</a></li></ul></li></ul><!--Generated from $Fink: packaging.en.xml,v 1.47
2004/09/07 09:57:30 dmacks Exp $-->
+ <li><a href="intro.php?phpLang=en"><b>1 Introduction</b></a><ul><li><a
href="intro.php?phpLang=en#def1">1.1 What is a Package?</a></li><li><a
href="intro.php?phpLang=en#ident">1.2 Identifying a Package</a></li></ul></li><li><a
href="format.php?phpLang=en"><b>2 Package Descriptions</b></a><ul><li><a
href="format.php?phpLang=en#trees">2.1 Tree Layout</a></li><li><a
href="format.php?phpLang=en#format">2.2 File Format</a></li><li><a
href="format.php?phpLang=en#percent">2.3 Percent Expansion</a></li></ul></li><li><a
href="policy.php?phpLang=en"><b>3 Packaging Policy</b></a><ul><li><a
href="policy.php?phpLang=en#licenses">3.1 Package Licenses</a></li><li><a
href="policy.php?phpLang=en#prefix">3.2 Base System Interference</a></li><li><a
href="policy.php?phpLang=en#sharedlibs">3.3 Shared Libraries</a></li><li><a
href="policy.php?phpLang=en#perlmods">3.4 Perl Modules</a></li><li><a
href="policy.php?phpLang=en#emacs">3.5 Emacs Policy</a></li></ul></li><li><a
href="fslayout.php?phpLang=en"><b>4 Filesystem Layout</b></a><ul><li><a
href="fslayout.php?phpLang=en#fhs">4.1 The Filesystem Hierarchy
Standard</a></li><li><a href="fslayout.php?phpLang=en#dirs">4.2 The
Directories</a></li><li><a href="fslayout.php?phpLang=en#avoid">4.3 Things to
Avoid</a></li></ul></li><li><a href="reference.php?phpLang=en"><b>5
Reference</b></a><ul><li><a href="reference.php?phpLang=en#build">5.1 The Build
Process</a></li><li><a href="reference.php?phpLang=en#fields">5.2
Fields</a></li><li><a href="reference.php?phpLang=en#splitoffs">5.3
SplitOffs</a></li><li><a href="reference.php?phpLang=en#scripts">5.4
Scripts</a></li><li><a href="reference.php?phpLang=en#patches">5.5
Patches</a></li><li><a href="reference.php?phpLang=en#profile.d">5.6 Profile.d
scripts</a></li></ul></li></ul><!--Generated from $Fink: packaging.en.xml,v 1.48
2004/09/07 11:52:24 dmacks Exp $-->
<? include_once "../../footer.inc"; ?>
-------------------------------------------------------
This SF.Net email is sponsored by BEA Weblogic Workshop
FREE Java Enterprise J2EE developer tools!
Get your free copy of BEA WebLogic Workshop 8.1 today.
http://ads.osdn.com/?ad_id=5047&alloc_id=10808&op=click
_______________________________________________
Fink-commits mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/fink-commits
