doc: Fix some regression introduced when fixing the shims behavior.

Previously, clients were displayed even when they were not tagged
or minimized. This was fixed in the shims. However, some examples
never created tags, so the client were never tagged, thus no longer
displayed.

tests/examples/awful/mouse/coords.lua

@@ -1,4 +1,5 @@
 --DOC_GEN_OUTPUT --DOC_GEN_IMAGE --DOC_HIDE
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {x = 175, width = 128, height = 96} --DOC_HIDE
 mouse.coords {x=175+60,y=60} --DOC_HIDE
 

tests/examples/awful/placement/aero_snap.lua

@@ -5,6 +5,10 @@ screen[1]._resize {width = 180, height = 120} --DOC_HIDE
 screen._add_screen {x = 190, y = 0, width = 180, height = 120} --DOC_HIDE
 screen._add_screen {x = 380, y = 0, width = 180, height = 120} --DOC_HIDE
 
+for s in screen do
+    require("awful.tag").add("1", {screen=s, selected=true}) --DOC_HIDE
+end
+
 for _, pos in ipairs{"left", "right"} do
     local c1 = client.gen_fake {x = 80, y = 55, width=78, height=50}
     placement.align(client.focus, {position = pos, honor_workarea=true})

tests/examples/awful/placement/align.lua

@@ -1,6 +1,7 @@
 --DOC_HIDE_ALL
 --DOC_GEN_IMAGE
 local placement = require("awful.placement")
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {x= 50}
 for _, pos in ipairs{
     "top_left", "top_right", "bottom_left", "bottom_right",
@@ -14,6 +15,8 @@ end
 
 screen._add_screen {x = 70, y = 260  , width = 128, height = 96}
 screen._add_screen {x = 210, y = 260  , width = 128, height = 96}
+require("awful.tag").add("1", {screen=screen[2], selected=true}) --DOC_HIDE
+require("awful.tag").add("1", {screen=screen[3], selected=true}) --DOC_HIDE
 
 local c
 

tests/examples/awful/placement/bottom.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.bottom --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/bottom_left.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.bottom_left --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/bottom_right.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.bottom_right --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/center_horizontal.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.center_horizontal --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/center_vertical.lua

@@ -4,6 +4,7 @@
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER
 -- @staticfct awful.placement.center_vertical --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 --[[local c = ]]client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/centered.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.centered --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/closest_mouse.lua

@@ -1,6 +1,7 @@
 --DOC_GEN_OUTPUT --DOC_GEN_IMAGE --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 local c = client.gen_fake {x = 20, y = 20, width= 280, height=200, screen =screen[1]} --DOC_HIDE
 local bw = c.border_width --DOC_HIDE
 

tests/examples/awful/placement/compose.lua

@@ -1,4 +1,5 @@
 --DOC_GEN_IMAGE --DOC_HIDE
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {x = 175, width = 128, height = 96} --DOC_NO_USAGE --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 220, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/compose2.lua

@@ -1,4 +1,5 @@
 --DOC_GEN_IMAGE --DOC_HIDE
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {x = 175, width = 128, height = 96} --DOC_NO_USAGE --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 220, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/left.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.left --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/maximize.lua

@@ -2,6 +2,11 @@
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 screen._add_screen {x = 140, y = 0, width = 128, height = 96} --DOC_HIDE
 screen._add_screen {x = 280, y = 0, width = 128, height = 96} --DOC_HIDE
+
+for s in screen do --DOC_HIDE
+    require("awful.tag").add("1", {screen=s, selected=true}) --DOC_HIDE
+end --DOC_HIDE
+
 local placement = require("awful.placement") --DOC_HIDE
 
 for k, pos in ipairs{ --DOC_HIDE

tests/examples/awful/placement/maximize_horizontally.lua

@@ -4,6 +4,7 @@
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER
 -- @staticfct awful.placement.maximize_horizontally --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local placement = require("awful.placement") --DOC_HIDE
 

tests/examples/awful/placement/maximize_vertically.lua

@@ -4,6 +4,7 @@
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER
 -- @staticfct awful.placement.maximize_vertically --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local placement = require("awful.placement") --DOC_HIDE
 

tests/examples/awful/placement/next_to.lua

@@ -1,5 +1,7 @@
 --DOC_GEN_IMAGE --DOC_HIDE
 local awful = { placement = require("awful.placement") }--DOC_HIDE
+
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {x= 0, width = 640, height=200} --DOC_HIDE
 
 local parent_client = client.gen_fake {x = 0, y = 0, width=350, height=70} --DOC_HIDE

tests/examples/awful/placement/next_to_mouse.lua

@@ -1,4 +1,5 @@
 --DOC_GEN_IMAGE --DOC_HIDE
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 client.gen_fake {x = 10, y = 10, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/no_offscreen.lua

@@ -1,6 +1,8 @@
 --DOC_GEN_OUTPUT --DOC_GEN_IMAGE --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
+
 --DOC_HIDE no_offscreen is auto-called when startup is true, avoid this.
 awesome.startup = false -- luacheck: globals awesome.startup --DOC_HIDE
 

tests/examples/awful/placement/no_overlap.lua

@@ -1,4 +1,5 @@
 --DOC_GEN_IMAGE --DOC_HIDE
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 screen._add_screen {x = 140, y = 0  , width = 128, height = 96} --DOC_HIDE
 screen._add_screen {x = 0  , y = 110, width = 128, height = 96} --DOC_HIDE

tests/examples/awful/placement/resize_to_mouse.lua

@@ -2,9 +2,12 @@
 --DOC_GEN_IMAGE
 local awful = {placement = require("awful.placement")}
 local unpack = unpack or table.unpack -- luacheck: globals unpack (compatibility with Lua 5.1)
-
 screen._setup_grid(64, 48, {4, 4, 4, 4}, {workarea_sides=0})
 
+for s in screen do
+    require("awful.tag").add("1", {screen=s, selected=true}) --DOC_HIDE
+end
+
 local function test_touch_mouse(c)
     local coords = mouse.coords()
 

tests/examples/awful/placement/right.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.right --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/skip_fullscreen-no_fullscreen.lua

@@ -1,6 +1,8 @@
 --DOC_GEN_OUTPUT --DOC_GEN_IMAGE --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
+
 --DOC_HIDE no_offscreen is auto-called when startup is true, avoid this.
 awesome.startup = false -- luacheck: globals awesome.startup --DOC_HIDE
 

tests/examples/awful/placement/skip_fullscreen.lua

@@ -1,5 +1,6 @@
 --DOC_GEN_OUTPUT --DOC_GEN_IMAGE --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 
 --DOC_HIDE no_offscreen is auto-called when startup is true, avoid this.
 awesome.startup = false -- luacheck: globals awesome.startup --DOC_HIDE

tests/examples/awful/placement/stretch.lua

@@ -4,6 +4,9 @@ screen[1]._resize {width = 128, height = 96}
 screen._add_screen {x = 140, y = 0  , width = 128, height = 96}
 screen._add_screen {x = 0  , y = 110, width = 128, height = 96}
 screen._add_screen {x = 140, y = 110, width = 128, height = 96}
+for s in screen do
+    require("awful.tag").add("1", {screen=s, selected=true})
+end
 local placement = require("awful.placement")
 
 for k, pos in ipairs{

tests/examples/awful/placement/stretch_down.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.stretch_down --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local placement = require("awful.placement") --DOC_HIDE
 

tests/examples/awful/placement/stretch_left.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.stretch_left --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local placement = require("awful.placement") --DOC_HIDE
 

tests/examples/awful/placement/stretch_right.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.stretch_right --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local placement = require("awful.placement") --DOC_HIDE
 

tests/examples/awful/placement/stretch_up.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.stretch_up --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local placement = require("awful.placement") --DOC_HIDE
 

tests/examples/awful/placement/top.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.top --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/top_left.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.top_left --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/top_right.lua

@@ -5,6 +5,7 @@
 -- @treturn table The new geometry --DOC_HEADER
 -- @staticfct awful.placement.top_right --DOC_HEADER
 
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE

tests/examples/awful/placement/under_mouse.lua

@@ -1,4 +1,5 @@
 --DOC_GEN_IMAGE --DOC_HIDE
+require("awful.tag").add("1", {screen=screen[1], selected=true}) --DOC_HIDE
 screen[1]._resize {width = 128, height = 96} --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 client.gen_fake {x = 10, y = 10, width=40, height=30} --DOC_HIDE

tests/examples/awful/titlebar/constructor.lua

@@ -5,6 +5,8 @@ local awful = { titlebar = require("awful.titlebar"),
 local beautiful = require("beautiful")
 local wibox = require("wibox")
 
+require("awful.tag").add("1", {screen=screen[1], selected = true})
+
 screen[1]._resize { width = 646, height = 182 }
 
 local c
@@ -38,27 +40,31 @@ c = clients[1]
 setup(
 --DOC_HIDE_END
 
-    -- Create default titlebar
+    -- Create default titlebar.
     awful.titlebar(c)
 
+--DOC_NEWLINE
 --DOC_HIDE_START
 )
 
+
 c = clients[2]
 setup(
 --DOC_HIDE_END
 
-    -- Create titlebar on the client's bottom edge
+    -- Create titlebar on the client's bottom edge.
     awful.titlebar(c, { position = "bottom" })
 
 --DOC_HIDE_START
 )
 
+
 c = clients[3]
 setup(
 --DOC_HIDE_END
+--DOC_NEWLINE
 
-    -- Create titlebar with inverted colors
+    -- Create titlebar with inverted colors.
     awful.titlebar(c, { bg_normal = beautiful.fg_normal, fg_normal = beautiful.bg_normal })
 
 --DOC_HIDE_START

tests/examples/awful/titlebar/default.lua

@@ -1,14 +1,19 @@
---DOC_GEN_IMAGE --DOC_HIDE
+--DOC_GEN_IMAGE
 --DOC_NO_USAGE
-local place = require("awful.placement") --DOC_HIDE
-local awful = { titlebar = require("awful.titlebar"), --DOC_HIDE
-                button   = require("awful.button"), --DOC_HIDE
-              } --DOC_HIDE
-local wibox = require("wibox") --DOC_HIDE
-local gears = {table = require("gears.table")} --DOC_HIDE
+--DOC_HIDE_START
+local place = require("awful.placement")
+local awful = { titlebar = require("awful.titlebar"),
+                button   = require("awful.button"),
+                tag      = require("awful.tag"),
+              }
+local wibox = require("wibox")
+local gears = {table = require("gears.table")}
 
-local c = client.gen_fake {hide_first=true} --DOC_HIDE
-place.maximize(c, {honor_padding=true, honor_workarea=true}) --DOC_HIDE
+awful.tag.add("1", {screen=screen[1], selected = true})
+
+local c = client.gen_fake {hide_first=true}
+place.maximize(c, {honor_padding=true, honor_workarea=true})
+--DOC_HIDE_END
 
     -- Create a titlebar for the client.
     -- By default, `ruled.client` will create one, but all it does is to call this
@@ -19,6 +24,8 @@ place.maximize(c, {honor_padding=true, honor_workarea=true}) --DOC_HIDE
         bg_normal = "#ff0000",
     })
 
+    --DOC_NEWLINE
+
     -- buttons for the titlebar
     local buttons = gears.table.join(
         awful.button({ }, 1, function()
@@ -33,7 +40,9 @@ place.maximize(c, {honor_padding=true, honor_workarea=true}) --DOC_HIDE
         end)
     )
 
-    top_titlebar : setup {
+    --DOC_NEWLINE
+
+    top_titlebar.widget = {
         { -- Left
             awful.titlebar.widget.iconwidget(c),
             buttons = buttons,
@@ -59,3 +68,4 @@ place.maximize(c, {honor_padding=true, honor_workarea=true}) --DOC_HIDE
     }
 
 --DOC_HIDE vim: filetype=lua:expandtab:shiftwidth=4:tabstop=8:softtabstop=4:textwidth=80
+