From nobody Fri Dec 9 16:39:55 2022 X-Original-To: dev-commits-ports-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4NTGwF3g39z4jjM3 for ; Fri, 9 Dec 2022 16:40:13 +0000 (UTC) (envelope-from adamw@adamw.org) Received: from mail-ej1-x629.google.com (mail-ej1-x629.google.com [IPv6:2a00:1450:4864:20::629]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1D4" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4NTGwF1j6Tz4P5X for ; Fri, 9 Dec 2022 16:40:13 +0000 (UTC) (envelope-from adamw@adamw.org) Authentication-Results: mx1.freebsd.org; none Received: by mail-ej1-x629.google.com with SMTP id ud5so12809190ejc.4 for ; Fri, 09 Dec 2022 08:40:13 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=adamw-org.20210112.gappssmtp.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=Ck88WYEpNaultcJJ9DjPU9UYlagkohyGbX9Fnup4/a8=; b=7uH60CPUK1wVvtvHv0kHHe1eRcn4F031HQZPpEQ5aa5V0nuV8sUeYs8s03QSj2Hyc9 mIexqEIg7xd1iY49NHPIeR8Y1QDzPLkFF27vhcrEG00rzDzptooD+APSZJq9frdk/Zpw tS/IQ0zDFxaOXtEaBJidZUFCOJXyeN0GOqow4YIKUwc5aKL4qwGIfiFpesKSStGn5rHs Yjxop89m0MPRqLP58VJsTWf88M94DoS8sMbZ9DAiYvHJYmT+tBWnRDH7239ENPijK1jF ILIMpeC7q54RpWS0MYCnMq00wxd8+L6A0g9kJdQc4nerixUoES9I/7ZW6Q0xV8Sd6DKp ud3Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=Ck88WYEpNaultcJJ9DjPU9UYlagkohyGbX9Fnup4/a8=; b=axneEjqJAWb5j8JYDU0UZQwEa9YMrRNT6ZaGYquJKhvbULY9YdDfVOVLvwwjKN3ecP evzFAaApBTkSnXYkujj7BXjv1eY47Tr7VDZxKGWJzztHJvLYw1EEBpbqo7XdHlQaoxzp 1xkz8x4UmITc/He6KdNMY5fz+wN1tqW1EmmSPJswrlB3EvxAdO7oAw8HeSmz/+lIASfu xK4UVKL1IYt4kSph09ZhQzCflAouZAx8c3zY0VsD+nDGzUc+jBZeBX/fh7+8QXkWtlba m/TRUo1ZnBH/FoZ3zsV0C1S4woPah37qDvQJTw6ZyQTR53RZDDPl20NXWHvFEvpqYrRH iM7Q== X-Gm-Message-State: ANoB5pk27eq7bCne9gmqNHhsz2HzoDxx/EEN944lMdoQASutHRAbZ/kg vIwZMwcHIM1a2ZocWPXM1Z1VTUWyjhW21iZm1RDRjw== X-Google-Smtp-Source: AA0mqf5LYJhpvehjL252q1N0MLQ4Nx5ZIUkB1P2MpFiE7xY+EaP6SVjGzL89V6yEj12SDuvFwg8UmUPeh6HqlUKI19g= X-Received: by 2002:a17:906:5a0c:b0:7c0:faca:4d5e with SMTP id mx12-20020a1709065a0c00b007c0faca4d5emr12298121ejc.140.1670604011788; Fri, 09 Dec 2022 08:40:11 -0800 (PST) List-Id: Commit messages for all branches of the ports repository List-Archive: https://lists.freebsd.org/archives/dev-commits-ports-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-ports-all@freebsd.org X-BeenThere: dev-commits-ports-all@freebsd.org MIME-Version: 1.0 References: <202212090809.2B989uY4030041@gitrepo.freebsd.org> <5yel-3rt5-wny@FreeBSD.org> In-Reply-To: <5yel-3rt5-wny@FreeBSD.org> From: Adam Weinberger Date: Fri, 9 Dec 2022 09:39:55 -0700 Message-ID: Subject: Re: git: 1597e735c46d - main - devel/glib20: rename DOCS into GTKDOC and disable it by default To: Jan Beich Cc: Baptiste Daroussin , ports-committers@freebsd.org, dev-commits-ports-all@freebsd.org, dev-commits-ports-main@freebsd.org Content-Type: multipart/alternative; boundary="000000000000aeefa505ef67cef6" X-Rspamd-Queue-Id: 4NTGwF1j6Tz4P5X X-Spamd-Bar: ---- X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; ASN(0.00)[asn:15169, ipnet:2a00:1450::/32, country:US] X-Rspamd-Pre-Result: action=no action; module=replies; Message is reply to one we originated X-ThisMailContainsUnwantedMimeParts: N --000000000000aeefa505ef67cef6 Content-Type: text/plain; charset="UTF-8" On Fri, Dec 9, 2022 at 1:27 AM Jan Beich wrote: > Baptiste Daroussin writes: > > > The branch main has been updated by bapt: > > > > URL: > https://cgit.FreeBSD.org/ports/commit/?id=1597e735c46d62efc9b5b9b74bcdde515e28165a > > > > commit 1597e735c46d62efc9b5b9b74bcdde515e28165a > > Author: Baptiste Daroussin > > AuthorDate: 2022-12-09 08:07:37 +0000 > > Commit: Baptiste Daroussin > > 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 --000000000000aeefa505ef67cef6 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
On Fri, Dec 9, 2022 at 1:27 AM Jan Beich <jbeich@freebsd.org> wrote:
<= /div>
Baptiste Daroussin <bapt@FreeBSD.org> writes:

> The branch main has been updated by bapt:
>
> URL: https:= //cgit.FreeBSD.org/ports/commit/?id=3D1597e735c46d62efc9b5b9b74bcdde515e281= 65a
>
> commit 1597e735c46d62efc9b5b9b74bcdde515e28165a
> Author:=C2=A0 =C2=A0 =C2=A0Baptiste Daroussin <bapt@FreeBSD.org>=
> AuthorDate: 2022-12-09 08:07:37 +0000
> Commit:=C2=A0 =C2=A0 =C2=A0Baptiste Daroussin <bapt@FreeBSD.org>=
> CommitDate: 2022-12-09 08:07:37 +0000
>
>=C2=A0 =C2=A0 =C2=A0devel/glib20: rename DOCS into GTKDOC and disable i= t by default
>=C2=A0 =C2=A0 =C2=A0
>=C2=A0 =C2=A0 =C2=A0Follow the path done for ports depending on doxygen= with gtkdoc.
>=C2=A0 =C2=A0 =C2=A0This reduced the number of build dependencies and r= espects the defaults
>=C2=A0 =C2=A0 =C2=A0of the upstream build system.

Reducing build-only dependencies regresses "batteries included" f= or packages.
One could say it improves/reduces package size but that's only valid ra= tionale
as long as subpackages (D16457) are forever stuck in review.

I agree with you about including batterie= s for user-facing functionality. But I'll argue that there's a quan= tifiable difference between including batteries and including a kitchen sin= k.
=
Abusing your metaphor here, glib's docs aren't batteries, nor are they eve= n=20 manuals. They're schematics, useful for very, very few of our users. Th= e API docs are only useful for users who'd have no=20 difficulty building a version that includes them, and their value is=20 easily offset by the comical time it takes everyone else to build them.

<= /div>
# Adam

--
--000000000000aeefa505ef67cef6--