Date: Fri, 14 Oct 2022 18:36:44 +0200 From: Guido Falsi <madpilot@FreeBSD.org> To: Alexey Dokuchaev <danfe@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: <401a2019-9a32-9e75-a950-38e29e1c8288@FreeBSD.org> In-Reply-To: <Y0mHAJ999ME%2Be4Xw@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> <Y0mHAJ999ME%2Be4Xw@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On 14/10/22 17:57, Alexey Dokuchaev wrote: > 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? I don't agree with this analysis, so I will not fight this battle, but anyone is free to file bug reports with upstream. > >> 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) "evil" is a very strong definition for everything. Nietzche has a very good book on the subject whose title translation in most languages is "Beyond Good and Evil". I like that title (and most of the content too actually), and that title is also a good description of my attitude towards "evil". A dear friend of mine also insists on calling me "Dr. Hostile" [1], guess it figures. Maybe I should change my committer nickname! :) [1] as a pun on a character named "Dr. Strange" or "Dr. Evil" I guess, but I know very little about Marvel/DC comics characters -- Guido Falsi <madpilot@FreeBSD.org>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?401a2019-9a32-9e75-a950-38e29e1c8288>