Merge pull request #2311 from psychon/example-tests-images

Example tests: Make it explicit what kind of output is expected

tests/examples/CMakeLists.txt

@@ -186,9 +186,7 @@ function(run_test test_path namespace escaped_content)
     get_filename_component(${test_path} TEST_FILE_NAME NAME)
     set(IMAGE_PATH "${IMAGE_DIR}/AUTOGEN${namespace}_${TEST_FILE_NAME}")
 
-    # Execute the script, leave the image extension decision to the test.
-    # SVG is preferred, but PNG is better suited for some tests, like bitmap
-    # patterns.
+    # Execute the script.
     file(RELATIVE_PATH rel_test_path "${TOP_SOURCE_DIR}" "${test_path}")
     message(STATUS "Running ${rel_test_path}…")
 
@@ -217,19 +215,13 @@ function(run_test test_path namespace escaped_content)
     # Build the documentation.
     set(TEST_DOC_CONTENT "${TEST_PRE_HEADER}")
 
-    # If the image has been created, then add it.
-    if(EXISTS "${IMAGE_PATH}.svg")
+    # Does the test generate an output image?
+    if(tmp_content MATCHES "--DOC_GEN_IMAGE")
         set(OUTPUT_IMAGE_PATH "${IMAGE_PATH}.svg")
         escape_string(
             "![Usage example](../images/AUTOGEN${namespace}_${TEST_FILE_NAME}.svg)\n"
             "${TEST_DOC_CONTENT}" TEST_DOC_CONTENT ""
         )
-    elseif(EXISTS "${IMAGE_PATH}.png")
-        set(OUTPUT_IMAGE_PATH "${IMAGE_PATH}.png")
-        escape_string(
-            "![Usage example](../images/AUTOGEN${namespace}_${TEST_FILE_NAME}.png)\n"
-            "${TEST_DOC_CONTENT}" TEST_DOC_CONTENT ""
-        )
     else()
         set(OUTPUT_IMAGE_PATH "")
     endif()
@@ -237,6 +229,9 @@ function(run_test test_path namespace escaped_content)
     # If there is an output, assume it is relevant and add it to the
     # documentation under the image.
     if(NOT ${TEST_OUTPUT} STREQUAL "")
+        if(NOT tmp_content MATCHES "--DOC_GEN_OUTPUT")
+            message(FATAL_ERROR "Unexpected output from ${test_path}: ${TEST_OUTPUT}")
+        endif()
         set(TEST_DOC_CONTENT
             "${TEST_DOC_CONTENT}\n${DOC_LINE_PREFIX}\n${DOC_LINE_PREFIX}**Usage example output**:\n${DOC_LINE_PREFIX}"
         )

tests/examples/awful/mouse/coords.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_OUTPUT --DOC_GEN_IMAGE --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/align.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local placement = require("awful.placement")
 screen[1]._resize {x= 50}
 for _, pos in ipairs{

tests/examples/awful/placement/bottom.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the bottom of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/bottom_left.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the bottom left of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/bottom_right.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the bottom right of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/center_horizontal.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the horizontal center left of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/center_vertical.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the vertical center of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/centered.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the center of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/closest_mouse.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_OUTPUT --DOC_GEN_IMAGE --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 
 local c = client.gen_fake {x = 20, y = 20, width= 280, height=200, screen =screen[1]} --DOC_HIDE

tests/examples/awful/placement/compose.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --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,3 +1,4 @@
+--DOC_GEN_IMAGE --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

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the left of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/maximize.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --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 = 280, y = 0, width = 128, height = 96} --DOC_HIDE

tests/examples/awful/placement/maximize_horizontally.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- 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

tests/examples/awful/placement/maximize_vertically.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- 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

tests/examples/awful/placement/next_to_mouse.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --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,3 +1,4 @@
+--DOC_GEN_OUTPUT --DOC_GEN_IMAGE --DOC_HIDE
 local awful = {placement = require("awful.placement")} --DOC_HIDE
 
 local c = client.gen_fake {x = -30, y = -30, width= 100, height=100} --DOC_HIDE

tests/examples/awful/placement/no_overlap.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --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

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local awful = {placement = require("awful.placement")}
 local unpack = unpack or table.unpack -- luacheck: globals unpack (compatibility with Lua 5.1)
 

tests/examples/awful/placement/right.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the right of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/stretch.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 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}

tests/examples/awful/placement/stretch_down.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Stretch the drawable to the bottom of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments --DOC_HEADER

tests/examples/awful/placement/stretch_left.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Stretch the drawable to the left of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments --DOC_HEADER

tests/examples/awful/placement/stretch_right.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Stretch the drawable to the right of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments --DOC_HEADER

tests/examples/awful/placement/stretch_up.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Stretch the drawable to the top of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments --DOC_HEADER

tests/examples/awful/placement/top.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the top of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/top_left.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the top left of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/top_right.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 -- Align a client to the top right of the parent area. --DOC_HEADER
 -- @tparam drawable d A drawable (like `client`, `mouse` or `wibox`) --DOC_HEADER
 -- @tparam[opt={}] table args Other arguments") --DOC_HEADER

tests/examples/awful/placement/under_mouse.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --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/default.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 --DOC_NO_USAGE
 local place = require("awful.placement") --DOC_HIDE
 local awful = { titlebar = require("awful.titlebar"), --DOC_HIDE

tests/examples/gears/shape/arc.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.arc(cr,70,70, 10)

tests/examples/gears/shape/arrow.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.arrow(cr, 70, 70)

tests/examples/gears/shape/circle.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.circle(cr, 70, 70)

tests/examples/gears/shape/cross.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.cross(cr, 70, 70)

tests/examples/gears/shape/hexagon.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.hexagon(cr, 70, 70)

tests/examples/gears/shape/infobubble.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.infobubble(cr, 70, 70)

tests/examples/gears/shape/isosceles_triangle.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.isosceles_triangle(cr, 70, 70)

tests/examples/gears/shape/losange.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.losange(cr, 70, 70)

tests/examples/gears/shape/octogon.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.octogon(cr, 70, 70)

tests/examples/gears/shape/parallelogram.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.parallelogram(cr, 70, 70)

tests/examples/gears/shape/partially_rounded_rect.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.partially_rounded_rect(cr, 70, 70)

tests/examples/gears/shape/pie.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.pie(cr, 70, 70)

tests/examples/gears/shape/powerline.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.powerline(cr, 70, 70)

tests/examples/gears/shape/radial_progress.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.radial_progress(cr, 70, 20, .3)

tests/examples/gears/shape/rectangle.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.rectangle(cr, 70, 70)

tests/examples/gears/shape/rectangular_tag.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.rectangular_tag(cr, 70, 70)

tests/examples/gears/shape/rounded_bar.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.rounded_bar(cr, 70, 70)

tests/examples/gears/shape/rounded_rect.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local shape,cr,show = ... --DOC_HIDE
 
 shape.rounded_rect(cr, 70, 70, 10)

tests/examples/text/gears/object/properties.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_OUTPUT --DOC_HIDE
 local gears = require("gears") --DOC_HIDE
 
 -- Create a class for this object. It will be used as a backup source for

tests/examples/text/gears/object/signal.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_OUTPUT --DOC_HIDE
 local gears = require("gears") --DOC_HIDE
 
 local o = gears.object{}

tests/examples/text/gears/sort/topological.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_OUTPUT --DOC_HIDE
 local gears = {sort={topological = require("gears.sort.topological")}} --DOC_HIDE
 
 local tsort = gears.sort.topological()

tests/examples/wibox/awidget/defaults/prompt.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent    = ... --DOC_NO_USAGE --DOC_HIDE
 local awful     = { widget = {  --DOC_HIDE
                     prompt = require("awful.widget.prompt")}}--DOC_HIDE

tests/examples/wibox/awidget/prompt/highlight.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent    = ... --DOC_NO_USAGE --DOC_HIDE
 local wibox     = require( "wibox"     ) --DOC_HIDE
 local awful     = { prompt = require("awful.prompt") }--DOC_HIDE

tests/examples/wibox/awidget/prompt/hooks.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent    = ... --DOC_NO_USAGE --DOC_HIDE
 local wibox     = require( "wibox"     ) --DOC_HIDE
 local awful     = { prompt = require("awful.prompt"),--DOC_HIDE

tests/examples/wibox/awidget/prompt/keypress.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent    = ... --DOC_NO_USAGE --DOC_HIDE
 local wibox     = require( "wibox"     ) --DOC_HIDE
 local awful     = { prompt = require("awful.prompt"),--DOC_HIDE

tests/examples/wibox/awidget/prompt/simple.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent    = ... --DOC_NO_USAGE --DOC_HIDE
 local wibox     = require( "wibox"     ) --DOC_HIDE
 local awful     = { prompt = require("awful.prompt") }--DOC_HIDE

tests/examples/wibox/awidget/prompt/vilike.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent    = ... --DOC_NO_USAGE --DOC_HIDE
 local wibox     = require( "wibox"     ) --DOC_HIDE
 local awful     = { prompt = require("awful.prompt"),--DOC_HIDE

tests/examples/wibox/awidget/taglist/indexed.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent = ... --DOC_NO_USAGE --DOC_HIDE
 local awful = { --DOC_HIDE
     tag = require("awful.tag"), --DOC_HIDE

tests/examples/wibox/awidget/tasklist/rounded.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent = ... --DOC_NO_USAGE --DOC_HIDE
 local awful = { --DOC_HIDE
     tag = require("awful.tag"), --DOC_HIDE

tests/examples/wibox/awidget/tasklist/windows10.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent = ... --DOC_NO_USAGE --DOC_HIDE
 local awful = { --DOC_HIDE
     tag = require("awful.tag"), --DOC_HIDE

tests/examples/wibox/container/arcchart/bg.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require( "wibox"     )
 local beautiful = require( "beautiful" )

tests/examples/wibox/container/arcchart/border_width.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require( "wibox"     )
 local beautiful = require( "beautiful" )

tests/examples/wibox/container/arcchart/paddings.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require( "wibox"     )
 local beautiful = require( "beautiful" )

tests/examples/wibox/container/arcchart/rounded_edge.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require( "wibox"     )
 local beautiful = require( "beautiful" )

tests/examples/wibox/container/arcchart/start_angle.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require( "wibox"     )
 local beautiful = require( "beautiful" )

tests/examples/wibox/container/arcchart/thickness.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require( "wibox"     )
 local beautiful = require( "beautiful" )

tests/examples/wibox/container/arcchart/value.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require( "wibox"     )
 local beautiful = require( "beautiful" )

tests/examples/wibox/container/background/bg.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent = ... --DOC_HIDE
 local wibox  = require("wibox") --DOC_HIDE
 

tests/examples/wibox/container/background/clip.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent    = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 local gears     = {shape = require("gears.shape")} --DOC_HIDE

tests/examples/wibox/container/background/fg.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent = ... --DOC_HIDE
 local wibox  = require("wibox") --DOC_HIDE
 

tests/examples/wibox/container/background/shape.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent    = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 local gears     = {shape = require("gears.shape")} --DOC_HIDE

tests/examples/wibox/container/defaults/arcchart.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox     = require("wibox")
 local beautiful = require("beautiful")
 

tests/examples/wibox/container/defaults/background.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox     = require("wibox")
 local gears     = {shape = require("gears.shape")}
 local beautiful = require("beautiful")

tests/examples/wibox/container/defaults/constraint.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox = require("wibox")
 
 return {

tests/examples/wibox/container/defaults/margin.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox     = require("wibox")
 local beautiful = require("beautiful")
 

tests/examples/wibox/container/defaults/mirror.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox     = require("wibox")
 
 return {

tests/examples/wibox/container/defaults/only_on_screen.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox = require("wibox")
 local awful = { widget = { only_on_screen = require("awful.widget.only_on_screen") } }
 

tests/examples/wibox/container/defaults/place.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox     = require("wibox")
 
 return {

tests/examples/wibox/container/defaults/radialprogressbar.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox     = require("wibox")
 
 return {

tests/examples/wibox/container/defaults/rotate.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox     = require("wibox")
 
 return {

tests/examples/wibox/container/defaults/scroll.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local wibox = require("wibox")
 
 return {

tests/examples/wibox/container/radialprogressbar/border_color.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require("wibox")
 

tests/examples/wibox/container/radialprogressbar/border_width.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require("wibox")
 

tests/examples/wibox/container/radialprogressbar/color.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require("wibox")
 

tests/examples/wibox/container/radialprogressbar/padding.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require("wibox")
 local beautiful = require("beautiful")

tests/examples/wibox/container/radialprogressbar/value.lua

@@ -1,4 +1,5 @@
 --DOC_HIDE_ALL
+--DOC_GEN_IMAGE
 local parent    = ...
 local wibox     = require("wibox")
 

tests/examples/wibox/container/rotate/angle.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local parent    = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 local gears     = {shape = require("gears.shape")} --DOC_HIDE

tests/examples/wibox/layout/defaults/align.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 

tests/examples/wibox/layout/defaults/fixed.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 

tests/examples/wibox/layout/defaults/flex.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 

tests/examples/wibox/layout/defaults/grid.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 

tests/examples/wibox/layout/defaults/manual.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 

tests/examples/wibox/layout/defaults/ratio.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 

tests/examples/wibox/layout/defaults/stack.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 

tests/examples/wibox/layout/fixed/spacing.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox = require("wibox") --DOC_HIDE
 

tests/examples/wibox/layout/fixed/spacing_widget.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 local gears     = {shape = require("gears.shape")}--DOC_HIDE

tests/examples/wibox/layout/flex/spacing.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox = require("wibox") --DOC_HIDE
 

tests/examples/wibox/layout/flex/spacing_widget.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_IMAGE --DOC_HIDE
 local generic_widget = ... --DOC_HIDE
 local wibox     = require("wibox") --DOC_HIDE
 local gears     = {shape = require("gears.shape")}--DOC_HIDE

tests/examples/wibox/layout/grid/add.lua

@@ -1,3 +1,4 @@
+--DOC_GEN_OUTPUT --DOC_GEN_IMAGE
 local generic_widget, generic_before_after = ... --DOC_HIDE_ALL
 local wibox = require("wibox") --DOC_HIDE
 local beautiful = require("beautiful") --DOC_HIDE