Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 154902

Summary: media-sound/esound-0.2.36-r2 installs empty /usr/share/doc/esound/html/
Product: Gentoo Linux Reporter: Chris Mayo <aklhfex>
Component: New packagesAssignee: Gentoo Linux Gnome Desktop Team <gnome>
Status: RESOLVED FIXED    
Severity: minor CC: sound
Priority: High    
Version: 2006.1   
Hardware: All   
OS: Linux   
Whiteboard:
Package list:
Runtime testing required: ---
Attachments: esound-0.2.37-r1.doc.patch

Description Chris Mayo 2006-11-12 09:17:02 UTC
media-sound/esound-0.2.36-r2 installs empty directory /usr/share/doc/esound/html/

Changing:

emake -j1 DESTDIR="${D}" install  || die "Installation failed"

to

emake -j1 DESTDIR="${D}" pkgdocdir="/usr/share/doc/${PF}" install  || die "Installation failed"

fixes this
Comment 1 Chris Mayo 2007-04-10 19:52:14 UTC
Created attachment 115931 [details, diff]
esound-0.2.37-r1.doc.patch

Similarly with esound-0.2.37-r1, and can actually get rid of the dohtml.
Comment 2 Daniel Gryniewicz (RETIRED) gentoo-dev 2007-04-16 18:28:17 UTC
0.2.37-r1 does not install that here:

[14:24:46 athena] totem> equery f esound | grep doc
/usr/share/doc
/usr/share/doc/esound-0.2.37-r1
/usr/share/doc/esound-0.2.37-r1/AUTHORS.bz2
/usr/share/doc/esound-0.2.37-r1/ChangeLog.bz2
/usr/share/doc/esound-0.2.37-r1/MAINTAINERS.bz2
/usr/share/doc/esound-0.2.37-r1/NEWS.bz2
/usr/share/doc/esound-0.2.37-r1/README.bz2
/usr/share/doc/esound-0.2.37-r1/TIPS.bz2
/usr/share/doc/esound-0.2.37-r1/TODO.bz2

I get essentially the same output (different version) on esound-0.2.36-r2.  The reason for this, I believe, is the lack of a docs/html directory; the dohtml can indeed be removed, but the current install seems to be correct otherwise.

Can you reproduce?  Is /usr/share/doc/esound owned by anything on your box?  Maybe it's left around by a very old install?
Comment 3 Chris Mayo 2007-04-16 20:25:08 UTC
If I start with my esound-0.2.37-r2 installed (esound-0.2.37-r1 + patch #1), in /usr/share/doc:

ll esound* -d
drwxr-xr-x 3 root root 4096 2007-04-10 20:44 esound-0.2.37-r2

then after emerge esound-0.2.37-r1:

ll esound* -d
drwxr-xr-x 3 root root 4096 2007-04-16 21:02 esound
drwxr-xr-x 3 root root 4096 2007-04-16 21:02 esound-0.2.37-r1

now esound/html is not empty but populated with the same files as esound-0.2.37-r1/html.

The relevant lines from the emerge:

>>> Install esound-0.2.37-r1 into /var/tmp/portage/media-sound/esound-0.2.37-r1/image/ category media-sound
Making install in docs
make[1]: Entering directory `/var/tmp/portage/media-sound/esound-0.2.37-r1/work/esound-0.2.37/docs'
make[2]: Entering directory `/var/tmp/portage/media-sound/esound-0.2.37-r1/work/esound-0.2.37/docs'
make[2]: Nothing to be done for `install-exec-am'.
/bin/sh /var/tmp/portage/media-sound/esound-0.2.37-r1/work/esound-0.2.37/install-sh -d /var/tmp/portage/media-sound/esound-0.2.37-r1/image//usr/share/doc/esound/html
files=`cd html && echo *.html`; \
        test "$files" && for f in $files; do \
          cp -p html/$f /var/tmp/portage/media-sound/esound-0.2.37-r1/image//usr/share/doc/esound/html/$f; \
        done


Have you got app-text/docbook-sgml-utils installed which provides jw to generate the html?
Comment 4 Daniel Gryniewicz (RETIRED) gentoo-dev 2007-04-16 22:15:39 UTC
Apparently not.  Are those files useful?  I'm tempted to just not install them at all, under any circumstances, especially since esound is going away...
Comment 5 Chris Mayo 2007-04-20 19:19:08 UTC
The html files have quite a bit of information, but they probably have not been updated for a while.
Comment 6 Rémi Cardona (RETIRED) gentoo-dev 2007-06-14 21:37:08 UTC
Any updates on this? Is it worth bothering (esd ...)?
Comment 7 Rémi Cardona (RETIRED) gentoo-dev 2007-09-02 17:54:12 UTC
The latest stable esound doesn't install any html documentation anymore ... closing.
Comment 8 Chris Mayo 2007-09-04 18:57:32 UTC
It does for me, here's a sample:

/usr/share/doc/esound/html/x308.html
/usr/share/doc/esound/html/x47.html
/usr/share/doc/esound/html/x66.html
/usr/share/doc/esound-0.2.38/html/a346.html
/usr/share/doc/esound-0.2.38/html/c19.html
/usr/share/doc/esound-0.2.38/html/c250.html
/usr/share/doc/esound-0.2.38/html/c271.html

As #3 have you got app-text/docbook-sgml-utils installed?
Comment 9 Chris Mayo 2007-09-04 18:59:03 UTC
Thought I'd selected reopen...
Comment 10 Rémi Cardona (RETIRED) gentoo-dev 2007-09-05 04:42:30 UTC
As much as I would like to help you, app-text/docbook-sgml-utils-0.6.14 refuses to build on my machine (nothing needs it in gnome anymore).

Looking at the Makefile.am, I realized that "make install" should install something inside /usr/share/doc/esound/html/ but according to that "qfile esound" snippet you posted, it looks like your ebuild installs all the html files *twice*. :)

If that's really the case, then I guess we can just drop the dohtml line entirely and let esound install its documentation wherever it sees fit (as I pointed out earlier, normal gnome installations should not have docbook-sgml-utils).

Could you try just removing this line and telling us where/what files are installed? Thanks
Comment 11 Chris Mayo 2007-09-05 17:37:35 UTC
Removing the dohtml and adding pkgdocdir="/usr/share/doc/${PF}" to emake install:

/usr/share/doc/esound-0.2.38/html/a346.html
/usr/share/doc/esound-0.2.38/html/c19.html
/usr/share/doc/esound-0.2.38/html/c250.html
/usr/share/doc/esound-0.2.38/html/c271.html
/usr/share/doc/esound-0.2.38/html/c285.html
/usr/share/doc/esound-0.2.38/html/c290.html
/usr/share/doc/esound-0.2.38/html/c32.html
/usr/share/doc/esound-0.2.38/html/c76.html
/usr/share/doc/esound-0.2.38/html/index.html
/usr/share/doc/esound-0.2.38/html/r311.html
/usr/share/doc/esound-0.2.38/html/r313.html
/usr/share/doc/esound-0.2.38/html/x119.html
/usr/share/doc/esound-0.2.38/html/x179.html
/usr/share/doc/esound-0.2.38/html/x211.html
/usr/share/doc/esound-0.2.38/html/x241.html
/usr/share/doc/esound-0.2.38/html/x259.html
/usr/share/doc/esound-0.2.38/html/x265.html
/usr/share/doc/esound-0.2.38/html/x268.html
/usr/share/doc/esound-0.2.38/html/x26.html
/usr/share/doc/esound-0.2.38/html/x277.html
/usr/share/doc/esound-0.2.38/html/x281.html
/usr/share/doc/esound-0.2.38/html/x296.html
/usr/share/doc/esound-0.2.38/html/x299.html
/usr/share/doc/esound-0.2.38/html/x302.html
/usr/share/doc/esound-0.2.38/html/x305.html
/usr/share/doc/esound-0.2.38/html/x308.html
/usr/share/doc/esound-0.2.38/html/x47.html
/usr/share/doc/esound-0.2.38/html/x66.html
/usr/share/doc/esound-0.2.38/AUTHORS.bz2
/usr/share/doc/esound-0.2.38/NEWS.bz2
/usr/share/doc/esound-0.2.38/ChangeLog.bz2
/usr/share/doc/esound-0.2.38/MAINTAINERS.bz2
/usr/share/doc/esound-0.2.38/README.bz2
/usr/share/doc/esound-0.2.38/TIPS.bz2
/usr/share/doc/esound-0.2.38/TODO.bz2
/usr/share/doc/html/media-sound/esound
Comment 12 Rémi Cardona (RETIRED) gentoo-dev 2007-09-09 08:24:37 UTC
Fixed in CVS as esound-0.2.38-r1 (~arch).

Esound configure/makefile scripts were bypassing standard install directories. Please take a look at files/esound-0.2.38-doc.patch if you want to see how I fixed it.

Don't hesitate to reopen this bug if you still have issues :) Thanks