[prev in list] [next in list] [prev in thread] [next in thread] 

List:       fink-commits
Subject:    web/doc/packaging format.en.php,1.15,1.16 format.fr.php,1.8,1.9 fslayout.en.php,1.15,1.16 fslayout.f
From:       Daniel Macks <dmacks () users ! sourceforge ! net>
Date:       2004-03-31 22:35:33
Message-ID: E1B8oJ3-0005u7-CN () sc8-pr-cvs1 ! sourceforge ! net
[Download RAW message or body]

Update of /cvsroot/fink/web/doc/packaging
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv22231/web/doc/packaging

Modified Files:
	format.en.php format.fr.php fslayout.en.php fslayout.fr.php 
	index.en.php index.fr.php intro.en.php intro.fr.php 
	packaging.en.html packaging.fr.html policy.en.php 
	policy.fr.php reference.en.php reference.fr.php 
Log Message:
Improved description of SplitOff processing.
Noted that SplitOff(N) may be handled out-of-order in the future.


Index: format.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/format.en.php,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- format.en.php	30 Mar 2004 09:48:57 -0000	1.15
+++ format.en.php	31 Mar 2004 22:35:28 -0000	1.16
@@ -1,7 +1,7 @@
 <?
 $title = "Packaging - Package Descriptions";
 $cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/03/30 09:46:19';
+$cvs_date = 'Date: 2004/03/31 20:08:34';
 $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">';  
 include_once "header.inc";

Index: format.fr.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/format.fr.php,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- format.fr.php	30 Mar 2004 22:10:50 -0000	1.8
+++ format.fr.php	31 Mar 2004 22:35:28 -0000	1.9
@@ -1,7 +1,7 @@
 <?
 $title = "Paquets - Descriptions de paquets";
 $cvs_author = 'Author: michga';
-$cvs_date = 'Date: 2004/03/27 10:08:26';
+$cvs_date = 'Date: 2004/03/30 22:09:55';
 $metatags = '<link rel="contents" href="index.php?phpLang=fr" title="Paquets \
Contents"><link rel="next" href="policy.php?phpLang=fr" title="Règles de \
distribution des paquets"><link rel="prev" href="intro.php?phpLang=fr" \
title="Introduction">';  
 include_once "header.inc";

Index: fslayout.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/fslayout.en.php,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- fslayout.en.php	30 Mar 2004 09:48:57 -0000	1.15
+++ fslayout.en.php	31 Mar 2004 22:35:28 -0000	1.16
@@ -1,7 +1,7 @@
 <?
 $title = "Packaging - FS Layout";
 $cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/03/30 09:46:19';
+$cvs_date = 'Date: 2004/03/31 20:08:34';
 $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">';  
 include_once "header.inc";

Index: fslayout.fr.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/fslayout.fr.php,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- fslayout.fr.php	27 Mar 2004 10:09:34 -0000	1.7
+++ fslayout.fr.php	31 Mar 2004 22:35:28 -0000	1.8
@@ -1,7 +1,7 @@
 <?
 $title = "Paquets - FS Layout";
 $cvs_author = 'Author: michga';
-$cvs_date = 'Date: 2004/03/27 10:08:26';
+$cvs_date = 'Date: 2004/03/30 22:09:55';
 $metatags = '<link rel="contents" href="index.php?phpLang=fr" title="Paquets \
Contents"><link rel="next" href="reference.php?phpLang=fr" title="Reference"><link \
rel="prev" href="policy.php?phpLang=fr" title="Règles de distribution des \
paquets">';  
 include_once "header.inc";

Index: index.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/index.en.php,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- index.en.php	30 Mar 2004 09:48:57 -0000	1.15
+++ index.en.php	31 Mar 2004 22:35:28 -0000	1.16
@@ -1,7 +1,7 @@
 <?
 $title = "Packaging";
 $cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/03/30 09:46:19';
+$cvs_date = 'Date: 2004/03/31 20:08:34';
 $metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging \
Contents"><link rel="next" href="intro.php?phpLang=en" title="Introduction">';  
 include_once "header.inc";
@@ -29,6 +29,6 @@
 currently has no maintainer.</a>
 </p>
 <h2>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.19 \
2004/03/30 09:46:19 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.20 \
2004/03/31 20:08:34 dmacks Exp $-->  
 <? include_once "footer.inc"; ?>

Index: index.fr.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/index.fr.php,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- index.fr.php	30 Mar 2004 22:10:50 -0000	1.8
+++ index.fr.php	31 Mar 2004 22:35:28 -0000	1.9
@@ -1,7 +1,7 @@
 <?
 $title = "Paquets";
 $cvs_author = 'Author: michga';
-$cvs_date = 'Date: 2004/03/27 10:08:26';
+$cvs_date = 'Date: 2004/03/30 22:09:55';
 $metatags = '<link rel="contents" href="index.php?phpLang=fr" title="Paquets \
Contents"><link rel="next" href="intro.php?phpLang=fr" title="Introduction">';  
 include_once "header.inc";
@@ -20,6 +20,6 @@
 Si vous cherchez un moyen d'aider Fink et que vous avez des compétences dans ce \
domaine, vous pouvez aussi adopter un <a \
href="http://fink.sourceforge.net/pdb/nomaintainer.php">paquet sans mainteneur</a>.  \
</p>  <h2>Contents</h2><ul>
-	<li><a href="intro.php?phpLang=fr"><b>1 Introduction</b></a><ul><li><a \
href="intro.php?phpLang=fr#def1">1.1 Qu'est-ce qu'un paquet ?</a></li><li><a \
href="intro.php?phpLang=fr#ident">1.2 Identification d'un \
paquet</a></li></ul></li><li><a href="format.php?phpLang=fr"><b>2 Descriptions de \
paquets</b></a><ul><li><a href="format.php?phpLang=fr#trees">2.1 \
Arborescence</a></li><li><a href="format.php?phpLang=fr#format">2.2 Format de \
fichier</a></li><li><a href="format.php?phpLang=fr#percent">2.3 Raccourcis \
%</a></li></ul></li><li><a href="policy.php?phpLang=fr"><b>3 Règles de distribution \
des paquets</b></a><ul><li><a href="policy.php?phpLang=fr#licenses">3.1 Licences de \
paquets</a></li><li><a href="policy.php?phpLang=fr#prefix">3.2 Interférence avec le \
système de base</a></li><li><a href="policy.php?phpLang=fr#sharedlibs">3.3 \
Librairies partagées</a></li><li><a href="policy.php?phpLang=fr#perlmods">3.4 \
Modules Perl</a></li><li><a href="policy.php?phpLang=fr#emacs">3.5 Règles \
Emacs</a></li></ul></li><li><a href="fslayout.php?phpLang=fr"><b>4 Filesystem \
Layout</b></a><ul><li><a href="fslayout.php?phpLang=fr#fhs">4.1 The Filesystem \
Hierarchy Standard</a></li><li><a href="fslayout.php?phpLang=fr#dirs">4.2 The \
Directories</a></li><li><a href="fslayout.php?phpLang=fr#avoid">4.3 Things to \
Avoid</a></li></ul></li><li><a href="reference.php?phpLang=fr"><b>5 \
Reference</b></a><ul><li><a href="reference.php?phpLang=fr#build">5.1 The Build \
Process</a></li><li><a href="reference.php?phpLang=fr#fields">5.2 \
Fields</a></li><li><a href="reference.php?phpLang=fr#splitoffs">5.3 \
SplitOffs</a></li><li><a href="reference.php?phpLang=fr#scripts">5.4 \
Scripts</a></li><li><a href="reference.php?phpLang=fr#patches">5.5 \
Patches</a></li><li><a href="reference.php?phpLang=fr#profile.d">5.6 Profile.d \
scripts</a></li></ul></li></ul><!--Generated from $Fink: packaging.fr.xml,v 1.8 \
2004/03/27 10:08:26 michga Exp $--> +	<li><a href="intro.php?phpLang=fr"><b>1 \
Introduction</b></a><ul><li><a href="intro.php?phpLang=fr#def1">1.1 Qu'est-ce qu'un \
paquet ?</a></li><li><a href="intro.php?phpLang=fr#ident">1.2 Identification d'un \
paquet</a></li></ul></li><li><a href="format.php?phpLang=fr"><b>2 Descriptions de \
paquets</b></a><ul><li><a href="format.php?phpLang=fr#trees">2.1 \
Arborescence</a></li><li><a href="format.php?phpLang=fr#format">2.2 Format de \
fichier</a></li><li><a href="format.php?phpLang=fr#percent">2.3 Raccourcis \
%</a></li></ul></li><li><a href="policy.php?phpLang=fr"><b>3 Règles de distribution \
des paquets</b></a><ul><li><a href="policy.php?phpLang=fr#licenses">3.1 Licences de \
paquets</a></li><li><a href="policy.php?phpLang=fr#prefix">3.2 Interférence avec le \
système de base</a></li><li><a href="policy.php?phpLang=fr#sharedlibs">3.3 \
Librairies partagées</a></li><li><a href="policy.php?phpLang=fr#perlmods">3.4 \
Modules Perl</a></li><li><a href="policy.php?phpLang=fr#emacs">3.5 Règles \
Emacs</a></li></ul></li><li><a href="fslayout.php?phpLang=fr"><b>4 Filesystem \
Layout</b></a><ul><li><a href="fslayout.php?phpLang=fr#fhs">4.1 The Filesystem \
Hierarchy Standard</a></li><li><a href="fslayout.php?phpLang=fr#dirs">4.2 The \
Directories</a></li><li><a href="fslayout.php?phpLang=fr#avoid">4.3 Things to \
Avoid</a></li></ul></li><li><a href="reference.php?phpLang=fr"><b>5 \
Reference</b></a><ul><li><a href="reference.php?phpLang=fr#build">5.1 The Build \
Process</a></li><li><a href="reference.php?phpLang=fr#fields">5.2 \
Fields</a></li><li><a href="reference.php?phpLang=fr#splitoffs">5.3 \
SplitOffs</a></li><li><a href="reference.php?phpLang=fr#scripts">5.4 \
Scripts</a></li><li><a href="reference.php?phpLang=fr#patches">5.5 \
Patches</a></li><li><a href="reference.php?phpLang=fr#profile.d">5.6 Profile.d \
scripts</a></li></ul></li></ul><!--Generated from $Fink: packaging.fr.xml,v 1.9 \
2004/03/30 22:09:55 michga Exp $-->  
 <? include_once "footer.inc"; ?>

Index: intro.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/intro.en.php,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- intro.en.php	30 Mar 2004 09:48:57 -0000	1.15
+++ intro.en.php	31 Mar 2004 22:35:28 -0000	1.16
@@ -1,7 +1,7 @@
 <?
 $title = "Packaging - Intro";
 $cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/03/30 09:46:19';
+$cvs_date = 'Date: 2004/03/31 20:08:34';
 $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">';  
 include_once "header.inc";

Index: intro.fr.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/intro.fr.php,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -d -r1.7 -r1.8
--- intro.fr.php	27 Mar 2004 10:09:34 -0000	1.7
+++ intro.fr.php	31 Mar 2004 22:35:28 -0000	1.8
@@ -1,7 +1,7 @@
 <?
 $title = "Paquets - Intro";
 $cvs_author = 'Author: michga';
-$cvs_date = 'Date: 2004/03/27 10:08:26';
+$cvs_date = 'Date: 2004/03/30 22:09:55';
 $metatags = '<link rel="contents" href="index.php?phpLang=fr" title="Paquets \
Contents"><link rel="next" href="format.php?phpLang=fr" title="Descriptions de \
paquets"><link rel="prev" href="index.php?phpLang=fr" title="Paquets Contents">';  
 include_once "header.inc";

Index: packaging.en.html
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/packaging.en.html,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- packaging.en.html	30 Mar 2004 09:48:57 -0000	1.15
+++ packaging.en.html	31 Mar 2004 22:35:28 -0000	1.16
@@ -1968,15 +1968,15 @@
 multiple packages.  
 The install phase begins as usual, with the execution of the 
 <tt style="white-space: nowrap;">InstallScript</tt> and <tt style="white-space: \
                nowrap;">DocFiles</tt> commands.
-A <tt style="white-space: nowrap;">SplitOff</tt> field, if present, then triggers \
                the
-creation of a
-second install directory.  Within the 
-<tt style="white-space: nowrap;">SplitOff</tt> field, the new install directory is \
referred to as %i, +A <tt style="white-space: nowrap;">SplitOff</tt> or <tt \
style="white-space: nowrap;">SplitOff<b>N</b></tt> field, if present, then triggers \
the +creation of an
+additional install directory.  Within the 
+<tt style="white-space: nowrap;">SplitOff</tt> or <tt style="white-space: \
nowrap;">SplitOff<b>N</b></tt> field, the new install directory is referred to as %i, \
while the original install directory of the parent   package is referred to as %I.
 </p>
 <p>
-The <tt style="white-space: nowrap;">SplitOff</tt> field must contain a number of \
fields of its +Each <tt style="white-space: nowrap;">SplitOff</tt> and <tt \
style="white-space: nowrap;">SplitOff<b>N</b></tt> field must contain a number of \
fields of its  own.  In fact, it resembles a complete package description, but with
 certain fields missing.  Here is what belongs in the sub-description
 (by category):
@@ -1985,32 +1985,45 @@
 <li>Initial Data: Only the <tt style="white-space: nowrap;">Package</tt> needs to be \
specified,  everything else is inherited from the parent package.  You may modify
 <tt style="white-space: nowrap;">Type</tt> and <tt style="white-space: \
                nowrap;">License</tt> by declaring the field
-within the <tt style="white-space: nowrap;">SplitOff</tt>.  Percent expansion can be \
used, and +within the <tt style="white-space: nowrap;">SplitOff</tt> or <tt \
style="white-space: nowrap;">SplitOff<b>N</b></tt>.  Percent expansion can be used, \
and  it is often convenient to refer to the name %N of the parent
 package.</li>
 <li>Dependencies: All of these are allowed.</li>
 <li>Unpack Phase, Patch Phase, Compile Phase: These fields are irrelevant
 and will be ignored.</li>
 <li>Install Phase, Build Phase: Any of these fields are allowed (except
-that <tt style="white-space: nowrap;">SplitOff</tt> should not be used within a <tt \
                style="white-space: nowrap;">SplitOff</tt>
-field).</li>
+that SplitOffs cannot themselves contain additional SplitOffs).</li>
 <li>Additional Data: These are inherited from the parent package but may
-be modified by declaring the field within the <tt style="white-space: \
nowrap;">SplitOff</tt>.</li> +be modified by declaring the field within the <tt \
style="white-space: nowrap;">SplitOff</tt> or <tt style="white-space: \
nowrap;">SplitOff<b>N</b></tt>.</li>  </ul>
 <p>
 During the install phase, the <tt style="white-space: nowrap;">InstallScript</tt> \
and   <tt style="white-space: nowrap;">DocFiles</tt> of the parent package are \
                executed first.
-Next comes the <tt style="white-space: nowrap;">Files</tt> command specified in the
-<tt style="white-space: nowrap;">SplitOff</tt> field, which causes the listed files \
and directories +Next comes processing of the <tt style="white-space: \
nowrap;">SplitOff</tt> and <tt style="white-space: nowrap;">SplitOff<b>N</b></tt> \
fields. For each such field in turn, the <tt style="white-space: nowrap;">Files</tt> \
command causes the listed files and directories  to be moved from the parent's \
installation directory %I to the  current installation directory %i.  Then the <tt \
                style="white-space: nowrap;">InstallScript</tt>
-and <tt style="white-space: nowrap;">DocFiles</tt> of the <tt style="white-space: \
nowrap;">SplitOff</tt> package are +and <tt style="white-space: \
nowrap;">DocFiles</tt> of the given <tt style="white-space: nowrap;">SplitOff</tt> or \
<tt style="white-space: nowrap;">SplitOff<b>N</b></tt> package are  executed.  
 </p><p>
-If there are additional sub-packages specified with <tt style="white-space: \
                nowrap;">SplitOff2</tt>,
-<tt style="white-space: nowrap;">SplitOff3</tt>, etc., this same sequence of \
                commands
-(<tt style="white-space: nowrap;">Files</tt>, <tt style="white-space: \
                nowrap;">InstallScript</tt>, <tt style="white-space: \
                nowrap;">DocFiles</tt>)
-is executed for each of them in turn.
+At this time, the <tt style="white-space: nowrap;">SplitOff</tt> is processed first \
(if +present), followed by each <tt style="white-space: \
nowrap;">SplitOff<b>N</b></tt> in +numerical order by N. However, this may change in \
the future, so, for +example, instead of:
+</p>
+<pre>
+SplitOff: &lt;&lt;
+  Description: Some header files
+  Files: include/foo.h include/bar.h
+&lt;&lt;
+SplitOff2: &lt;&lt;
+  Description: All other header files
+  Files: include/*
+&lt;&lt;
+</pre>
+<p>
+which only works correctly if <tt style="white-space: nowrap;">SplitOff</tt> is \
processed +before <tt style="white-space: nowrap;">SplitOff2</tt> it's safer to list \
explicitly the files +for each (or use more specific filename globs).
 </p><p>
 During the build phase, the pre/post install/remove scripts for each of
 the packages is constructed by using the build phase commands which
@@ -2101,4 +2114,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.19 2004/03/30 09:46:19 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.20 2004/03/31 20:08:34 dmacks Exp $</i></p></body></html>

Index: packaging.fr.html
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/packaging.fr.html,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -d -r1.10 -r1.11
--- packaging.fr.html	30 Mar 2004 22:10:50 -0000	1.10
+++ packaging.fr.html	31 Mar 2004 22:35:29 -0000	1.11
@@ -1837,4 +1837,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.fr.xml,v 1.8 2004/03/27 10:08:26 michga Exp $</i></p></body></html> \
+requires the explicit consent of the author.</p><hr><p>Generated from <i>$Fink: \
packaging.fr.xml,v 1.9 2004/03/30 22:09:55 michga Exp $</i></p></body></html>

Index: policy.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/policy.en.php,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- policy.en.php	30 Mar 2004 09:48:57 -0000	1.15
+++ policy.en.php	31 Mar 2004 22:35:29 -0000	1.16
@@ -1,7 +1,7 @@
 <?
 $title = "Packaging - Policy";
 $cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/03/30 09:46:19';
+$cvs_date = 'Date: 2004/03/31 20:08:34';
 $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">'; \
  include_once "header.inc";

Index: policy.fr.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/policy.fr.php,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- policy.fr.php	30 Mar 2004 22:10:50 -0000	1.8
+++ policy.fr.php	31 Mar 2004 22:35:29 -0000	1.9
@@ -1,7 +1,7 @@
 <?
 $title = "Paquets - Règles";
 $cvs_author = 'Author: michga';
-$cvs_date = 'Date: 2004/03/27 10:08:26';
+$cvs_date = 'Date: 2004/03/30 22:09:55';
 $metatags = '<link rel="contents" href="index.php?phpLang=fr" title="Paquets \
Contents"><link rel="next" href="fslayout.php?phpLang=fr" title="Filesystem \
Layout"><link rel="prev" href="format.php?phpLang=fr" title="Descriptions de \
paquets">';  
 include_once "header.inc";

Index: reference.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/reference.en.php,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -d -r1.15 -r1.16
--- reference.en.php	30 Mar 2004 09:48:57 -0000	1.15
+++ reference.en.php	31 Mar 2004 22:35:29 -0000	1.16
@@ -1,7 +1,7 @@
 <?
 $title = "Packaging - Reference";
 $cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2004/03/30 09:46:19';
+$cvs_date = 'Date: 2004/03/31 20:08:34';
 $metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging \
Contents"><link rel="prev" href="fslayout.php?phpLang=en" title="Filesystem \
Layout">';  
 include_once "header.inc";
@@ -980,15 +980,15 @@
 multiple packages.  
 The install phase begins as usual, with the execution of the 
 <code>InstallScript</code> and <code>DocFiles</code> commands.
-A <code>SplitOff</code> field, if present, then triggers the
-creation of a
-second install directory.  Within the 
-<code>SplitOff</code> field, the new install directory is referred to as %i,
+A <code>SplitOff</code> or <code>SplitOff<b>N</b></code> field, if present, then \
triggers the +creation of an
+additional install directory.  Within the 
+<code>SplitOff</code> or <code>SplitOff<b>N</b></code> field, the new install \
directory is referred to as %i,  while the original install directory of the parent 
 package is referred to as %I.
 </p>
 <p>
-The <code>SplitOff</code> field must contain a number of fields of its
+Each <code>SplitOff</code> and <code>SplitOff<b>N</b></code> field must contain a \
number of fields of its  own.  In fact, it resembles a complete package description, \
but with  certain fields missing.  Here is what belongs in the sub-description
 (by category):
@@ -997,32 +997,45 @@
 <li>Initial Data: Only the <code>Package</code> needs to be specified,
 everything else is inherited from the parent package.  You may modify
 <code>Type</code> and <code>License</code> by declaring the field
-within the <code>SplitOff</code>.  Percent expansion can be used, and
+within the <code>SplitOff</code> or <code>SplitOff<b>N</b></code>.  Percent \
expansion can be used, and  it is often convenient to refer to the name %N of the \
parent  package.</li>
 <li>Dependencies: All of these are allowed.</li>
 <li>Unpack Phase, Patch Phase, Compile Phase: These fields are irrelevant
 and will be ignored.</li>
 <li>Install Phase, Build Phase: Any of these fields are allowed (except
-that <code>SplitOff</code> should not be used within a <code>SplitOff</code>
-field).</li>
+that SplitOffs cannot themselves contain additional SplitOffs).</li>
 <li>Additional Data: These are inherited from the parent package but may
-be modified by declaring the field within the <code>SplitOff</code>.</li>
+be modified by declaring the field within the <code>SplitOff</code> or \
<code>SplitOff<b>N</b></code>.</li>  </ul>
 <p>
 During the install phase, the <code>InstallScript</code> and 
 <code>DocFiles</code> of the parent package are executed first.
-Next comes the <code>Files</code> command specified in the
-<code>SplitOff</code> field, which causes the listed files and directories
+Next comes processing of the <code>SplitOff</code> and <code>SplitOff<b>N</b></code> \
fields. For each such field in turn, the <code>Files</code> command causes the listed \
files and directories  to be moved from the parent's installation directory %I to the
 current installation directory %i.  Then the <code>InstallScript</code>
-and <code>DocFiles</code> of the <code>SplitOff</code> package are
+and <code>DocFiles</code> of the given <code>SplitOff</code> or \
<code>SplitOff<b>N</b></code> package are  executed.  
 </p><p>
-If there are additional sub-packages specified with <code>SplitOff2</code>,
-<code>SplitOff3</code>, etc., this same sequence of commands
-(<code>Files</code>, <code>InstallScript</code>, <code>DocFiles</code>)
-is executed for each of them in turn.
+At this time, the <code>SplitOff</code> is processed first (if
+present), followed by each <code>SplitOff<b>N</b></code> in
+numerical order by N. However, this may change in the future, so, for
+example, instead of:
+</p>
+<pre>
+SplitOff: &lt;&lt;
+  Description: Some header files
+  Files: include/foo.h include/bar.h
+&lt;&lt;
+SplitOff2: &lt;&lt;
+  Description: All other header files
+  Files: include/*
+&lt;&lt;
+</pre>
+<p>
+which only works correctly if <code>SplitOff</code> is processed
+before <code>SplitOff2</code> it's safer to list explicitly the files
+for each (or use more specific filename globs).
 </p><p>
 During the build phase, the pre/post install/remove scripts for each of
 the packages is constructed by using the build phase commands which

Index: reference.fr.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/reference.fr.php,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -d -r1.8 -r1.9
--- reference.fr.php	30 Mar 2004 22:10:50 -0000	1.8
+++ reference.fr.php	31 Mar 2004 22:35:29 -0000	1.9
@@ -1,7 +1,7 @@
 <?
 $title = "Paquets - Reference";
 $cvs_author = 'Author: michga';
-$cvs_date = 'Date: 2004/03/27 10:08:26';
+$cvs_date = 'Date: 2004/03/30 22:09:55';
 $metatags = '<link rel="contents" href="index.php?phpLang=fr" title="Paquets \
Contents"><link rel="prev" href="fslayout.php?phpLang=fr" title="Filesystem \
Layout">';  
 include_once "header.inc";



-------------------------------------------------------
This SF.Net email is sponsored by: IBM Linux Tutorials
Free Linux tutorial presented by Daniel Robbins, President and CEO of
GenToo technologies. Learn everything from fundamentals to system
administration.http://ads.osdn.com/?ad_id=1470&alloc_id=3638&op=click
_______________________________________________
Fink-commits mailing list
Fink-commits@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/fink-commits


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic