Update of /cvsroot/fink/scripts/installer/dmg/doc/packaging
In directory
sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv6934/scripts/installer/dmg/doc/packaging
Modified Files:
packaging.en.html
Log Message:
Notes about Revision field increment and misuse of Depends on multiple
major verions of a library.
Index: packaging.en.html
===================================================================
RCS file: /cvsroot/fink/scripts/installer/dmg/doc/packaging/packaging.en.html,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -d -r1.42 -r1.43
--- packaging.en.html 7 Sep 2004 09:59:15 -0000 1.42
+++ packaging.en.html 7 Sep 2004 11:54:33 -0000 1.43
@@ -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>
-------------------------------------------------------
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
