Docs: awful.layouts fixup

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

lib/awful/layout/init.lua.in

@@ -1,7 +1,10 @@
 ---------------------------------------------------------------------------
+--- Layout module for awful
+--
 -- @author Julien Danjou <julien@danjou.info>
 -- @copyright 2008 Julien Danjou
 -- @release @AWESOME_VERSION@
+-- @module awful.layout
 ---------------------------------------------------------------------------
 
 -- Grab environment we need
@@ -18,9 +21,11 @@ local capi = {
 local client = require("awful.client")
 local timer = require("gears.timer")
 
---- Layout module for awful
--- awful.layout
 local layout = {}
+
+--- Default predefined layouts
+--
+-- @fixme Add documentation on available layouts as all of them are hidden
 layout.suit = require("awful.layout.suit")
 
 -- The default list of layouts

lib/awful/layout/suit/fair.lua.in

@@ -1,15 +1,16 @@
 ---------------------------------------------------------------------------
+--- Fair layouts module for awful
+--
 -- @author Josh Komoroske
 -- @copyright 2012 Josh Komoroske
 -- @release @AWESOME_VERSION@
+-- @module awful.layout.suit.fair
 ---------------------------------------------------------------------------
 
 -- Grab environment we need
 local ipairs = ipairs
 local math = math
 
---- Fair layouts module for awful
--- awful.layout.suit.fair
 local fair = {}
 
 local function do_fair(p, orientation)

lib/awful/layout/suit/floating.lua.in

@@ -1,10 +1,12 @@
 ---------------------------------------------------------------------------
+--- Dummy function for floating layout
+--
 -- @author Gregor Best
 -- @copyright 2008 Gregor Best
 -- @release @AWESOME_VERSION@
+-- @module awful.layout.suit.floating
 ---------------------------------------------------------------------------
 
---- Dummy function for floating layout
 -- Grab environment we need
 local math = math
 local ipairs = ipairs
@@ -14,7 +16,6 @@ local capi =
     mousegrabber = mousegrabber
 }
 
--- awful.layout.suit.floating
 local floating = {}
 
 function floating.mouse_resize_handler(c, corner, x, y)

lib/awful/layout/suit/init.lua.in

@@ -1,11 +1,11 @@
 ---------------------------------------------------------------------------
+--- Suits for awful
 -- @author Julien Danjou <julien@danjou.info>
 -- @copyright 2008 Julien Danjou
 -- @release @AWESOME_VERSION@
+-- @module awful.layout.suit
 ---------------------------------------------------------------------------
 
---- Suits for awful
-
 return
 {
     max = require("awful.layout.suit.max");

lib/awful/layout/suit/magnifier.lua.in

@@ -1,7 +1,10 @@
 ---------------------------------------------------------------------------
+--- Magnifier layout module for awful
+--
 -- @author Julien Danjou <julien@danjou.info>
 -- @copyright 2008 Julien Danjou
 -- @release @AWESOME_VERSION@
+-- @module awful.layout.suit.magnifier
 ---------------------------------------------------------------------------
 
 -- Grab environment we need
@@ -17,8 +20,6 @@ local capi =
 }
 local client = require("awful.client")
 
---- Magnifier layout module for awful
--- awful.layout.suit.magnifier
 local magnifier = {}
 
 function magnifier.mouse_resize_handler(c, corner, x, y)

lib/awful/layout/suit/max.lua.in

@@ -1,15 +1,16 @@
 ---------------------------------------------------------------------------
+--- Maximized and fullscreen layouts module for awful
+--
 -- @author Julien Danjou <julien@danjou.info>
 -- @copyright 2008 Julien Danjou
 -- @release @AWESOME_VERSION@
+-- @module awful.layout.suit.max
 ---------------------------------------------------------------------------
 
 -- Grab environment we need
 local pairs = pairs
 local client = require("awful.client")
 
---- Maximized and fullscreen layouts module for awful
--- awful.layout.suit.max
 local max = {}
 
 local function fmax(p, fs)

lib/awful/layout/suit/spiral.lua.in

@@ -1,15 +1,18 @@
 ---------------------------------------------------------------------------
+--- Dwindle and spiral layouts
+--
 -- @author Uli Schlachter <psychon@znc.in>
 -- @copyright 2009 Uli Schlachter
 -- @copyright 2008 Julien Danjou
 -- @release @AWESOME_VERSION@
+--
+-- @module awful.layout.suit.spiral
 ---------------------------------------------------------------------------
 
 -- Grab environment we need
 local ipairs = ipairs
 local math = math
 
--- awful.layout.suit.spiral
 local spiral = {}
 
 local function do_spiral(p, _spiral)

lib/awful/layout/suit/tile.lua.in

@@ -1,9 +1,12 @@
 ---------------------------------------------------------------------------
+--- Tiled layouts module for awful
+--
 -- @author Donald Ephraim Curtis <dcurtis@cs.uiowa.edu>
 -- @author Julien Danjou <julien@danjou.info>
 -- @copyright 2009 Donald Ephraim Curtis
 -- @copyright 2008 Julien Danjou
 -- @release @AWESOME_VERSION@
+-- @module awful.layout.suit.tile
 ---------------------------------------------------------------------------
 
 -- Grab environment we need
@@ -18,8 +21,6 @@ local capi =
     mousegrabber = mousegrabber
 }
 
---- Tiled layouts module for awful
--- awful.layout.suit.tile
 local tile = {}
 
 local function mouse_resize_handler(c, corner, x, y, orientation)