From fded165e41c09497cf8c01c3d71b410c3af49524 Mon Sep 17 00:00:00 2001
From: Emmanuel Lepage Vallee <elv1313@gmail.com>
Date: Mon, 4 Mar 2019 17:06:42 -0500
Subject: [PATCH] doc: Document how to select different shapes based on the
 content.

---
 lib/naughty/notification.lua | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/lib/naughty/notification.lua b/lib/naughty/notification.lua
index f363a288d..aa4145fdb 100644
--- a/lib/naughty/notification.lua
+++ b/lib/naughty/notification.lua
@@ -161,7 +161,17 @@ local notification = {}
 -- @see gears.color
 
 --- Widget shape.
+--
+-- Note that when using a custom `request::display` handler or `naughty.rules`,
+-- choosing between multiple shapes depending on the content can be done using
+-- expressions like:
+--
+--    -- The notification object is called `n`
+--    shape = #n.actions > 0 and
+--        gears.shape.rounded_rect or gears.shape.rounded_bar,
+--
 --@DOC_naughty_shape_EXAMPLE@
+--
 -- @property shape
 -- @param gears.shape