From nobody Fri Oct 14 15:57:52 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 4MprdD6rqDz4flF4; Fri, 14 Oct 2022 15:57:52 +0000 (UTC) (envelope-from danfe@freebsd.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2610:1c1:1:6074::16:84]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "freefall.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4MprdD6Lxkz3FH5; Fri, 14 Oct 2022 15:57:52 +0000 (UTC) (envelope-from danfe@freebsd.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1665763072; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=SKjd5OZFghdzLiADJnWXx6K9SqA0U71LJ3U0UiZN/tM=; b=wZ5pOAoTP0Pyilci88u6RCoQ5fJIacMuNbwF2Po55s/g4flh8DDXBtqKKyQr1t8QCHg7gv vabkyzkNgVPobnntmPOhbb5oSWQ1F9r/zt7tMT9F14Zsai6zBW/BPanXqrdslB0yfgfiFq MdgfOe88/1XZVEPgq9oa5H0BhzQzTSBl881oZmJR495QQ7HGJ7w8T9vGuDd+e4XClbcoFX MffTY/F5kucCHe/aDesa9D6GehbgWCvh7t+/pIe52346ebpZliMz8COosC78uF+IDx/vS2 +qQ+l2r44GkSp9IPQOMbXTJ9myTlKcnmk6IYF8Y3lYvxkTpcGbPAVuwsPRaqiA== Received: by freefall.freebsd.org (Postfix, from userid 1033) id AF3106D01; Fri, 14 Oct 2022 15:57:52 +0000 (UTC) Date: Fri, 14 Oct 2022 15:57:52 +0000 From: Alexey Dokuchaev To: Guido Falsi Cc: ports-committers@freebsd.org, dev-commits-ports-all@freebsd.org, dev-commits-ports-main@freebsd.org Subject: Re: git: cf75f452e94a - main - sysutils/conky: Update to 1.14.0 Message-ID: References: <202210131824.29DIO985022530@gitrepo.freebsd.org> <934dc4ad-91df-2376-63e7-b82be53ecdb2@FreeBSD.org> 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 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1665763072; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=SKjd5OZFghdzLiADJnWXx6K9SqA0U71LJ3U0UiZN/tM=; b=qil6cJEs0zCT9RZ+tFmcB1CcALIsJg1Wz5ttj2PPL0s7/ueWWlpXJgC/kJpciasGrzN0B8 g7RjfgVAU9//wMZTQjZZBbg1xxfhuFFxa0G1IW/sttCjiZ0jtosQGDs6iCI1DcCXZ71ZzA DxP7CZPm1rZnaTCuDFrX7gy1x6GNOurqonSmnKW5/hOLLBSsWUGkDFQJEibsNvEwcdKUgN w4vJLdVt5JgSWBSNELXeah5nG0vpwAw2As7RRPZzk7rKeIY5e83cxAC1/A0Tco8tfnziSt wNbdok26NJ8sq6baZNsxiBhG6XsBFsq95b3HE6cNuGsxHs3ZzPtT1Ka+VnHoHw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1665763072; a=rsa-sha256; cv=none; b=vBcYMLuqwkZHG3AhxZ1ZZh74QgGXrpRLRq/9oRkeQg2GC9D34yurSbXKS+Rb49Mu31d5vZ uJPCfg55cEIpJVNcGT0SdLuUKzJrAlyDfhnTpO97xyKsDzOTyA56La2IglOOpTdmz4o5uU LQwycDn8SKz1y/OOhzZq6LB0CZ87cKXt21vm7PyZ5GSW8PmZ57o8wYJ6jvsYGgh9wCf3rV Q7cZ2/htLdmkGdiWkjsY2BoZIcHwSzsSTthiRvka4ejEWkbl7gBKRBpy0o3M7MPD0Vo9Ts X/Rk5d7UBmJN2wqqMBPf9RRxe5h0ZpViV0JyZaXi4pMpoIbK1ee2ObFa9sVQ2A== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N On Fri, Oct 14, 2022 at 05:31:54PM +0200, Guido Falsi wrote: > ... > More practical part (conky case): > > Upstream now uses pandoc to generate the software man page. I did not > even know pandoc existed up to yesterday. I am definitely unable to cook > up a substitute. > > In the ports tree man pages are not part of DOCS, but a base component > of a port, so I can't wrap the man page generation in the DOCS knob. > > Any suggestions? > > Adding a pre-generated man page to the port? Not sure it's a good idea, This is the best thing to do; if fact, that's part of the upstream's job ideally. When grass was greener, software was released as properly bootstrapped, so users won't have to bother building *documentation* which does not fuckin' change. The result would 99% likely be the same for user's of *BSD, GNU/Linux, or SunOS. We're in GitHub era now, and people start to forget how to prepare good releases. We need to remind them from time to time. > I should check that [the] man page gets generated the same on every > release at least, and I'm sure at some point in the future I'll end up > upgrading the port and forgetting to update the pre-generated man page. Right, that's why it should not be your job in the first place. Could we try convincing upstream to ship pre-generated manpage? > For example one thing that annoys the hell out of me is seeing every > software grow a dependency on some HTML5+js+multimedia rendering engine, > often for very small gains. +1, this is annoying as hell. I don't know what those people are thinking but this cancer spreads rapidly. > I will not be surprised the day something like less or ls will grow > such a dependency. But I don't have time or resources to fight this. OTOH, the only thing necessary for the triumph of evil is for good men to do nothing. (c) ./danfe