diff --git a/lib/awful/widget/taglist.lua b/lib/awful/widget/taglist.lua
index a384ed1d..4845a1de 100644
--- a/lib/awful/widget/taglist.lua
+++ b/lib/awful/widget/taglist.lua
@@ -425,7 +425,7 @@ end
 --   update. See `awful.widget.common`.
 -- @tparam[opt] widget args.layout Optional layout widget for tag widgets. Default
 --   is wibox.layout.fixed.horizontal().
--- @tparam[opt=awful.taglist.source.for_screen] function args.source The
+-- @tparam[opt=awful.widget.taglist.source.for_screen] function args.source The
 --  function used to generate the list of tag.
 -- @tparam[opt] table args.widget_template A custom widget to be used for each tag
 -- @tparam[opt={}] table args.style The style overrides default theme.
@@ -462,7 +462,7 @@ end
 -- @param style **DEPRECATED** use args.style
 -- @param update_function **DEPRECATED** use args.update_function
 -- @param base_widget **DEPRECATED** use args.base_widget
--- @function awful.taglist
+-- @function awful.widget.taglist
 function taglist.new(args, filter, buttons, style, update_function, base_widget)
 
     local screen = nil
@@ -566,7 +566,7 @@ end
 --- Filtering function to include all nonempty tags on the screen.
 -- @param t The tag.
 -- @return true if t is not empty, else false
--- @filterfunction awful.taglist.filter.noempty
+-- @filterfunction awful.widget.taglist.filter.noempty
 function taglist.filter.noempty(t)
     return #t:clients() > 0 or t.selected
 end
@@ -574,14 +574,14 @@ end
 --- Filtering function to include selected tags on the screen.
 -- @param t The tag.
 -- @return true if t is not empty, else false
--- @filterfunction awful.taglist.filter.selected
+-- @filterfunction awful.widget.taglist.filter.selected
 function taglist.filter.selected(t)
     return t.selected
 end
 
 --- Filtering function to include all tags on the screen.
 -- @return true
--- @filterfunction awful.taglist.filter.all
+-- @filterfunction awful.widget.taglist.filter.all
 function taglist.filter.all()
     return true
 end
@@ -590,7 +590,7 @@ end
 --
 -- This is the default source.
 --
--- @sourcefunction awful.taglist.source.for_screen
+-- @sourcefunction awful.widget.taglist.source.for_screen
 -- @see screen
 function taglist.source.for_screen(s)
     return s.tags