Re: git: cf75f452e94a - main - sysutils/conky: Update to 1.14.0
- In reply to: Alexey Dokuchaev : "Re: git: cf75f452e94a - main - sysutils/conky: Update to 1.14.0"
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Fri, 14 Oct 2022 16:36:44 UTC
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>