Mantis Bug Tracker

View Issue Details Jump to Notes ] Issue History ] Print ]
IDProjectCategoryView StatusDate SubmittedLast Update
0001371OCamlOCaml generalpublic2002-09-04 17:162002-09-16 13:01
Reporteradministrator 
Assigned To 
PrioritynormalSeverityminorReproducibilityalways
StatusclosedResolutionfixed 
PlatformOSOS Version
Product Version 
Target VersionFixed in Version 
Summary0001371: [Laurent.Bonnaud@inpg.fr: Bug#159581: ocaml: many whatis parse failures in manpages]
DescriptionHello, ...

I just received this bug report, concerning the whatis program and the
ocamldoc generated manpages.

I am no manpages expert, but my understanding is that whatis is called
by mandb to create a database of man pages or something such.

Whatis seems to look at the short description of the manpage, the one in
section NAME, and output that :

& man whatis
whatis(1) Manual pager utils whatis(1)

NAME
       whatis - display manual page descriptions

SYNOPSIS
...
& whatis whatis
whatis (1) - display manual page descriptions

But the man pages generated by ocamldoc and present with the .o
extension don't seem to have this kind of format :

Module(Unix) OCaml library Module(Unix)

Module
       Module Unix

Documentation
       Module Unix
        : sig end
...

I don't know if this is a bug in ocamldoc, or a problem with
whatis/mandb or something else, so i forward this to the caml BTW.

Friendly,

Sven Luther

----- Forwarded message from Laurent Bonnaud <Laurent.Bonnaud@inpg.fr> -----

Envelope-to: luther@localhost
Delivery-date: Wed, 04 Sep 2002 16:38:12 +0200
Subject: Bug#159581: ocaml: many whatis parse failures in manpages
Reply-To: "Laurent Bonnaud" <Laurent.Bonnaud@inpg.fr>, 159581@bugs.debian.org
Resent-From: "Laurent Bonnaud" <Laurent.Bonnaud@inpg.fr>
Original-Sender: Laurent Bonnaud <bonnaud@irancy.lis.inpg.fr>
Resent-To: debian-bugs-dist@lists.debian.org
Resent-CC: Sven Luther <luther@debian.org>, ocaml@packages.qa.debian.org
Resent-Date: Wed, 04 Sep 2002 12:18:01 GMT
Resent-Message-ID: <handler.159581.B.103114102912622@bugs.debian.org>
X-Debian-PR-Message: report 159581
X-Debian-PR-Package: ocaml
X-Debian-PR-Keywords:
From: "Laurent Bonnaud" <Laurent.Bonnaud@inpg.fr>
To: "Debian Bug Tracking System" <submit@bugs.debian.org>
X-Scanned-By: MIMEDefang 2.2 (www dot roaringpenguin dot com slash mimedefang)
Resent-Sender: Debian BTS <debbugs@master.debian.org>
X-Antivirus: scanned by sophos at isis.u-strasbg.fr
X-Spam-Status: No, hits=-4.5 required=5.0 tests=SENT_BY_BTS,FORGED_RCVD_FOUND version=2.20
X-Spam-Level:

Package: ocaml
Version: 3.06-5
Severity: normal


Hi,

when I run mandb -c, mandb complains about the following manpages:

Updating index cache for path `/usr/share/man/mano'. Wait...
mandb: warning: /usr/share/man/mano/Bigarray.Array1.o.gz: whatis parse for Bigarray.Array1(o) failed
mandb: warning: /usr/share/man/mano/ArrayLabels.o.gz: whatis parse for ArrayLabels(o) failed
mandb: warning: /usr/share/man/mano/Hashtbl.S.o.gz: whatis parse for Hashtbl.S(o) failed
mandb: warning: /usr/share/man/mano/Gc.o.gz: whatis parse for Gc(o) failed
mandb: warning: /usr/share/man/mano/Bigarray.Array2.o.gz: whatis parse for Bigarray.Array2(o) failed
mandb: warning: /usr/share/man/mano/Bigarray.Array3.o.gz: whatis parse for Bigarray.Array3(o) failed
mandb: warning: /usr/share/man/mano/Bigarray.Genarray.o.gz: whatis parse for Bigarray.Genarray(o) failed
mandb: warning: /usr/share/man/mano/Bigarray.o.gz: whatis parse for Bigarray(o) failed
mandb: warning: /usr/share/man/mano/Buffer.o.gz: whatis parse for Buffer(o) failed
mandb: warning: /usr/share/man/mano/CamlinternalOO.o.gz: whatis parse for CamlinternalOO(o) failed
mandb: warning: /usr/share/man/mano/Char.o.gz: whatis parse for Char(o) failed
mandb: warning: /usr/share/man/mano/Complex.o.gz: whatis parse for Complex(o) failed
mandb: warning: /usr/share/man/mano/Digest.o.gz: whatis parse for Digest(o) failed
mandb: warning: /usr/share/man/mano/Filename.o.gz: whatis parse for Filename(o) failed
mandb: warning: /usr/share/man/mano/Format.o.gz: whatis parse for Format(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Hashtbl.Make.o.gz: whatis parse for MoreLabels.Hashtbl.Make(o) failed
mandb: warning: /usr/share/man/mano/Hashtbl.HashedType.o.gz: whatis parse for Hashtbl.HashedType(o) failed
mandb: warning: /usr/share/man/mano/Hashtbl.Make.o.gz: whatis parse for Hashtbl.Make(o) failed
mandb: warning: /usr/share/man/mano/Hashtbl.o.gz: whatis parse for Hashtbl(o) failed
mandb: warning: /usr/share/man/mano/Int32.o.gz: whatis parse for Int32(o) failed
mandb: warning: /usr/share/man/mano/Lazy.o.gz: whatis parse for Lazy(o) failed
mandb: warning: /usr/share/man/mano/Lexing.o.gz: whatis parse for Lexing(o) failed
mandb: warning: /usr/share/man/mano/List.o.gz: whatis parse for List(o) failed
mandb: warning: /usr/share/man/mano/Map.Make.o.gz: whatis parse for Map.Make(o) failed
mandb: warning: /usr/share/man/mano/Map.OrderedType.o.gz: whatis parse for Map.OrderedType(o) failed
mandb: warning: /usr/share/man/mano/Map.S.o.gz: whatis parse for Map.S(o) failed
mandb: warning: /usr/share/man/mano/Map.o.gz: whatis parse for Map(o) failed
mandb: warning: /usr/share/man/mano/Marshal.o.gz: whatis parse for Marshal(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Map.OrderedType.o.gz: whatis parse for MoreLabels.Map.OrderedType(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Hashtbl.S.o.gz: whatis parse for MoreLabels.Hashtbl.S(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Hashtbl.o.gz: whatis parse for MoreLabels.Hashtbl(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Map.Make.o.gz: whatis parse for MoreLabels.Map.Make(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Set.Make.o.gz: whatis parse for MoreLabels.Set.Make(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Map.S.o.gz: whatis parse for MoreLabels.Map.S(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Map.o.gz: whatis parse for MoreLabels.Map(o) failed
mandb: warning: /usr/share/man/mano/Parsing.o.gz: whatis parse for Parsing(o) failed
mandb: warning: /usr/share/man/mano/Num.o.gz: whatis parse for Num(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Set.OrderedType.o.gz: whatis parse for MoreLabels.Set.OrderedType(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Set.S.o.gz: whatis parse for MoreLabels.Set.S(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Set.o.gz: whatis parse for MoreLabels.Set(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.o.gz: whatis parse for MoreLabels(o) failed
mandb: warning: /usr/share/man/mano/Nativeint.o.gz: whatis parse for Nativeint(o) failed
mandb: warning: /usr/share/man/mano/Obj.o.gz: whatis parse for Obj(o) failed
mandb: warning: /usr/share/man/mano/Oo.o.gz: whatis parse for Oo(o) failed
mandb: warning: /usr/share/man/mano/Scanf.Scanning.o.gz: whatis parse for Scanf.Scanning(o) failed
mandb: warning: /usr/share/man/mano/Pervasives.o.gz: whatis parse for Pervasives(o) failed
mandb: warning: /usr/share/man/mano/Printexc.o.gz: whatis parse for Printexc(o) failed
mandb: warning: /usr/share/man/mano/Printf.o.gz: whatis parse for Printf(o) failed
mandb: warning: /usr/share/man/mano/Queue.o.gz: whatis parse for Queue(o) failed
mandb: warning: /usr/share/man/mano/Random.o.gz: whatis parse for Random(o) failed
mandb: warning: /usr/share/man/mano/Set.Make.o.gz: whatis parse for Set.Make(o) failed
mandb: warning: /usr/share/man/mano/Scanf.o.gz: whatis parse for Scanf(o) failed
mandb: warning: /usr/share/man/mano/Pervasives.LargeFile.o.gz: whatis parse for Pervasives.LargeFile(o) failed
mandb: warning: /usr/share/man/mano/Set.OrderedType.o.gz: whatis parse for Set.OrderedType(o) failed
mandb: warning: /usr/share/man/mano/Set.S.o.gz: whatis parse for Set.S(o) failed
mandb: warning: /usr/share/man/mano/Set.o.gz: whatis parse for Set(o) failed
mandb: warning: /usr/share/man/mano/Sort.o.gz: whatis parse for Sort(o) failed
mandb: warning: /usr/share/man/mano/Stack.o.gz: whatis parse for Stack(o) failed
mandb: warning: /usr/share/man/mano/StdLabels.List.o.gz: whatis parse for StdLabels.List(o) failed
mandb: warning: /usr/share/man/mano/StdLabels.String.o.gz: whatis parse for StdLabels.String(o) failed
mandb: warning: /usr/share/man/mano/StdLabels.o.gz: whatis parse for StdLabels(o) failed
mandb: warning: /usr/share/man/mano/Str.o.gz: whatis parse for Str(o) failed
mandb: warning: /usr/share/man/mano/Stream.o.gz: whatis parse for Stream(o) failed
mandb: warning: /usr/share/man/mano/String.o.gz: whatis parse for String(o) failed
mandb: warning: /usr/share/man/mano/Sys.o.gz: whatis parse for Sys(o) failed
mandb: warning: /usr/share/man/mano/Unix.LargeFile.o.gz: whatis parse for Unix.LargeFile(o) failed
mandb: warning: /usr/share/man/mano/Unix.o.gz: whatis parse for Unix(o) failed
mandb: warning: /usr/share/man/mano/Weak.Make.o.gz: whatis parse for Weak.Make(o) failed
mandb: warning: /usr/share/man/mano/Weak.S.o.gz: whatis parse for Weak.S(o) failed
mandb: warning: /usr/share/man/mano/Weak.o.gz: whatis parse for Weak(o) failed
mandb: warning: /usr/share/man/mano/Arg.o.gz: whatis parse for Arg(o) failed
mandb: warning: /usr/share/man/mano/Array.o.gz: whatis parse for Array(o) failed
mandb: warning: /usr/share/man/mano/Callback.o.gz: whatis parse for Callback(o) failed
mandb: warning: /usr/share/man/mano/Genlex.o.gz: whatis parse for Genlex(o) failed
mandb: warning: /usr/share/man/mano/Int64.o.gz: whatis parse for Int64(o) failed
mandb: warning: /usr/share/man/mano/ListLabels.o.gz: whatis parse for ListLabels(o) failed
mandb: warning: /usr/share/man/mano/MoreLabels.Hashtbl.HashedType.o.gz: whatis parse for MoreLabels.Hashtbl.HashedType(o) failed
mandb: warning: /usr/share/man/mano/StdLabels.Array.o.gz: whatis parse for StdLabels.Array(o) failed
mandb: warning: /usr/share/man/mano/StringLabels.o.gz: whatis parse for StringLabels(o) failed


-- System Information:
Debian Release: testing/unstable
Architecture: i386
Kernel: Linux irancy 2.4.19-k7 #1 Thu Aug 8 23:19:38 EST 2002 i686
Locale: LANG=fr_FR@euro, LC_CTYPE=fr_FR@euro

Versions of packages ocaml depends on:
ii libc6 2.2.5-14 GNU C Library: Shared libraries an
ii libncurses5-dev 5.2.20020112a-8 Developer's libraries and docs for
ii ocaml-base [ocaml-base-3 3.06-5 Runtime system for ocaml bytecode

-- no debconf information

----- End forwarded message -----

TagsNo tags attached.
Attached Files

- Relationships

-  Notes
(0001061)
administrator (administrator)
2002-09-16 12:57

>
> Hi,
>
> when I run mandb -c, mandb complains about the following manpages:
>
> Updating index cache for path `/usr/share/man/mano'. Wait...
> mandb: warning: /usr/share/man/mano/Bigarray.Array1.o.gz: whatis parse for > Bigarray.Array1(o) failed

Hello,

the man pages generated by OCamldoc did not contain a ".SH NAME" section,
making mandb crazy and preventing whatis to be used on these pages.
This is fixed in the CVS.

Thanks for your report,

--
Maxence Guesdon

(0001062)
administrator (administrator)
2002-09-16 13:01

Fixed by Maxence -- 2002-Sep-16

- Issue History
Date Modified Username Field Change
2005-11-18 10:13 administrator New Issue


Copyright © 2000 - 2011 MantisBT Group
Powered by Mantis Bugtracker