From nobody Fri Dec 09 16:39:55 2022 X-Original-To: dev-commits-ports-main@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 4NTGwF3rlDz4jjGG for ; Fri, 9 Dec 2022 16:40:13 +0000 (UTC) (envelope-from adamw@adamw.org) Received: from mail-ej1-x62c.google.com (mail-ej1-x62c.google.com [IPv6:2a00:1450:4864:20::62c]) (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 4NTGwF1bdSz4Ny9 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-x62c.google.com with SMTP id kw15so12761699ejc.10 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=wT/AXHQhQPFZ0t6iQ3Rbly97K808XONMTGv62qpjbLF7rbyK4Dq5YLz+hFn+Xdygwu Hv2z1ZMpxmv6Bum7eEodVEbvhMzzH5DJ9KQoAEL8rAZcCCgfbG5k/DwROCzcoFSZYyay D1Lzj+OXEu9tUdSiD3MuTQzkaD+INKflgb5InAhGFCW/YWfC+B0lamPewrDVHcEQo8sx gQhVMIpEZ/gUi8SpnpqocKgmT0uk8DvkNIDZ/BS93Pfyd9zzpVjGnoQAxxXEWL8Aj8bL qQ5xT6KDyw7NPXC2736Vwf2F5+XLQKQWLbk/9HEmk9kLzsZETx4SA7aJ+LFN7ByGPZ6G X4KA== X-Gm-Message-State: ANoB5pn1ninmEKbNXKcOq5UHKPykSR1thl2wEz4k+zCiJai3u2IW9KMK k4Y3MVY5rFoyQ6QGbbEIkGe9+lpk+X0Em1bfQdgYSA== 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: Commits to the main branch of the FreeBSD ports repository List-Archive: https://lists.freebsd.org/archives/dev-commits-ports-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-ports-main@freebsd.org X-BeenThere: dev-commits-ports-main@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: 4NTGwF1bdSz4Ny9 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--