diff --git a/lib/awful/tag.lua b/lib/awful/tag.lua
index f7168bf5..23f7cfe3 100644
--- a/lib/awful/tag.lua
+++ b/lib/awful/tag.lua
@@ -312,7 +312,7 @@ end
 --
 -- @staticfct awful.tag.new
 -- @tparam table names The tag name, in a table
--- @tparam screen|nil screen The tag screen, or 1 if not set.
+-- @tparam[opt=1] screen|number screen The tag screen (defaults to screen 1).
 -- @tparam table layout The layout or layout table to set for this tags by default.
 -- @treturn table A table with all created tags.
 function tag.new(names, screen, layout)
@@ -918,7 +918,7 @@ end
 --
 --        if (not c2) or c2 == c then return end
 --
---        local t = aw_tag.add("Aero", {
+--        local t = awful.tag.add("Aero", {
 --            screen              = c.screen,
 --            volatile            = true,
 --            layout              = awful.layout.suit.tile,
diff --git a/objects/tag.c b/objects/tag.c
index f06e0169..729cfe29 100644
--- a/objects/tag.c
+++ b/objects/tag.c
@@ -19,7 +19,7 @@
  *
  */
 
-/** awesome tag API
+ /** awesome tag API.
  *
  * What is a tag?
  * ==============
diff --git a/tests/examples/sequences/tag/new_with_layouts.lua b/tests/examples/sequences/tag/new_with_layouts.lua
index 7d6e0c39..8ba00cfe 100644
--- a/tests/examples/sequences/tag/new_with_layouts.lua
+++ b/tests/examples/sequences/tag/new_with_layouts.lua
@@ -20,7 +20,6 @@ module.add_event("Calling awful.tag.new", function() --DOC_HIDE
         awful.layout.suit.spiral.dwindle,
         awful.layout.suit.magnifier,
         awful.layout.suit.corner.nw,
-        awful.layout.suit.max.fullscreen,
     }
 
     --DOC_NEWLINE