[Pkg-php-commits] [php/debian-sid] Add some more documentation about the source package

[Raphael Geissert]

---
 debian/README.source |   29 +++++++++++++++++++++++++++++
 1 files changed, 29 insertions(+), 0 deletions(-)

diff --git a/debian/README.source b/debian/README.source
index 31a1146..7e017c9 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -14,3 +14,32 @@ source.  Changes are stored in the source package as diffs in
 debian/patches and applied during the build.
  
 See /usr/share/doc/quilt/README.source for a detailed explanation.
+
+ == Making some sense out of the configure options  ==
+
+The COMMON_CONFIG variable contains the configure options that are to
+be used on all the SAPIs. Built-in extensions and other general options
+should be set here.
+The shared extensions are built when building the apache2 SAPI and as
+such they need to be specified there.
+The calls to configure for the other SAPIs usually only need
+--without-foo when the extension or feature is otherwise enabled by
+default.
+
+ == The *modulelist files ==
+
+When building a new module (or extension) on an individual binary
+package, it must be added to the debian/modulelist file. However, if
+the extension is to be included in an existing binary package, it
+must be added to the debian/extramodulelist file.
+
+The format of these files is:
+"<package name> <fancy name, one word> <extension name>"
+
+E.g. for, if we want the mysql extension to be shipped in the
+php5-mysql package we use:
+"mysql MySQL mysql"
+But we also want mysqli and the PDO in the same package, so we add the
+following lines to extramoduleslist:
+"mysql MySQLi mysqli
+mysql MySQL_PDO pdo_mysql"
-- 
1.6.3.3