Bug 173089

Summary: ImageMagic documentation somewhat misleading/inadequate
Product: [Fedora] Fedora Reporter: Michal Jaegermann <michal>
Component: ImageMagickAssignee: Norm Murray <nmurray>
Status: CLOSED RAWHIDE QA Contact: Mike McLean <mikem>
Severity: medium Docs Contact:
Priority: medium    
Version: rawhideCC: hdegoede, triage
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: Linux   
Whiteboard: bzcl34nup
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2008-04-25 13:26:13 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Michal Jaegermann 2005-11-13 23:56:45 UTC
Description of problem:

ImageMagick documentation in in
file:///usr/share/doc/ImageMagick-6.2.5/www/command-line-options.html#draw
claims that feeding 'convert' an option

        -draw 'text 100,100 "Works like magick!"'

should annotate a converted image with a text like the above.  Well,
it does not until one will guess that also is needed something like

         -font Helvetica

where the only acceptable font names seem to be, by experiment, the ones which
occur in 'Fontmap.GS' file from ghostscript.  What is written at
file:///usr/share/doc/ImageMagick-6.2.5/www/command-line-options.html#font
does not seem to lead anywhere.  Do I miss some other names which can
be accepted with -font as well?

In any case a default font for -draw 'text ....' would be a good start
and if such font indeed does exist then it is not accesible and the
whole procedure fails silently.

Version-Release number of selected component (if applicable):
ImageMagick-6.2.5.4-1

Comment 1 Bug Zapper 2008-04-03 16:37:31 UTC
Based on the date this bug was created, it appears to have been reported
against rawhide during the development of a Fedora release that is no
longer maintained. In order to refocus our efforts as a project we are
flagging all of the open bugs for releases which are no longer
maintained. If this bug remains in NEEDINFO thirty (30) days from now,
we will automatically close it.

If you can reproduce this bug in a maintained Fedora version (7, 8, or
rawhide), please change this bug to the respective version and change
the status to ASSIGNED. (If you're unable to change the bug's version
or status, add a comment to the bug and someone will change it for you.)

Thanks for your help, and we apologize again that we haven't handled
these issues to this point.

The process we're following is outlined here:
http://fedoraproject.org/wiki/BugZappers/F9CleanUp

We will be following the process here:
http://fedoraproject.org/wiki/BugZappers/HouseKeeping to ensure this
doesn't happen again.

Comment 2 Hans de Goede 2008-04-25 13:26:13 UTC
Quick intro: I'm now a comaintainer of ImageMagick, and thus going through all
the open bugs.

We no longer ship a (possible stale) copy of the website in /usr/share/doc, closing.