From 7c9706de7186f32159f719e3f15fcdc017a13f35 Mon Sep 17 00:00:00 2001 From: William Culhane Date: Sun, 20 Dec 2020 00:33:32 -0600 Subject: [PATCH] grimshot: Fix man page issues This fixes a few formatting errors in SYNOPSIS, moves the command options out of SYNOPSIS, swaps the labels on the SYNOPSIS and DESCRIPTION sections, creates an EXAMPLES section and slightly rewords parts of the OPTIONS, DESCRIPTION, EXAMPLES, and OUTPUT sections. --- contrib/grimshot.1 | 59 +++++++++++++++++++++++------------------- contrib/grimshot.1.scd | 37 ++++++++++++++------------ 2 files changed, 54 insertions(+), 42 deletions(-) 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 -grimshot [--notify] (copy|save) [TARGET] [FILE] -grimshot check -grimshot usage +\fBgrimshot\fR [--notify] (copy|save) [TARGET] [FILE] +.br +\fBgrimshot\fR check +.br +\fBgrimshot\fR usage +.P +.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 tool for sway. It relies on grim, slurp -and jq to do the heavy lifting, and mostly provides an easy to use interface. +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 -A recommended usage pattern is to just bind this to Super+P via sway: +.SH EXAMPLES +.P +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 tool for sway. It relies on grim, slurp -and jq to do the heavy lifting, and mostly provides an easy to use interface. +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. -A recommended usage pattern is to just bind this to Super+P via sway: +# EXAMPLES + +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