Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Laurent.Bonnaud@inpg.fr: Bug#159581: ocaml: many whatis parse failures in manpages] #3634

Closed
vicuna opened this issue Sep 4, 2002 · 2 comments
Labels

Comments

@vicuna
Copy link

vicuna commented Sep 4, 2002

Original bug ID: 1371
Reporter: administrator
Status: closed
Resolution: fixed
Priority: normal
Severity: minor
Category: ~DO NOT USE (was: OCaml general)

Bug description

Hello, ...

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 -----

@vicuna
Copy link
Author

vicuna commented Sep 16, 2002

Comment author: administrator

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

@vicuna
Copy link
Author

vicuna commented Sep 16, 2002

Comment author: administrator

Fixed by Maxence -- 2002-Sep-16

@vicuna vicuna closed this as completed Sep 16, 2002
@vicuna vicuna added the bug label Mar 19, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

1 participant