Updated manpage

Author: eribertomota

man/create-man.sh

@@ -8,9 +8,9 @@
 TEST=$(txt2man -h 2> /dev/null)
 [ "$TEST" ] || { echo -e "\nYou need to install txt2man, from https://github.com/mvertes/txt2man.\n"; exit 1; }
 
-T2M_DATE="10 June 2019"
+T2M_DATE="09 July 2019"
 T2M_NAME=scrot
-T2M_VERSION=1.0
+T2M_VERSION=1.1
 T2M_LEVEL=1
 T2M_DESC="command line screen capture utility"
 

man/scrot.1

@@ -1,5 +1,5 @@
 .\" Text automatically generated by txt2man
-.TH scrot 1 "10 June 2019" "scrot-1.0" "command line screen capture utility"
+.TH scrot 1 "09 July 2019" "scrot-1.1" "command line screen capture utility"
 .SH NAME
 \fBscrot \fP- command line screen capture utility
 \fB
@@ -75,6 +75,16 @@ together.
 .B
 \fB-s\fP, \fB--select\fP
 Interactively select a window or rectangle with the mouse.
+See \fB-l\fP and \fB-f\fP \fIoptions\fP.
+.TP
+.B
+\fB-l\fP, \fB--line\fP
+Indicates the style of the line when the \fB-s\fP option is used.
+See SELECTION STYLE.
+.TP
+.B
+\fB-f\fP, \fB--freeze\fP
+Freeze the screen when the \fB-s\fP option is used.
 .TP
 .B
 \fB-u\fP, \fB--focused\fP
@@ -95,24 +105,13 @@ Prevent beeping.
 Capture the mouse pointer.
 .TP
 .B
-\fB-f\fP, \fB--freeze\fP
-Freeze the screen when the selection is used: \fB--select\fP
-.TP
-.B
 \fB-o\fP, \fB--overwrite\fP
 By default \fBscrot\fP does not overwrite the files, use this option to allow it.
 .TP
 .B
-\fB-l\fP, \fB--line\fP
-Indicates the style of the line when the selection is used: \fB--select\fP
-See SELECTION STYLE
-.TP
-.B
 \fB-n\fP, \fB--note\fP
-Draw a text note.
-See NOTE FORMAT
+Draw a text note. See NOTE FORMAT.
 .SH SPECIAL STRINGS
-
 Both the \fB--exec\fP and filename parameters can take format specifiers that are
 expanded by \fBscrot\fP when encountered. There are two types of format specifier.
 Characters preceded by a '%' are interpreted by \fBstrftime\fP(2). See man strftime
@@ -136,37 +135,45 @@ following specifiers are recognised:
 
 .fam T
 .fi
-.SH EXAMPLE
-.TP
-.B
-\fBscrot\fP '%Y-%m-%d_$wx$h.png' \fB-e\fP 'mv $f ~/shots/'
-This would create a \fIfile\fP called something like 2000-10-30_2560x1024.png
-and move it to your shots directory.
-.RE
+Example:
 .PP
+.nf
+.fam C
+    scrot '%Y-%m-%d_$wx$h.png' -e 'mv $f ~/shots/'
 
+.fam T
+.fi
+This would create a \fIfile\fP called something like 2000-10-30_2560x1024.png
+and move it to your shots directory.
 .SH SELECTION STYLE
-
 When using \fB--select\fP you can indicate the style of the line with \fB--line\fP.
 .PP
 The following specifiers are recognised:
 .PP
 .nf
 .fam C
-                  style=(solid,dash),width=(range 1 to 8)
+    style=(solid,dash),width=(range 1 to 8)
 
 .fam T
 .fi
-The default style are:
-style=solid,width=1
-.SH EXAMPLE
-\fBscrot\fP \fB--line\fP style=dash,width=3 \fB--select\fP
-.RE
+The default style is:
 .PP
+.nf
+.fam C
+    style=solid,width=1
 
-.SH NOTE FORMAT
+.fam T
+.fi
+Example:
+.PP
+.nf
+.fam C
+    scrot --line style=dash,width=3 --select
 
-The following specifiers are recognised for the option \fB--note\fP
+.fam T
+.fi
+.SH NOTE FORMAT
+The following specifiers are recognised for the option \fB--note\fP:
 .PP
 .nf
 .fam C
@@ -178,10 +185,17 @@ The following specifiers are recognised for the option \fB--note\fP
 
 .fam T
 .fi
-.SH EXAMPLE
-\fBscrot\fP \fB--note\fP "\fB-f\fP '/usr/share/fonts/TTF/DroidSans-Bold/40' \fB-x\fP 10 \fB-y\fP 20 \fB-c\fP 255,0,0,255 \fB-t\fP 'Hi'"
+Example:
+.PP
+.nf
+.fam C
+    scrot --note "-f '/usr/share/fonts/TTF/DroidSans-Bold/40' -x 10 -y 20 -c 255,0,0,255 -t 'Hi'"
+
+.fam T
+.fi
 .SH AUTHOR
-\fBscrot\fP was originally developed by Tom Gilbert under MIT-advertising license.
+\fBscrot\fP was originally developed by Tom Gilbert under MIT-advertising license
+and is maintained by some people.
 .PP
 Currently, source code and newer versions are available at
 https://github.com/resurrecting-open-source-projects/\fBscrot\fP

man/scrot.txt

@@ -33,21 +33,21 @@ OPTIONS
   -m, --multidisp    For multiple heads, grab shot from each and join them
                      together.
   -s, --select       Interactively select a window or rectangle with the mouse.
+                     See -l and -f options.
+  -l, --line         Indicates the style of the line when the -s option is used.
+                     See SELECTION STYLE.
+  -f, --freeze       Freeze the screen when the -s option is used.
   -u, --focused      Use the currently focused window.
   -t, --thumb NUM|GEOM  Generate thumbnail too. NUM is the percentage of the
                         original size for the thumbnail to be. Alternatively,
                         a GEOMetry can be specified, example: 300x200
   -z, --silent       Prevent beeping.
   -p, --pointer      Capture the mouse pointer.
-  -f, --freeze       Freeze the screen when the selection is used: --select
+
   -o, --overwrite    By default scrot does not overwrite the files, use this option to allow it.
-  -l, --line         Indicates the style of the line when the selection is used: --select
-                     See SELECTION STYLE
-  -n, --note         Draw a text note.
-                     See NOTE FORMAT
+  -n, --note         Draw a text note. See NOTE FORMAT.
 
 SPECIAL STRINGS
-
   Both the --exec and filename parameters can take format specifiers that are
   expanded by scrot when encountered. There are two types of format specifier.
   Characters preceded by a '%' are interpreted by strftime(2). See man strftime
@@ -67,41 +67,44 @@ SPECIAL STRINGS
     $$  print a literal '$'
     \\n  print a newline (ignored when used in the filename)
 
-EXAMPLE
-  scrot '%Y-%m-%d_$wx$h.png' -e 'mv $f ~/shots/'  
-       This would create a file called something like 2000-10-30_2560x1024.png
-       and move it to your shots directory.
+  Example:
 
+    scrot '%Y-%m-%d_$wx$h.png' -e 'mv $f ~/shots/'
 
-SELECTION STYLE
+  This would create a file called something like 2000-10-30_2560x1024.png
+  and move it to your shots directory.
 
+SELECTION STYLE
   When using --select you can indicate the style of the line with --line.
 
   The following specifiers are recognised:
 
-                  style=(solid,dash),width=(range 1 to 8)
+    style=(solid,dash),width=(range 1 to 8)
 
-  The default style are:
-                  style=solid,width=1
-EXAMPLE
-  scrot --line style=dash,width=3 --select
+  The default style is:
 
+    style=solid,width=1
 
-NOTE FORMAT
+  Example:
+
+    scrot --line style=dash,width=3 --select
 
-  The following specifiers are recognised for the option --note
+NOTE FORMAT
+  The following specifiers are recognised for the option --note:
 
     -f 'FontName/size'
     -t 'text'
     -x position (optional)
     -y position (optional)
     -c color(RGBA) (optional)
 
-EXAMPLE
-  scrot --note "-f '/usr/share/fonts/TTF/DroidSans-Bold/40' -x 10 -y 20 -c 255,0,0,255 -t 'Hi'"
+  Example:
+
+    scrot --note "-f '/usr/share/fonts/TTF/DroidSans-Bold/40' -x 10 -y 20 -c 255,0,0,255 -t 'Hi'"
 
 AUTHOR
-  scrot was originally developed by Tom Gilbert under MIT-advertising license.
+  scrot was originally developed by Tom Gilbert under MIT-advertising license
+  and is maintained by some people.
 
   Currently, source code and newer versions are available at
   https://github.com/resurrecting-open-source-projects/scrot