diff --git a/lib/wibox/container/scroll.lua b/lib/wibox/container/scroll.lua
index 95aae370..08cc64a5 100644
--- a/lib/wibox/container/scroll.lua
+++ b/lib/wibox/container/scroll.lua
@@ -1,4 +1,16 @@
 ---------------------------------------------------------------------------
+-- @usage
+-- wibox.widget {
+--    layout = wibox.container.scroll.horizontal,
+--    max_size = 100,
+--    step_function = wibox.container.scroll.step_functions
+--                    .waiting_nonlinear_back_and_forth,
+--    speed = 100,
+--    {
+--        widget = wibox.widget.textbox,
+--        text = "This is a " .. string.rep("very, ", 10) ..  " very long text",
+--    },
+-- }
 -- @author Uli Schlachter (based on ideas from Saleur Geoffrey)
 -- @copyright 2015 Uli Schlachter
 -- @classmod wibox.container.scroll