Re: Ocaml 3.07, bugs and manpages.

[Sven Luther <sven.luther@wanadoo.fr>]

On Thu, Oct 02, 2003 at 09:20:49AM +0200, Maxence Guesdon wrote:
> 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.

I still get :

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

Which is consistent with the bug report. I also get :

$ ls -l /usr/share/man/man3/Std*
-rw-r--r--    1 root     root          323 2003-10-02 08:33 /usr/share/man/man3/StdLabels.3o.gz
-rw-r--r--    1 root     root          480 2003-10-02 08:33 /usr/share/man/man3/StdLabels.Array.3o.gz
-rw-r--r--    1 root     root          562 2003-10-02 08:33 /usr/share/man/man3/StdLabels.List.3o.gz
-rw-r--r--    1 root     root          437 2003-10-02 08:33 /usr/share/man/man3/StdLabels.String.3o.gz

So there are no old files left around, but i guess the problem is with
the StdLabels submodules manpages, not the StdLabels per see.

And looking at the files, i effectively have what you described :

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

But it does not solve the problem.

Friendly,

Sven Luther