This project is a fork of the straw.git project. If you have that one already cloned locally, you can use
git clone --reference /path/to/your/straw.git/incarnation mirror_URL
to save bandwidth during cloning.
descriptionStraw work fork
homepage URL
last changeSun, 9 Dec 2007 17:25:05 +0000 (9 18:25 +0100)
content tags

= Contents =

    * Introduction
    * Minimum Requirements
    * Installation
    * Notes on Installation
    * Notes on Translation
    * Notes on Configuring your Web Browser
    * Database Corruption: How to recover data
    * Database Conversion Problems ( for version 0.21.x and below ONLY )
    * Environment variables
    * Help?

=== Introduction ===

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.4
2. Berkeley DB and their python bindings (pybsddb)
3. PyGTK 2.8+ (incl. extras which contains the gtkhtml2 module)
4. GConf

=== Installation ===

1. Make sure you have the required packages to run Straw

[]$ cd straw
[]$ python install_modules_check

2. Build the necessary files to run Straw

[]$ python build

3. Install

[]$ python install

... Or if you want to install straw in /usr/local..

[]$ python install --prefix=/usr/local

=== Notes on Installation ===

Straw installs files into three locations: 

1. The straw executable into a directory that should be in your $PATH, like
   '/usr/bin/' or '/usr/local/bin'.

2. A library directory to a location that should be in python's search path,
    like '/usr/lib/python2.X/site-packages' or '/usr/local/lib/python2.X/site-packages'.

3. And a data directory into a location that should be an architecture-neutral
    directory like it '/usr/share/' or '/usr/local/share'

If the library directory[2] 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. 

=== Notes on Translation ===

(1) Updating the POT file

[]$ python translate --pot

(2) Merging LANGCODE.po with straw.pot

[]$ python translate --dist LANGCODE

(3) Merging translation with desktop file

[]$ python build_desktop

'python --help-commands' for more info.

=== Database Corruption: How to recover data ===

When you see following error ...

"Recovery Error: See README for details on how to recover data."

... run ...

[]$ db_recover -h $HOME/.straw -c -v
[]$ db_checkpoint -1 -v

... after which you can now restart straw and everything should be fine. 

If it still errors, read the last paragraph of the next section (... conversion problems)

=== Database conversion problems ( for version 0.21.x and below ONLY ) ===

The database format changed between Straw versions 0.21 and
0.22. Straw will automatically convert your database, but people have
experienced problems which we have been unable to trace.

If the conversion fails, you will be shown a dialog reporting the
problem. The exception will be saved to a file, the dialog will tell
you the name. You should see what's the problem; if it contains an
error telling you to run recover, you should try running db_recover on
the $HOME/.straw directory, like this:

$ db_recover -h $HOME/.straw -c -v
$ db_checkpoint -1 -v

However, this does not always help. If all else fails, you should
rescue your $HOME/.straw/config file and put it in a new, empty
$HOME/.straw directory. You will lose all the articles and images, but
your subscriptions will be safe.

We apologize for the inconvenience.

=== Environment variables ===

While most of Straw's configuration is stored in gconf and its own
configuration file, there are also some more developer-oriented
environment variables that modify Straw's behaviour.

STRAW_RELOAD_CSS: If defined, reload CSS every time an article is

STRAW_IN_SOURCE_DIR: Tell Straw it's running in the source directory,
                     so it knows where to look for dependencies.

=== Help? ===

1. Visit for mailing lists and reporting defects.
2. We have a channel in called #straw.
3. For more installation commands, run:

[]$ python --help-commands

- Straw Maintainers
2007-12-09 DrFrasierCraneWork on reordering and reparenting in the tree view... master
2007-12-09 DrFrasierCraneFixes (workarounds) in OPML parsing, more work on GUI...
2007-12-08 DrFrasierCraneWork on GUI integration with new model.
2007-12-08 DrFrasierCraneIntermediate commit of big changes in the model, GUI...
2007-12-05 DrFrasierCraneMake treeview nodes reordering work properly.
2007-12-05 DrFrasierCraneAdded more indexes to database schema.
2007-12-05 DrFrasierCraneJobManager code cleanup.
2007-12-04 DrFrasierCraneFixed feed aggregation on nested subcategories.
2007-12-03 DrFrasierCraneAdded task-start signal to JobManager, more work on...
2007-12-03 PawelPaprotaJobManager code cleanup.
2007-12-02 DrFrasierCraneWork on feed discovery dialog.
2007-12-01 DrFrasierCraneWork on feed discovery assistant.
2007-12-01 DrFrasierCraneIntermediate work commit.
2007-11-30 DrFrasierCraneUpdate feedfinder to the latest version.
2007-11-26 DrFrasierCraneOPML fixes, more work on GUI.
2007-11-25 PawelPaprotaAfter right clicking on the feed list treeview, tree...
7 years ago master