Re: Ocaml 3.07, bugs and manpages.

[Maxence Guesdon <maxence.guesdon@inria.fr>]

Hi,

> On Wed, Oct 01, 2003 at 03:30:17PM +0200, Sven Luther wrote:
> 
> > It seems that of the 5 remaining ocaml bugs, 205391 (manpage conflict)
> > is fixed, but 211190 (printer in ocamldebug) is not, nor is 183936
> > (whatis manpage stuff), nor are the 2 wishlist bugs.
> > 
> > I remember some discussion about this whatis issue, but can't find it
> > back. Do anyone remember something about it ?
> 
> $ man -k StdLabels     
> StdLabels (o)        - Standard labeled libraries.
> StdLabels.Array (o)  - (unknown subject)
> 
> I don't remember discussion about this, but from looking at the
> manpages it just seems that, for instance in case of StdLabels.Array
> there us no short description in the NAME section:
> 
> % zcat /usr/share/man/man3/StdLabels.Array.3.gz | head -5
> .TH "Module" StdLabels.Array "2003-08-20" OCamldoc "OCaml library"
> .SH NAME
> StdLabels.Array \- 
> .SH Module
> Module   StdLabels.Array
> 
> 
> In contrast, StdLables has a short description:
> 
> % zcat /usr/share/man/man3/StdLabels.3.gz | head -5
> .TH "Module" StdLabels "2003-08-20" OCamldoc "OCaml library"
> .SH NAME
> StdLabels \- Standard labeled libraries.
> .SH Module
> Module   StdLabels

That's strange because I modified the man pages generator to add "no
description" as description, and it is indeed generated in this case for
StdLabels.Array. I have, in StdLabels.Array.3o :

.TH "Module" StdLabels.Array "2003-10-01" OCamldoc "OCaml library"
.SH NAME
StdLabels.Array \- no description
.SH Module
Module   StdLabels.Array
.SH Documentation
....

Are you sure the man pages you are using were generated by ocaml 3.07 ?
Man pages extension for ocaml stdlib changed from .3 to .3o in ocaml 3.07,
and it seems you're using old .3 files.

Regards,

Maxence