diff --git a/doc.lua b/doc.lua
index 3408d7a..3446f15 100644
--- a/doc.lua
+++ b/doc.lua
@@ -194,11 +194,13 @@ minetest.register_on_player_receive_fields(function(player, formname, fields)
 end)
 
 -------------------------------------------------------------------------------
---[[ This category shows off the gallery widget ]]
+--[[ This category demonstrates the use of the gallery widget. ]]
 -- FIXME: Depends on Minetest Game
 doc.new_category("example4", {
 	name="Example: Galleries",
 	build_formspec = function(data, playername)
+		-- The trick here is to include doc.widgets.gallery into the custom
+		-- build_formspec definition.
 		local formspec = ""
 		--[[ Mostly using default values, but we want an aspect ratio of
 		1:1 (square). ]]