update from master

_widgets/battery-widget.md

@@ -38,7 +38,7 @@ It is possible to customize widget by providing a table with all or some of the
 | `warning_msg_icon` | ~/.config/awesome/awesome-wm-widgets/battery-widget/spaceman.jpg | Icon of the warning popup |
 | `enable_battery_warning` | `true` | Display low battery warning |
 
-*Note: the widget expects following icons be present in the folder:
+*Note: the widget expects following icons to be present in the folder:
 
  - battery-caution-charging-symbolic.svg
  - battery-empty-charging-symbolic.svg
@@ -56,6 +56,7 @@ It is possible to customize widget by providing a table with all or some of the
 ## Installation
 
 This widget reads the output of acpi tool.
+
 - install `acpi` and check the output:
 
 ```bash

_widgets/calendar-widget.md

@@ -12,9 +12,9 @@ Calendar widget for Awesome WM - slightly improved version of the `wibox.widget.
 
 | Name | Default | Description |
 |---|---|---|
-| theme     | `naughty` | The theme to use          |
-| placement | `top`     | The position of the popup |
-| radius    |  8        | The popup radius          |
+| theme        | `naughty` | The theme to use          |
+| placement    | `top`     | The position of the popup |
+| radius       |  8        | The popup radius          |
 | start_sunday | false  | Start the week on Sunday  |
 
  - themes:

_widgets/cmus-widget.md

@@ -34,7 +34,10 @@ s.mytasklist, -- Middle widget
 To improve responsiveness of the widget when playback is changed by a shortcut use corresponding methods of the widget:
 
 ```lua
-awful.key({ modkey, "Shift"   }, "p", function () cmus_widget:play_pause() end, {description = "play/pause cmus", group = "custom"}),
+awful.key({ modkey, "Shift"   }, 
+        "p", 
+        function() cmus_widget:play_pause() end, 
+        {description = "play/pause cmus", group = "custom"}),
 ```
 
 ## Customization

_widgets/logout-menu-widget.md

@@ -9,7 +9,7 @@ This widget shows a menu with options to log out from the current session, lock,
 
 ## Installation
 
-Clone this repo (if not cloned yet) **./.config/awesome/**
+Clone this repo (if not cloned yet) under **./.config/awesome/**
 
 ```bash
 cd ./.config/awesome/