Re: git: 1597e735c46d - main - devel/glib20: rename DOCS into GTKDOC and disable it by default
Date: Fri, 09 Dec 2022 16:39:55 UTC
On Fri, Dec 9, 2022 at 1:27 AM Jan Beich <jbeich@freebsd.org> wrote: > Baptiste Daroussin <bapt@FreeBSD.org> writes: > > > The branch main has been updated by bapt: > > > > URL: > https://cgit.FreeBSD.org/ports/commit/?id=1597e735c46d62efc9b5b9b74bcdde515e28165a > > > > commit 1597e735c46d62efc9b5b9b74bcdde515e28165a > > Author: Baptiste Daroussin <bapt@FreeBSD.org> > > AuthorDate: 2022-12-09 08:07:37 +0000 > > Commit: Baptiste Daroussin <bapt@FreeBSD.org> > > CommitDate: 2022-12-09 08:07:37 +0000 > > > > devel/glib20: rename DOCS into GTKDOC and disable it by default > > > > Follow the path done for ports depending on doxygen with gtkdoc. > > This reduced the number of build dependencies and respects the > defaults > > of the upstream build system. > > Reducing build-only dependencies regresses "batteries included" for > packages. > One could say it improves/reduces package size but that's only valid > rationale > as long as subpackages (D16457) are forever stuck in review. > I agree with you about including batteries for user-facing functionality. But I'll argue that there's a quantifiable difference between including batteries and including a kitchen sink. Abusing your metaphor here, glib's docs aren't batteries, nor are they even manuals. They're schematics, useful for very, very few of our users. The API docs are only useful for users who'd have no difficulty building a version that includes them, and their value is easily offset by the comical time it takes everyone else to build them. # Adam -- Adam Weinberger adamw@adamw.org https://www.adamw.org