$Id: README,v 1.8 2002/05/23 22:22:18 ianmacd Exp $


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

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


USAGE
-----

Please see google.html or the man page for details of how to use this software.

Before you will be able to use this software effectively, you will need to
request a key from Google. You can get this from at the following URL:

	https://www.google.com/accounts/NewAccount?continue=http://api.google.com/createkey&followup=http://api.google.com/createkey

Google has made available a Web API archive containing sample code, an API
reference document and a WSDL file. Although none of these files are necessary
in order to use Ruby/Google, you may find the API document a useful reference
for determining what some of the more obscure parameters to the method calls
are.

The Web API archive can be downloaded from:

	http://www.google.com/apis/download.html

The Google Web API home page can be found at:

	http://www.google.com/apis/

Google also offers a newsgroup to support the Web API. You can find this at:

	http://groups.google.com/groups?hl=en&group=google.public.web-apis


EXAMPLE PROGRAMS
----------------

To use the programs in the examples subdirectory, you should copy your
your Google key into ~/.google_key


DISCLAIMER
----------

Although I am an employee of Google at the time of writing, the software
contained in this package is my own non-derivative work and is neither endorsed
nor supported by Google.

Any resemblance to code living or dead is purely coincidental...
