Hi, For the record, I have reported a regression behavior of the info reader to upstream (bug-texi...@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