Docs: Use LDoc markdown support, exclude files.

Use markdown support, which is bundled together with LDoc.

Also, add a macro for the client type, which will simplify parameter
definitions. With this we can write `@client` instead of `@tparam
client` in order to denote that the parameter needs to be a client
structure. This simplifies `awful.client` module.

This also excludes some of the `.lua` files from generating the
documentation, because some of the files do not contain useful
information or any public functions at all. This make the docs easier to
navigate.

Remove layouts from documentation

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: Port awful.rules into the new doc format.

This converts the old documentation style into the new one to use
markdown instead of HTML in bigger doc blocks. Also, we can use block
comments, which means that writting documentation (and indenting code
blocks) easier.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Fix LDoc errors on generating the documentation.

This also at the same time ports the documentation to the new `Markdown`
format.
Docs: Start gears.color refactoring

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

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: general C API fixes

This contains general C API fixes:

    1) Remove module declarations in LUA and use the @module directives

    2) Fix indentation/usage where necessary

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: Begin work on awful.client

This fixes usage and some and client parameter types.
Docs: awful.layouts fixup

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: General work on gears module.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: Fix headers for the wibox module

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: General work on the awful module.

This is basically an initial stab for some modules and some
experimenting with the `@classmod` directive.

For most of the docs only basic transforming was done.

At the moment the tooltip module looks the best.

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

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: Ignore awful.widget.common

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: merge PATCHES, STYLE, BUGS into CONTRIBUTING.md

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: Minor fixes to the README

Fix some syntax, so that we have the sections separated by empty lines
(my pandoc syntax plugin was not working correctly without it). Also,
add a sentence on the CONTRIBUTING guide.

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: Fix the header for beautiful

Signed-off-by: Ignas Anikevicius (gns_ank) <anikevicius@gmail.com>
Docs: update config.ld.in

Include more files in order to generate the docs.

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