From 38a1d0b57cc690bf892f640238c772a59aa278ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20Ekl=C3=B6f?= <daniel@ekloef.se>
Date: Mon, 2 Jan 2023 11:51:43 +0100
Subject: [PATCH] doc: tags: add a couple of formatting examples

---
 doc/yambar-tags.5.scd | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/yambar-tags.5.scd b/doc/yambar-tags.5.scd
index 91f7616..b778154 100644
--- a/doc/yambar-tags.5.scd
+++ b/doc/yambar-tags.5.scd
@@ -108,3 +108,23 @@ be used.
 :  Realtime tags
 :  Renders a realtime tag's unit (e.g. "s", or "ms")
 
+# EXAMPLES
+
+- A numeric (float or int) tag with at least 3 digits, zero-padded if
+  necessary:
+
+```
+{tag:03}
+```
+
+- A float tag with 2 decimals:
+
+```
+{tag:.2}
+```
+
+- A "byte count" tag in gigabytes:
+
+```
+{tag:gib}GB
+```