Bugzilla Bug 154902

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

Created an attachment (id=115931) [details]
esound-0.2.37-r1.doc.patch

Similarly with esound-0.2.37-r1, and can actually get rid of the dohtml.

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?

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?

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...

The html files have quite a bit of information, but they probably have not been
updated for a while.

Any updates on this? Is it worth bothering (esd ...)?

The latest stable esound doesn't install any html documentation anymore ...
closing.

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?

Thought I'd selected reopen...

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

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

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