Enhanced documentation around the source package and the reasons for it

being arch:any

git-svn-id: svn://svn.debian.org/svn/pkg-mysql/mysql-5.5/branches/unstable@2125 bb5a2ed9-75f0-0310-a2b8-e46d7b0922c1

3 files changed, 25 insertions, 3 deletions

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..15264b3
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,19 @@
+The question arises why we have the mysql-source-* packages and why
+they are arch:any wasting so much space. This conversation covered the
+issue although it should probably be looked at again.
+
+(26/05/12 16:24:18) SpamapS: periapt: hey, are you 100% sure that mysql-source-5.5 is arch: all ?
+(16:24:37) SpamapS: periapt: It includes generated files.. some of which might be arch specific. I've never taken the time to make sure.
+(16:35:56) periapt: SpamapS: Actually that's a fair point - cmake output. But then I think we ought to drop it. I view it as duplication which I think is against Debian policy.
+(16:44:04) periapt: It seems to be some sort of hangover from when the licensing issues were much worse. It's popcorn rating is almost lower than the arches we support.
+(16:49:27) SpamapS: Nope, its needed for plugins
+(16:49:39) SpamapS: It is only useful as a build-dep
+(16:49:57) SpamapS: Now, I have been made aware of the fact that source format 3.0 allows multiple upstreams..
+(16:50:24) SpamapS: periapt: I created the package, and I use it as a build-dep for handlersocket.
+(16:50:54) SpamapS: periapt: perhaps we should add handlersocket as a second upstream source. That would eliminate the need for it.
+(16:55:21) periapt: SpamapS: I would advise against multiple upstream sources. I actually tried to write some debhelper stuff to maange it. I never got the uscan wrapper working and it's horrible: pkg-components.
+(16:56:23) SpamapS: periapt: then we cannot remove the mysql-source-* packages
+(16:56:57) periapt: I'll put it back to arch:any for now and update the long description. I notice there are already bugs that cover the issue of how to manage plugins. I think it should be revisited. 
+(16:57:30) SpamapS: periapt: perhaps the clarity from this discussion belongs in README.source too :)
+(16:57:40) periapt: okay
+(16:58:15) periapt: Actually I would prefer the FAQ: http://wiki.debian.org/Teams/MySQL/FAQ
diff --git a/debian/changelog b/debian/changelog
index 696e64c..af38afa 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -16,7 +16,8 @@ mysql-5.5 (5.5.24+dfsg-1) UNRELEASED; urgency=low
   * Added --fail-missing to dh_install to catch executables not being installed
   * Distributed unused resources amongst packages appropriately
   * Added fixes to mop up various permissions issues in auto-install rule
-  * Converted mysql-source-5.5 to arch:all
+  * Enhanced documentation around the source package and the reasons for it
+    being arch:any
   * Removed source cruft: debian/additions/*.1 (apart from mysqlreport.1)
   * Restored zlib1g-dev build dependency pending further investigation
   * Removed the numerical prefix from the patch files
diff --git a/debian/control b/debian/control
index e81a77e..bcaff93 100644
--- a/debian/control
+++ b/debian/control
@@ -164,7 +164,7 @@ Description: MySQL testsuite
  This package includes the MySQL testsuite.
 
 Package: mysql-source-5.5
-Architecture: all
+Architecture: any
 Depends: ${misc:Depends}, ${shlibs:Depends}
 Description: MySQL source
  MySQL is a fast, stable, and true multi-user, multi-threaded SQL database
@@ -172,4 +172,6 @@ Description: MySQL source
  language in the world. The main goals of MySQL are speed, robustness and
  ease of use.
  .
- This package includes the MySQL source code as configured before building.
+ This package includes the MySQL source code as configured before building
+ - but after the arch specific configuration. This is currently required for
+ building plugins.