Update of /cvsroot/fink/web/doc/packaging
In directory
sfp-cvs-1.v30.ch3.sourceforge.com:/tmp/cvs-serv3897/web/doc/packaging
Modified Files:
compilers.en.php format.en.php fslayout.en.php index.en.php
intro.en.php packaging.en.html policy.en.php reference.en.php
Log Message:
update compiled docs
Index: compilers.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/compilers.en.php,v
retrieving revision 1.49
retrieving revision 1.50
diff -u -d -r1.49 -r1.50
--- compilers.en.php 11 Nov 2012 16:04:54 -0000 1.49
+++ compilers.en.php 11 Jun 2013 00:02:31 -0000 1.50
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Compilers";
-$cvs_author = 'Author: gecko2';
-$cvs_date = 'Date: 2012/11/11 15:20:16';
+$cvs_author = 'Author: nieder';
+$cvs_date = 'Date: 2013/06/10 21:39:21';
$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="fslayout.php?phpLang=en"
title="Filesystem Layout">';
Index: intro.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/intro.en.php,v
retrieving revision 1.102
retrieving revision 1.103
diff -u -d -r1.102 -r1.103
--- intro.en.php 11 Nov 2012 16:04:54 -0000 1.102
+++ intro.en.php 11 Jun 2013 00:02:31 -0000 1.103
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Intro";
-$cvs_author = 'Author: gecko2';
-$cvs_date = 'Date: 2012/11/11 15:20:16';
+$cvs_author = 'Author: nieder';
+$cvs_date = 'Date: 2013/06/10 21:39:21';
$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.103
retrieving revision 1.104
diff -u -d -r1.103 -r1.104
--- format.en.php 11 Nov 2012 16:04:54 -0000 1.103
+++ format.en.php 11 Jun 2013 00:02:31 -0000 1.104
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Package Descriptions";
-$cvs_author = 'Author: gecko2';
-$cvs_date = 'Date: 2012/11/11 15:20:16';
+$cvs_author = 'Author: nieder';
+$cvs_date = 'Date: 2013/06/10 21:39:21';
$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">';
@@ -106,20 +106,7 @@
<<
</pre>
<p>
-An older, deprecated, notation is crafted after the RFC 822 header folding
-method.
-A line that starts with whitespace is treated as a continuation of the
-previous line.
-Example:
-</p>
-<pre>InstallScript: mkdir -p %i/share/man
- make install prefix=%i mandir=%i/share/man
- mkdir -p %i/share/doc/%n
- install -m 644 COPYING %i/share/doc/%n</pre>
-<p>
-Note the mandatory indentation of the lines.
-</p><p>
-In both formats, empty lines and lines starting with a hash (#) are ignored.
+In this format, empty lines and lines starting with a hash (#) are ignored.
Keys (field names) are case-insensitive in Fink, so you can write
<code>InstallScript</code>, <code>installscript</code> or
<code>INSTALLSCRIPT</code> as you please.
Index: policy.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/policy.en.php,v
retrieving revision 1.103
retrieving revision 1.104
diff -u -d -r1.10 n 1.104 /doc/packaging/policy.en.php,v ======== gnored.
Contents"><link rel="next" href="policy.php?phpLang=en" title="Packaging
Policy"><link rel="prev" href="intro.php?phpLang=en"
title="Introduction">'; ents">'; P2¬$ÿ k ·Ü* 6
è è ! è !
>¬$ÿ >¬$ÿ xT¯¸Ü* 4¬$ÿ ·Ü* ·Ü*
>¬$ÿ `·Ü* _>¬$ÿ ÀO¹Ü* u·Ü* @¹Ü* ØD¹Ü* ¨I¹Ü* ª·Ü* xT¯¸Ü* 4¬$ÿ P3¬$ÿ k
·Ü* à! à!
>¬$ÿ >¬$ÿ H ¸Ü* `5¬$ÿ ·Ü* ·Ü*
>¬$ÿ `·Ü* _>¬$ÿ P>¬$ÿ H>¬$ÿ 8«³·Ü* p >¬$ÿ u·Ü* ª·Ü* `5¬$ÿ 04¬$ÿ k
·Ü* G H I J K M N O P
>¬$ÿ >¬$ÿ HÕe¸Ü* 7¬$ÿ ·Ü* ·Ü*
>¬$ÿ 0O¹Ü* u·Ü* `¯¸Ü*
C¸Ü* @¹Ü* ØD¹Ü* ¨I¹Ü* ª·Ü* HÕe¸Ü* 7¬$ÿ @5¬$ÿ k
·Ü* 8Õe¸Ü* 7¬$ÿ p5¬$ÿ k
·Ü* (Õe¸Ü* 7¬$ÿ 5¬$ÿ k
·Ü* Õe¸Ü* 7¬$ÿ Ð5¬$ÿ k ·Ü*
¨N¹Ü* u·Ü* ¨I¹Ü* P0¬$ÿ XC¸Ü* e·Ü* ØD¹Ü* p6¬$ÿ yXC¸Ü* e·Ü* @¹Ü*
6¬$ÿ ZXC¸Ü* e·Ü* ØC¸Ü* `¯¸Ü*
C¸Ü* @¹Ü* Ød¯¸Ü* ØD¹Ü* ¨I¹Ü* ª·Ü* 8«³·Ü* ͸Ü* >¬$ÿ pB¸Ü* P8¬$ÿ
7¬$ÿ k
·Ü* 5 6 7 8 : < = > ? @ B D
>¬$ÿ >¬$ÿ
Ñ ¸Ü* >¬$ÿ u·Ü* ¥³·Ü* Ð6¬$ÿ ͸Ü* e·Ü* ¥³·Ü* Õ_@f ÆS
Qöl±í ìãÚ·Ü* >¬$ÿ Ñ ¸Ü* `9¬$ÿ 08¬$ÿ k
·Ü* u]ÞÓ 4Q ÷U^Qʧ ¶uª¹ñìò*Äv
>¬$ÿ >¬$ÿ H Ø·Ü* p;¬$ÿ ·Ü* ·Ü*
>¬$ÿ `·Ü* _>¬$ÿ P>¬$ÿ H>¬$ÿ o¯¸Ü* u·Ü* Ød¯¸Ü*
i¯¸Ü* ª·Ü* p;¬$ÿ 9¬$ÿ k
·Ü* 8 Ø·Ü* p;¬$ÿ P9¬$ÿ k 3 -r1.104
--- policy.en.php 11 Nov 2012 16:04:55 -0000 1.103
+++ policy.en.php 11 Jun 2013 00:02:31 -0000 1.104
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Policy";
-$cvs_author = 'Author: gecko2';
-$cvs_date = 'Date: 2012/11/11 15:20:16';
+$cvs_author = 'Author: nieder';
+$cvs_date = 'Date: 2013/06/10 21:39:21';
$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.105
retrieving revision 1.106
diff -u -d -r1.105 -r1.106
--- reference.en.php 11 Nov 2012 16:04:55 -0000 1.105
+++ reference.en.php 11 Jun 2013 00:02:31 -0000 1.106
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Reference";
-$cvs_author = 'Author: gecko2';
-$cvs_date = 'Date: 2012/11/11 15:20:16';
+$cvs_author = 'Author: nieder';
+$cvs_date = 'Date: 2013/06/10 21:39:21';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="prev" href="compilers.php?phpLang=en" title="Compilers">';
@@ -441,14 +441,24 @@
<p>
A list of packages which must be installed before this package can be
built. Percent expansion is performed on this field (as well as the
-other package list fields in this section: BuildDepends, RuntimeDepends,
Provides,
-Conflicts, Replaces, Recommends, Suggests, and Enhances.
+other package list fields in this section: BuildDepends, RuntimeDepends,
+Provides, Conflicts, Replaces, Recommends, Suggests, and Enhances.
Usually, this is just a comma-separated list for plain package names,
but Fink now supports alternatives and version clauses with the same
syntax as dpkg.
A fully featured example:
</p>
-<pre>Depends: daemonic (>= 20010902-1), emacs | xemacs</pre>
+<pre>Depends: <<
+ daemonic (>= 20010902-1),
+ emacs | xemacs
+<<</pre>
+<p>
+The layout above is the preferred format for the <code>Depends</code>
+and similar fields. The field uses the multi-line field declarators
+<code><<</code> and each package is placed in alphabetical order
+on its own indented line. If the field only has a single entry, the
+simplified <code>Field: value</code> format may be used.
+</p>
<p>
Note that there is no way to express real optional dependencies.
If a package works both with and without another package, you must
@@ -477,7 +487,10 @@
You can use this format to simplify maintaining several similar
packages. For example, the packages elinks and elinks-ssl could both list:
</p>
-<pre>Depends: (%n = elinks-ssl) openssl097-shlibs, expat-shlibs</pre>
+<pre>Depends: <<
+ expat-shlibs,
+ (%n = elinks-ssl) openssl097-shlibs
+<<</pre>
<p>
would have the same effect as having elinks list:
</p>
@@ -485,7 +498,7 @@
<p>
and elinks-ssl list:
</p>
-<pre>Depends: openssl097-shlibs, expat-shlibs</pre>
+<pre>Depends: expat-shlibs, openssl097-shlibs</pre>
<p>
As an alternative syntax, you can also specify <code>(string)</code>,
which is "true" if <code>string</code> is non-null. For example:
@@ -506,7 +519,7 @@
</p>
<pre>
Package: foo
- Depends: id3lib3.7-shlibs | id3lib3.7-shlibs
+ Depends: id3lib3.7-shlibs | id3lib4-shlibs
BuildDepends: id3lib3.7-dev | id3lib4-dev
</pre>
<p>
@@ -1068,6 +1081,19 @@
<p>
will always pass the <code>--mandir</code> and <code>--disable-shared</code>
flags, but only pass <code>--with-x11</code> in the -x11 variant.
</p>
+<p>
+This field supports placing parameters into multiple lines using multi-line
field declarators. The field is handled as a shell command line and uses
<code>\</code> to separate lines:
+</p>
+<pre>
+ConfigureParams: <<
+ --mandir=%p/share/man \
+ (%type_pkg[-x11]) --with-x11 \
+ --disable-shared
+<<
+</pre>
+<p>
+Note: do not place conditional parameters as the last line when using the
multi-line field format. In instances when the conditional evaluates as false,
the parameter immediately following is not evaluated and this breaks the shell.
+</p>
</td></tr><tr valign="top"><td>GCC</td><td>
<p>
This field specifies the GCC-ABI used by C++ code in this package.
Index: fslayout.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/fslayout.en.php,v
retrieving revision 1.103
retrieving revision 1.104
diff -u -d -r1.103 -r1.104
--- fslayout.en.php 11 Nov 2012 16:04:54 -0000 1.103
+++ fslayout.en.php 11 Jun 2013 00:02:31 -0000 1.104
@@ -1,7 +1,7 @@
<?
$title = "Packaging - FS Layout";
-$cvs_author = 'Author: gecko2';
-$cvs_date = 'Date: 2012/11/11 15:20:16';
+$cvs_author = 'Author: nieder';
+$cvs_date = 'Date: 2013/06/10 21:39:21';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="compilers.php?phpLang=en"
title="Compilers"><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.121
retrieving revision 1.122
diff -u -d -r1.121 -r1.122
--- packaging.en.html 2 Jan 2013 03:44:06 -0000 1.121
+++ packaging.en.html 11 Jun 2013 00:02:31 -0000 1.122
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!--
-Generated from $Fink: packaging.en.xml,v 1.125 2012/11/11 15:20:16 gecko2 Exp $
+Generated from $Fink: packaging.en.xml,v 1.127 2013/06/10 21:39:21 nieder Exp $
-->
<title>Fink Documentation - Creating Fink Packages</title></head><body>
<table width="100%" cellspacing="0">
@@ -196,20 +196,7 @@
<<
</pre>
<p>
-An older, deprecated, notation is crafted after the RFC 822 header folding
-method.
-A line that starts with whitespace is treated as a continuation of the
-previous line.
-Example:
-</p>
-<pre>InstallScript: mkdir -p %i/share/man
- make install prefix=%i mandir=%i/share/man
- mkdir -p %i/share/doc/%n
- install -m 644 COPYING %i/share/doc/%n</pre>
-<p>
-Note the mandatory indentation of the lines.
-</p><p>
-In both formats, empty lines and lines starting with a hash (#) are ignored.
+In this format, empty lines and lines starting with a hash (#) are ignored.
Keys (field names) are case-insensitive in Fink, so you can write
<tt style="white-space: nowrap;">InstallScript</tt>, <tt style="white-space:
nowrap;">installscript</tt> or
<tt style="white-space: nowrap;">INSTALLSCRIPT</tt> as you please.
@@ -1906,14 +1893,24 @@
<p>
A list of packages which must be installed before this package can be
built. Percent expansion is performed on this field (as well as the
-other package list fields in this section: BuildDepends, RuntimeDepends,
Provides,
-Conflicts, Replaces, Recommends, Suggests, and Enhances.
+other package list fields in this section: BuildDepends, RuntimeDepends,
+Provides, Conflicts, Replaces, Recommends, Suggests, and Enhances.
Usually, this is just a comma-separated list for plain package names,
but Fink now supports alternatives and version clauses with the same
syntax as dpkg.
A fully featured example:
</p>
-<pre>Depends: daemonic (>= 20010902-1), emacs | xemacs</pre>
+<pre>Depends: <<
+ daemonic (>= 20010902-1),
+ emacs | xemacs
+<<</pre>
+<p>
+The layout above is the preferred format for the <tt style="white-space:
nowrap;">Depends</tt>
+and similar fields. The field uses the multi-line field declarators
+<tt style="white-space: nowrap;"><<</tt> and each package is placed in
alphabetical order
+on its own indented line. If the field only has a single entry, the
+simplified <tt style="white-space: nowrap;">Field: value</tt> format may be
used.
+</p>
<p>
Note that there is no way to express real optional dependencies.
If a package works both with and without another package, you must
@@ -1942,7 +1939,10 @@
You can use this format to simplify maintaining several similar
packages. For example, the packages elinks and elinks-ssl could both list:
</p>
-<pre>Depends: (%n = elinks-ssl) openssl097-shlibs, expat-shlibs</pre>
+<pre>Depends: <<
+ expat-shlibs,
+ (%n = elinks-ssl) openssl097-shlibs
+<<</pre>
<p>
would have the same effect as having elinks list:
</p>
@@ -1950,7 +1950,7 @@
<p>
and elinks-ssl list:
</p>
-<pre>Depends: openssl097-shlibs, expat-shlibs</pre>
+<pre>Depends: expat-shlibs, openssl097-shlibs</pre>
<p>
As an alternative syntax, you can also specify <tt style="white-space:
nowrap;">(string)</tt>,
which is "true" if <tt style="white-space: nowrap;">string</tt> is non-null.
For example:
@@ -1971,7 +1971,7 @@
</p>
<pre>
Package: foo
- Depends: id3lib3.7-shlibs | id3lib3.7-shlibs
+ Depends: id3lib3.7-shlibs | id3lib4-shlibs
BuildDepends: id3lib3.7-dev | id3lib4-dev
</pre>
<p>
@@ -2533,6 +2533,19 @@
<p>
will always pass the <tt style="white-space: nowrap;">--mandir</tt> and <tt
style="white-space: nowrap;">--disable-shared</tt> flags, but only pass <tt
style="white-space: nowrap;">--with-x11</tt> in the -x11 variant.
</p>
+<p>
+This field supports placing parameters into multiple lines using multi-line
field declarators. The field is handled as a shell command line and uses <tt
style="white-space: nowrap;">\</tt> to separate lines:
+</p>
+<pre>
+ConfigureParams: <<
+ --mandir=%p/share/man \
+ (%type_pkg[-x11]) --with-x11 \
+ --disable-shared
+<<
+</pre>
+<p>
+Note: do not place conditional parameters as the last line when using the
multi-line field format. In instances when the conditional evaluates as false,
the parameter immediately following is not evaluated and this breaks the shell.
+</p>
</td></tr><tr valign="top"><td>GCC</td><td>
<p>
This field specifies the GCC-ABI used by C++ code in this package.
@@ -3171,4 +3184,4 @@
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.125 2012/11/11 15:20:16
gecko2 Exp $</i></p></body></html>
+<p>Generated from <i>$Fink: packaging.en.xml,v 1.127 2013/06/10 21:39:21
nieder Exp $</i></p></body></html>
Index: index.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/index.en.php,v
retrieving revision 1.103
retrieving revision 1.104
diff -u -d -r1.103 -r1.104
--- index.en.php 11 Nov 2012 16:04:54 -0000 1.103
+++ index.en.php 11 Jun 2013 00:02:31 -0000 1.104
@@ -1,7 +1,7 @@
<?
$title = "Packaging";
-$cvs_author = 'Author: gecko2';
-$cvs_date = 'Date: 2012/11/11 15:20:16';
+$cvs_author = 'Author: nieder';
+$cvs_date = 'Date: 2013/06/10 21:39:21';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="intro.php?phpLang=en" title="Introduction">';
@@ -30,7 +30,7 @@
</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#openssl">3.2 The GPL and
OpenSSL</a></li><li><a href="policy.php?phpLang=en#prefix">3.3 Base System
Interference</a></li><li><a href="policy.php?phpLang=en#sharedlibs">3.4 Shared
Libraries</a></li><li><a href="policy.php?phpLang=en#perlmods">3.5 Perl
Modules</a></li><li><a href="policy.php?phpLang=en#emacs">3.6 Emacs
Policy</a></li><li><a href="policy.php?phpLang=en#sources">3.7 Source
Policy</a></li><li><a href="policy.php?phpLang=en#downloading">3.8 File
Download 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="compilers.php?phpLang=en"><b>5
Compilers</b></a><ul><li><a href="compilers.php?phpLang=en#versions">5.1
Compiler Versions</a></li><li><a href="compilers.php?phpLang=en#abi">5.2 The
g++ ABI</a></li></ul></li><li><a href="reference.php?phpLang=en"><b>6
Reference</b></a><ul><li><a href="reference.php?phpLang=en#build">6.1 The Build
Process</a></li><li><a href="reference.php?phpLang=en#fields">6.2
Fields</a></li><li><a href="reference.php?phpLang=en#splitoffs">6.3
SplitOffs</a></li><li><a href="reference.php?phpLang=en#scripts">6.4
Scr ipts</a></li><li><a href="reference.php?phpLang=en#patches">6.5
Patches</a></li><li><a href="reference.php?phpLang=en#profile.d">6.6 Profile.d
scripts</a></li></ul></li></ul>
-<!--Generated from $Fink: packaging.en.xml,v 1.125 2012/11/11 15:20:16 gecko2
Exp $-->
+<!--Generated from $Fink: packaging.en.xml,v 1.127 2013/06/10 21:39:21 nieder
Exp $-->
<? include_once "../../footer.inc"; ?>
------------------------------------------------------------------------------
This SF.net email is sponsored by Windows:
Build for Windows Store.
http://p.sf.net/sfu/windows-dev2dev
_______________________________________________
Fink-commits mailing list
Fink-commits@lists.sourceforge.net
http://news.gmane.org/gmane.os.apple.fink.cvs
