pngcrush: add manpage

[macports@…]

The pngcrush port does not install a manpage; I’m attaching one but I don’t know portfiles well enough to submit a patch to install it.

[dbevans (David B. Evans)]

When submitting tickets for a port be sure to CC the port's maintainer so he doesn't miss it.

$ port info --maintainer pngcrush
maintainer: snc@macports.org

Thanks.

[ryandesign (Ryan Carsten Schmidt)]

Where did this manpage come from? It's not really our mission to distribute additional files not created by the developer of the software. There are exceptions, but in this case, if the pngcrush distribution does not come with a manpage, and you have written one, then you should provide it not to us but to the developers of pngcrush, so that they can include it in the distribution. This way, everyone benefits, not just those installing pngcrush via MacPorts.

[macports@…]

manpage

[macports@…]

Replying to ryandesign@…:

Where did this manpage come from? It's not really our mission to distribute additional files not created by the developer of the software. There are exceptions, but in this case, if the pngcrush distribution does not come with a manpage, and you have written one, then you should provide it not to us but to the developers of pngcrush, so that they can include it in the distribution. This way, everyone benefits, not just those installing pngcrush via MacPorts.

It’s credited as

This  manual  page  was written by David Whedon dwhedon@gordian.com for
        the Debian GNU/Linux system (but may be used by others).

and included in Ubuntu at least as far back as Gutsy in 2007. After eight years I have to assume the developer is aware of its existence; SourceForge (where pngcrush lives) has been down all day so I haven’t been able to investigate his rationale for not including documentation. I’ll keep checking and update this ticket whenever SF comes back up.

[ryandesign (Ryan Carsten Schmidt)]

SourceForge suffered a major storage system failure (#48383); they're still working on recovering everything, though the web sites and issue trackers should be back up by now.

[nerdling (Jeremy Lavergne)]

As Ryan state, we wish to:

• avoid constantly verifying accuracy of dated (as it is not updated with software) Linux man page, and
• avoid validating the man page's Linux content on non-Linux platforms.

I'll add that:

• pngcrush -h (exists and is built for each platform) is infinitely more authoritative, and
• the developer has chosen to not provide a man page, and
• the man page is chronically out-of-date e.g. ​https://bugs.debian.org/471159, and
• tracking and verifying multiple upstreams is overly burdensome and diverges from our role.

Since pngcrush -h does exist and is more authoritative while avoiding all these concerns, I'm closing as won't fix.