doc: Add a section for the important classes.

The choice is very subjective, but at least they stand out.

docs/config.ld

@@ -93,6 +93,7 @@ sort_modules=true
 new_type("widgetmod"   , "Widgets"   , true)
 new_type("containermod", "Widget containers", true)
 new_type("layoutmod"   , "Widget layouts"   , true)
+new_type("coreclassmod", "Core components"  , true)
 
 file = {
     -- C parts of libraries

lib/awful/keygrabber.lua

@@ -60,7 +60,7 @@
 -- @author Emmanuel Lepage Vallee <elv1313@gmail.com>
 -- @copyright 2012 dodo
 -- @copyright 2017 Emmanuel Lepage Vallee
--- @classmod awful.keygrabber
+-- @coreclassmod awful.keygrabber
 ---------------------------------------------------------------------------
 
 local ipairs = ipairs
@@ -731,7 +731,6 @@ end
 -- @return the given callback `g`.
 --
 -- @deprecated awful.keygrabber.run
--- @see keygrabber.run
 
 --- A lower level API to interact with the keygrabber directly.
 --

lib/gears/timer.lua

@@ -46,7 +46,7 @@
 --
 -- @author Uli Schlachter
 -- @copyright 2014 Uli Schlachter
--- @classmod gears.timer
+-- @coreclassmod gears.timer
 ---------------------------------------------------------------------------
 
 local capi = { awesome = awesome }

lib/naughty/notification.lua

@@ -13,7 +13,7 @@
 -- @author Emmanuel Lepage Vallee
 -- @copyright 2008 koniu
 -- @copyright 2017 Emmanuel Lepage Vallee
--- @classmod naughty.notification
+-- @coreclassmod naughty.notification
 ---------------------------------------------------------------------------
 local gobject = require("gears.object")
 local gtable  = require("gears.table")

lib/wibox/init.lua

@@ -1,7 +1,7 @@
 ---------------------------------------------------------------------------
 -- @author Uli Schlachter
 -- @copyright 2010 Uli Schlachter
--- @classmod wibox
+-- @coreclassmod wibox
 ---------------------------------------------------------------------------
 
 local capi = {

mouse.c

@@ -57,7 +57,7 @@
  *
  * @author Julien Danjou <julien@danjou.info>
  * @copyright 2008-2009 Julien Danjou
- * @module mouse
+ * @coreclassmod mouse
  */
 
 #include "mouse.h"

mousegrabber.c

@@ -22,7 +22,7 @@
 /** awesome mousegrabber API
  * @author Julien Danjou <julien@danjou.info>
  * @copyright 2008-2009 Julien Danjou
- * @module mousegrabber
+ * @coreclassmod mousegrabber
  */
 
 #include "mousegrabber.h"

objects/button.c

@@ -30,7 +30,7 @@
  *
  * @author Julien Danjou <julien@danjou.info>
  * @copyright 2008-2009 Julien Danjou
- * @classmod button
+ * @coreclassmod button
  */
 
 #include "button.h"

objects/client.c

@@ -84,7 +84,7 @@
  *
  * @author Julien Danjou <julien@danjou.info>
  * @copyright 2008-2009 Julien Danjou
- * @classmod client
+ * @coreclassmod client
  */
 
 #include "objects/client.h"

objects/drawable.c

@@ -27,7 +27,7 @@
  *
  * @author Uli Schlachter <psychon@znc.in>
  * @copyright 2012 Uli Schlachter
- * @classmod drawable
+ * @coreclassmod drawable
  */
 
 #include "drawable.h"

objects/key.c

@@ -31,7 +31,7 @@
  *
  * @author Julien Danjou <julien@danjou.info>
  * @copyright 2008-2009 Julien Danjou
- * @classmod key
+ * @coreclassmod key
  */
 
 #include "objects/key.h"

objects/screen.c

@@ -42,7 +42,7 @@
  *
  * @author Julien Danjou <julien@danjou.info>
  * @copyright 2008-2009 Julien Danjou
- * @classmod screen
+ * @coreclassmod screen
  */
 
 #include "objects/screen.h"

objects/tag.c

@@ -180,7 +180,7 @@
  *
  * @author Julien Danjou <julien@danjou.info>
  * @copyright 2008-2009 Julien Danjou
- * @classmod tag
+ * @coreclassmod tag
  */
 
 #include "tag.h"

root.c

@@ -22,7 +22,7 @@
 /** awesome root window API
  * @author Julien Danjou <julien@danjou.info>
  * @copyright 2008-2009 Julien Danjou
- * @module root
+ * @coreclassmod root
  */
 
 #include "globalconf.h"