use perl for uu*code

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

diff --git a/debian/changelog b/debian/changelog
index 1fc239fc93720f90223a6d6c0b6dec2436445f4e..d66e28cfb105fe26e7f85253a8e54f3dfa101a20 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -28,6 +28,8 @@ developers-reference (3.3.8) unstable; urgency=low
     Closes: #382477
   * section changing needs re-uploading orig.tar.gz.
     Thanks, Adam D. Barratt. Closes: #387154
+  * binary files in diffs could be en/decoded with perl.
+    Thanks, Frank Küster. Closes: #397786
 
  -- Andreas Barth <aba@not.so.argh.org>  Sat, 11 Nov 2006 10:55:44 -0700
 

diff --git a/developers-reference.sgml b/developers-reference.sgml
index 1f4392f94356458cd4c6ec847f7dbc90f06e85ec..536ffee46f534e76e03630e1d950f0296cf9559d 100644 (file)
--- a/developers-reference.sgml
+++ b/developers-reference.sgml
@@ -7,7 +7,7 @@
   <!ENTITY % dynamicdata  SYSTEM "dynamic.ent" > %dynamicdata;
 
   <!-- CVS revision of this document -->
-  <!ENTITY cvs-rev "$Revision: 1.307 $">
+  <!ENTITY cvs-rev "$Revision: 1.308 $">
 
   <!-- if you are translating this document, please notate the CVS
        revision of the original developer's reference in cvs-en-rev -->
@@ -4972,6 +4972,17 @@ form
 The file should have a name that makes it clear which binary file it
 encodes. Usually, some postfix indicating the encoding should be
 appended to the original filename.
+Note that you don't need to depend on <package>sharutils</package> to get
+the <prgn>uudecode</prgn> program if you use <prgn>perl</prgn>'s
+<tt>pack</tt> function.
+The code could look like
+<example>
+uuencode-file:
+    perl -ne 'print(pack "u", $$_);' $(file) > $(file).uuencoded
+
+uudecode-file:
+    perl -ne 'print(unpack "u", $$_);' $(file).uuencoded > $(file)
+</example>
 </footnote>.
 The file would then be decoded and copied to its place during the
 build process. Thus the change will be visible quite easy.