From 43fa4e7807c6f4f08492753f97bbc6b545d52b9c Mon Sep 17 00:00:00 2001
From: Aki Tuomi <aki.tuomi@open-xchange.com>
Date: Thu, 6 Feb 2025 15:48:02 +0200
Subject: [PATCH 1/2] man: doveadm-fs - See also is a section header

---
 docs/core/man/include/doveadm-fs.inc | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/docs/core/man/include/doveadm-fs.inc b/docs/core/man/include/doveadm-fs.inc
index 83119118a..7447aae6c 100644
--- a/docs/core/man/include/doveadm-fs.inc
+++ b/docs/core/man/include/doveadm-fs.inc
@@ -139,7 +139,6 @@ size (in bytes) of the item is returned.
 
 <!-- @include: ./reporting-bugs.inc -->
 
-SEE ALSO
+## SEE ALSO
 
 [[man,doveadm]]
-

From b1bfd310d650ed5d63f09c1ef78282e089f4702f Mon Sep 17 00:00:00 2001
From: Aki Tuomi <aki.tuomi@open-xchange.com>
Date: Thu, 6 Feb 2025 15:51:48 +0200
Subject: [PATCH 2/2] man: doveadm-fs - Add usage example

---
 docs/core/man/include/doveadm-fs.inc | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/docs/core/man/include/doveadm-fs.inc b/docs/core/man/include/doveadm-fs.inc
index 7447aae6c..a224c8e7d 100644
--- a/docs/core/man/include/doveadm-fs.inc
+++ b/docs/core/man/include/doveadm-fs.inc
@@ -139,6 +139,20 @@ size (in bytes) of the item is returned.
 
 <!-- @include: ./reporting-bugs.inc -->
 
+## EXAMPLE
+
+How to decompress a file.
+
+```sh
+doveadm -o fs=compress,posix -o fs/compress/fs_driver=compress -o fs/posix/fs_driver=posix -o fs_posix_prefix=/tmp/ fs get empty test.gz
+```
+
+Using a named filter.
+
+```sh
+doveadm mail fs -u testuser get obox path/to/file
+```
+
 ## SEE ALSO
 
 [[man,doveadm]]