Bug#803887: Luc's answer
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/
>> 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.
>> 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.
>> 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
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?
http://http.debian.net/debian/pool/non-free/o/ocaml-doc/ocaml-doc_4.02.orig.tar.gz
The above archive has been generated using the following script:
https://sources.debian.net/src/ocaml-doc/4.02-1/debian/generate_tarball/
Regards,
--
Mehdi
Reply to: