diff --git a/tests/examples/awful/placement/maximize_horizontally.lua b/tests/examples/awful/placement/maximize_horizontally.lua
new file mode 100644
index 000000000..dd06ab3a6
--- /dev/null
+++ b/tests/examples/awful/placement/maximize_horizontally.lua
@@ -0,0 +1,15 @@
+-- Horizontally maximize the drawable in the parent area. --DOC_HEADER
+-- @tparam drawable d A drawable (like `client` or `wibox`) --DOC_HEADER
+-- @tparam[opt={}] table args Other arguments") --DOC_HEADER
+-- @name maximize_horizontally --DOC_HEADER
+-- @class function --DOC_HEADER
+
+screen[1]._resize {width = 128, height = 96} --DOC_HIDE
+local placement = require("awful.placement") --DOC_HIDE
+
+local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE
+placement.maximize_horizontally(c)
+
+assert(c.width + 2*c.border_width == screen[1].geometry.width) --DOC_HIDE
+assert(c.y == 35) --DOC_HIDE
+assert(c.height == 30) --DOC_HIDE
diff --git a/tests/examples/awful/placement/maximize_vertically.lua b/tests/examples/awful/placement/maximize_vertically.lua
new file mode 100644
index 000000000..8ecdfec21
--- /dev/null
+++ b/tests/examples/awful/placement/maximize_vertically.lua
@@ -0,0 +1,15 @@
+-- Vetically maximize the drawable in the parent area. --DOC_HEADER
+-- @tparam drawable d A drawable (like `client` or `wibox`) --DOC_HEADER
+-- @tparam[opt={}] table args Other arguments") --DOC_HEADER
+-- @name maximize_vertically --DOC_HEADER
+-- @class function --DOC_HEADER
+
+screen[1]._resize {width = 128, height = 96} --DOC_HIDE
+local placement = require("awful.placement") --DOC_HIDE
+
+local c = client.gen_fake {x = 45, y = 35, width=40, height=30} --DOC_HIDE
+placement.maximize_vertically(c)
+
+assert(c.height+2*c.border_width == screen[1].geometry.height)--DOC_HIDE
+assert(c.x == 45) --DOC_HIDE
+assert(c.width == 40) --DOC_HIDE