From owner-svn-ports-head@FreeBSD.ORG Tue Sep 2 03:36:00 2014 Return-Path: Delivered-To: svn-ports-head@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 856A21FA; Tue, 2 Sep 2014 03:36:00 +0000 (UTC) Received: from apnoea.adamw.org (apnoea.adamw.org [204.109.59.150]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id EF65F1BB9; Tue, 2 Sep 2014 03:35:59 +0000 (UTC) Received: from [192.168.192.25] (dhcp-108-170-169-12.cable.user.start.ca [108.170.169.12]) (using TLSv1 with cipher ECDHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by apnoea.adamw.org (Postfix) with ESMTPSA id 1652A114029; Mon, 1 Sep 2014 23:35:56 -0400 (EDT) Content-Type: text/plain; charset=windows-1252 Mime-Version: 1.0 (Mac OS X Mail 7.3 \(1878.6\)) Subject: Re: svn commit: r366936 - head/devel/avr-libc From: Adam Weinberger In-Reply-To: <20140902031509.GB51270@FreeBSD.org> Date: Mon, 1 Sep 2014 23:35:52 -0400 Content-Transfer-Encoding: quoted-printable Message-Id: References: <201409011926.s81JQ4IV011890@svn.freebsd.org> <20140902031509.GB51270@FreeBSD.org> To: Alexey Dokuchaev X-Mailer: Apple Mail (2.1878.6) Cc: svn-ports-head@freebsd.org, svn-ports-all@freebsd.org, Adam Weinberger , ports-committers@freebsd.org X-BeenThere: svn-ports-head@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: SVN commit messages for the ports tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Sep 2014 03:36:00 -0000 On 1 Sep, 2014, at 23:15, Alexey Dokuchaev wrote: > On Mon, Sep 01, 2014 at 07:26:04PM +0000, Adam Weinberger wrote: >> New Revision: 366936 >> URL: http://svnweb.freebsd.org/changeset/ports/366936 >>=20 >> Log: >> The doxygen build was failing on 8 and 9 for non-obvious reasons. >> As a stopgap (and as a favour to anyone building from ports ;-), = change >> the DOCS option to DOXYGEN, and default it to off. >=20 > Thanks for bringing more sanity to ports! Doxygen should be default = to off > everywhere indeed. The problem with the doxygen issue is that it only negatively affects = people who build from ports. It=92s generally a build-time dependency = only. For people installing from pkg, it=92s often a couple extra files, = no big deal. Defaulting doxygen to off means that those ports produce = packages with no (or less) documentation. The crucially important thing, from my perspective, is that any port = that requires doxygen HAS TO say so up front! The fact that some ports = hide doxygen behind the DOCS option means that I have to inspect every = single port=92s Makefile before I install it. In fact, I think that portmgr should include making sure that doxygen = dependencies are protected behind a DOXYGEN option instead of DOCS in = the blanket just-fix-it. Even blanket permission to add =93(requires = doxygen)=94 to those ports=92 DOCS_DESC would be a great start. I=92ve said it before, it is important to maintain a consistent and = predictable end-user experience, and that means we need to get rid of = these sorts of gotchas. # Adam --=20 Adam Weinberger adamw@adamw.org http://www.adamw.org