Opened 9 years ago

Closed 9 years ago

#48380 closed enhancement (wontfix)

pngcrush: add manpage

Reported by: macports@… Owned by: nerdling (Jeremy Lavergne)
Priority: Normal Milestone:
Component: ports Version:
Keywords: Cc:
Port: pngcrush

Description

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.

Attachments (1)

pngcrush.1.gz (5.7 KB) - added by macports@… 9 years ago.
manpage

Download all attachments as: .zip

Change History (6)

comment:1 Changed 9 years ago by dbevans (David B. Evans)

Owner: changed from macports-tickets@… to snc@…

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.

comment:2 Changed 9 years ago by 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.

Changed 9 years ago by macports@…

Attachment: pngcrush.1.gz added

manpage

comment:3 in reply to:  2 Changed 9 years ago by 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.

Last edited 9 years ago by macports@… (previous) (diff)

comment:4 Changed 9 years ago by ryandesign (Ryan Carsten Schmidt)

Summary: Missing manpagepngcrush: add manpage

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.

comment:5 Changed 9 years ago by nerdling (Jeremy Lavergne)

Resolution: wontfix
Status: newclosed
Version: 2.3.3

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.

Note: See TracTickets for help on using tickets.