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

Bug#183936: marked as done (ocaml: no whatis entry in StdLabels* manpages)

Your message dated Sun, 2 Sep 2007 18:50:50 +0200
with message-id <20070902165050.GA27245@takhisis.invalid>
and subject line closing (if needed please reopen with a more in depth analysis)
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: ocaml
Version: 3.06-15
Severity: normal


Hi,

here is the problem:

$ man -k StdLabels     
StdLabels (o)        - Standard labeled libraries.
StdLabels.Array (o)  - (unknown subject)
StdLabels.Array - (o) [StdLabels.Array] - (unknown subject)
StdLabels.List (o)   - (unknown subject)
StdLabels.List - (o) [StdLabels.List] - (unknown subject)
StdLabels.String (o) - (unknown subject)
StdLabels.String - (o) [StdLabels.String] - (unknown subject)


-- System Information:
Debian Release: testing/unstable
Architecture: i386
Kernel: Linux jophur 2.4.20-686 #1 Mon Jan 13 22:22:30 EST 2003 i686
Locale: LANG=fr_FR@euro, LC_CTYPE=fr_FR@euro

Versions of packages ocaml depends on:
ii  libc6                     2.3.1-14       GNU C Library: Shared libraries an
ii  libncurses5-dev           5.3.20021109-2 Developer's libraries and docs for
ii  ocaml-base [ocaml-base-3. 3.06-15        Runtime system for ocaml bytecode 

-- debconf information excluded

--- End Message ---
--- Begin Message --- 
[ full story available at http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=183936 ]

Hi, the bug report was about two issues: a manpage generation bug, and
some missing descriptions in manpages.  The first one has been solved.

The second one is not a bug per se IMO. Indeed the descriptions will be
missing for modules with lack a comment, that usually happens for inner
modules. So for example we have a description for StdLabels, but no
description for StdLabels.Array. Nonetheless the page is useful and
describe all inner values.

A proper bug report would be to list all modules of the standard library
which lack a proper comment and add one to them. (The fix for this
should actually come for upstream, so please consider bugging in the
upstream BTS.)

Cheers.

-- 
Stefano Zacchiroli -*- PhD in Computer Science ............... now what?
zack@{cs.unibo.it,debian.org,bononia.it} -%- http://www.bononia.it/zack/
(15:56:48)  Zack: e la demo dema ?    /\    All one has to do is hit the
(15:57:15)  Bac: no, la demo scema    \/    right keys at the right time

Attachment: signature.asc
Description: Digital signature


--- End Message ---
Reply to: