Bugzilla Bug 77660

Texinfo documentation system
* Info: (info).         How to use the documentation browsing system.
* Texi2html: (texi2html).  Texinfo to HTML Converter.
* Texinfo: (texinfo).           The GNU documentation format.
* fftw3: (fftw3).       FFTW User's Manual.
* info standalone: (info-stnd).            Read Info documents without Emacs.
* infokey: (info-stnd)Invoking infokey.    Compile Info customizations.
* install-info: (texinfo)Invoking install-info. Update info/dir entries.
* makeinfo: (texinfo)Invoking makeinfo.         Translate Texinfo source.
* texi2dvi: (texinfo)Format with texi2dvi.      Print Texinfo documents.
* texindex: (texinfo)Format with tex/texindex.  Sort Texinfo index files.

This isn't decided by the ebuild but in the info file itself. I'll send a hint
about this problem to the developers.

I've added the following lines to my own ebuild since an upstream fix/new
version hasn't appeared for a year now.

        # fix info file
        local infofile
        for infofile in doc/fftw*info*; do
                sed -i 's/Texinfo documentation system/Libraries/' ${infofile}
        done

I just adapted what I found in the 2.1.5 ebuild.

Re: comment #1 "This isn't decided by the ebuild but in the info file itself." 

But there are many ebuilds that have fixes in them for stuff like this and for
stuff even less reasonably dismissed as something that is "decided by the
ebuild". In this case, there *already was* a fix in the 2.1.5 ebuild - it's
still there - and I don't understand why that fix was abandoned in later
ebuilds.

Okay it wasn't a major problem and might well have gone away on its own if the
FFTW developers had taken your hint but after all this time they haven't, it
hasn't gone away and the same bug is now present in 3.1.1. So I'm re-opening
this bug in the hope that the 2.1.5 fix will be re-applied to the later ebuilds
- as I think it should've been in the first place - and to make a more general
point about the info files:

My info directory page is a horrible mess. Apart from entries appearing under
the wrong headings, such as fftw, there are a ridiculous number of
multiplicities of slightly different headings for the same subject, strewn at
random througout the page (not necessarily in the order shown here):

Libraries
Libraries:
Software Libraries
GNU Libraries
GNU libraries

Programming & development tools.
Programming & development tools

Network applications
Network Applications

Miscellaneous
Miscellaneous:

etc. etc.

Presumably it is the same for other Gentoo users and I think this is what comes
of letting the info files decide their own headings ;-) I'd be interested to
hear any suggestions as to what the best way to sort this mess out is and what
is the correct way to go about doing it (propose a GLEP...?). 

Hi,

Thanks for pointing this out and I've just fixed this in the ebuilds
for fftw-3.0.1-r2 and fftw-3.1.1. 
Regarding the larger issue of inconsistencies in Gentoo's info
files I would like to ask you to bring this up by posting to gentoo-dev
so it can be discussed by all devs and users.

Thanks in advance,
Markus

Thanks Markus. I'll post something to gentoo-dev at some point.

(In reply to comment #5)
> Thanks Markus. I'll post something to gentoo-dev at some point.

Unfortunately that is extremely unlikely now. Perhaps someone else can deal
with it.