Bug 35749 - jack-audio-connection-kit, doxygen and USE -doc
Bug#: 35749 Product:  Gentoo Linux Version: unspecified Platform: All
OS/Version: All Status: RESOLVED Severity: normal Priority: P2
Resolution: FIXED Assigned To: sound@gentoo.org Reported By: dju@gentoo.org
Component: Ebuilds
URL: 
Summary: jack-audio-connection-kit, doxygen and USE -doc
Keywords:  
Status Whiteboard: 
Opened: 2003-12-13 12:23 0000
Description:   Opened: 2003-12-13 12:23 0000
please look at the files jack-audio-connection-kit-0.80.0 installed while
having doxygen *and* USE -doc:

$ qpkg -l jack-audio-connection-kit
media-sound/jack-audio-connection-kit-0.80.0 *
CONTENTS:
/no
/no/reference
/no/reference/html
/no/reference/html/types_8h-source.html
/no/reference/html/types_8h.html
/no/reference/html/transport-design.html
/no/reference/html/globals_eval.html
/no/reference/html/globals_defs.html
/no/reference/html/functions_vars.html
/no/reference/html/mainpage_8dox.html
/no/reference/html/globals_enum.html
/no/reference/html/doxygen.css
/no/reference/html/doxygen.png
/no/reference/html/functions.html
/no/reference/html/index.html
/no/reference/html/globals.html
/no/reference/html/files.html
/no/reference/html/pages.html
/no/reference/html/fsm.png
/no/reference/html/globals_type.html
/no/reference/html/jack_8h.html
/no/reference/html/structjack__transport__info__t.html
/no/reference/html/structjack__position__t.html
/no/reference/html/transport_8h.html
/no/reference/html/transport_8dox.html
/no/reference/html/annotated.html
/no/reference/html/globals_vars.html
/no/reference/html/jack_8h-source.html
/no/reference/html/globals_func.html
/no/reference/html/deprecated.html
/no/reference/html/transport_8h-source.html
/usr
/usr/bin
/usr/bin/jack_transport
/usr/bin/jackd
/usr/bin/jack_connect
/usr/bin/jack_metro
/usr/bin/jack_load
/usr/bin/jack_showtime
/usr/bin/jack_disconnect
/usr/bin/jack_lsp
/usr/bin/jack_monitor_client
/usr/bin/jack_simple_client
/usr/bin/jack_unload
/usr/bin/jack_impulse_grabber
/usr/bin/jackrec
/usr/lib
/usr/lib/jack
/usr/lib/jack/jack_dummy.la
/usr/lib/jack/jack_dummy.so
/usr/lib/jack/inprocess.a
/usr/lib/jack/jack_dummy.a
/usr/lib/jack/jack_alsa.a
/usr/lib/jack/inprocess.la
/usr/lib/jack/inprocess.so
/usr/lib/jack/jack_alsa.la
/usr/lib/jack/jack_alsa.so
/usr/lib/jack/intime.la
/usr/lib/jack/intime.so
/usr/lib/jack/intime.a
/usr/lib/libjack.a
/usr/lib/pkgconfig
/usr/lib/pkgconfig/jack.pc
/usr/lib/libjack.la
/usr/lib/libjack.so -> libjack.so.0.0.22
/usr/lib/libjack.so.0 -> libjack.so.0.0.22
/usr/lib/libjack.so.0.0.22
/usr/share
/usr/share/man
/usr/share/man/man1
/usr/share/man/man1/jackd.1.gz
/usr/share/man/man1/jackstart.1.gz
/usr/include
/usr/include/jack
/usr/include/jack/timestamps.h
/usr/include/jack/jack.h
/usr/include/jack/types.h
/usr/include/jack/transport.h

i believe the /no/reference/html/* files shouldn't be installed if i specify
USE -doc.

------- Comment #1 From Mikael Magnusson 2004-01-09 09:40:07 0000 -------
i dont think it should install anything in /no ever, what the heck is /no
anyway?

------- Comment #2 From Steve Arnold 2004-01-12 10:11:31 0000 -------
What does this mean exactly "while having doxygen *and* USE -doc"?  What does
doxygen have to do with it?

------- Comment #3 From Julien Allanos (RETIRED) 2004-01-12 10:24:55 0000 -------
In fact, the ./configure detects doxygen and will use it to build the code
documentation, without regarding the doc USE flag.
Then it tries to install the doxygen generated files into
/var/tmp/portage/jack-audio-connection-kit-0.80.0/image/no/reference/html,
that's why they are in the /no dir after merging. I don't know why the make
install in doc wants to create such a dir.

------- Comment #4 From Julien Allanos (RETIRED) 2004-01-12 10:27:01 0000 -------
Created an attachment (id=23684) [details]
emerge output

I've attached the emerge output of jack-0.80.0.

------- Comment #5 From Brian Harring 2004-02-04 13:49:53 0000 -------
Fix commited to cvs;
--without-html-dir isn't the correct method to disable doc generation, it actually is what is setting the HTML_DIR to no (hence /no/html-docs).

I wrote out a --enable-html-docs option to control doc generation/installation, and all versions of jack-audio-connection-kit have been patched, exempting 0.75.

We need to do something w/ 0.75, either backport the alsa fix and add this patch to the ebuild, or yank it.  Dunno, wait and see.
Either way, in cvs, closing.

------- Comment #6 From Julien Allanos (RETIRED) 2004-02-05 00:17:44 0000 -------
thanks, i didn't get generated docs this time.