README gives incorrect usage instructions

Please David, I'd appreciate it very much... I'm not the best doc writer on the planet, and I'd rather being reviewing patches and working on 6.x, and leaving the doc writing to the folk who are better at that kind of stuff.

here it is as a patch.

+1 to this; just had a user confused about the move come through the Ubercart forums and told him I'd ping you here about it. Glad someone has already patched it. : )

I do think the method for reaching the Imagecache menu has an unnecessary step, though, and the process for usage could use some visual indicator for each step. This new version still doesn't have the right names for the labels of fields and buttons. Also, the previous version kept a more consistent 80 column width which I'll correct.

I don't have patching capabilities, but I'd like to propose the attached readme instead and will patch it when I'm able if no one else can do it.

Please review this for label and terminology consistency and anything that might be missing. My only hesitancy is that maybe the README has too much information... the information might be better maintained through handbook pages with links in the README to the appropriate places for getting started, using the theme function, and using Imagecache w/ contributed modules.

Patch ... not ... working. :-/ (For some reason it doesn't post my attachments.)

Sorry to do this, but I'll just post the file contents:

------------------------------------------------------------------------------------------------------

Imagecache is a dynamic image manipulation and cache tool. It allows you to
create a namespace that corresponds to a set of image manipulation actions. It
generates a derivative image the first time it is requested from a namespace
until the namespace or the entire imagecache is flushed.

Getting Started:

1. Upload and enable both the Imagecache and Imagecache UI modules.

2. Go to Administer -> Site Building -> Imagecache. Click on the local task tab
labeled "Add New Preset" to build a new set of image manipulation actions.

3. Enter a descriptive name of your choice (e.g. 'product_thumbnail') into the
"Preset Namespace" box and click "Create New Preset".

4. Add actions to your preset that tell Imagecache how to manipulate the
original image when it is rendered for display. Available actions include
crop, scale, desaturate (grey scale), resize, and rotate. Multiple actions
may be added to a preset.

5. Each action is configured in its own form, and the actions may be reordered
from the preset's configuration form. If you need to make any changes to the
order of actions in a preset, remember to click "Update Preset" when you're
finished.

Viewing Manipulated Images:

Your modified image can be viewed by visiting a URL in this format:

http://example.com/files/imagecache/preset-name/files/image-name.jpg

For example, if your preset is named 'product_thumbnail' and your image is
named 'green-widget.jpg', you could view your modified image at:

http://example.com/files/imagecache/product_thumbnail/files/green-widget...

Imagecache also defines a theme function that you can use in your modules and
themes to automatically display a manipulated image. For example, to use the
theme function in a .tpl.php file, add the following line where you would like
the image to appear:

print theme('imagecache', 'preset_namespace', $image_filepath, $alt, $title, $attributes);

Change 'preset_namespace' to the name of your imagecache preset and make sure
that $image_filepath or some other variable contains the actual filepath to
the image you would like to display.

$alt, $title and $attributes are optional parameters that specify ALT/TITLE
text for the image element in the HTML or other attributes as specified in the
$attributes array.

Using Imagecache with Contributed Modules:

Imagecache presets can be put to use in various other modules. For example, when
using CCK with the Imagefield module, you can use the "Display fields" local
task tab to choose a preset to apply to images in that field. Similarly, you
can specify a preset when displaying images attached to nodes using Imagefield
in a View through the Views UI.

For more information, refer to http://drupal.org/node/163561.

(Images, page names, and form field names may refer to previous versions of
Imagecache, but the concepts are the same.)

applied to drupal-5--2 and head