Skip to content

Added hint to manpage (for finding wildcards) inside toopltip #792

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Photon89 wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Added hint to manpage (for finding wildcards) inside toopltip #792

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
29288b3
Added hint to manpage (for finding wildcards) inside toopltip
Photon89 Jan 4, 2026
fc0ea18
Regenerated man page
Photon89 Jan 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 21 additions & 14 deletions bin/shutter
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1217,21 +1217,23 @@ sub STARTUP {
fct_validate_filename($filename, $filename_hint);

my $filename_tooltip_string =
$d->get("There are several wildcards available, like\n")
. $d->get("%Y = year\n")
. $d->get("%m = month\n")
. $d->get("%d = day\n")
. $d->get("%T = time\n")
$d->get("There are several wildcards available.\n")
. $d->get("Wild cards provided by Shutter are:\n")
. $d->get("\$w = width\n")
. $d->get("\$h = height\n")
. $d->get("\$name = multi-purpose (e.g. window title)\n")
. $d->get("\$nb_name = like \$name but without blanks in resulting strings\n")
. $d->get("\$profile = name of current profile\n")
. $d->get("\$R = random char (e.g. \$RRRR = ag4r)\n")
. $d->get("%NN = counter");

$filename->set_tooltip_text($filename_tooltip_string);
$filename_label->set_tooltip_text($filename_tooltip_string);
. $d->get("%NN = counter\n")
. $d->get("Additionally, there are date related wildcards:\n")
. $d->get("%Y = year\n")
. $d->get("%m = month\n")
. $d->get("%d = day\n")
. $d->get("%T = time\n")
. $d->get("Further wildcards are documented in <i>man strftime</i>.");
$filename->set_tooltip_markup($filename_tooltip_string);
$filename_label->set_tooltip_markup($filename_tooltip_string);

$filename_box->pack_start($filename_label, FALSE, TRUE, 12);
$filename_box->pack_start($filename, TRUE, TRUE, 0);
Expand Down Expand Up @@ -11282,12 +11284,10 @@ Specify a filename to save the screenshot to (overwrites any profile-related set

B<Supported image formats:> You can save to any popular image format (e.g. jpeg, png, gif, bmp). Additionally it is possible to save to pdf, ps or svg.

B<Please note:> There are several wildcards available, like
B<Please note:> There are several wildcards available.

Wild cards provided by Shutter are:

%Y = year
%m = month
%d = day
%T = time
$w = width
$h = height
$name = multi-purpose (e.g. window title)
Expand All @@ -11296,6 +11296,13 @@ B<Please note:> There are several wildcards available, like
$R = random char (e.g. $RRRR = ag4r)
%NN = counter

Additionally, there are date related wildcards:

%Y = year
%m = month
%d = day
%T = time

The string is interpretted by strftime. See C<man strftime> for more examples.

B<As an example:> shutter -f -e -o './%y-%m-%d_$w_$h.png' would create a file named '11-10-28_1280_800.png' in the current directory.
Expand Down
34 changes: 22 additions & 12 deletions share/man/man1/shutter.1
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
Expand Down Expand Up @@ -52,10 +52,13 @@
. \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "SHUTTER 1"
.TH SHUTTER 1 2025-03-02 "perl v5.40.0" "User Contributed Perl Documentation"
.TH SHUTTER 1 2026-01-11 "perl v5.42.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
Expand All @@ -70,7 +73,7 @@ shutter [options]
Shutter is Copyright (C) by Mario Kemper and Shutter Team
.SH DESCRIPTION
.IX Header "DESCRIPTION"
\&\fBShutter\fR is a feature-rich screenshot program. You can take a screenshot of a specific area, window, your whole screen, or even of a website \- apply different effects to it, draw on it to highlight points, and then upload to an image hosting site, all within one window.
\&\fBShutter\fR is a feature\-rich screenshot program. You can take a screenshot of a specific area, window, your whole screen, or even of a website \- apply different effects to it, draw on it to highlight points, and then upload to an image hosting site, all within one window.
.SH OPTIONS
.IX Header "OPTIONS"
.IP "Example 1" 8
Expand All @@ -95,7 +98,7 @@ Capture an area of the screen. Providing X,Y,WIDTH,HEIGHT is optional.
Capture the entire screen.
.IP "\fB\-w, \-\-window=[NAME_PATTERN]\fR" 8
.IX Item "-w, --window=[NAME_PATTERN]"
Select a window to capture. Providing a NAME_PATTERN (Perl-style regex) is optional.
Select a window to capture. Providing a NAME_PATTERN (Perl\-style regex) is optional.
.IP "\fB\-a, \-\-active\fR" 8
.IX Item "-a, --active"
Capture the current active window.
Expand All @@ -118,17 +121,15 @@ Redo last screenshot.
Load a specific profile on startup.
.IP "\fB\-o, \-\-output=FILENAME\fR" 8
.IX Item "-o, --output=FILENAME"
Specify a filename to save the screenshot to (overwrites any profile-related setting).
Specify a filename to save the screenshot to (overwrites any profile\-related setting).
.Sp
\&\fBSupported image formats:\fR You can save to any popular image format (e.g. jpeg, png, gif, bmp). Additionally it is possible to save to pdf, ps or svg.
.Sp
\&\fBPlease note:\fR There are several wildcards available, like
\&\fBPlease note:\fR There are several wildcards available.
.Sp
.Vb 11
\& %Y = year
\& %m = month
\& %d = day
\& %T = time
Wild cards provided by Shutter are:
.Sp
.Vb 7
\& $w = width
\& $h = height
\& $name = multi\-purpose (e.g. window title)
Expand All @@ -138,9 +139,18 @@ Specify a filename to save the screenshot to (overwrites any profile-related set
\& %NN = counter
.Ve
.Sp
Additionally, there are date related wildcards:
.Sp
.Vb 4
\& %Y = year
\& %m = month
\& %d = day
\& %T = time
.Ve
.Sp
The string is interpretted by strftime. See \f(CW\*(C`man strftime\*(C'\fR for more examples.
.Sp
\&\fBAs an example:\fR shutter \-f \-e \-o './%y\-%m\-%d_$w_$h.png' would create a file named '11\-10\-28_1280_800.png' in the current directory.
\&\fBAs an example:\fR shutter \-f \-e \-o \*(Aq./%y\-%m\-%d_$w_$h.png\*(Aq would create a file named \*(Aq11\-10\-28_1280_800.png\*(Aq in the current directory.
.IP "\fB\-d, \-\-delay=SECONDS\fR" 8
.IX Item "-d, --delay=SECONDS"
Wait n seconds before taking a screenshot.
Expand Down