From: joy <joy@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Date: Wed, 12 Feb 2003 14:42:51 +0000 (+0000)
Subject: added a section describing how to handle large amounts of architecture-independent... 
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=developers-reference.git;a=commitdiff_plain;h=3655759aa4aa898ab5761e83be37aef2ca29a3d0

added a section describing how to handle large amounts of architecture-independent data bundled with programs


git-svn-id: svn://anonscm.debian.org/ddp/manuals/trunk/developers-reference@2152 313b444b-1b9f-4f58-a734-7bb04f332e8d
---

diff --git a/debian/changelog b/debian/changelog
index f0af2f2..9961072 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -8,6 +8,8 @@ developers-reference (3.3) unstable; urgency=low
   * Josip Rodin:
     - split out the doc-files per language, closes: #177448.
     - shuffled stuff around in the packages chapter
+    - added a section describing how to handle large amounts of
+      architecture-independent data bundled with programs
   * Adam Di Carlo:
     - update (c) year
     - convert to debhelper (compat mode 4); maintainer scripts no longer
diff --git a/developers-reference.sgml b/developers-reference.sgml
index 9ae4e09..f108203 100644
--- a/developers-reference.sgml
+++ b/developers-reference.sgml
@@ -6,7 +6,7 @@
   <!entity % commondata  SYSTEM "common.ent" > %commondata;
 
   <!-- CVS revision of this document -->
-  <!entity cvs-rev "$Revision: 1.168 $">
+  <!entity cvs-rev "$Revision: 1.169 $">
   <!-- if you are translating this document, please notate the CVS
        revision of the developers reference here -->
   <!--
@@ -3348,7 +3348,6 @@ Lisp packages should register themselves with
 &file-lisp-controller;.
 </list>
         </sect1>
-      </sect>
 
 <!--
 	<sect1 id="custom-config-files">Custom configuration files
@@ -3365,7 +3364,25 @@ Lisp packages should register themselves with
 	sympa may be an example package
 -->	
 
+	<sect1 id="bpp-archindepdata">Architecture-independent data
+	<p>
+	It is not uncommon to have a large amount of architecture-independent
+	data packaged with a program. For example, collection of icons,
+	wallpapers or other graphic files, or audio files. If the size of
+	this data is negligible compared to the size of the remainder of the
+	package, you can keep it all in the same package.
 
+	<p>
+	However, if the size of the data is considerable, consider splitting
+	it out into a separate, architecture-independent package
+	("_all.deb"). By doing this, you avoid needless duplication of the
+	same data into eleven or more .debs per each architecture. While
+	this adds some extra overhead into the Packages files, it can save a
+	lot of disk space on Debian mirrors, and it also reduces processing
+	time of Lintian or Linda when run over the entire Debian archive. 
+	</sect1>
+
+      </sect>
 
 
   <chapt id="beyond-pkging">