readme updated

README.rst

@@ -1,7 +1,23 @@
 Copycat themes for Awesome WM 3.5
 ---------
-I.E. modded and localized versions of some stuff I like.
-Beware! They're more awesome than they appear.
+I.E. heavy mods of some stuff I like.
+
+Beware! They're more awesome than they appear, it's just they're shy.
+
+Notable features:
+- Autohide widgets (*tell me only when you have to*)
+- Autostart functionality
+- Fast mpd and volume shortcuts (believe me, nobody showed this before anywhere)
+- Other fancy shortcuts for: copying to the clipboard (goodbye clipboard managers!), toggle wiboxes, widgets popups, screenshots, moving clients, user programs
+- Dropdown terminal, quake style
+- Small but complete calendar, with current day hightlighted and the possibility to switch months back and forward with just a click 
+- Very elegant notifications for: new mails, current song, hdd critical state, low battery
+- Yahoo Wheather integration 
+- A net carrier checker, when you're offline it warns you and lets you start wifi-menu
+- Full localization potential (just easy edit about 20 lines)
+- Colorful (and nice) icons
+
+They're scattered all over the themes, but you can get them all *only* in Blackburn.
 
 **Blackburn** the wannabe definitive theme
 

rc.lua.blackburn

@@ -228,7 +228,7 @@ local function create_calendar()
    local first_day = os.time({ day = 1, month = cal_month, year = cal_year})
    local first_day_in_week =
       os.date("%w", first_day)
-   local result = "do lu ma me gi ve sa\n"
+   local result = "do lu ma me gi ve sa\n" -- days of the week
    for i = 1, first_day_in_week do
       result = result .. "   "
    end
@@ -276,7 +276,7 @@ function show(inc_offset)
    inc_offset = inc_offset or 0
 
    local save_offset = offset
-   hide()
+   remove_calendar()
    offset = save_offset + inc_offset
 
    local char_width = char_width or calculate_char_width()
@@ -288,7 +288,7 @@ function show(inc_offset)
 end
 
 function add_calendar(t_out)
-   hide()
+   remove_calendar()
    local char_width = char_width or calculate_char_width()
    local header, cal_text = create_calendar()
    calendar = naughty.notify({ title = header,