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. 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.