Bug 35749 – jack-audio-connection-kit, doxygen and USE -doc

• Status: RESOLVED FIXED
• Product: Gentoo Linux

[Description Julien Allanos (RETIRED) 2003-12-13 12:23:12 UTC]

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 Mikael Magnusson 2004-01-09 09:40:07 UTC]

i dont think it should install anything in /no ever, what the heck is /no anyway?

[Comment 2 Steve Arnold 2004-01-12 10:11:31 UTC]

What does this mean exactly "while having doxygen *and* USE -doc"?  What does doxygen have to do with it?

[Comment 3 Julien Allanos (RETIRED) 2004-01-12 10:24:55 UTC]

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 Julien Allanos (RETIRED) 2004-01-12 10:27:01 UTC]

Created attachment 23684 [details]
emerge output

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

[Comment 5 Brian Harring (RETIRED) 2004-02-04 13:49:53 UTC]

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 Julien Allanos (RETIRED) 2004-02-05 00:17:44 UTC]

thanks, i didn't get generated docs this time.