Simplify verbose modes in the main function.

In the main function, verbose falgs "-v" change the layout of what is printed out.

The first -v would print two result formats,a nd teh subsequent two -vv would print either one of the two.

Now, single -v prints only the various single-unit results, double -vv prints compound time range only,a nd thrice -vv prints AST-style compound rage only.

This does not change printing a target single-unit result (when the last argument of the command line invocation is "y", "mo", and "d" for example.

This does not change the table layout option, either, meaning that to print the table layout now user may set simply "-vt".

Update README.md, help and man  pages.

Author: mountaineerbr

README.md

@@ -54,11 +54,11 @@ Setting the last argument of the command line to exactly `y`, `mo`, `w`, `d`, `m
 
 Alternatively, set `options -vvv` to filter the main output layout for specific fields.
 
-For example, print the **compound time range** only:
+For example, print the **compound time range** _only_:
 
 
 ```
-% datediff.sh -vvv tomorrow+6years+400hours+12seconds
+% datediff.sh -vv tomorrow+6years+400hours+12seconds
 
 6Y 00M 02W 03D  16h 00m 12s
 ```
@@ -71,31 +71,23 @@ prints two sections with processed dates (**DATES**) and time range results (**R
 
 The user can filter out which fields are going to be calculated and printed.
 
-Set the verbose `option -v` up to four times to select different layouts.
+Set the verbose `option -v` up to three times to select different layouts in
+the main function. Setting `-v` in other functions decrease verbose.
 
 
-Compound time range and all single unit results:
+All single unit results _only_:
 
 ```
 % datediff.sh -v 2008-01-15
 
-16Y 10M 00W 03D  21h 24m 19s
-16.8 years | 378.8 months | 879.0 weeks | 6152.9 days | 147669.4 hours | 8860164.3 mins | 531609859 secs
-```
-
-All single unit results only:
-
-```
-% datediff.sh -vv 2008-01-15
-
 16.8 years | 378.8 months | 879.0 weeks | 6152.9 days | 147669.4 hours | 8860165.2 mins | 531609914 secs
 ```
 
 <!--
-Compound time range only:
+Compound time range _only_:
 
 ```
-% datediff.sh -vvv 2008-01-15
+% datediff.sh -vv 2008-01-15
 
 16Y 10M 00W 03D  21h 25m 28s
 ```
@@ -105,7 +97,7 @@ Compound time range only:
 Compound time range (`AST date` style):
 
 ```
-% datediff.sh -vvvv 2008-01-15
+% datediff.sh -vvv 2008-01-15
 
 16Y10M00W03D21h25m34s
 ```
@@ -143,7 +135,7 @@ must set both `options -ttvv` at the command line incantation:
 
 
 ```
-% datediff.sh -3 -ttvv 2008-01-15
+% datediff.sh -3 -ttv 2008-01-15
 
 Years	       16.844
 Months	      378.833

datediff.sh

@@ -1,6 +1,6 @@
 #!/usr/bin/env ksh
 # datediff.sh - Calculate time ranges between dates
-# v0.25  nov/2024  mountaineerbr  GPLv3+
+# v0.25.1  dec/2024  mountaineerbr  GPLv3+
 [[ -n $BASH_VERSION ]] && shopt -s extglob  #bash2.05b+/ksh93u+/zsh5+
 [[ -n $ZSH_VERSION  ]] && setopt NO_SH_GLOB KSH_GLOB KSH_ARRAYS SH_WORD_SPLIT GLOB_SUBST
 
@@ -1129,7 +1129,7 @@ function mainf
 	fi
 
 	#single unit time durations (when `bc' is available)
-	if ((OPTT || OPTVERBOSE<3))
+	if ((OPTT || OPTVERBOSE<2))
 	then 	if bc=( $(bc <<<" /* round argument 'x' to 'd' digits */
 			define r(x, d) {
 				auto r, s
@@ -1226,10 +1226,10 @@ function mainf
 			"${date2_iso8601_pr:-${date2_iso8601:-$inputB}}" ''${unix2:+$'\t'} "$unix2"  \
 			"${BOLD}RANGES${NC}"
 	fi
-	((OPTVERBOSE<2 || OPTVERBOSE>2)) && { 	((OPTVERBOSE>3)) && v= || v=' '  #AST `date -E' style
+	((OPTVERBOSE<1 || OPTVERBOSE>1)) && { 	((OPTVERBOSE>2)) && v= || v=' '  #AST `date -E' style
 		printf "%dY${v}%02dM${v}%02dW${v}%02dD${v}${v}%02dh${v}%02dm${v}%02ds\n" "${sh[@]}"
 	}
-	((OPTVERBOSE<3)) && printf '%s\n' "${range_pr:-$range secs}"
+	((OPTVERBOSE<2)) && printf '%s\n' "${range_pr:-$range secs}"
 
 	return ${ret:-0}
 }
@@ -1331,7 +1331,7 @@ fi
 #set single time unit
 opt="${opt:-${@: -1}}" opt="${opt//[$IFS]}"
 if [[ $opt$OPTFF = $GLOBOPT ]]
-then 	OPTT=1 OPTVERBOSE=2 OPTLAYOUT=
+then 	OPTT=1 OPTVERBOSE=1 OPTLAYOUT=
 	case $opt in
 		[yY]) 	OPTTy=1;;
 		[mM][oO]) 	OPTTmo=1;;

man/README.md

@@ -1,8 +1,8 @@
 ---
 author:
 - Jamil Soni N
-date: November 2024
-title: DATEDIFF.SH(1) v0.25 \| General Commands Manual
+date: December 2024
+title: DATEDIFF.SH(1) v0.25.1 \| General Commands Manual
 ---
 
 # NAME
@@ -70,7 +70,10 @@ Output “DATES” section prints two dates in **ISO-8601 format** or, if
 in the main function. This affects how the `C-code date` programme
 process dates.
 
-Set **options -vvv** to print different output layouts.
+In the main function, set **options -v** to print only the single-unit
+results and **-vv** to print only the compound time range result.
+
+In other function, set **options -v** to decrease verbose.
 
 ### Extra Functions
 

man/datediff.sh.1

@@ -1,6 +1,6 @@
 .\" Automatically generated by Pandoc 3.1.11.1
 .\"
-.TH "DATEDIFF.SH" "1" "November 2024" "v0.25" "General Commands Manual"
+.TH "DATEDIFF.SH" "1" "December 2024" "v0.25.1" "General Commands Manual"
 .SH NAME
 .PP
 \ \ \ \f[B]datediff.sh\f[R] \- Calculate time ranges / intervals between
@@ -83,7 +83,11 @@ format\f[R].
 (UTC) in the main function.
 This affects how the \f[CR]C\-code date\f[R] programme process dates.
 .PP
-Set \f[B]options \-vvv\f[R] to print different output layouts.
+In the main function, set \f[B]options \-v\f[R] to print only the
+single\-unit results and \f[B]\-vv\f[R] to print only the compound time
+range result.
+.PP
+In other function, set \f[B]options \-v\f[R] to decrease verbose.
 .SS Extra Functions
 \f[B]Option \-e\f[R] prints Easter dates for given \f[I]YEARS\f[R] (for
 Western Churches) and \f[B]option \-ee\f[R] additionally prints Carnaval

man/datediff.sh.1.md

@@ -1,6 +1,6 @@
-% DATEDIFF.SH(1) v0.25 | General Commands Manual
+% DATEDIFF.SH(1) v0.25.1 | General Commands Manual
 % Jamil Soni N
-% November 2024
+% December 2024
 
 
 # NAME
@@ -67,7 +67,10 @@ Output "DATES" section prints two dates in **ISO-8601 format** or, if
 **Option -u** sets or prints dates in Coordinated Universal Time (UTC)
 in the main function. This affects how the `C-code date` programme process dates.
 
-Set **options -vvv** to print different output layouts.
+In the main function, set **options -v** to print only the single-unit results
+and **-vv** to print only the compound time range result.
+
+In other function, set **options -v** to decrease verbose.
 
 
 ### Extra Functions

man/datediff.sh.html

@@ -5,7 +5,7 @@
   <meta name="generator" content="pandoc" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
   <meta name="author" content="Jamil Soni N" />
-  <title>DATEDIFF.SH(1) v0.25 | General Commands Manual</title>
+  <title>DATEDIFF.SH(1) v0.25.1 | General Commands Manual</title>
   <style>
     html {
       color: #1a1a1a;
@@ -171,9 +171,9 @@
 </head>
 <body>
 <header id="title-block-header">
-<h1 class="title">DATEDIFF.SH(1) v0.25 | General Commands Manual</h1>
+<h1 class="title">DATEDIFF.SH(1) v0.25.1 | General Commands Manual</h1>
 <p class="author">Jamil Soni N</p>
-<p class="date">November 2024</p>
+<p class="date">December 2024</p>
 </header>
 <h1 id="name">NAME</h1>
 <div class="line-block">   <strong>datediff.sh</strong> - Calculate time
@@ -234,8 +234,11 @@ <h3 id="main-output">Main Output</h3>
 <p><strong>Option -u</strong> sets or prints dates in Coordinated
 Universal Time (UTC) in the main function. This affects how the
 <code>C-code date</code> programme process dates.</p>
-<p>Set <strong>options -vvv</strong> to print different output
-layouts.</p>
+<p>In the main function, set <strong>options -v</strong> to print only
+the single-unit results and <strong>-vv</strong> to print only the
+compound time range result.</p>
+<p>In other function, set <strong>options -v</strong> to decrease
+verbose.</p>
 <h3 id="extra-functions">Extra Functions</h3>
 <p><strong>Option -e</strong> prints Easter dates for given
 <em>YEARS</em> (for Western Churches) and <strong>option -ee</strong>

man/datediff.sh.txt

@@ -1,6 +1,6 @@
-DATEDIFF.SH(1) v0.25 | General Commands Manual
+DATEDIFF.SH(1) v0.25.1 | General Commands Manual
 Jamil Soni N
-November 2024
+December 2024
 
 NAME
 
@@ -64,7 +64,10 @@ Option -u sets or prints dates in Coordinated Universal Time (UTC) in
 the main function. This affects how the C-code date programme process
 dates.
 
-Set options -vvv to print different output layouts.
+In the main function, set options -v to print only the single-unit
+results and -vv to print only the compound time range result.
+
+In other function, set options -v to decrease verbose.
 
 Extra Functions