Unverified Commit 124f7b04 authored by Jan Kotanski's avatar Jan Kotanski
Browse files

update config

parent 2b2b4801
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@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@debian.fr> Sat, 07 Oct 2017 14:02:39 +0200
......@@ -5,13 +5,12 @@ The Debian version of HDF5 is created starting from the official tarball and
adding some required patches managed by quilt. More information about quilt
use are available in /usr/share/doc/quilt/README.Debian and its documentation.
Note that starting from 1.8 HDF Group is not more providing a tarball of the
library documentation. The documentation in html format is now taken by
the HDF Group svn repository:
svn export https://svn.hdfgroup.uiuc.edu/hdf5doc/branches/hdf5_1_8_4/html
This is taken care by uscan companion script debian/orig-tar.sh.
No more html docs after release 1.10.2. Quoting upstream:
> The latest documentation is on the support portal only, which is freely
> available. However, it's not easily downloadable.
> We are no longer updating the User's Guide/Reference Manual in the hdf5doc
> repo, and there is now only one version of the documentation. See the
> history at the end of an API to determine when it was introduced.
About symbols files
-------------------
......@@ -36,7 +35,7 @@ care about identifying local symbols for now.
About C++ symbols tracking
--------------------------
Tracking C++ versioned symbols is complacated:
Tracking C++ versioned symbols is complicated:
* Firstly we need to track them under their unmangled form to be arch
independant.
* Secondly I discovered after many /try fail repeat/ that dpkg-gensymbols
......@@ -46,6 +45,7 @@ Tracking C++ versioned symbols is complacated:
* Finaly the patches generated by dpkg-gensymbols don't allow any
comment in the symbols files and requires a specific sorting order
(bug #773718).
All these concerns are handled by three helper scripts:
* debian/process-symbols-files
* debian/sort-symbols
......@@ -58,32 +58,6 @@ using this C++ library, we didn't bother.
The script debian/check-dep-on-hdf5-cpp is used to check these dependencies.
About shared libraries versioning and SONAME
--------------------------------------------
Worth reading to get the picture about libtool versioning:
<http://bzed.de/scratchpad/soname-libtool.txt>
[Old note - for the record]
> About versioning style. In very recent times (since 1.8 series) HDF Group
> introduced a libtool SONAME versioning in the library with major/minor releases.
> Unfortunately, past experieces showed that API retention has been sometimes
> violated in the past, so current packages use a defensive approach by considering
> each release as not back-compatible. This is also motivated by the presence of
> of C++ and Fortran bindings as well as multiple MPI editions, which could imply
> ABI breakages even for minor releases. Be defensive is more safe, definitively
Looking at the 1.8.x releases, it seems that upstream doesn't apply the
libtool versioning strategy. Instead they use it the major.medium.minor way
where:
* medium=0
* minor++ on release
* major++, minor=0 on API breaks
Considering applying this piece of advice from Julien Cristau:
> J'aurais tendance à suggérer d'utiliser le switch -version-number de
> libtool plutôt que -version-info. Ça prend directement comme argument
> major:minor:micro, donc on se perd pas dans des calculs à la con.
Manpages
--------
$ help2man -n "helper script to compile HDF5 Fortran applications" --version-string="h5pfc (hdf5 1.8.12)" -h -help -N h5pfc >debian/man/h5pfc.1
......@@ -93,9 +67,6 @@ $ help2man -n "debugs an existing HDF5 file at a low level" --version-string="h5
TO-DO
-----
* common manpage for h5*{c,f}c
* patch libtool usage to use -version-number instead of -version-info'?
* propose to upstream to use a separate libtool version for each language
(C, C++, Fortran)?
-- Francesco Paolo Lovergine <frankie@debian.org> Mon Jan 25 06:00:00 CET 2010
-- Gilles Filippini <pini@debian.org> Mon, 22 Dec 2014 01:50:39 +0100
-- Gilles Filippini <pini@debian.org> Wed, 10 Apr 2019 13:19:06 +0200
This diff is collapsed.
This diff is collapsed.
This package was debianized by Brian Russo <wolfie@debian.org> on
Mon, 22 Jan 2001 22:09:19 -1000.
Currently maintained by Francesco P. Lovergine <frankie@debian.org>
in behalf of the DebianGis Team.
It was downloaded from http://hdfgroup.org/
Upstream authors: The HDF Group (THG)
Copyright:
HDF5 (Hierarchical Data Format 5) Software Library and Utilities
Copyright 2006-2008 by The HDF Group (THG).
NCSA HDF5 (Hierarchical Data Format 5) Software Library and Utilities
Copyright 1998-2006 by the Board of Trustees of the University of Illinois.
All rights reserved.
Contributors: National Center for Supercomputing Applications (NCSA) at
the University of Illinois, Fortner Software, Unidata Program Center (netCDF),
The Independent JPEG Group (JPEG), Jean-loup Gailly and Mark Adler (gzip),
and Digital Equipment Corporation (DEC).
Redistribution and use in source and binary forms, with or without
modification, are permitted for any purpose (including commercial purposes)
provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions, and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions, and the following disclaimer in the documentation
and/or materials provided with the distribution.
3. In addition, redistributions of modified forms of the source or binary
code must carry prominent notices stating that the original code was
changed and the date of the change.
4. All publications or advertising materials mentioning features or use of
this software are asked, but not required, to acknowledge that it was
developed by The HDF Group and by the National Center for Supercomputing
Applications at the University of Illinois at Urbana-Champaign and
credit the contributors.
5. Neither the name of The HDF Group, the name of the University, nor the
name of any Contributor may be used to endorse or promote products derived
from this software without specific prior written permission from the
University, THG, or the Contributor, respectively.
DISCLAIMER:
THIS SOFTWARE IS PROVIDED BY THE HDF GROUP (THG) AND THE CONTRIBUTORS
"AS IS" WITH NO WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED. In no
event shall THG or the Contributors be liable for any damages suffered by
the users arising out of the use of this software, even if advised of the
possibility of such damage.
-----------------------------------------------------------------------------
Portions of HDF5 were developed with support from the University of
California, Lawrence Livermore National Laboratory (UC LLNL).
The following statement applies to those portions of the product and must
be retained in any redistribution of source code, binaries, documentation,
and/or accompanying materials:
This work was partially produced at the University of California,
Lawrence Livermore National Laboratory (UC LLNL) under contract
no. W-7405-ENG-48 (Contract 48) between the U.S. Department of Energy
(DOE) and The Regents of the University of California (University)
for the operation of UC LLNL.
DISCLAIMER:
This work was prepared as an account of work sponsored by an agency of
the United States Government. Neither the United States Government nor
the University of California nor any of their employees, makes any
warranty, express or implied, or assumes any liability or responsibility
for the accuracy, completeness, or usefulness of any information,
apparatus, product, or process disclosed, or represents that its use
would not infringe privately- owned rights. Reference herein to any
specific commercial products, process, or service by trade name,
trademark, manufacturer, or otherwise, does not necessarily constitute
or imply its endorsement, recommendation, or favoring by the United
States Government or the University of California. The views and
opinions of authors expressed herein do not necessarily state or reflect
those of the United States Government or the University of California,
and shall not be used for advertising or product endorsement purposes.
-----------------------------------------------------------------------------
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: HDF5
Upstream-Contact: HDF Group <help@hdfgroup.org>
Sources: https://bitbucket.hdfgroup.org/scm/hdffv/hdf5.git
Comment: Upstream tarball repacked to drop PDF files for which we have no
source, and some others useless files.
See debian/{watch,orig-tar.sh,orig-tar.exclude} for details.
Files: *
Copyright: 1998-2006 The Board of Trustees of the University of Illinois
2016 The Regents of the University of California
2006-2018 The HDF Group
License: BSD-3-clause
Copyright Notice and License Terms for
HDF5 (Hierarchical Data Format 5) Software Library and Utilities
-----------------------------------------------------------------------------
.
HDF5 (Hierarchical Data Format 5) Software Library and Utilities
Copyright (c) 2006-2018, The HDF Group.
.
NCSA HDF5 (Hierarchical Data Format 5) Software Library and Utilities
Copyright (c) 1998-2006, The Board of Trustees of the University of Illinois.
.
All rights reserved.
.
Redistribution and use in source and binary forms, with or without
modification, are permitted for any purpose (including commercial purposes)
provided that the following conditions are met:
.
1. Redistributions of source code must retain the above copyright notice,
this list of conditions, and the following disclaimer.
.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions, and the following disclaimer in the documentation
and/or materials provided with the distribution.
.
3. Neither the name of The HDF Group, the name of the University, nor the
name of any Contributor may be used to endorse or promote products derived
from this software without specific prior written permission from
The HDF Group, the University, or the Contributor, respectively.
.
DISCLAIMER:
THIS SOFTWARE IS PROVIDED BY THE HDF GROUP AND THE CONTRIBUTORS
"AS IS" WITH NO WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED. IN NO EVENT
SHALL THE HDF GROUP OR THE CONTRIBUTORS BE LIABLE FOR ANY DAMAGES SUFFERED BY
THE USERS ARISING OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
.
You are under no obligation whatsoever to provide any bug fixes, patches, or
upgrades to the features, functionality or performance of the source code
("Enhancements") to anyone; however, if you choose to make your Enhancements
available either publicly, or directly to The HDF Group, without imposing a
separate written license agreement for such Enhancements, then you hereby grant
the following license: a non-exclusive, royalty-free perpetual license to
install, use, modify, prepare derivative works, incorporate into other computer
software, distribute, and sublicense such enhancements or derivative works
thereof, in binary and source code form.
.
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
.
Limited portions of HDF5 were developed by Lawrence Berkeley National
Laboratory (LBNL). LBNL's Copyright Notice and Licensing Terms can be
found here: COPYING_LBNL_HDF5 file in this directory or at
http://support.hdfgroup.org/ftp/HDF5/releases/COPYING_LBNL_HDF5.
.
-----------------------------------------------------------------------------
-----------------------------------------------------------------------------
.
Contributors: National Center for Supercomputing Applications (NCSA) at
the University of Illinois, Fortner Software, Unidata Program Center (netCDF),
The Independent JPEG Group (JPEG), Jean-loup Gailly and Mark Adler (gzip), and
Digital Equipment Corporation (DEC).
.
-----------------------------------------------------------------------------
.
Portions of HDF5 were developed with support from the Lawrence Berkeley
National Laboratory (LBNL) and the United States Department of Energy
under Prime Contract No. DE-AC02-05CH11231.
.
-----------------------------------------------------------------------------
.
Portions of HDF5 were developed with support from the University of
California, Lawrence Livermore National Laboratory (UC LLNL).
The following statement applies to those portions of the product and must
be retained in any redistribution of source code, binaries, documentation,
and/or accompanying materials:
.
This work was partially produced at the University of California,
Lawrence Livermore National Laboratory (UC LLNL) under contract
no. W-7405-ENG-48 (Contract 48) between the U.S. Department of Energy
(DOE) and The Regents of the University of California (University)
for the operation of UC LLNL.
.
DISCLAIMER:
This work was prepared as an account of work sponsored by an agency of
the United States Government. Neither the United States Government nor
the University of California nor any of their employees, makes any
warranty, express or implied, or assumes any liability or responsibility
for the accuracy, completeness, or usefulness of any information,
apparatus, product, or process disclosed, or represents that its use
would not infringe privately- owned rights. Reference herein to any
specific commercial products, process, or service by trade name,
trademark, manufacturer, or otherwise, does not necessarily constitute
or imply its endorsement, recommendation, or favoring by the United
States Government or the University of California. The views and
opinions of authors expressed herein do not necessarily state or reflect
those of the United States Government or the University of California,
and shall not be used for advertising or product endorsement purposes.
.
-----------------------------------------------------------------------------
.
HDF5 is available with the SZIP compression library but SZIP is not part
of HDF5 and has separate copyright and license terms. See SZIP Compression
in HDF Products (www.hdfgroup.org/doc_resource/SZIP/) for further details.
.
-----------------------------------------------------------------------------
.
Copyright Notice and License Terms for
HDF5 (Hierarchical Data Format 5) Software Library and Utilities
-----------------------------------------------------------------------------
.
HDF5 (Hierarchical Data Format 5)
Copyright (c) 2016, The Regents of the University of California, through
Lawrence Berkeley National Laboratory (subject to receipt of any required
approvals from the U.S. Dept. of Energy).
.
All rights reserved.
.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
.
1. Redistributions of source code must retain the above copyright notice,
this list of conditions, and the following disclaimer.
.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions, and the following disclaimer in the documentation
and/or materials provided with the distribution.
.
3. Neither the name of the University of California, Lawrence Berkeley
National Laboratory, U.S. Dept. of Energy nor the names of its contributors
may be used to endorse or promote products derived from this software without
specific prior written permission.
.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
THE POSSIBILITY OF SUCH DAMAGE.
.
You are under no obligation whatsoever to provide any bug fixes, patches,
or upgrades to the features, functionality or performance of the source
code ("Enhancements") to anyone; however, if you choose to make your
Enhancements available either publicly, or directly to Lawrence Berkeley
National Laboratory, without imposing a separate written license agreement
for such Enhancements, then you hereby grant the following license:
a non-exclusive, royalty-free perpetual license to install, use, modify,
prepare derivative works, incorporate into other computer software,
distribute, and sublicense such enhancements or derivative works thereof,
in binary and source code form.
Files: debian/*
Copyright: 2001 Brian Russo <wolfie@debian.org>
2003 Josselin Mouette <joss@debian.org>
2007-2009 Francesco P. Lovergine <frankie@debian.org>
2010-2013 Sylvestre Ledru <sylvestre@debian.org>
2014-2018 Gilles Filippini <pini@debian.org>
License: GPL-2+
This program is free software; you can redistribute it
and/or modify it under the terms of the GNU General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later
version.
.
This program is distributed in the hope that it will be
useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more
details.
.
You should have received a copy of the GNU General Public
License along with this package; if not, write to the Free
Software Foundation, Inc., 51 Franklin St, Fifth Floor,
Boston, MA 02110-1301 USA
.
On Debian systems, the full text of the GNU General Public
License version 2 can be found in the file
`/usr/share/common-licenses/GPL-2'.
Comment: When I took over the package in 2014 the d/copyright file was
written in free format and didn't mention debian/* files, but d/rules
had this section:
# (c) 2001 Brian Russo, under GPL.
# (c) 2003 Josselin Mouette
# (c) 2007-2009 Francesco P. Lovergine.
# (c) 2010-2013 Sylvestre Ledru
Because the GPL is mentioned with no version I infered GPL-2+.
[DEFAULT]
debian-branch = debian/stretch
upstream-branch = upstream/stretch
debian-tag = debian/stretch/%(version)s
upstream-tag = upstream/stretch/%(version)s
[buildpackage]
git-debian-branch = debian/stretch
git-debian-tag = debian/stretch/%(version)s
git-upstream-tag = upstream/stretch/%(version)s
# The default name for the upstream branch is "upstream".
# Change it if the name is different (for instance, "master").
upstream-branch = upstream
# The default name for the Debian branch is "master".
# Change it if the name is different (for instance, "debian/unstable").
debian-branch = master
# git-import-orig uses the following names for the upstream tags.
# Change the value if you are not using git-import-orig
upstream-tag = upstream/%(version)s
[import-orig]
# Always use pristine-tar.
pristine-tar = True
[buildpackage]
pbuilder-options = --source-only-changes
# Right but otherwise, hdf5-helpers will depend on one of the 3 hdf5 implementation
# causing some potential conflicts
hdf5-helpers: missing-dependency-on-libc needed by *
missing-dependency-on-libc needed by *
Name: HDF5
Description: Hierarchical Data Format 5 (HDF5) - MPICH version
Version: 1.8.13
Version: @VERSION@
Requires: mpich
Cflags: -I/usr/include/hdf5/mpich
Libs: -L/usr/lib/@MULTIARCH@/hdf5/mpich -lhdf5
Name: HDF5
Description: Hierarchical Data Format 5 (HDF5) - OpenMPI version
Version: 1.8.13
Version: @VERSION@
Requires:
Cflags: -I/usr/include/openmpi -I/usr/include/hdf5/openmpi
Libs: -L/usr/lib/@MULTIARCH@/hdf5/openmpi -lhdf5 -L/usr/lib/openmpi/lib -lmpi
Name: HDF5
Description: Hierarchical Data Format 5 (HDF5)
Version: 1.8.13
Version: @VERSION@
Requires:
Cflags: -I/usr/include/hdf5/serial
Libs: -L/usr/lib/@MULTIARCH@/hdf5/serial -lhdf5
usr/bin/gif2h5
usr/bin/h52gif
usr/bin/h5clear
usr/bin/h5copy
usr/bin/h5debug
usr/bin/h5diff
......
# Right but otherwise, hdf5-tools will depend on one of the 3 hdf5 implementation
# causing some potential conflicts
hdf5-tools: missing-dependency-on-libc needed by *
missing-dependency-on-libc needed by *
package-name-doesnt-match-sonames libhdf5-serial101 libhdf5-serial-fortran100 libhdf5-serial-hl100 libhdf5-serialhl-fortran100
This diff is collapsed.
package-name-doesnt-match-sonames libhdf5-cpp102 libhdf5-hl-cpp100
This diff is collapsed.
# This is wanted
libhdf5-dev: symlink-is-self-recursive usr/lib/*/hdf5/serial/lib .
symlink-is-self-recursive usr/lib/*/hdf5/serial/lib .
hdf5 (1.10.3+repack-1~exp1) experimental; urgency=medium
Starting with release 1.10.3 the HDF Group is no longer providing the
source for the HDF5 User's Guide and the Reference Manual.
The latest documentation is on the support portal only [1], which is
freely available. However, it's not easily downloadable.
[1] https://portal.hdfgroup.org/display/HDF5/HDF5
-- Gilles Filippini <pini@debian.org> Tue, 03 Apr 2018 22:05:51 +0200
# See bug #736360
# <http://bugs.debian.org/736360>
libhdf5-doc: embedded-javascript-library
embedded-javascript-library
usr/lib/*/libhdf5_cpp.so.*
usr/lib/*/libhdf5_hl_cpp.so.*
usr/lib/*/libhdf5@FLAVORLIB@_cpp.so.*
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment