Page 1 of 1

Man page and usage help are not matching

Posted: 2013-07-30T07:58:30-07:00
by bentiss
Hi there,

I am the current Red Hat maintainer of ImageMagick for Red Hat Enterprise Linux. We did scan all the packages we have in our distribution, and one of the check is the matching between the "help" usage of each binary and its man page. IM failed at some point and I have written some patches to fix it.
I'm sorry I can not give you access to all the tools required to do the check, but here are the resulting patches.

The patches and scan results are located in http://people.freedesktop.org/~tissoire/IM/

For the trunk:
  • patch: 0001-Fix-man-pages-scan-results-trunk.patch
  • log result: man-scan-result-trunk.txt
For the IM 6.8 version:
  • patch: 0001-Fix-man-pages-scan-results-IM-6.patch
  • log result: man-scan-result-IM-6.txt
The patches are generated from git, but they should be applied through either:

Code: Select all

$> git apply 0001-Fix-man-pages-scan-results-VERSION.patch
or

Code: Select all

$> /usr/bin/patch -p1 --fuzz=0 < 0001-Fix-man-pages-scan-results-VERSION.patch
As you can see on the log results, the "-borderwidth" is a false warning, and the tools are lost when scanning the binary "magick".

I hope you will find these patches useful.

Cheers,
Benjamin

Re: Man page and usage help are not matching

Posted: 2013-07-30T08:42:53-07:00
by magick
Thanks for the patches, we have applied them to ImageMagick version 6 and 7 and they will be available in the next point release of ImageMagick.

Re: Man page and usage help are not matching

Posted: 2013-07-30T09:24:37-07:00
by bentiss
Hey, thanks for applying them that quickly :)

Cheers,
Benjamin