From owner-freebsd-ports@FreeBSD.ORG Fri Jun 1 19:13:32 2012 Return-Path: Delivered-To: freebsd-ports@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id A737B106566C; Fri, 1 Jun 2012 19:13:32 +0000 (UTC) (envelope-from uqs@FreeBSD.org) Received: from acme.spoerlein.net (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by mx1.freebsd.org (Postfix) with ESMTP id 4EC368FC08; Fri, 1 Jun 2012 19:13:32 +0000 (UTC) Received: from localhost (acme.spoerlein.net [IPv6:2a01:4f8:131:23c2::1]) by acme.spoerlein.net (8.14.5/8.14.5) with ESMTP id q51JDV5Q090230 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Fri, 1 Jun 2012 21:13:31 +0200 (CEST) (envelope-from uqs@FreeBSD.org) Date: Fri, 1 Jun 2012 21:13:31 +0200 From: Ulrich =?utf-8?B?U3DDtnJsZWlu?= To: Baptiste Daroussin Message-ID: <20120601191331.GR10094@acme.spoerlein.net> Mail-Followup-To: Baptiste Daroussin , Michael Scheidell , freebsd-ports@freebsd.org References: <4301C0E3-3C53-46E2-B5A5-7BD120CD775F@FreeBSD.org> <4FC5F794.9050506@gmail.com> <4FC68FC0.1010707@FreeBSD.org> <4FC69352.4000702@FreeBSD.org> <20120530214803.GD85232@ithaqua.etoilebsd.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20120530214803.GD85232@ithaqua.etoilebsd.net> User-Agent: Mutt/1.5.21 (2010-09-15) Cc: Michael Scheidell , freebsd-ports@FreeBSD.org Subject: Re: [HEADSUP] New framework options aka optionng X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 01 Jun 2012 19:13:32 -0000 On Wed, 2012-05-30 at 23:48:03 +0200, Baptiste Daroussin wrote: > On Wed, May 30, 2012 at 05:38:26PM -0400, Michael Scheidell wrote: > > > > > > On 5/30/12 5:33 PM, Kevin Oberman wrote: > > >> would only cause confusion. > > > I'll go one further and suggest that the vast majority who don't want > > > these features are building specialized systems and they know very > > > well what they are doing. A global setting for these would be > > > desirable, though, as someone building a specialized distribution for, > > > say, an embedded system, will want no docs or examples for any port. I > > > suspect it is ALMOST always an all or nothing issue, not per port. > > > -- > > for our commercial systems, we don't install man, docs, examples. > > and, I would suspect that I would be a little peeved if next time I > > recompile all the ports, I had to stop and hit 'WITHOUT_PORTDOCS, > > WITHOUT_PORTEXAMPLES' on every port. > > > > Upward compatibility folks, if at all possible. You are not guaranteed that all ports implement NOPORTDOCS, so what do you do with those? If folks really are that allergic against docs, then they need to do rm -rf /usr/local/share/doc anyway. I don't quite get why people think WITHOUT_NLS and NO_PORTDOCS are useful or even worth the burden they put on the porters and maintainers. > echo "OPTIONS_UNSET+= DOCS" >> /etc/make.conf > echo "NO_DIALOG=yes" >> /etc/make.conf > > having NOPORTSDOC and NOPORTEXAMPLES, KNOBS and OPTIONS has been a constant > demand by lots of users that is why I wrote it that way and merged NOPORTDOCS > and NOPORTEXAMPLES and WITHOUT_NLS btw to optionsng, I may be wrong, if that is > the case please speak loudly, saying why, what would be best what do you expect. > > Keep in mind that currently lots of ports already define OPTIONS only concerning > documentation, also note that some DOCS might bring some heavy depencies like > doxygen. That's about the only justifiable use-case IMHO. There should be a DOC_DEPENDS that pulls in ports necessary for building documentation (if required) and perhaps (perhaps!) a knob to not pull that in and install documentation. A better solution, saving hundreds of cpu-hours world-wide, would be to persuade upstream to include fully rendered documentation (HOW HARD CAN IT BE?). The fall-back could be to have the maintainer provide the set of documentation. It will usually not change between distfile releases, so re-rolling the documentation could be part of the port update that the maintainer does. > Last but not least, by chance (for once I'm happy with chance :)) you do not > have to add DOCS or EXAMPLES to OPTIONS_DEFINE to be able to use them in your > ports! So you can use it just like NOPORTDOCS and NOPORTEXAMPLES use to work. > IE without and make config needed. > > that mean a single way to define/check for it but 2 different kind of options. > > Not sure this mail is clear :) I hate WITHOUT_NLS and NO_PORTDOCS with a passion. They work for 80% of the ports you are likely to install, so they are not a safe way to escape docs or NLS. Why bother? Seriously, could someone give me a usecase for them? Cheers, Uli