Re: ocaml 3.06-17

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

On Wed, Jun 04, 2003 at 11:50:16PM +0200, Sylvain LE GALL wrote:
> On Wed, Jun 04, 2003 at 05:11:09PM +0200, Sven Luther wrote:
> > Hello, ...
> > 
> > I am preparing a new ocaml 3.06-17 package which i will upload at the
> > latest this WE. The problem i will be fixing are :
> > 
> >   1) policy cleanup as suggested by Sylvain.
> > 
> >   2) handling of /usr/include/caml directory (Bug#195574)
> > 
> >   3) gdbm dependency fixing. James Troup informed me that ocaml will
> >      FTBFS as of today morning mirror update.
> >  
> > If there is anything else that needs fixing and that i missed here,
> > please inform me now about it.
> > 
> > Friendly,
> > 
> > Sven Luther
> > 
> 
> Hello,
> 
> Yes i have a bug to correct ( as usual, i try to bored everybody ).
> Could you move the manpages producted by ocaml to a better location than
> /usr/share/man/mano. 
> 
> The bug comes from the ocamldoc manpages policy, which considers that
> manpages are by default .o. So there is a bunch of file ( Arg.o, List.o
> ... ) which document library functions and that are classified in mano (
> as it should be man7 / 3, don't remember ).

Err, man man says :

       1   Executable programs or shell commands
       2   System calls (functions provided by the kernel)
       3   Library calls (functions within system libraries)
       4   Special files (usually found in /dev)
       5   File formats and conventions eg /etc/passwd
       6   Games
       7   Miscellaneous (including macro  packages  and  conven-
           tions), e.g. man(7), groff(7)
       8   System administration commands (usually only for root)
       9   Kernel routines [Non standard]

So 3 would be best, altough the reference to system libraries may pose a
problem, maybe. ... But then, the FHS says :

# man2: System calls
This section describes all of the system calls (requests for the kernel
to perform operations).
# man3: Library functions and subroutines
Section 3 describes program library routines that are not direct calls
to kernel services. This and chapter 2 are only really of interest to
programmers.

So it seems the man manpage is buggy and section 3 is the right one.

Friendly,

Sven Luther