[Pkg-ocaml-maint-commits] [SCM] bin-prot packaging branch, master, updated. debian/1.0.5-2-1-ge6442a6

[Stefano Zacchiroli]

The following commit has been merged in the master branch:
commit e6442a64b302a81945390c57e3259c9bc53bece8
Author: Stefano Zacchiroli <zack at upsilon.cc>
Date:   Fri May 9 11:05:28 2008 +0200

    upload to unstable
    
    * upload to unstable
    * release to all architecture as discussed with upstream, add notes to
      README.Debian about which cross-architectures patterns work and which
      don't

diff --git a/debian/README.Debian b/debian/README.Debian
index ba52071..add846d 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,3 +1,42 @@
+Architecture support
+====================
+
+bin-prot works at its best on little endian architecture and has been
+thoroughly tested only on i386 and amd64. Using it on other architectures can
+exhibit a number of limitation. Here is a summary of such limitation taken from
+a post by upstream author Markus Mottl to the Caml mailing list
+(http://groups.google.com/group/fa.caml/msg/80da07bb322f2d7a)
+
+> We currently do not have any immediate need and man power to fully
+> support big-endian machines (we also don't have access to any), but
+> we'll gladly accept patches.  This could be implemented using
+> platform-specific macros as is the case with 32/64bit.
+> 
+> This is what works / doesn't work as of now:
+> 
+>   *) Big-endian and little-endian machines cannot communicate with
+> each other for anything but very specific cases.  Don't use the binary
+> protocol in such heterogeneous environments.
+> 
+>   *) 32 and 64 bit, little-endian architectures can communicate
+> freely, assuming, of course, that integers do not overflow on 32bit.
+> This is tested at runtime to prevent hard to debug errors.
+> 
+>   *) 32bit big-endian machines can communicate with each other freely.
+> 64 bit big-endians can communicate with each other freely, too, but
+> not necessarily with 32bit big-endians: values of type int64, etc.,
+> may not necessarily be communicated correctly.  Note, too, that you
+> should exclusively use the automatically generated converters on
+> big-endian machines.  The hand-written (slower) ones for the basic
+> types are intended mostly for testing purposes only, and will not work
+> when mixed with a different endianness (they assume little-endians).
+> 
+> Thus, it certainly makes sense to package the binary protocol for
+> big-endians, too, as long as people are informed of what works.  Since
+> almost nobody uses big-endian machines, most users won't care.  But
+> I'd surely be happy to see a patch to fully support all
+> architectures... 
+
 Syntax extension usage
 ======================
 
diff --git a/debian/TODO b/debian/TODO
index 186ba1e..afa54b3 100644
--- a/debian/TODO
+++ b/debian/TODO
@@ -1,9 +1,3 @@
 
-- enlarge the set of Architectures supported by bin-prot. On one hand we can
-  (in theory) enlarge it to the set of all little endian architectures, see
-  http://wiki.debian.org/ArchitectureSpecificsMemo for a reference. On the
-  other hand, we will need sooner or later to support also big endian
-  architecture (patch needed)
-
 - ship ocamldoc html API reference, at least for the library part of bin_prot
 
diff --git a/debian/changelog b/debian/changelog
index 767664a..af827ef 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,12 @@
+bin-prot (1.0.5-3) unstable; urgency=low
+
+  * upload to unstable
+  * release to all architecture as discussed with upstream, add notes to
+    README.Debian about which cross-architectures patterns work and which
+    don't
+
+ -- Stefano Zacchiroli <zack at debian.org>  Fri, 09 May 2008 11:04:18 +0200
+
 bin-prot (1.0.5-2) experimental; urgency=low
 
   * add build-dep on camlp4-extra (fix FTBFS)
diff --git a/debian/control b/debian/control
index 510329f..8189581 100644
--- a/debian/control
+++ b/debian/control
@@ -14,7 +14,7 @@ Homepage: http://www.janestcapital.com/ocaml/
 
 Package: libbin-prot-camlp4-dev
 Section: libdevel
-Architecture: i386 amd64
+Architecture: any
 Depends: ocaml-nox-${F:OCamlABI}, ocaml-findlib,
  camlp4, libtype-conv-camlp4-dev,
  ${shlibs:Depends}, ${misc:Depends}

-- 
bin-prot packaging