From 4f59f8948105f1103d0d2b21356ac77345c5b593 Mon Sep 17 00:00:00 2001
From: Steef Hegeman <mail@steefhegeman.com>
Date: Mon, 25 Jul 2022 18:05:35 +0200
Subject: [PATCH] man page snixembed(1)

---
 makefile    |  5 ++++-
 snixembed.1 | 32 ++++++++++++++++++++++++++++++++
 2 files changed, 36 insertions(+), 1 deletion(-)
 create mode 100644 snixembed.1

diff --git a/makefile b/makefile
index afd927a..9d1bc67 100644
--- a/makefile
+++ b/makefile
@@ -4,6 +4,7 @@ SRC = src/*.vala version.vala
 
 PREFIX ?= /usr
 BINDIR ?= /bin
+MANDIR ?= /share/man
 
 PKG := $(foreach pkg, $(PKG), --pkg $(pkg))
 CFLAGS := $(CFLAGS) $(shell pkg-config --cflags --libs $(CPKG))
@@ -25,8 +26,10 @@ clean:
 
 install: snixembed
 	install -Dm755 snixembed $(DESTDIR)$(PREFIX)$(BINDIR)/snixembed
+	install -Dm644 snixembed.1 $(DESTDIR)$(PREFIX)$(MANDIR)/man1/snixembed.1
 
 uninstall:
-	rm -f $(DESTDIR)$(PREFIX)$(BINDIR)/snixembed
+	rm -f $(DESTDIR)$(PREFIX)$(BINDIR)/snixembed \
+		$(DESTDIR)$(PREFIX)$(MANDIR)/man1/snixembed.1
 
 .PHONY: clean install uninstall version.vala
diff --git a/snixembed.1 b/snixembed.1
new file mode 100644
index 0000000..d7e259a
--- /dev/null
+++ b/snixembed.1
@@ -0,0 +1,32 @@
+\" Contributors: see groff_man(7) and man-pages(7)
+.TH snixembed 1 2022-07-25
+.SH NAME
+snixembed \- proxy the StatusNotifierItem protocol to the XEmbed System Tray
+.SH SYNOPSIS
+.SY snixembed
+.OP \-\-fork
+.YS
+.SH DESCRIPTION
+The snixembed daemon proxies StatusNotifierItems as XEmbedded System Tray icons.
+.SH OPTIONS
+.TP
+.BR \-\-fork
+.RS
+Set up in the foreground,
+then fork to background process.
+.PP
+This can be used to avoid race conditions with applications that expect a StatusNotifierWatcher to be ready on startup.
+Start these applications only after snixembed --fork has completed.
+.RE
+.SH BUGS
+Not all of the StatusNotifierItem specification is supported.
+Current support includes:
+mouse events,
+context menus,
+tooltips.
+There is also limited AppIndicator support.
+.SH AUTHORS
+Maintained by Steef Hegeman,
+who is assisted by other open source contributors.
+.PP
+More information and up-to-date sources can be found at https://git.sr.ht/~steef/snixembed.
-- 
2.45.2