[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#354946: marked as done (No manpage and no other kind of help.)

Your message dated Sat, 10 Mar 2007 22:32:02 +0000
with message-id <E1HQA6c-0000sL-9u@ries.debian.org>
and subject line Bug#354946: fixed in ocamlodbc 2.12-1
has caused the attached Bug report to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere.  Please contact me immediately.)

Debian bug tracking system administrator
(administrator, Debian Bugs database)
--- Begin Message --- 
Package: libocamlodbc-ocaml-bin
Version: 2.10-4
Severity: normal

Hello,

thanks for bringing on Ocaml in Debian!

I've had however a bit of a frustrating experience with
libocamlodbc-ocaml-bin.

In short:

 - libocamlodbc-ocaml-bin contains a biniki executable with no manpage
   and no other kind of help
 - the package description makes it really hard to understand that this
   is an application
 - the package description does not say what kind of application it is.
   I suggest something like: "graphical application to run SQL queries
   on a database over ODBC".


Follows a bit of a longer feedback on my overall experience with biniki.


I've noticed libocamlodbc-ocaml-bin almost by accident when reviewing
some debtags submissions, and I've noticed that it's not a library but
an application, and I decided to give it a try.

First thing to report, is that it's very unlikely that someone would see
the name and description of this package and quickly figure out that it
contains an application.  Renaming it to biniki, and/or changing the short
description into something like 'Graphical, multi-database access
application' would probably a good idea.

Also, the description as it is doesn't say what kind of database
application it is.  From the description, it could as well be something
like a graphical, multi-database application to corrupt all the data in
the database without asking for confirmation :)

I assumed that it's a database browsing application of some sort.

Then I tried to run it:

 $ biniki
 Usage : biniki <base> [<user> [<password>]]
 $ biniki --help
 Fatal error: exception Ocamlodbc.SQL_Error("Error while connecting to
 database --help as enrico with password <> : -1")
 $ LANG=C man biniki
 No manual entry for biniki
 See 'man 7 undocumented' for help when manual pages are not available.

I was trying to understand what 'base' really meant.  MySQL database
name?  ODBC DSN?  Type of database (mysql, psql...)?

If it's some sort of database name, 'test' can usually work:

 $ biniki test

First it tells me that ~enrico/.biniki does not exist, and asks me to
press ok.  I can see no reason for that confirmation, though: the
program can very well create the file by itself, or if it's really
something that is needed, give instructions on how to create it.

Finally, I get to see what seems to be the main window of the program:
an entry box without a label telling what it is, and an 'Execute'
button.  Most of the things I type in it give me 'unknown error'.

I tried the "?/About..." menu: it doesn't tell me much about the program
(not even what it is), but at least tells me who I should blame for it :)

Finally, I had a try at a 'show tables' SQL command and I managed to get
a result window out.  Enter does not work as I would expected in the
entry field, in that it shows a list of previous commands instead of
executing the command.

That's about all for my usage experience with biniki.  As a glance, it
looks more like an example program for libocamlodbc rather than a proper
application, and I'd expect to find it as source code in
libocamlodbc-ocaml-dev rather than as a binary in a package of its own.
But in case you have ambitious plans for it, the previous part of this
mail might provide useful feedback for further improvements :)


Ciao,

Enrico

-- System Information:
Debian Release: testing/unstable
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.15-1-686-smp
Locale: LANG=it_IT.UTF-8, LC_CTYPE=it_IT.UTF-8 (charmap=UTF-8)

Versions of packages libocamlodbc-ocaml-bin depends on:
ii  libatk1.0-0               1.10.3-1       The ATK accessibility toolkit
ii  libc6                     2.3.6-2        GNU C Library: Shared libraries an
ii  libcairo2                 1.0.2-3        The Cairo 2D vector graphics libra
ii  libfontconfig1            2.3.2-2        generic font configuration library
ii  libglib2.0-0              2.8.6-1        The GLib library of C routines
ii  libgtk2.0-0               2.8.12-1       The GTK+ graphical user interface 
ii  libpango1.0-0             1.10.4-1       Layout and rendering of internatio
ii  libx11-6                  6.9.0.dfsg.1-4 X Window System protocol client li
ii  libxcursor1               1.1.3-1        X cursor management library
ii  libxext6                  6.9.0.dfsg.1-4 X Window System miscellaneous exte
ii  libxi6                    6.9.0.dfsg.1-4 X Window System Input extension li
ii  libxinerama1              6.9.0.dfsg.1-4 X Window System multi-head display
ii  libxrandr2                6.9.0.dfsg.1-4 X Window System Resize, Rotate and
ii  libxrender1               1:0.9.0.2-1    X Rendering Extension client libra
ii  unixodbc                  2.2.11-9       ODBC tools libraries

libocamlodbc-ocaml-bin recommends no packages.

-- no debconf information

--- End Message ---
--- Begin Message --- 
Source: ocamlodbc
Source-Version: 2.12-1

We believe that the bug you reported is fixed in the latest version of
ocamlodbc, which is due to be installed in the Debian FTP archive:

libocamlodbc-ocaml-dev_2.12-1_i386.deb
  to pool/main/o/ocamlodbc/libocamlodbc-ocaml-dev_2.12-1_i386.deb
ocamlodbc_2.12-1.diff.gz
  to pool/main/o/ocamlodbc/ocamlodbc_2.12-1.diff.gz
ocamlodbc_2.12-1.dsc
  to pool/main/o/ocamlodbc/ocamlodbc_2.12-1.dsc
ocamlodbc_2.12.orig.tar.gz
  to pool/main/o/ocamlodbc/ocamlodbc_2.12.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 354946@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Samuel Mimram <smimram@debian.org> (supplier of updated ocamlodbc 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.7
Date: Wed, 28 Feb 2007 18:47:42 +0100
Source: ocamlodbc
Binary: libocamlodbc-ocaml-dev
Architecture: source i386
Version: 2.12-1
Distribution: experimental
Urgency: low
Maintainer: Debian OCaml Maintainers <debian-ocaml-maint@lists.debian.org>
Changed-By: Samuel Mimram <smimram@debian.org>
Description: 
 libocamlodbc-ocaml-dev - UnixODBC database bindings for OCaml
Closes: 354946
Changes: 
 ocamlodbc (2.12-1) experimental; urgency=low
 .
   * New upstream release.
   * Not providing the libocamlodbc-ocaml-bin package anymore, biniki was a toy
     example and is now provided as an example in libocamlodbc-ocaml-dev,
     closes: #354946.
   * Removed lablgtk2.dpatch, integrated upstream.
   * We don't need to remove rpaths anymore.
   * Updated package description.
   * Updated standards version to 3.7.2, no changes needed.
Files: 
 f0b7d40c8c7b97da107f3a5c927a8c32 926 devel optional ocamlodbc_2.12-1.dsc
 682e5d63352258391b3a45a387748302 57015 devel optional ocamlodbc_2.12.orig.tar.gz
 7e4792c1b0922855235eae7f61b1e8bf 4718 devel optional ocamlodbc_2.12-1.diff.gz
 79dfcda840e68ddb74e636cdced06d50 33922 libdevel optional libocamlodbc-ocaml-dev_2.12-1_i386.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)

iD8DBQFF8zDyIae1O4AJae8RAiEWAJ97U98r9AKJB/g9g/0hZVOsn/l0qACeJEZj
tsDBtDwEvCZN2SaCBN5Xbcs=
=v3F9
-----END PGP SIGNATURE-----

--- End Message ---
Reply to: