Date: Fri, 14 Oct 2022 15:57:52 +0000 From: Alexey Dokuchaev <danfe@freebsd.org> To: Guido Falsi <madpilot@freebsd.org> 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: <Y0mHAJ999ME%2Be4Xw@FreeBSD.org> In-Reply-To: <d944069c-c304-0015-0eed-5ea4f4f1a54d@FreeBSD.org> References: <202210131824.29DIO985022530@gitrepo.freebsd.org> <Y0l40iZP2cVzRQ/8@xombo.localdomain> <934dc4ad-91df-2376-63e7-b82be53ecdb2@FreeBSD.org> <Y0l9zWxheSkF28Lq@FreeBSD.org> <d944069c-c304-0015-0eed-5ea4f4f1a54d@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?Y0mHAJ999ME%2Be4Xw>