doc: Add a section for utility libraries

Dedicated for the modules extensions developers will need, but that the
general "I only edit rc.lua" user wont.

docs/config.ld

@@ -95,6 +95,7 @@ new_type("containermod", "Widget containers", true)
 new_type("layoutmod"   , "Widget layouts"   , true)
 new_type("coreclassmod", "Core components"  , true)
 new_type("popupmod"    , "Popups and bars"  , true)
+new_type("utillib"     , "Utility libraries", true)
 
 file = {
     -- C parts of libraries

lib/gears/debug.lua

@@ -1,7 +1,7 @@
 ---------------------------------------------------------------------------
 -- @author Uli Schlachter
 -- @copyright 2010 Uli Schlachter
--- @module gears.debug
+-- @utillib gears.debug
 ---------------------------------------------------------------------------
 
 local tostring = tostring

lib/gears/filesystem.lua

@@ -1,7 +1,7 @@
 ---------------------------------------------------------------------------
 --- Filesystem module for gears
 --
--- @module gears.filesystem
+-- @utillib gears.filesystem
 ---------------------------------------------------------------------------
 
 -- Grab environment we need

lib/gears/geometry.lua

@@ -7,7 +7,7 @@
 --
 -- @author Julien Danjou <julien@danjou.info>
 -- @copyright 2008 Julien Danjou
--- @module gears.geometry
+-- @utillib gears.geometry
 ---------------------------------------------------------------------------
 local math = math
 

lib/gears/math.lua

@@ -1,7 +1,7 @@
 ---------------------------------------------------------------------------
 --- Math module for gears
 --
--- @module gears.math
+-- @utillib gears.math
 ---------------------------------------------------------------------------
 
 local rtable = table

lib/gears/object.lua

@@ -6,7 +6,7 @@
 --
 -- @author Uli Schlachter
 -- @copyright 2010 Uli Schlachter
--- @classmod gears.object
+-- @utillib gears.object
 ---------------------------------------------------------------------------
 
 local setmetatable = setmetatable

lib/gears/protected_call.lua

@@ -1,7 +1,7 @@
 ---------------------------------------------------------------------------
 -- @author Uli Schlachter
 -- @copyright 2016 Uli Schlachter
--- @module gears.protected_call
+-- @utillib gears.protected_call
 ---------------------------------------------------------------------------
 
 local gdebug = require("gears.debug")

lib/gears/sort/init.lua

@@ -1,7 +1,7 @@
 ---------------------------------------------------------------------------
 --- Extra sorting algorithms.
 --
--- @module gears.sort
+-- @utillib gears.sort
 ---------------------------------------------------------------------------
 
 return {

lib/gears/string.lua

@@ -1,7 +1,7 @@
 ---------------------------------------------------------------------------
 --- String module for gears
 --
--- @module gears.string
+-- @utillib gears.string
 ---------------------------------------------------------------------------
 
 local gstring = {}

lib/gears/table.lua

@@ -1,7 +1,7 @@
 ---------------------------------------------------------------------------
 --- Table module for gears
 --
--- @module gears.table
+-- @utillib gears.table
 ---------------------------------------------------------------------------
 
 

lib/gears/wallpaper.lua

@@ -20,7 +20,7 @@
 --
 -- @author Uli Schlachter
 -- @copyright 2012 Uli Schlachter
--- @module gears.wallpaper
+-- @utillib gears.wallpaper
 ---------------------------------------------------------------------------
 
 local cairo = require("lgi").cairo