From owner-freebsd-ports@FreeBSD.ORG Thu Aug 21 11:27:32 2014 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id CEDC28DA for ; Thu, 21 Aug 2014 11:27:32 +0000 (UTC) Received: from QMTA11.westchester.pa.mail.comcast.net (qmta11.westchester.pa.mail.comcast.net [IPv6:2001:558:fe14:44:76:96:59:211]) by mx1.freebsd.org (Postfix) with ESMTP id 7E89F3940 for ; Thu, 21 Aug 2014 11:27:32 +0000 (UTC) Received: from omta20.westchester.pa.mail.comcast.net ([76.96.62.71]) by QMTA11.westchester.pa.mail.comcast.net with comcast id hPGM1o0061YDfWL5BPTXCL; Thu, 21 Aug 2014 11:27:31 +0000 Received: from kirby.cyberbotx.com ([107.5.48.95]) by omta20.westchester.pa.mail.comcast.net with comcast id hPTW1o00D23DSHF3gPTWoD; Thu, 21 Aug 2014 11:27:31 +0000 Message-ID: <53F5D7A2.4090105@cyberbotx.com> Date: Thu, 21 Aug 2014 07:27:30 -0400 From: Naram Qashat User-Agent: Mozilla/5.0 (X11; FreeBSD amd64; rv:31.0) Gecko/20100101 Thunderbird/31.0 MIME-Version: 1.0 To: Kurt Jaeger Subject: Re: devel/doxygen woes References: <8e2579e9b8a76340d02cf44904b63c3d@cyberbotx.com> <20140821091714.GR9400@home.opsec.eu> In-Reply-To: <20140821091714.GR9400@home.opsec.eu> Content-Type: text/plain; charset=windows-1252; format=flowed Content-Transfer-Encoding: 7bit DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net; s=q20140121; t=1408620451; bh=A6O1CHvYw0Rt4mjo3YlrHH0ahXLeR1R7F6K9/LHRdj4=; h=Received:Received:Message-ID:Date:From:MIME-Version:To:Subject: Content-Type; b=mKXigY093Be+lv0a/lvT4PDEO5QGqdQ0v33RTKkDGMm+Wr+had25Uw53OR2Up3esw Tl8C380MQvH6m5Z0+SCJjvSD7FFkDk+3Q2EPqJ/yZJfkuqpfZYqK0yfWlazhcKlBnA iWr3cx/dpxgcTP6/Q9b6+/DwWts+beomEJUKBLINDGyp9mbcmHjorzxwTL3Mq808KW cYktdJ9gFI0XA+adVjg2pwo+oceeDHtnWdJyCUaeu9r8/THuLrMSAWcewupX375uST OjRpFPBmjGKTWkWsoEQZ5qcLew+WqE5jjIiN5uOHPJErZ9vALVZH/b1NFpGgUDY6yT AyQmPOg2QSgRA== Cc: freebsd-ports@FreeBSD.org X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 21 Aug 2014 11:27:33 -0000 On 08/21/14 05:17, Kurt Jaeger wrote: > Hi! > >> So I've been getting a lot of issues being directed at me due to the >> recent devel/doxygen update to 1.8.7. While I'm not sure why these >> issues only cropped up after that update and not before, I would like to >> try addressing a few things. > > Those discussions always pop up if something changes, even if it is not > related 8-} > >> doxygen has a bit of an issue in that it uses itself to build its own >> documentation. > > Let me state this a bit more general: > > doxygen has the issue that if you use it, it brings in a huge > amount of dependencies. And currently, this process is not > thought-through. > >> As a result of this, the HTMLDOCS and PDFDOCS options >> will only pull in what is needed to allow doxygen to be built in such a >> way to be able to build its own documentation. Because of this, if those >> options are left out, then doxygen will be left in a state where it can >> no longer build HTML docs fully (because of the lack of graphviz) and >> cannot build PDF docs (because of the lack of a LaTeX distribution). > > What might be a use case for doxygen, if it is not used for html > and pdf docs ? What other formats are supported ? As far as I can tell from looking at a Doxyfile, it can generate HTML, Docset files for Xcode, Microsoft HTML help (.chm files), Qt compressed help (.qch files), Eclipse help plugin, LaTeX (which I believe creates a PDF), RTF, man pages, XML, AutoGen definitions, and perlmod. A lot of these are disabled by default in Doxyfile, though. I think that doxygen's documentation states that only the HTML and LaTeX generators require external dependencies, and dot from graphviz is only really needed for HTML if the Doxyfile says it wants to use it. >> Because of this, consumers of doxygen, whether they be other FreeBSD >> ports or just users of doxygen in general, would need to have graphviz >> and LaTeX installed to get all of doxygen's features. I recently had >> someone that wanted to build doxygen without the LaTeX dependency, >> though. So I think ideally, the dependencies for graphviz and LaTeX >> should becomes separate options, and the HTMLDOCS and PDFDOCS options >> should only be allowed if graphviz and LaTeX, respectively, are enabled. > > The problem is: If a port has options to use doxygen, those > options should also include BUILD_DEPENDS for graphviz etc. > The ports that use doxygen normally do not know about those > BUILD_DEPENDS. > > One idea was to provide a /usr/ports/Mk/Uses/doxygen.mk which > provides the necessary "glue" by USES += doxygen. > >> All in all, it basically boils down to needing to find a way to include >> graphviz and LaTeX in a way that doesn't cause too many problems but >> also allows doxygen to still have the option of building its own >> documentation. > > It's either in or out 8-} Well, I'd already put in a bug for this: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=192732 It does mean that, yes, by default, it'll pull in a lot of dependencies. I'm not sure if having a uses for doxygen really makes much sense, though. The only thing that I can think of that would really need work is probably figuring out just what parts of TexLive are actually needed by doxygen instead of trying to pull in the full distribution.