From 29288b3ab92567ebb7dbac15d67d6c36cace05a9 Mon Sep 17 00:00:00 2001 From: Photon89 Date: Sun, 4 Jan 2026 23:36:22 +0100 Subject: [PATCH 1/2] Added hint to manpage (for finding wildcards) inside toopltip --- bin/shutter | 35 +++++++++++++++++++++-------------- 1 file changed, 21 insertions(+), 14 deletions(-) diff --git a/bin/shutter b/bin/shutter index a2d307f1..e440c37d 100755 --- a/bin/shutter +++ b/bin/shutter @@ -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 man strftime."); + $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); @@ -11282,12 +11284,10 @@ Specify a filename to save the screenshot to (overwrites any profile-related set B 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 There are several wildcards available, like +B 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) @@ -11296,6 +11296,13 @@ B 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 for more examples. B 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. From fc0ea18000e8abaca7dfed04ff0f973749bf7b52 Mon Sep 17 00:00:00 2001 From: Photon89 Date: Sun, 11 Jan 2026 09:16:17 +0100 Subject: [PATCH 2/2] Regenerated man page --- share/man/man1/shutter.1 | 34 ++++++++++++++++++++++------------ 1 file changed, 22 insertions(+), 12 deletions(-) diff --git a/share/man/man1/shutter.1 b/share/man/man1/shutter.1 index 39e13357..972f7e80 100644 --- a/share/man/man1/shutter.1 +++ b/share/man/man1/shutter.1 @@ -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: .\" ======================================================================== @@ -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 @@ -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 @@ -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. @@ -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) @@ -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.