[hdf5] 12/17: mv debian/README{, .Debina} + add v1.10.{0, 1} compatibility note

[Gilles Filippini]

This is an automated email from the git hooks/post-receive script.

pini pushed a commit to branch master
in repository hdf5.

commit a2e24227cb7fb1dfd3f3ef9379ba5219cf6703c8
Author: Gilles Filippini <pini at debian.org>
Date:   Sat Oct 7 14:06:05 2017 +0200

    mv debian/README{,.Debina} + add v1.10.{0,1} compatibility note
---
 debian/README        | 19 -------------------
 debian/README.Debian | 32 ++++++++++++++++++++++++++++++++
 debian/changelog     |  2 ++
 3 files changed, 34 insertions(+), 19 deletions(-)

diff --git a/debian/README b/debian/README
deleted file mode 100644
index b23aef1..0000000
--- a/debian/README
+++ /dev/null
@@ -1,19 +0,0 @@
-HDF5 for Debian
----------------
-
-Some general notes for developers: since 1.8 series HDF Group deprecates 
-enabling the thread-safe option for the C library and at the same time
-supporting C++ and Fortran bindings. Those options cannot cohexist for
-safety because non C libraries wrapper are not thread-aware. 
-Debian GNU/Linux still support a C thread-safe library and the alternative
-bindings, but it does not imply that the Debian distributed C++ and Fortran
-are thread-safe. 
-
-For short: DO NOT use C++ or Fortran bindings in multi-thread programs
-witihout providing yourself mutex infrastructure support for every wrapped 
-function. You can use safely only the C binding in a multi-thread environment.
-That was not different in 1.6 series, just the issue was ignored.
-
-Now, you are warned. 
-
- -- Francesco Paolo Lovergine <frankie at debian.org> Fri Jun 19 22:09:25 CEST 2009
diff --git a/debian/README.Debian b/debian/README.Debian
new file mode 100644
index 0000000..f874e7c
--- /dev/null
+++ b/debian/README.Debian
@@ -0,0 +1,32 @@
+HDF5 for Debian
+===============
+
+On thread safety
+----------------
+Some general notes for developers: since 1.8 series HDF Group deprecates 
+enabling the thread-safe option for the C library and at the same time
+supporting high level (HL), C++ and Fortran bindings. Those options cannot
+cohexist for safety because non C libraries wrapper are not thread-aware. 
+Debian GNU/Linux still support a C thread-safe library and the alternative
+bindings, but it does not imply that the Debian distributed high level, C++
+aand Fortranalibraries are thread-safe. 
+
+For short: DO NOT use HL, C++ or Fortran bindings in multi-thread programs
+witihout providing yourself mutex infrastructure support for every wrapped 
+function. You can use safely only the C binding in a multi-thread environment.
+That was not different in 1.6 series, just the issue was ignored.
+
+Now, you are warned. 
+
+ -- Francesco Paolo Lovergine <frankie at debian.org> Fri Jun 19 22:09:25 CEST 2009
+
+1.10.0 and 1.10.1 compatibility
+-------------------------------
+From HDF Group newsletter #153:
+HDF5 releases are always backward compatible. In general, they are also
+forward compatible in maintenance releases of a major release. However,
+the HDF5 - 1.10.0 maintenance release will NOT be able to read HDF5 - 1.10.1
+files that contain a metadata cache image. The metadata cache image must be
+removed with the h5clear tool in order for HDF5 - 1.10.0 to read the file.
+
+ -- Gilles Filippini <pini at debian.fr>  Sat, 07 Oct 2017 14:02:39 +0200
diff --git a/debian/changelog b/debian/changelog
index f34cb33..826c36a 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -7,6 +7,8 @@ hdf5 (1.10.1+docs-1) UNRELEASED; urgency=medium
     Thanks to James Clarke <jrtc27 at debian.org>
   * Drop patches CVE-2016-433*.patch (fixed upstream)
   * Refresh other patches
+  * Rename debian/README to debian/README.Debian and add note about
+    v1.10.0 and 1.10.1 compatibility
 
   * Improve flavor-configure-option.patch to manage -dev packages'
     symlinks and clean-up debian/rules a bit

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/hdf5.git