Date: Wed, 12 Dec 2012 01:55:51 +0000 From: Alexey Dokuchaev <danfe@FreeBSD.org> To: Dmitry Marakasov <amdmi3@amdmi3.ru> Cc: svn-ports-head@freebsd.org, svn-ports-all@freebsd.org, ports-committers@freebsd.org Subject: Re: svn commit: r308655 - in head/games/xmoto: . files Message-ID: <20121212015551.GA46387@FreeBSD.org> In-Reply-To: <20121211161033.GL20652@hades.panopticon> References: <201212110314.qBB3EErH082058@svn.freebsd.org> <20121211033625.GA39028@FreeBSD.org> <20121211132128.GA50148@hades.panopticon> <20121211140840.GA95992@FreeBSD.org> <20121211161033.GL20652@hades.panopticon>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Dec 11, 2012 at 08:10:33PM +0400, Dmitry Marakasov wrote: > My opinion is that in this case a separate option should be used (e.g. > DOXYGEN). That's disputable: from one POV, we'd want consistent DOXYGEN is cool and very handy, unfortunately it does not cover all cases of built-up docs (that do not use Doxygen), not to mention few ports are not using it while they should. > documentation handling, from another, we won't want extra depends by > default. > > It seems like it can be solved by setting a following policy: > > - DOCS which pull additional depends should be disabled by default Totally agree. Perhaps conditional should include PACKAGE_BUILD or BATCH into account, but for people building things from ports by hand, heavy docs generation should be disabled. > Unfortunately, that won't really work in current situation, as DOCS > are enabled by default (while no NOPORTDOCS is set). True, it's a bit ugly to fix without getting rid of NOPORTDOCS. Last but not least, I think we should encourage upstream to include pre-generated docs, if it does not cost them too much. If docs would take too much space and thus make distfile heavy, they should be packaged separately, but still come pre- gen'ed. This is normal release engineering practice, akin to providing ready to use ./configure script (rather than pile of autotools files which are rarely compatible with anything even slightly different from author's build box). ./danfe
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20121212015551.GA46387>