- Added a quick example at the documentation's top.

- Updated version to 0.3.

2 files changed, 39 insertions, 3 deletions

diff --git a/README b/README
index 0738d57..91a16cc 100644
--- a/README
+++ b/README
@@ -34,10 +34,46 @@ the standard '''datetime''' module, available in Python 2.3+.
 
   * More than 400 test cases.
 
+== Quick example ==
+Here's a snapshot, just to give an idea about the power of the
+package. For more examples, look at the documentation below.
+
+Suppose you want to know how much time is left, in
+years/months/days/etc, before the next easter happening on a
+year with a Friday 13th in August, and you want to get today's
+date out of the "date" unix system command. Here is the code:
+{{{
+from dateutil.relativedelta import *
+from dateutil.easter import *
+from dateutil.rrule import *
+from dateutil.parser import *
+from datetime import *
+import commands
+import os
+now = parse(commands.getoutput("date"))
+today = now.date()
+year = rrule(FREQ_YEARLY,bymonth=8,bymonthday=13,byweekday=FR)[0].year
+rdelta = relativedelta(easter(year), today)
+print "Today is:", today
+print "Year with next Aug 13th on a Friday is:", year
+print "How far is the Easter of that year:", rdelta
+print "And the Easter of that year is:", today+rdelta
+}}}
+
+And here's the output:
+{{{
+Today is: 2003-10-11
+Year with next Aug 13th on a Friday is: 2004
+How far is the Easter of that year: relativedelta(months=+6)
+And the Easter of that year is: 2004-04-11
+}}}
+
+{i} It was '''really''' a coincidence :)
+
 == Download ==
 The following files are available.
-  * attachment:python-dateutil-0.2.tar.bz2
-  * attachment:python-dateutil-0.2-1cl.noarch.rpm
+  * attachment:python-dateutil-0.3.tar.bz2
+  * attachment:python-dateutil-0.3-1cl.noarch.rpm
 
 == Author ==
 The dateutil module was written by GustavoNiemeyer <niemeyer@conectiva.com>.
diff --git a/setup.py b/setup.py
index b542742..3fcbc52 100644
--- a/setup.py
+++ b/setup.py
@@ -2,7 +2,7 @@
 from distutils.core import setup
 
 setup(name="python-dateutil",
-      version = "0.2",
+      version = "0.3",
       description = "Extensions to the standard python 2.3+ datetime module",
       author = "Gustavo Niemeyer",
       author_email = "niemeyer@conectiva.com",