From: aba <aba@313b444b-1b9f-4f58-a734-7bb04f332e8d>
Date: Sun, 12 Nov 2006 09:01:30 +0000 (+0000)
Subject: use perl for uu*code
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=12b83843dba3fb4be435ef6a1fe246e52aa4c44f;p=developers-reference.git

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 1fc239f..d66e28c 100644
--- 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 1f4392f..536ffee 100644
--- 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.