disabling lain.widget.weather because OpenWeatherMap requires API key now, seek lain wiki

README.rst

@@ -141,42 +141,21 @@ This way, you can safely ``git pull`` anytime.
 Notes
 =====
 
-Complements are provided by lain_ and freedesktop_. **Be sure** to satisfy their dependencies.
+Complements are provided by lain_ and freedesktop_. **Be sure** to satisfy their dependencies_. In particular, mail_ and weather_ widgets have **mandatory** arguments.
 
-The fonts used in the screenshots are: Terminus_ (Multicolor, Powerarrow, Powerarrow Dark), Roboto_ (Holo, Vertex) and Tamsyn_ (other ones).
+The fonts used in the screenshots are: Terminus_ (Multicolor, Powerarrow, Powerarrow Dark), Roboto_ (Holo, Vertex) and Tamzen_ (other ones).
 
 As taglist font, Blackburn and Dremora use Icons_, Vertex uses FontAwesome_: be sure to have bitmaps enabled if running under Debian or Ubuntu_.
 
-Due the removal of support for bitmap fonts in Pango 1.44_, the current main font is Terminus (OTB version). Under Arch Linux, use ``community/terminus-font-otb``.
-
 Every theme has a colorscheme_.
 
-You can also configure the ``city_id`` in the following snippet in ``/.config/awesome/themes/<<CHOSEN_THEME>>/theme.lua`` to get the correct weather information (we suggest doing it in your ``theme-personal.lua``):
-
-.. code-block::
-
-     -- Weather
-        local weathericon = wibox.widget.imagebox(theme.widget_weather)
-        theme.weather = lain.widget.weather({
-            city_id = 2643743, -- placeholder (London)
-            notification_preset = { font = "Terminus 10", fg = theme.fg_normal },
-            weather_na_markup = markup.fontfg(theme.font, "#eca4c4", "N/A "),
-            settings = function()
-                descr = weather_now["weather"][1]["description"]:lower()
-                units = math.floor(weather_now["main"]["temp"])
-                widget:set_markup(markup.fontfg(theme.font, "#eca4c4", descr .. " @ " .. units .. "°C "))
-            end
-        })
-
-You can find your ``city_id`` in city.list.json.gz_ after you extract it.
-
 Additional default software used: ::
 
     dmenu firefox mpc mpd scrot unclutter xsel slock
 
 .. _BY-NC-SA: http://creativecommons.org/licenses/by-nc-sa/4.0
-.. _b0ab0d7: https://github.com/lcpz/awesome-copycats/tree/b0ab0d7837987be81b9195a36631df773113d491
 .. _Awesome: http://github.com/awesomeWM/awesome
+.. _branches: https://github.com/lcpz/awesome-copycats/branches
 .. _lucamanni: https://github.com/lucamanni/awesome
 .. _romockee: https://github.com/romockee/powerarrow
 .. _ok100: http://ok100.deviantart.com/art/DWM-January-2013-348656846
@@ -186,13 +165,12 @@ Additional default software used: ::
 .. _lain: https://github.com/lcpz/lain
 .. _freedesktop: https://github.com/lcpz/awesome-freedesktop
 .. _Terminus: http://terminus-font.sourceforge.net
-.. _Tamzen: https://github.com/sunaku/tamzen-font
 .. _Roboto: https://fonts.google.com/specimen/Roboto
-.. _Tamsyn: http://www.fial.com/~scott/tamsyn-font
+.. _Tamzen: https://github.com/sunaku/tamzen-font
-.. _colorscheme: https://github.com/lcpz/dots/tree/master/.colors
 .. _Icons: https://github.com/lcpz/dots/tree/master/.fonts
-.. _Ubuntu: https://wiki.ubuntu.com/Fonts#Enabling_Bitmapped_Fonts
 .. _FontAwesome: https://github.com/FortAwesome/Font-Awesome
-.. _branches: https://github.com/lcpz/awesome-copycats/branches
+.. _Ubuntu: https://wiki.ubuntu.com/Fonts#Enabling_Bitmapped_Fonts
-.. _city.list.json.gz: http://bulk.openweathermap.org/sample/city.list.json.gz
+.. _colorscheme: https://github.com/lcpz/dots/tree/master/.colors
-.. _1.44: https://github.com/lcpz/awesome-copycats/issues/269
+.. _dependencies: https://github.com/lcpz/lain/wiki#dependencies
+.. _mail: https://github.com/lcpz/lain/wiki/mail
+.. _weather: https://github.com/lcpz/lain/wiki/weather

freedesktop

@@ -1 +1 @@
-Subproject commit 6951b09b9813a8c98c9927d8b1f78b710b8c993c
+Subproject commit b77dee0250599b2810efadf34f612f32c7ceb556

lain

@@ -1 +1 @@
-Subproject commit 33c0e0c2360a04fcc6f51bccb0ad2a7a9e9c07b3
+Subproject commit da418f2ec60672d4fa3ce3cb2087e16292fa0adf

themes/blackburn/theme.lua

@@ -93,7 +93,7 @@ theme.cal = lain.widget.cal({
 })
 
 -- Mail IMAP check
---[[ commented because it needs to be set before use
+--[[ to be set before use
 theme.mail = lain.widget.imap({
     timeout  = 180,
     server   = "server",
@@ -178,13 +178,16 @@ theme.volume = lain.widget.alsa({
 })
 
 -- Weather
+--[[ to be set before use
 theme.weather = lain.widget.weather({
+    --APPID = 
     city_id = 2643743, -- placeholder (London)
     settings = function()
         units = math.floor(weather_now["main"]["temp"])
         widget:set_markup(" " .. units .. " ")
     end
 })
+--]]
 
 -- Separators
 local first     = wibox.widget.textbox('<span font="Terminus 4"> </span>')
@@ -262,8 +265,8 @@ function theme.at_screen_connect(s)
             first,
             theme.mpd.widget,
             --theme.mail.widget,
-            theme.weather.icon,
+            --theme.weather.icon,
-            theme.weather.widget,
+            --theme.weather.widget,
             --theme.fs.widget,
             bat,
             theme.volume.widget,

themes/copland/theme.lua

@@ -109,7 +109,7 @@ theme.cal = lain.widget.cal({
 })
 
 -- Mail IMAP check
---[[ commented because it needs to be set before use
+--[[ to be set before use
 theme.mail = lain.widget.imap({
     timeout  = 180,
     server   = "server",
@@ -279,9 +279,12 @@ local volumebg = wibox.container.background(theme.volume.bar, "#474747", gears.s
 local volumewidget = wibox.container.margin(volumebg, dpi(2), dpi(7), dpi(4), dpi(4))
 
 -- Weather
+--[[ to be set before use
 theme.weather = lain.widget.weather({
+    --APPID = 
     city_id = 2643743, -- placeholder (London)
 })
+--]]
 
 -- Separators
 local first     = wibox.widget.textbox(markup.font("Terminus 3", " "))