File: README

==================

This document was last updated on Fri Sep 08 03:34:52 2006. Please see the file COPYING for licensing and warranty information. Visit pablotron.org/software/rubilicious/ for the latest version of this software.

Overview

==

Delicious (del.icio.us/) bindings for Ruby. You‘ll need to create an account at Delicious in order to use Rubilicious. An RDoc-generated API reference is in doc/, and some simple examples are in examples/.

Note: If you’re upgrading from version 0.1.x, please read the file "release_notes-0.2.0.txt" for information about several API changes.

Requirements

======

Ruby (www.ruby-lang.org/), version 1.8.0 (or newer).

(Yup, that’s it!)

Installation

======

The easiest way to install is via RubyGems (rubygems.org/). If you’ve got RubyGems, installing Rubilicious is simple. Here’s how:

    # install rubilicious using RubyGems
    sudo gem install rubilicious

or, without sudo:

    # install rubilicious using RubyGems, without sudo
    su -c 'gem install rubilicious'

If you don’t use RubyGems, you can still install Rubilicious directly with the tarball like this:

    # install rubilicious directly, without RubyGems
    sudo cp -v rubilicious.rb $(ruby -e 'puts $LOAD_PATH.first')

No sudo? No problem. Here’s the same command without sudo:

    # install rubilicious directly, without RubyGems or sudo
    su -c "cp -v rubilicious.rb $(ruby -e 'puts $LOAD_PATH.first')"

Reporting Bugs

========

Have a bug to report or a feature you’d like me to add to Rubilicious? Feel free to email me at the address below. Alternatively, you can submit your feature request or bug directly to my bug-tracking web interface at the following URL:

    http://bugs.pablotron.org/

Note: You‘ll need to create an account in order to submit a feature request or a bug report via the web interface.

About the Author

==========

Paul Duncan <pabs@pablotron.org> www.pablotron.org/