$Id: README,v 1.3 2008/03/24 18:23:46 ianmacd Exp $

INTRODUCTION
------------

Ruby/AWS is the follow-up to Ruby/Amazon. See the NOTES file for more
information.

Ruby/AWS is a Ruby language library that allows the programmer to retrieve
information from the popular Amazon Web site via Amazon Web Services. In
addition to the original amazon.com site, amazon.co.uk, amazon.de, amazon.fr,
amazon.ca and amazon.co.jp are also supported.

This library supports significant functionality in the AWS v4 API. Currently
implemented operations are:

  ItemSearch
  ItemLookup
  SellerListingSearch
  ListSearch
  BrowseNodeLookup

Shopping cart functionality is not currently implemented.

You can generate HTML documentation for this library with the following
command, executed from the directory into which you have untarred the archive:

  rdoc -x CVS lib

Documentation on how to use this library is currently almost non-existent.
Sorry about that.

The code is being released in this alpha state to provide a migration path for
users of Ruby/Amazon, for whom AWS v3 will be discontinued by Amazon on
2008-03-31.


INSTALLATION
------------

Please see the INSTALL file for details of how to install Ruby/Amazon.


LICENCE
-------

This software is copyright (C) 2008 Ian Macdonald and distributed under the
terms of the GNU GENERAL PUBLIC LICENSE, a copy of which is included.

-- 
Ian Macdonald
<ian@caliban.org>
