Manpage with actual content

.gitignore

@@ -0,0 +1 @@
+maim-utils-*.tar.gz

APKBUILD

@@ -2,7 +2,7 @@
 # Maintainer: Marty Sluijtman <marty.wanderer@disroot.org>
 pkgname=maim-utils
 pkgver=1.0
-pkgrel=1
+pkgrel=3
 pkgdesc="A few common screenshot options rolled into one script based on maim"
 url="https://alpine.voidcruiser.nl"
 arch="noarch"
@@ -24,5 +24,5 @@ package() {
 }
 
 sha512sums="
-e73d7e82ea183521862e3e6e1d8967aa832290d16407edbf574474077e317ab8013c4f0fc792de09479f040e880e12a6cfecc5aa391bdaff7dabac43fd4b870f  maim-utils-1.0.tar.gz
+f99ec8cea8f71d9096fa7654211dab38a2ee5abc9e7c879052c948f8aa0bf14ed6906ba4860432a68a0e2ef968572c324bebd28ac2a4120a96440aebae246410  maim-utils-1.0.tar.gz
 "

Makefile

@@ -15,7 +15,7 @@ dist:
 	rm -rf $(DIRNAME)
 
 clean:
-	rm $(MANPAGE) $(DIRNAME).tar.gz
+	rm -f $(MANPAGE) $(DIRNAME).tar.gz
 
 install: $(MANPAGE)
 	install -dm 0755 $(DESTDIR)$(PREFIX)/bin

maim-utils

@@ -1,4 +1,6 @@
 #!/bin/sh
+# Copyright 2023 Marty Sluijtman <marty.wanderer@disroot.org>
+# Distributed under the terms of the GPLv3 license
 
 savedir="${SCROTDIR:-$HOME/Pictures/Screenshots}"
 filename="$savedir/$(date -Iseconds)_maim.png"

maim-utils.1.scd

@@ -9,3 +9,48 @@ maim-utils - A few common screenshot options rolled into one script based on mai
 *maim-utils* _<fullscreen|focus|selection>_
 
 *maim-utils* _<clip-fullscreen|clip-focus|clip-selection>_
+
+# DESCRIPTION
+
+I wrote around six scripts to take screenshots in various different ways a few
+years ago and at some point I got the idea to turn it into a single script.
+*maim-utils* is the result of that. It only took me a few years to finally get
+to it.
+
+# CONFIGURATION
+
+*maim-utils* saves it's screenshots to $HOME/Pictures/Screenshots by default.
+This can be changed by setting the $SCROTDIR.
+
+# OPTIONS
+
+*fullscreen*
+	Take a screenshot of the entire screen and save it to the screenshot
+	directory.
+
+*full*
+	same as *fullscreen*.
+
+*selection*
+	Take a screenshot based on a rectangular selection and save it to the
+	screenshot directory.
+
+*sel*
+	same as *selection*.
+
+*focus*
+	Take a screenshot of the currently focussed window and save it to the
+	screenshot directory.
+
+*clip-fullscreen*
+	Take a screenshot of the entire screen and write it to the clipboard.
+
+*clip-full* and *full-clip*
+	Same as *clip-fullscreen*
+
+*clip-focus* and *focus-clip*
+	Take a screenshot of the currently focus window and write it to the
+	clipboard.
+
+*open*, *show* and *screenshots*
+	Open the directory containing screenshots.