Straw is a desktop news aggregator for the GNOME environment. Its aim is to
be a faster, easier and more accessible way to read news and blogs than the
traditional browser.

* Minimum Requirements *

1. Python 2.2.
2. pyadns
3. Berkeley DB3 and pybsddb. (python 2.3 ships with pybsddb)
4. PyGTK, python bindings for GTK+. 
5. gnome-python 1.99.13.
6. orbit-python or pyorbit.
7. libglade
8. mxDateTime
9. PyXML

* Installation *

[foo@test.com]$ cd /straw/directory
[foo@test.com]$ make install

* Notes on Installation *

The Makefile installs files into three locations: the straw executable
into a directory that should be in your $PATH, a library directory to
a location that should be in python's search path, and a data
directory into a location that should be an architecture-neutral
directory.

In practice, this means, at least by default, /usr/local/bin,
/usr/local/lib/python2.2/site-packages and /usr/local/share.

If the library directory isn't in your search path, or if you for some
reason installed it elsewhere, you should point the STRAW_LIB
environment variable at the directory under which the straw library
directory was created. That is, in the default installation,
/usr/local/lib/python2.2/site-packages.

* Notes on Configuring your Web Browser *

If you click on a URL, straw loads the URL in whatever browser is set in your
environment. In GNOME 2.x, this is done through the "Web Browser" tab in

 1. Applications -> Desktop Preferences -> Advanced -> Preferred Applications.


* Notes on Filing Bugs *

1. Make sure it's REALLY a straw bug and NOT a dependency bug. If you're not
   sure, please ask people in the mailing list first.

2. Include what VERSION of Straw(and its dependencies if possible) you are
   using and give us test data to work with(e.g, sample feeds, backtrace, etc...)

* Notes on HACKING *

1. All CVS bugs should go to the mailing list.

* Suggestions *

All suggestions should go to the mailing list so that community members can
also discuss it. For UI changes, please include a LINK to the screenshot and tell us why
you want it that way.

Visit http://www.nongnu.org/straw for more info.

$Id: README,v 1.5.2.1 2003/08/31 03:44:49 jmalonzo Exp $
