Re: git: cf75f452e94a - main - sysutils/conky: Update to 1.14.0

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