Re-generate manpage

Author: eribertomota

man/create-man.sh

@@ -16,9 +16,9 @@ txt2man -d "$T2M_DATE" -t $T2M_NAME -r $T2M_NAME-$T2M_VERSION -s $T2M_LEVEL -v "
 #--------------------------------------------------------
 
 # Put here all data for your first manpage (in T2M lines)
-T2M_DATE="10 Apr 2023"
+T2M_DATE="10 Jun 2023"
 T2M_NAME=scrot
-T2M_VERSION=1.9
+T2M_VERSION=1.10
 T2M_LEVEL=1
 T2M_DESC="command line screen capture utility"
 create-man

man/scrot.1

@@ -1,5 +1,5 @@
 .\" Text automatically generated by txt2man
-.TH scrot 1 "10 Apr 2023" "scrot-1.9" "command line screen capture utility"
+.TH scrot 1 "10 Jun 2023" "scrot-1.10" "command line screen capture utility"
 .SH NAME
 \fBscrot \fP- command line screen capture utility
 \fB
@@ -32,7 +32,7 @@ screen.
 Because \fBscrot\fP is a command line utility, it can easily be scripted and put to
 novel uses. For instance, \fBscrot\fP can be used to monitor an X server in absence.
 .PP
-\fBscrot\fP is free software under the MIT-advertising license.
+\fBscrot\fP is free software under the MIT-feh license.
 .SH OPTIONS
 .TP
 .B
@@ -70,7 +70,7 @@ Execute \fICMD\fP on the saved image.
 .B
 \fB-F\fP, \fB--file\fP \fIFILE\fP
 Specify the output file. If \fIFILE\fP is "-", \fBscrot\fP will
-output a PNG image to stdout. The filename is
+output the image to stdout. The filename is
 expanded according to the format specified in
 SPECIAL STRINGS. The output file may be specified
 through the \fB-F\fP option, or as a non-option argument.
@@ -107,11 +107,6 @@ Capture Xinerama monitor number \fINUM\fP.
 For multiple heads, screenshot all of them in order.
 .TP
 .B
-\fB-n\fP, \fB--note\fP \fIOPTS\fP
-\fIOPTS\fP is a collection of options which specify notes
-to bake into the image. See NOTE FORMAT.
-.TP
-.B
 \fB-o\fP, \fB--overwrite\fP
 By default \fBscrot\fP does not overwrite the output
 \fIFILE\fP, use this option to enable it.
@@ -122,11 +117,11 @@ Capture the mouse pointer.
 .TP
 .B
 \fB-q\fP, \fB--quality\fP \fINUM\fP
-\fINUM\fP must be between 1 and 100. For lossless output
-formats, a higher value represents better but slower
-compression. For lossy output formats, a higher
-value represents higher quality and larger
-file size. Default: 75.
+\fINUM\fP must be within [1, 100]. A higher value
+represents better quality image and a lower value
+represents worse quality image. Effect of this flag
+depends on the file format, see COMPRESSION QUALITY
+section. Default: 75.
 .TP
 .B
 \fB-s\fP, \fB--select\fP[=\fIOPTS\fP]
@@ -155,9 +150,17 @@ Use the currently focused window.
 Output version information and exit.
 .TP
 .B
-\fB-w\fP, \fB--window\fP
+\fB-w\fP, \fB--window\fP WID
 Window identifier to capture.
-Must be a valid identifier (see \fBxwininfo\fP(1)).
+WID must be a valid identifier (see \fBxwininfo\fP(1)).
+.TP
+.B
+\fB-Z\fP, \fB--compression\fP LVL
+Compression level to use, LVL must be within
+[0, 9]. Higher level compression provides lower file
+size at the cost of slower encoding/saving speed.
+Effect of this flag depends on the file format, see
+COMPRESSION QUALITY section. Default: 7.
 .TP
 .B
 \fB-z\fP, \fB--silent\fP
@@ -221,7 +224,7 @@ Some actions allow optional parameters too.
 
     blur,AMOUNT         Blurs the selection area.
                         Optionally you can specify the amount of blur.
-                        Amount,range: 1..30,  default: 18
+                        Amount must be within [1, 30]. Default: 18.
 
 .fam T
 .fi
@@ -251,7 +254,7 @@ When using \fB-s\fP, you can indicate the style of the line with \fB-l\fP.
 .fam C
     style=STYLE     STYLE is either "solid" or "dash" without quotes.
 
-    width=NUM       NUM is a pixel count between 1 and 8 inclusive.
+    width=NUM       NUM is a pixel count within [1, 8].
 
     color="COLOR"   Color is a hexadecimal HTML color code or the name of
                     a color. HTML color codes are composed of a pound
@@ -260,10 +263,9 @@ When using \fB-s\fP, you can indicate the style of the line with \fB-l\fP.
                     blue respectively. Examples: #FF0000 (red), #E0FFFF
                     (light cyan), #000000 (black).
 
-    opacity=NUM     NUM is between 0 and 255 inclusive. 255 means
-                    100% opaque, 0 means 100% transparent. For the
-                    opacity of the line this is only effective if a
-                    Composite Manager is running.
+    opacity=NUM     NUM is within [0, 255]. 255 means 100% opaque, 0 means
+                    100% transparent. For the opacity of the line, this is only
+                    effective if the compositor supports _NET_WM_WINDOW_OPACITY.
 
     mode=MODE       MODE is either "edge" or "classic" without quotes.
                     edge is the new selection, classic uses the old one.
@@ -288,29 +290,12 @@ Example:
 
 .fam T
 .fi
-.SH NOTE FORMAT
-The \fB-n\fP option's argument is more arguments:
-.PP
-.nf
-.fam C
-    -f  'FontName/size'
-    -t  'text'
-    -x  position (optional)
-    -y  position (optional)
-    -c  color(RGBA, range 0..255) (optional)
-    -a  angle (optional)
-
-.fam T
-.fi
-Example:
-.PP
-.nf
-.fam C
-    $ scrot -n "-f '/usr/share/fonts/TTF/DroidSans-Bold/40' -x 10
-            -y 20 -c 255,0,0,255 -t 'Hi'"
+.SH COMPRESSION QUALITY
 
-.fam T
-.fi
+For lossless formats (e.g PNG), the quality options is ignored. For lossy
+formats where the quality and compression are tied together (e.g JPEG),
+compression will be ignored. And for image formats where quality and
+compression can be independently set (e.g WebP, JXL), both flags are respected.
 .SH SEE ALSO
 \fBoptipng\fP(1)
 \fBxwininfo\fP(1)