diff --git a/contrib/grimshot.1 b/contrib/grimshot.1
index a51f3d4d..f6c8a377 100644
--- a/contrib/grimshot.1
+++ b/contrib/grimshot.1
@@ -1,53 +1,60 @@
-.\" Generated by scdoc 1.10.1
+.\" Generated by scdoc 1.11.1
 .\" Complete documentation for this program is not available as a GNU info page
 .ie \n(.g .ds Aq \(aq
 .el       .ds Aq '
 .nh
 .ad l
 .\" Begin generated content:
-.TH "grimshot" "1" "2020-05-08"
+.TH "grimshot" "1" "2020-12-20"
 .P
 .SH NAME
 .P
 grimshot - a helper for screenshots within sway
 .P
-.SH DESCRIPTION
+.SH SYNOPSIS
+.P
+\fBgrimshot\fR [--notify] (copy|save) [TARGET] [FILE]
+.br
+\fBgrimshot\fR check
+.br
+\fBgrimshot\fR usage
 .P
-grimshot [--notify] (copy|save) [TARGET] [FILE]
-grimshot check
-grimshot usage
+.SH OPTIONS
 .P
 \fB--notify\fR
 .RS 4
-Show notifications to the user that a screenshot has been taken.
+Show notifications to the user that a screenshot has been taken.\&
 .P
 .RE
 \fBsave\fR
 .RS 4
-Save the screenshot into a regular file. Grimshot will write images
-files to \fB$XDG_SCREENSHOTS_DIR\fR if this is set (or defined
-in `user-dirs.dir`), or otherwise fall back to `$XDG_PICTURES_DIR`
+Save the screenshot into a regular file.\& Grimshot will write images
+files to \fBXDG_SCREENSHOTS_DIR\fR if this is set (or defined
+in \fBuser-dirs.\&dir\fR), or otherwise fall back to \fBXDG_PICTURES_DIR\fR.\&
 .P
 .RE
 \fBcopy\fR
 .RS 4
-Copy the screenshot data (as image/png) into the clipboard.
+Copy the screenshot data (as image/png) into the clipboard.\&
 .P
 .RE
-.SH SYNOPSIS
+.SH DESCRIPTION
+.P
+Grimshot is an easy-to-use screenshot utility for sway.\& It provides a
+convenient interface over grim, slurp and jq, and supports storing the
+screenshot either directly to the clipboard using wl-copy or to a file.\&
 .P
-Grimshot is an easy to use screenshot tool for sway. It relies on grim, slurp
-and jq to do the heavy lifting, and mostly provides an easy to use interface.
+.SH EXAMPLES
 .P
-A recommended usage pattern is to just bind this to Super+P via sway:
+An example usage pattern is to add these bindings to your sway config:
 .P
 .nf
 .RS 4
 # Screenshots:
-# Cmd+P: Current window
-# Cmd+Shift+p: Select area
-# Cmd+Alt+p Current output
-# Cmd+Ctrl+p Select a window
+# Super+P: Current window
+# Super+Shift+p: Select area
+# Super+Alt+p Current output
+# Super+Ctrl+p Select a window
 
 bindsym Mod4+p       exec grimshot save active
 bindsym Mod4+Shift+p exec grimshot save area
@@ -62,34 +69,34 @@ grimshot can capture the following named targets:
 .P
 \fIactive\fR
 .RS 4
-Captures the currently active window.
+Captures the currently active window.\&
 .P
 .RE
 \fIscreen\fR
 .RS 4
-Captures the entire screen. This includes all visible outputs.
+Captures the entire screen.\& This includes all visible outputs.\&
 .P
 .RE
 \fIarea\fR
 .RS 4
-Allows manually selecting a rectangular region, and captures that.
+Allows manually selecting a rectangular region, and captures that.\&
 .P
 .RE
 \fIwindow\fR
 .RS 4
 Allows manually selecting a single window (by clicking on it), and
-captures it.
+captures it.\&
 .P
 .RE
 \fIoutput\fR
 .RS 4
-Captures the currently active output.
+Captures the currently active output.\&
 .P
 .RE
 .SH OUTPUT
 .P
-Grimshot will always print the filename of the captured screenshot to
-stdout.
+Grimshot will print the filename of the captured screenshot to stdout if called
+with the \fIsave\fR subcommand.\&
 .P
 .SH SEE ALSO
 .P
diff --git a/contrib/grimshot.1.scd b/contrib/grimshot.1.scd
index b2877976..4ab58532 100644
--- a/contrib/grimshot.1.scd
+++ b/contrib/grimshot.1.scd
@@ -4,36 +4,41 @@ grimshot(1)
 
 grimshot - a helper for screenshots within sway
 
-# DESCRIPTION
+# SYNOPSIS
+
+*grimshot* [--notify] (copy|save) [TARGET] [FILE]++
+*grimshot* check++
+*grimshot* usage
 
-grimshot [--notify] (copy|save) [TARGET] [FILE]
-grimshot check
-grimshot usage
+# OPTIONS
 
 *--notify*
 	Show notifications to the user that a screenshot has been taken.
 
 *save*
 	Save the screenshot into a regular file. Grimshot will write images
-	files to *$XDG_SCREENSHOTS_DIR* if this is set (or defined
-	in `user-dirs.dir`), or otherwise fall back to `$XDG_PICTURES_DIR`
+	files to *XDG_SCREENSHOTS_DIR* if this is set (or defined
+	in *user-dirs.dir*), or otherwise fall back to *XDG_PICTURES_DIR*.
 
 *copy*
 	Copy the screenshot data (as image/png) into the clipboard.
 
-# SYNOPSIS
+# DESCRIPTION
+
+Grimshot is an easy-to-use screenshot utility for sway. It provides a
+convenient interface over grim, slurp and jq, and supports storing the
+screenshot either directly to the clipboard using wl-copy or to a file.
 
-Grimshot is an easy to use screenshot tool for sway. It relies on grim, slurp
-and jq to do the heavy lifting, and mostly provides an easy to use interface.
+# EXAMPLES
 
-A recommended usage pattern is to just bind this to Super+P via sway:
+An example usage pattern is to add these bindings to your sway config:
 
 ```
 # Screenshots:
-# Cmd+P: Current window
-# Cmd+Shift+p: Select area
-# Cmd+Alt+p Current output
-# Cmd+Ctrl+p Select a window
+# Super+P: Current window
+# Super+Shift+p: Select area
+# Super+Alt+p Current output
+# Super+Ctrl+p Select a window
 
 bindsym Mod4+p       exec grimshot save active
 bindsym Mod4+Shift+p exec grimshot save area
@@ -63,8 +68,8 @@ _output_
 
 # OUTPUT
 
-Grimshot will always print the filename of the captured screenshot to
-stdout.
+Grimshot will print the filename of the captured screenshot to stdout if called
+with the _save_ subcommand.
 
 # SEE ALSO