|From:||Tony Cook <tony [...] develop-help.com>|
|Date:||Wed, 10 Mar 2004 10:54:38 +1100|
|To:||bug-imager [...] rt.cpan.org|
----- Forwarded message from Dave Rolsky <email@example.com> ----- Date: Tue, 9 Mar 2004 17:10:48 -0600 (CST) From: Dave Rolsky <firstname.lastname@example.org> To: Tony Cook <email@example.com> cc: mason <firstname.lastname@example.org> Subject: Re: [Mason] Working with PerlMagick [now way OT] On Wed, 10 Mar 2004, Tony Cook wrote: Show quoted text
> On Tue, Mar 09, 2004 at 11:37:12AM -0600, Dave Rolsky wrote:There's just no list of methods! Look at the SYNOPSIS, which references methods like "scale". But where is scale documented besides the synopsis? Basically, you need to list every method and exported constant/var (like %Imager::formats) and say what they do, what arguments they take, and what they return. A few quick examples is simply not sufficiient. It also needs a lot more high-level "here's how you do task X" type of documentation. Right now it's mostly very low-level, and doesn't make much sense unless you already know what the method you want is named. An Imager::Cookbook would be really helpful. Here's a list of things you could cover (taken from the Image Magick home page ;): Convert an image from one format to another (e.g. TIFF to JPEG) Resize, rotate, sharpen, color reduce, or add special effects to an image Create a montage of image thumbnails Create a transparent image suitable for use on the Web Turn a group of images into a GIF animation sequence Create a composite image by combining several separate images Draw shapes or text on an image Decorate an image with a border or frame Describe the format and characteristics of an image Obviously, Imager may not do all of these things, but I know it does some of those. That'd be a great start for a cookbook, I think. Browsing the rest of the Image Magick docs and example will probably give you more ideas for cookbook topics. -dave /*======================= House Absolute Consulting www.houseabsolute.com =======================*/ Show quoted text
> > On Tue, 9 Mar 2004, Randal L. Schwartz wrote: > >> > What do you are the main problems with the Imager documentation?
> > > As you can tell, I have a great love/hate relationship with > > > ImageMagick.> > > > Mine is mostly hate ;) > > > > Argh, what a poorly documented monstrosity. And the API is just awful > > once you figure it out. I'd really like to see Imager replace it, though > > it's docs are terrible too. But at least the API is reasonably sane ;)
----- End forwarded message -----