Bug#803887: Luc's answer
Hi,
For the record, I have reported a regression behavior of the info reader
to upstream (bug-texinfo@gnu.org)
--Luc
> 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
--
Luc
Reply to: