--- Begin Message ---
- To: Debian Bug Tracking System <submit@bugs.debian.org>
- Subject: ocaml-batteries-included: Lots of mismatches between what the documentation says and what the package does.
- From: Roberto Di Cosmo <roberto@dicosmo.org>
- Date: Sun, 08 Apr 2012 13:40:10 +0200
- Message-id: <20120408114010.26401.73117.reportbug@voyager>
Package: ocaml-batteries-included
Version: 1.4.1-1
Severity: important
The documentation included in libbatteries-ocaml-doc does not correspond
to what the libraries actually do, and what the packages contain: it really
needs a thorough check.
Please do not underestimate the importance of fixing "just some documentation":
in the current state, a developer will simply not find a way to use these packages,
unless he/she has a friend in the Batteries developer's team.
A few examples:
/usr/share/doc/libbatteries-ocaml-doc/html/setup.html says:
To use batteries in the ocaml toplevel, install ocamlinit from the batteries source directory into your ~/.ocamlinit file and launch ocaml normally
but there is no ocamlinit to be found in any of the three batteries packages
/usr/share/doc/libbatteries-ocaml-doc/html/toplevel.html says:
To launch the toplevel from a terminal, open a terminal and write ocamlfind batteries/ocaml
but here is what happens if one tries
ocamlfind: Cannot find command: /usr/lib/ocaml/batteries/ocaml
/usr/share/doc/libbatteries-ocaml-doc/html/extensions.html says:
"where" construction (activated by default, implemented as findlib package batteries.pa_where.syntax)
but there is no findlib package batteries.pa_where.syntax to be found on the system!
-- System Information:
Debian Release: 6.0.1
APT prefers testing
APT policy: (760, 'testing'), (700, 'stable'), (600, 'unstable'), (550, 'experimental'), (500, 'stable-updates')
Architecture: amd64 (x86_64)
Kernel: Linux 2.6.38-1-amd64 (SMP w/8 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8) (ignored: LC_ALL set to en_US.utf8)
Shell: /bin/sh linked to /bin/dash
Versions of packages ocaml-batteries-included depends on:
ii libbatteries-ocaml-dev [libba 1.4.1-1+b1 Batteries included: OCaml developm
ii libbatteries-ocaml-doc 1.4.1-1 Batteries included - OCaml develop
ocaml-batteries-included recommends no packages.
ocaml-batteries-included suggests no packages.
-- no debconf information
--- End Message ---
--- Begin Message ---
Source: ocaml-batteries
Source-Version: 1.4.3-1
We believe that the bug you reported is fixed in the latest version of
ocaml-batteries, which is due to be installed in the Debian FTP archive:
libbatteries-ocaml-dev_1.4.3-1_amd64.deb
to main/o/ocaml-batteries/libbatteries-ocaml-dev_1.4.3-1_amd64.deb
libbatteries-ocaml-doc_1.4.3-1_all.deb
to main/o/ocaml-batteries/libbatteries-ocaml-doc_1.4.3-1_all.deb
ocaml-batteries-included_1.4.3-1_all.deb
to main/o/ocaml-batteries/ocaml-batteries-included_1.4.3-1_all.deb
ocaml-batteries_1.4.3-1.debian.tar.gz
to main/o/ocaml-batteries/ocaml-batteries_1.4.3-1.debian.tar.gz
ocaml-batteries_1.4.3-1.dsc
to main/o/ocaml-batteries/ocaml-batteries_1.4.3-1.dsc
ocaml-batteries_1.4.3.orig.tar.gz
to main/o/ocaml-batteries/ocaml-batteries_1.4.3.orig.tar.gz
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to 668027@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Mehdi Dogguy <mehdi@debian.org> (supplier of updated ocaml-batteries package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 1.8
Date: Tue, 05 Jun 2012 22:51:41 +0200
Source: ocaml-batteries
Binary: libbatteries-ocaml-dev libbatteries-ocaml-doc ocaml-batteries-included
Architecture: source amd64 all
Version: 1.4.3-1
Distribution: unstable
Urgency: low
Maintainer: Debian OCaml Maintainers <debian-ocaml-maint@lists.debian.org>
Changed-By: Mehdi Dogguy <mehdi@debian.org>
Description:
libbatteries-ocaml-dev - Batteries included: OCaml development platform - development file
libbatteries-ocaml-doc - Batteries included - OCaml development platform - documentation
ocaml-batteries-included - Batteries included: OCaml development platform - metapackage
Closes: 668027
Changes:
ocaml-batteries (1.4.3-1) unstable; urgency=low
.
* New upstream release (Closes: 668027)
- add 0002-Use-mirror-of-ocaml-tutorial.org-which-is-dead.patch
- add 0003-Fix-doc-batteries-html-extensions.html.patch
Checksums-Sha1:
fc6417788f0ca84cb70ab9f6ea86373c0c63dd42 1963 ocaml-batteries_1.4.3-1.dsc
0b4d91b5d3268d2fc65708fadadb63cc12b9bdf8 657223 ocaml-batteries_1.4.3.orig.tar.gz
43ef103d8b084314dc50b4ccb6640a3dc37dc351 9018 ocaml-batteries_1.4.3-1.debian.tar.gz
a1b6fc1907adbbf4bbbeed1d30330de166412c9c 7388192 libbatteries-ocaml-dev_1.4.3-1_amd64.deb
bb285d23c931d89a68d8e7f67c8e4d41e72ad6b8 1052044 libbatteries-ocaml-doc_1.4.3-1_all.deb
c8220b2645ee39e5c25d9ff5aa970eb5bdef86e4 8208 ocaml-batteries-included_1.4.3-1_all.deb
Checksums-Sha256:
c2b8b60dc780b0e716a669492fbc70b9a141966ae9c3e4f184c761b00debac79 1963 ocaml-batteries_1.4.3-1.dsc
4c1516455180dfa50d735b8f139c72aeb64f08e8b3619eb0c1dc4cc1034bcfdf 657223 ocaml-batteries_1.4.3.orig.tar.gz
2668414f630a6076ef13a4522ed59d48b6c5b0002567b27208210f7888b64362 9018 ocaml-batteries_1.4.3-1.debian.tar.gz
d2b605abade97393cd49f2ffbf91b4e23c322b9ab01eb3417ec134585846435f 7388192 libbatteries-ocaml-dev_1.4.3-1_amd64.deb
007d4fe967d34e09385eb68efa35fb939a2bde5cd543c587b94ece6517c9eea7 1052044 libbatteries-ocaml-doc_1.4.3-1_all.deb
69b88bb24655b536a8f8cd70cd4ef1949e9c081afb878ed40696cbd85b490723 8208 ocaml-batteries-included_1.4.3-1_all.deb
Files:
5e07d085259adc8881b9d570970e4296 1963 ocaml optional ocaml-batteries_1.4.3-1.dsc
af93a95bcbfeaa188453b7495b815413 657223 ocaml optional ocaml-batteries_1.4.3.orig.tar.gz
77caeb743b99d8e2a051496db4631326 9018 ocaml optional ocaml-batteries_1.4.3-1.debian.tar.gz
937349aea78818d76995eb323d652b6e 7388192 ocaml optional libbatteries-ocaml-dev_1.4.3-1_amd64.deb
e806ce0f33a3ec3fb21ff89293a41e2d 1052044 doc optional libbatteries-ocaml-doc_1.4.3-1_all.deb
99cad8574098bd5feeb63852bc2793bf 8208 ocaml optional ocaml-batteries-included_1.4.3-1_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
iQEcBAEBAgAGBQJPznMnAAoJEDe1GR0FRlJojzsH/A1mlxeqvBIRHDk7ILj+RTRP
nHD8mu1FUcgVOx3ml3YKFC1MxNhu0LnbW+9TFCVHstebW49/Gdnpgu5i3Ah2w12Q
ya5DqwBxoTi81pXrXuDTUNx71Gnx7Q2cXsngs/mOBD/ElkqdzOq2Z/oP1ahHktAV
/5HUmyugG/cP8HYNB8a4I2sdiV2ZdWNzYVIe6SeXZpj6jCDAS3R2YNsm9v8jIq/2
1vcE2szzOoNkUSYnh6jIbAVN6vF8G82jt81u/FNaKYv2k7sEsUrziK7lHPDLQf5j
Kug9UGi7Nn2FWvS+5jORnHY6HVcefCz+BepL7wS5wWVZA0wWtJMJLOvIBKMd2/g=
=gsYN
-----END PGP SIGNATURE-----
--- End Message ---