doc/dome-key.1.txt: Add "Launchd" section

Include the program's launchd plist in the man page.

2 files changed, 15 insertions, 1 deletions

diff --git a/Makefile b/Makefile
index cf204e2..ddc8fa7 100644
--- a/Makefile
+++ b/Makefile
@@ -16,6 +16,8 @@ DEBUG_PRODUCT := build/Build/Products/Debug/DomeKey
 RELEASE_PRODUCT := build/Build/Products/Release/DomeKey
 ARCHIVE_PRODUCT := build/Release.xcarchive/Products/usr/local/bin/DomeKey
 
+LAUNCHD_PLIST := pkg/com.teddywing.dome-key.plist
+
 
 # Build debug
 
@@ -89,8 +91,13 @@ run: build
 .PHONY: doc
 doc: doc/dome-key.1
 
-doc/dome-key.1: doc/dome-key.1.txt
+doc/dome-key.1: doc/dome-key.1.intermediate.txt
 	a2x --no-xmllint --format manpage $<
+	rm $<
+
+doc/dome-key.1.intermediate.txt: doc/dome-key.1.txt $(LAUNCHD_PLIST)
+	sed 's/^/	/' $(LAUNCHD_PLIST) | \
+		perl -0777 -pe '$$plist = <STDIN>; s/\$$\{PLIST}\n/$${plist}/' $< > $@
 
 
 # Distribution
diff --git a/doc/dome-key.1.txt b/doc/dome-key.1.txt
index 6fbb680..c9d5337 100644
--- a/doc/dome-key.1.txt
+++ b/doc/dome-key.1.txt
@@ -78,6 +78,13 @@ mappings apply when undefined, even without a mappings file:
 
 LAUNCHD
 -------
+It’s recommended that you run the program in the background using
+launchd(8). Here’s an example plist:
+
+${PLIST}
+
+You can also use *brew services* to do this automatically if the program
+was installed with Homebrew.
 
 SEE ALSO
 --------