Update LDoc configuration: enable Markdown.

Enable Markdown and write some exception rules, so that we do not have
empty documentation pages about modules which nobody wants to read about
(like awful.dbus).

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
CAPI docs: convert HTML to Markdown.

This is one of the first of many changes to documentation. We first
start with the core modules.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Make awful docs easier to read

This essentially changes lots of stuff in awful documentation. Use
markdown where necessary and update the formating of the parameters.
Some of the changes are not consistent, but in my opinion it is a move
to the right direction. I hope that it will be easier to maintain stuff
in the future.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Fix drawable docs.

Here I made some refactoring on the drawable side. Not much was needed.
in this stage.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Wibox doc fixes.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Fix Menubar docs

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Naughty docs fixes.

Here I have done more than just refactoring docs, I have moved most of
the default values from the description of the notify function to the
naughty.config.defaults table description. I hope that the changes are
in the right direction.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Beatiful docs became more beautiful.

This is the same kind of refactoring as awful faced.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>