Bug#803887: Luc's answer
Hi Mehdi,
Below I digress on the warnings at installation time and
on how to suppress them. However the problem looks to be elsewhere.
I have reproduced the "info ocaml" bug on some Debian machine.
I Investigate.
NB: On the Debian machine info is at version 6.0
while other machine have older versions of info.
% info --version
info (GNU texinfo) 6.0
A+
--Luc
> Hello,
>
> On 22/12/2015 14:25, Gabriel Scherer wrote:
> > Thanks for the clarifications. I forward to Luc and here is the answer I got.
> >
>
> Thanks for the reply. I've added Luc in CC. My reply is below.
>
> >> As far as I understand the issue, info files are installed by
> >> "GNU install-info" aka ginstall-info.
> >>
> >> From hand experiments on an UBUNTU 14.04, "dropping relevant files
> >> into files under /usr/share/info" is not enough. One should
> >> also add an entry for ocaml into /usr/share/info/dir.
> >>
>
> Indeed. Though is is done automatically in the packaging since we've told
> the package that those files are info files. So, in order to avoid confusion
> and implicit statements. Let's clarify what the package does (automatically):
> 1) All pointed files are put under /usr/share/info.
> 2) Each time the content of /usr/share/info changes, the script update-info-dir
> is called (via a trigger).
>
> For your convenience, here is the content of update-info-dir:
>
> https://sources.debian.net/src/texinfo/6.0.0.dfsg.1-3/debian/update-info-dir/
Ok I have looked at the script. It apparently applies install-info
to all files in the directory except for some patterns:
*/dir|*/dir.gz|*/dir.old|*/dir.old.gz|*-[0-9]|*-[0-9].gz|*-[1-9][0-9]|*-[1-9][0-9].gz|*.png|*.jpg)
Hence there is no other way to avoid invoking "install-info" on some files
than say, to put numbers in them (those files usually result from file
splitting). As this is an installation problem, I'd suggest that
you rename the warning producing files (eg in your packaging script),
or find any other way not to apply install-info to these files, which are
`/usr/share/info/ocaml.info.hocaml.info.hind.gz'
`/usr/share/info/ocaml.info.haux.gz'
`/usr/share/info/ocaml.info.hocaml.info.kwd.hind.gz'
The last `/usr/share/info/ocaml.info.body.gz' can be deleted safely.
I'd be happy to rename files myself upstream if you prefer, but will not
alone, as I cannot test your installation procedure. Additionaly
I'd rather see Debian adopting a clear and documented
position on info file installation...
This is a minor issue though. What seems more important is that
I still do not know why "info ocaml" does not work
on Debian after installation of the ocaml-doc package
(it works non Ubuntu 14.04, see below).
I am not even sure that this problem exists.... I do not feel like
installing Debian just for checking this...
>
> >> This can be done from the command line as
> >> # sudo ginstall-info /usr/share/info/ocaml.info.gz /usr/share/info/dir
> >>
>
> This is not needed since it has been done by update-info-dir, which calls
> install-info, which is ginstall-info (by default). And, indded, one can
> check that an entry has been added for OCaml. The issue is that no content
> can be read under the "ocaml" node using the "info" command-line utility.
> One can read the manual using Emacs's info reader, but not with the standard
> "info" program.
Here our experiences differ, on Ubuntu 14.04.3, installation
does work, saved for a few warnings.
>I have desinstalled
the ocaml-doc package. "info ocaml" redirects to the ocaml manual page...
I now install the package
# apt-get install ocaml-doc
The following NEW packages will be installed
ocaml-doc
0 to upgrade, 1 to newly install, 0 to remove and 50 not to upgrade.
Need to get 0 B/2,647 kB of archives.
After this operation, 7,634 kB of additional disk space will be used.
Selecting previously unselected package ocaml-doc.
(Reading database ... 306582 files and directories currently installed.)
Preparing to unpack .../ocaml-doc_4.01-1_all.deb ...
Unpacking ocaml-doc (4.01-1) ...
Processing triggers for install-info (5.2.0.dfsg.1-2) ...
install-info: warning: no info dir entry in `/usr/share/info/ocaml.info.hocaml.info.hind.gz'
install-info: warning: no info dir entry in `/usr/share/info/ocaml.info.haux.gz'
install-info: warning: no info dir entry in `/usr/share/info/ocaml.info.hocaml.info.kwd.hind.gz'
install-info: warning: no info dir entry in `/usr/share/info/ocaml.info.body.gz'
Processing triggers for doc-base (0.10.5) ...
Processing 2 added doc-base files...
Error while merging /usr/share/doc-base/ocaml-doc-ocaml with /usr/share/doc-base/ocaml-doc-ocaml.in: format html already defined.
Setting up ocaml-doc (4.01-1) ...
Notice the suprious warnings for ocaml.info.hocaml.info.hind.gz etc..
and also teh doc-base problem below.
Anyway "info ocaml" now displays the manual and an OCaml entry is present
in the list displayed by "info" without argument.
>
> >> There is no need to invoke ginstall-info on other info files, as
> >> "apt-get install ocaml-doc" apparently does. However, the only
> >> consequence seems to be warnings.
> >>
>
> Indeed. Since they don't contain any relevant information, processing
> them doesn't change the content of /usr/share/info/dir. Though the warnings
> are related to real garbage files, that should not be shipped.
No those files are useful (except caml.info.body.gz, which is no longer
part of the distribution). They contain the indexes of the manual
and are referenced to from the main text. It may be that they are poorly
named.
>
> >> So the conclusion is (?) avoid spurious warnings during the installation
> >> of the package ocaml-doc by applying ginstall-info to the file ocaml.info.gz
> >> and to this file only.
> >>
>
> As explained above, there is still something missing since all is done as
> you've described. I am really surprised it works on your machine using those
Warning, my machine is Ubuntu LTS 14.04.03
> files and only the described steps... or maybe we took different files. Can you
> please confirm that files contained in the following archive are the good ones?
> Or, maybe you're not seeing the issue because you're testing using Emacs?
No I am using info.
>
> http://http.debian.net/debian/pool/non-free/o/ocaml-doc/ocaml-doc_4.02.orig.tar.gz
The subdirectory does contain the correct files
(for what it is worth the file ocaml.info.body.gz can be deleted).
>
> The above archive has been generated using the following script:
>
> https://sources.debian.net/src/ocaml-doc/4.02-1/debian/generate_tarball/
I see nothing special in this script, it could have removed ocaml.info.body.gz.
>
> Regards,
>
> --
> Mehdi
--
Luc
Reply to: