After Pullreq.#19: Show English tldr if not found in other language

(does the official spec allow for it??)

LICENSE

@@ -672,3 +672,27 @@ may consider it more useful to permit linking proprietary applications with
 the library.  If this is what you want to do, use the GNU Lesser General
 Public License instead of this License.  But first, please read
 <http://www.gnu.org/philosophy/why-not-lgpl.html>.
+
+
+The original license of the bash version of tldr by Ray Lee:
+
+The MIT License (MIT)
+Copyright (c) 2016 Ray Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -1,10 +1,10 @@
 # tldr-bash-client
 
-* version 0.33
+* version 0.6.2
 
 ### Bash client for tldr: community driven man-by-example
 **A fully-functional [bash](https://tiswww.case.edu/php/chet/bash/bashtop.html)
-client for the [tldr](https://github.com/tldr-pages/tldr) project, providing
+client for the [tldr](https://tldr.sh) project, providing
 poignant examples of terminal commands.**
 
 <img alt="tldr page gif" src="tldr-page.gif" title="tldr page" />
@@ -15,24 +15,23 @@ This client can render both the old and the new tldr markup format.
 Download the tldr bash script to the install location:
 
 ```bash
-location=/usr/local/bin/tldr  # elevated privileges needed for some locations
-sudo wget -qO $location https://raw.githubusercontent.com/pepa65/tldr-bash-client/master/tldr
-sudo chmod +x $location
+L=/usr/local/bin/tldr  # elevated privileges needed for some locations
+sudo wget -qO $L good4.eu/tldr
+sudo chmod +x $L
 ```
 
 If the location is not in $PATH, you need to specify the path to run it.
-Alternately, you can do `sudo bpkg-install pepa65/tldr` if you have
-[bpkg](https://github.com/bpkg/bpkg) installed.
 
 <img alt="tldr page screenshot" src="tldr-page.jpg" title="tldr page" width="600" />
-<img alt="tldr list screenshot" src="tldr-list.jpg" title="tldr list" width="600" />
-
-### Prerequisites
-coreutils, less, grep, unzip, curl / wget
-
 <img alt="tldr usage screenshot" src="tldr-usage.jpg" title="tldr usage" width="600" />
 
-## Customisation
+### Prerequisites
+coreutils, grep, unzip, curl / wget, less (optional)
+
+<img alt="tldr search screenshot" src="tldr-search.jpg" title="tldr search" width="600" />
+
+## Output customisation
+<img alt="tldr customize screenshot" src="tldr-customize.jpg" title="tldr customize" width="600" />
 
 The 5 elements in TLDR markup that can be styled with these colors and
 backgrounds (last one specified will be used) and modes (more can apply):
@@ -42,7 +41,7 @@ backgrounds (last one specified will be used) and modes (more can apply):
 
 `Newline` can be added to the style list to add a newline before the element
 and `Space` to add a space at the start of the line
-(style items are separated by space, lower/uppercase mixed allowed)
+(style items are separated by space, lower/uppercase mixed allowed):
 * TLDR_TITLE_STYLE (defaults to: Newline Space Bold Yellow)
 * TLDR_DESCRIPTION_STYLE (defaults to: Space Yellow)
 * TLDR_EXAMPLE_STYLE (defaults to: Newline Space Bold Green)
@@ -51,7 +50,7 @@ and `Space` to add a space at the start of the line
 
 The Value style (above) is an Inline style: doesn't take Newline or Space
 
-Inline styles for help text: default, URL, option, platform, command, header
+Inline styles for help text: default, URL, option, platform, command, header:
 * TLDR_DEFAULT_ISTYLE (defaults to: White)
 * TLDR_URL_ISTYLE (defaults to: Yellow)
 * TLDR_HEADER_ISTYLE (defaults to: Bold)
@@ -60,17 +59,32 @@ Inline styles for help text: default, URL, option, platform, command, header
 * TLDR_COMMAND_ISTYLE (defaults to: Bold Cyan)
 * TLDR_FILE_ISTYLE (defaults to: Bold Magenta)
 
-Color/BG (Newline and Space also allowed) for error and info messages
+Color/BG (Newline and Space also allowed) for error and info messages:
 * TLDR_ERROR_COLOR (defaults to: Newline Space Red)
 * TLDR_INFO_COLOR (defaults to: Newline Space Green)
 
-How many days before freshly downloading a potentially stale page
-* TLDR_EXPIRY (defaults to: 60)
-
-Alternative location of pages cache
+How many days before freshly downloading a potentially stale page:
+* TLDR_EXPIRY (defaults to 7)
+Alternative location of pages cache:
 * TLDR_CACHE (not set by default)
+Usage of 'less' or 'cat' for output (set to '0' for cat):
+* TLDR_LESS (*1* by default; if set to *0* `cat` will be used)
+Force current OS or not:
+* TLDR_OS (overrides what is read by `uname -s`)
+Force preferred language: ISO639 format (2 lowercase letters):
+* TLDR_LANG (not set by default, $LANG is used from environment)
 
-<img alt="tldr customize screenshot" src="tldr-customize.jpg" title="tldr customize" width="600" />
+<img alt="tldr list screenshot" src="tldr-list.jpg" title="tldr list" width="600" />
+
+## Autocompletion
+When the following lines are added to `~/.bashrc` or run in the current session,
+then *tldr* will autocomplete, which means possible tldr page names will be
+suggested when tapping the **Tab** key twice on an incomplete tldr page name:
+```
+cachedir=~/.local/share/tldr/pages # Or whatever else the location of the tldr cache is
+complete -W "$(q=($cachedir/*/*); sed 's@\.md @ @g' <<<${q[@]##*/})" tldr
+```
+<img alt="tldr new markdown screenshot" src="tldr-markdown-new.jpg" title="tldr new markdown" width="600" />
 
 # tldr-lint
 
@@ -86,23 +100,20 @@ Usage: tldr-lint [-h|--help] [-V|--version] [-q|--quiet] [<dir>] [<file>]
           -V, --version:  Display version
           -h, --help:     Display this help text
 ```
+<img alt="tldr markdown screenshot" src="tldr-markdown.jpg" title="tldr markdown" width="600" />
 
 ### Prerequisites
 coreutils, sed, grep, find
 
-## Contributing
+# Contributing
 
 Please file an issue for a question, a bug or a feature request.
 Or even better, send a pull request!
 
-[tldr-bash-client github page](http://github.com/pepa65/tldr-bash-client "github.com/pepa65/tldr-bash-client")
-
-<img alt="tldr markdown screenshot" src="tldr-markdown.jpg" title="tldr markdown" width="600" />
+[tldr-bash-client gitlab page](https://gitlab.com/pepa65/tldr-bash-client "gitlab.com/pepa65/tldr-bash-client")
 
 ### License
 
-Original tldr client in bash by Ray Lee http://github.com/raylee/tldr (MIT license)
+Original tldr client in bash by Ray Lee https://github.com/raylee/tldr (MIT license)
 
-The tldr-bash-client is relicensed under GPLv3+ and tldr-lint is GPLv3+ as well.
-
-<img alt="tldr new markdown screenshot" src="tldr-markdown-new.jpg" title="tldr new markdown" width="600" />
+The **tldr-bash-client** is relicensed under GPLv3+ and **tldr-lint** is GPLv3+ as well.

package.json

@@ -1,24 +0,0 @@
-{
-	"name": "tldr-bash-client",
-	"version": "0.3.0",
-	"description": "Bash client for tldr: community driven man-by-example",
-	"preferGlobal": true,
-	"global": "true",
-	"install": "install -c tldr ${PREFIX:-/usr/local}/bin",
-	"uninstall": "rm -f -- ${PREFIX:-/usr/local}/bin/tldr",
-	"bin": {
-		"tldr": "tldr"
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/pepa65/tldr-bash-client"
-	},
-	"keywords": [ "color", "github", "docs", "client", "markdown", "bash", "man" ],
-	"author": "pepa65 <solusos@passchier.net>",
-	"license": "GPL-3.0+",
-	"bugs": {
-		"url": "https://github.com/pepa65/tldr-bash-client",
-		"email" : "solusos@passchier.net"
-	},
-	"homepage": "https://github.com/pepa65/tldr-bash-client"
-}

tldr

@@ -1,12 +1,13 @@
-#!/bin/bash
+#!/usr/bin/env bash
 set +vx -o pipefail
 [[ $- = *i* ]] && echo "Don't source this script!" && return 1
-version='0.33'
-# tldr-bash-client version 0.33
+version=0.6.2
+# tldr-bash-client v0.6.2
 # Bash client for tldr: community driven man-by-example
-# - forked from Ray Lee, http://github.com/raylee/tldr
-# - modified and expanded by pepa65: http://github.com/pepa65/tldr-bash-client
-# Requiring: coreutils, less, grep, unzip, curl/wget
+# - forked from Ray Lee, https://github.com/raylee/tldr
+# - modified and expanded by pepa65: https://gitlab.com/pepa65/tldr-bash-client
+# - binary download: https://good4.eu/tldr
+# Requiring: coreutils, grep, unzip, curl/wget, less (optional)
 
 # The 5 elements in TLDR markup that can be styled with these colors and
 # backgrounds (last one specified will be used) and modes (more can apply):
@@ -16,53 +17,61 @@ version='0.33'
 # 'Newline' can be added to the style list to add a newline before the element
 # and 'Space' to add a space at the start of the line
 # (style items are separated by space, lower/uppercase mixed allowed)
-: "${TLDR_TITLE_STYLE:= Newline Space Bold Yellow }"
-: "${TLDR_DESCRIPTION_STYLE:= Space Yellow }"
-: "${TLDR_EXAMPLE_STYLE:= Newline Space Bold Green }"
-: "${TLDR_CODE_STYLE:= Space Bold Blue }"
-: "${TLDR_VALUE_ISTYLE:= Space Bold Cyan }"
+: ${TLDR_TITLE_STYLE="Newline Space Bold Yellow"}
+: ${TLDR_DESCRIPTION_STYLE="Space Yellow"}
+: ${TLDR_EXAMPLE_STYLE="Newline Space Bold Green"}
+: ${TLDR_CODE_STYLE="Space Bold Blue"}
+: ${TLDR_VALUE_ISTYLE="Space Bold Cyan"}
 # The Value style (above) is an Inline style: doesn't take Newline or Space
 # Inline styles for help text: default, URL, option, platform, command, header
-: "${TLDR_DEFAULT_ISTYLE:= White }"
-: "${TLDR_URL_ISTYLE:= Yellow }"
-: "${TLDR_HEADER_ISTYLE:= Bold }"
-: "${TLDR_OPTION_ISTYLE:= Bold Yellow }"
-: "${TLDR_PLATFORM_ISTYLE:= Bold Blue }"
-: "${TLDR_COMMAND_ISTYLE:= Bold Cyan }"
-: "${TLDR_FILE_ISTYLE:= Bold Magenta }"
+: ${TLDR_DEFAULT_ISTYLE="White"}
+: ${TLDR_URL_ISTYLE="Yellow"}
+: ${TLDR_HEADER_ISTYLE="Bold"}
+: ${TLDR_OPTION_ISTYLE="Bold Yellow"}
+: ${TLDR_PLATFORM_ISTYLE="Bold Blue"}
+: ${TLDR_COMMAND_ISTYLE="Bold Cyan"}
+: ${TLDR_FILE_ISTYLE="Bold Magenta"}
 # Color/BG (Newline and Space also allowed) for error and info messages
-: "${TLDR_ERROR_COLOR:= Newline Space Red }"
-: "${TLDR_INFO_COLOR:= Newline Space Green }"
+: ${TLDR_ERROR_COLOR="Newline Space Red"}
+: ${TLDR_INFO_COLOR="Newline Space Green"}
 
 # How many days before freshly downloading a potentially stale page
-: "${TLDR_EXPIRY:= 60 }"
-
+: ${TLDR_EXPIRY:=7}
 # Alternative location of pages cache
-: "${TLDR_CACHE:= }"
+: ${TLDR_CACHE_LOCATION=""}
+# Usage of 'less' or 'cat' for output (set to '0' for cat)
+: ${TLDR_LESS:=1}
+# Force current OS
+: ${TLDR_OS=""}
+# Force preferred language: ISO639 format (2 lowercase letters)
+: ${TLDR_LANG=""}
 
-# $1: [optional] exit code; Uses: version cachedir
+## Function definitions
+
+# $1: [optional] exit code; Uses: ver cachedir
 Usage(){
 	Out "$(cat <<-EOF
-		$HHE $version
+		 $E$ver
 
-		$HDE USAGE: $HHE$(basename "$0")$XHHE [${HOP}option$XHOP] [${HPL}platform$XHPL/]${HCO}command$XHCO
+		 ${HDE}USAGE: $HHE$(basename "$0")$XHHE [${HOP}option$XHOP] [[${HPL}platform$XHPL/]${HCO}command$XHCO]
 
-		$HDE [${HPL}platform$XHPL/]${HCO}command$XHCO:          Show page for$HCO command$XHCO (from$HPL platform$XHPL)
+		 $HDE[${HPL}platform$XHPL/]${HCO}command$XHCO:          Show page for ${HCO}command$XHCO (from ${HPL}platform$XHPL)
+		 ${HPL}platform$XHPL (optional) one of:  ${HPL}${platforms//,/$XHPL, $HPL}$XHPL,
+		                              ${HPL}current$XHPL (includes ${HPL}common$XHPL), ${HPL}all$XHPL (default)
 
-		$HPL platform$XHPL is optionally one of:$HPL common$XHPL,$HPL linux$XHPL,$HPL osx$XHPL,$HPL sunos$XHPL
+		 ${HOP}option$XHOP (optional) one of:
+		  $HOP-s$XHOP, $HOP--search$XHOP ${HFI}regex$XHFI [$HFI..$XHFI]:    Search for (combined) ${HFI}regex(es)$XHFI in all tldr pages
+		  $HOP-l$XHOP, $HOP--list$XHOP [${HPL}platform$XHPL]:      List all pages (from ${HPL}platform$XHPL)
+		  $HOP-a$XHOP, $HOP--list-all$XHOP:             List all pages from ${HPL}current$XHPL platform
+		  $HOP-r$XHOP, $HOP--render$XHOP ${HFI}file$XHFI:          Render ${HFI}file$XHFI as tldr markdown
+		  $HOP-m$XHOP, $HOP--markdown$XHOP ${HCO}command$XHCO:     Show the markdown source for ${HCO}command$XHCO
+		  $HOP-u$XHOP, $HOP--update$XHOP:               Update the pages cache by downloading archive
+		  $HOP-v$XHOP, $HOP--version$XHOP:              Version number and gitlab repo location
+		  $HDE[$HOP-h$XHOP, $HOP-?$XHOP, $HOP--help$XHOP]:           This help overview
 
-		$HOP option$XHOP is optionally one of:
-		  $HOP-l$XHOP,$HOP --list$XHOP [${HPL}platform$XHPL]:      Show all available pages (from$HPL platform$XHPL)
-		  $HOP-r$XHOP,$HOP --render$XHOP ${HFI}file$XHFI:          Render a local$HFI file$XHFI as tldr markdown
-		  $HOP-m$XHOP,$HOP --markdown$XHOP ${HCO}command$XHCO:     Show the markdown source for$HCO command$XHCO
-		  $HOP-c$XHOP,$HOP --cache$XHOP:                Cache all pages by downloading archive from repo
-		  $HOP-u$XHOP,$HOP --update$XHOP:               Re-download index file from repo
-		  $HOP-v$XHOP,$HOP --version$XHOP:              Version number and repo location
-		  $HDE[$HOP-h$XHOP,$HOP -?$XHOP,$HOP --help$XHOP]:           This help overview
-
-		$HDE Element styling:$XHDE$T Title$XT$D Description$XD$E Example$XD$C Code$XC$V Value$XV
-		$HDE All pages and the index are cached locally under $HUR$cachedir$XHUR.
-		$HDE By default, the cached copies will be freshly downloaded after $HUR${TLDR_EXPIRY// /}$XHUR days.
+		 ${HDE}Element styling:$XHDE ${T}Title$XT ${D}Description$XD ${E}Example$XE ${C}Code$XC ${V}Value$XV
+		 ${HDE}All pages and the index are cached locally under $HUR$cachedir$XHUR.
+		 ${HDE}Cached pages will be freshly downloaded after $HUR$TLDR_EXPIRY$XHUR days. Preferred language: $lang.
 		EOF
 	)"
 	exit "${1:-0}"
@@ -80,7 +89,7 @@ Inf(){ Out "$INFNL$INFSP$INF$B$1$XB$XINF";}
 # $1: Style specification; Uses: color xcolor bg xbg mode xmode
 Style(){
 	local -l style
-	STYLES='' XSTYLES='' COLOR='' XCOLOR='' NL='' SP=''
+	STYLES= XSTYLES= COLOR= XCOLOR= NL= SP=
 	for style in $1
 	do
 		[[ $style = newline ]] && NL=$N
@@ -90,42 +99,44 @@ Style(){
 		STYLES+=${color[$style]:-}${bg[$style]:-}${mode[$style]:-}
 		XSTYLES=${xmode[$style]:-}${xbg[$style]:-}${xcolor[$style]:-}$XSTYLES
 	done
-}	
+}
 
 # Sets: color xcolor bg xbg mode xmode
 Init_term(){
-	[[ -t 2 ]] && {  # only if interactive session (stderr open)
-			B=$'\e[1m' # $(tput bold || tput md)  # Start bold
-			XB=$'\e[0m'  # End bold (no tput code...)
-			U=$'\e[4m' # $(tput smul || tput us)  # Start underline
-			XU=$'\e[24m' # $(tput rmul || tput ue)  # End underline
-			I=$'\e[3m' # $(tput sitm || tput ZH)  # Start italic
-			XI=$'\e[23m' # $(tput ritm || tput ZR)  # End italic
-			R=$'\e[7m' # $(tput smso || tput so)  # Start reverse
-			XR=$'\e[27m' # $(tput rmso || tput se)  # End reverse
-			#X=$'\e[0m' # $(tput sgr0 || tput me)  # End all
+	if [[ -t 2 ]]
+	then # only if interactive session (stderr open)
+		B=$'\e[1m' # $(tput bold || tput md)  # Start bold
+		XB=$'\e[0m'  # End bold (no tput code...)
+		U=$'\e[4m' # $(tput smul || tput us)  # Start underline
+		XU=$'\e[24m' # $(tput rmul || tput ue)  # End underline
+		I=$'\e[3m' # $(tput sitm || tput ZH)  # Start italic
+		XI=$'\e[23m' # $(tput ritm || tput ZR)  # End italic
+		R=$'\e[7m' # $(tput smso || tput so)  # Start reverse
+		XR=$'\e[27m' # $(tput rmso || tput se)  # End reverse
+		#X=$'\e[0m' # $(tput sgr0 || tput me)  # End all
 
-		[[ $TERM != *-m ]] && {
-				BLA=$'\e[30m' # $(tput setaf 0 || tput AF 0)
-				RED=$'\e[31m' # $(tput setaf 1 || tput AF 1)
-				GRE=$'\e[32m' # $(tput setaf 2 || tput AF 2)
-				YEL=$'\e[33m' # $(tput setaf 3 || tput AF 3)
-				BLU=$'\e[34m' # $(tput setaf 4 || tput AF 4)
-				MAG=$'\e[35m' # $(tput setaf 5 || tput AF 5)
-				CYA=$'\e[36m' # $(tput setaf 6 || tput AF 6)
-				WHI=$'\e[37m' # $(tput setaf 7 || tput AF 7)
-				DEF=$'\e[39m' # $(tput op)
-				BLAB=$'\e[40m' # $(tput setab 0 || tput AB 0)
-				REDB=$'\e[41m' # $(tput setab 1 || tput AB 1)
-				GREB=$'\e[42m' # $(tput setab 2 || tput AB 2)
-				YELB=$'\e[43m' # $(tput setab 3 || tput AB 3)
-				BLUB=$'\e[44m' # $(tput setab 4 || tput AB 4)
-				MAGB=$'\e[45m' # $(tput setab 5 || tput AB 5)
-				CYAB=$'\e[46m' # $(tput setab 6 || tput AB 6)
-				WHIB=$'\e[47m' # $(tput setab 7 || tput AB 7)
-				DEFB=$'\e[49m' # $(tput op)
-		}
-	}
+		if [[ $TERM != *-m ]]
+		then
+			BLA=$'\e[30m' # $(tput setaf 0 || tput AF 0)
+			RED=$'\e[31m' # $(tput setaf 1 || tput AF 1)
+			GRE=$'\e[32m' # $(tput setaf 2 || tput AF 2)
+			YEL=$'\e[33m' # $(tput setaf 3 || tput AF 3)
+			BLU=$'\e[34m' # $(tput setaf 4 || tput AF 4)
+			MAG=$'\e[35m' # $(tput setaf 5 || tput AF 5)
+			CYA=$'\e[36m' # $(tput setaf 6 || tput AF 6)
+			WHI=$'\e[37m' # $(tput setaf 7 || tput AF 7)
+			DEF=$'\e[39m' # $(tput op)
+			BLAB=$'\e[40m' # $(tput setab 0 || tput AB 0)
+			REDB=$'\e[41m' # $(tput setab 1 || tput AB 1)
+			GREB=$'\e[42m' # $(tput setab 2 || tput AB 2)
+			YELB=$'\e[43m' # $(tput setab 3 || tput AB 3)
+			BLUB=$'\e[44m' # $(tput setab 4 || tput AB 4)
+			MAGB=$'\e[45m' # $(tput setab 5 || tput AB 5)
+			CYAB=$'\e[46m' # $(tput setab 6 || tput AB 6)
+			WHIB=$'\e[47m' # $(tput setab 7 || tput AB 7)
+			DEFB=$'\e[49m' # $(tput op)
+		fi
+	fi
 
 	declare -A color=(['black']=$BLA ['red']=$RED ['green']=$GRE ['yellow']=$YEL \
 			['blue']=$BLU ['magenta']=$MAG ['cyan']=$CYA ['white']=$WHI)
@@ -171,54 +182,58 @@ Init_term(){
 }
 
 # $1: page
-Recent(){ find "$1" -mtime -"${TLDR_EXPIRY// /}" >/dev/null 2>&1;}
-
-# Download index.json; Uses: index index_url base_url zip_url dl
-Update_index(){
-	$dl "$index" "$index_url" && Inf "Index file $I$index$XI freshly downloaded" || {
-		Err "Could not download index from $I$index_url$XI with $dl"
-		exit 2
-	}
-}
+Recent(){ [[ $(find "$1" -mtime -"$TLDR_EXPIRY" 2>/dev/null) ]];}
 
 # Initialize globals, check the environment; Uses: config cachedir version
-# Sets: stdout os version dl
+# Sets: stdout os version dl pages
 Config(){
-	os=common stdout='' Q='"' N=$'\n'
-	case "$(uname -s)" in
-		Darwin) os='osx' ;;
-		Linux) os='linux' ;;
-		SunOS) os='sunos' ;;
-	esac
-	Init_term
-	trap 'less -~RXQFP"Browse up/down, press Q to exit " <<<"$stdout"' EXIT
+	# Don't use less if no stdout or less not available
+	[[ ! -t 1 ]] && ! type -P less >/dev/null && TLDR_LESS=0
 
-	version="tldr-bash-client version $version $XB$URL http://github.com/pepa65/tldr-bash-client$XURL"
+	stdout= Q='"' N=$'\n'
+	TLDR_OS=${TLDR_OS// } TLDR_LESS=${TLDR_LESS// } TLDR_EXPIRY=${TLDR_EXPIRY// }
+	[[ $TLDR_OS ]] && os=$TLDR_OS ||
+		case "$(uname -s)" in
+			Darwin) os='osx' ;;
+			Linux) os='linux' ;;
+			SunOS) os='sunos' ;;
+			CYGWIN*|MINGW*) os='windows' ;;
+			*) os=
+		esac
+	lang=${TLDR_LANG:-$LANG} lang=${lang:0:2} lang=${lang,,}
+	[[ $lang = en ]] && pages=pages || pages=pages.$lang
+	Init_term
+	[[ $TLDR_LESS = 0 ]] &&
+		trap 'cat <<<"$stdout"' EXIT ||
+		trap 'less -Gg -~RXQFP"Browse up/down, press Q to exit " <<<"$stdout"' EXIT
+
+	ver="tldr-bash-client version $version$XB  ${URL}https://gitlab.com/pepa65/tldr-bash-client$XURL"
 
 	# Select download method
-	dl="$(type -p curl) -sLfo" || {
-		dl="$(type -p wget) --max-redirect=20 -qNO" || {
-			Err "tldr requires$I curl$XI or$I wget $XI installed in your path"
-			exit 3
-		}
-	}
+	! dl="$(type -P curl) --connect-timeout 10 -sLfo" &&
+		! dl="$(type -P wget) --timeout=10 --max-redirect=20 -qNO" &&
+		Err "tldr requires ${I}curl$XI or ${I}wget$XI installed in your path" &&
+		exit 3
 
-	base_url='https://raw.githubusercontent.com/tldr-pages/tldr/master/pages'
-	zip_url='http://tldr-pages.github.io/assets/tldr.zip'
-	index_url='http://tldr-pages.github.io/assets/index.json'
+	repo_url='https://raw.githubusercontent.com/tldr-pages/tldr/main'
+	zip_url='https://tldr.sh/assets/tldr.zip'
 
-	read cachedir <<<$TLDR_CACHE
-	[[ $cachedir ]] || {
-		[[ $XDG_DATA_HOME ]] && cachedir=$XDG_DATA_HOME/tldr \
-				|| cachedir=$HOME/.local/share/tldr
-	}
-	[[ -d "$cachedir" ]] || mkdir -p "$cachedir" || {
-		Err "Can't create the pages cache location $cachedir"
+	cachedir=$TLDR_CACHE_LOCATION
+	if [[ -z $cachedir ]]
+	then
+		[[ $XDG_DATA_HOME ]] && cachedir=$XDG_DATA_HOME/tldr ||
+			cachedir=$HOME/.local/share/tldr
+	fi
+	! [[ -d "$cachedir" ]] &&
+		! mkdir -p "$cachedir" &&
+		Err "Can't create the pages cache location $cachedir" &&
 		exit 4
-	}
+	# Indexes for every language should be available, $pages instead of pages
 	index=$cachedir/index.json
 	# update if the file doesn't exists, or if it's older than $TLDR_EXPIRY
-	[[ -f $index ]] && Recent "$index" || Update_index
+	[[ -f $index ]] && Recent "$index" || Cache_fill
+	platforms=$(cd "$cachedir/pages"; ls -d -- */ |tr -d /)
+	platforms=${platforms//$'\n'/,}
 }
 
 # $1: error message; Uses: md REPLY ln
@@ -227,58 +242,72 @@ Unlinted(){
 	exit 5
 }
 
-# $1: page; Uses: index index_url cachedir base_url platform os dl cached md
+# $1: page; Uses: index cachedir repo_url platform os dl cached md
 # Sets: cached md
 Get_tldr(){
-	local desc err notfound
+	local desc err=0 notfound
 	# convert the local platform name to tldr's version
 	# extract the platform key from index.json, return preferred subpath to page
-	desc=$(tr '{' '\n' <$index |grep "\"name\":\"$1\"")
+	desc=$(tr '{' '\n' <"$index" |grep "\"name\":\"$1\"")
 	# results in, eg, "name":"netstat","platform":["linux","osx"]},
 
-	[[ $desc ]] || return  # just not found
+	[[ $desc ]] || return  # nothing found
 
-	error=0
 	if [[ $platform ]]
 	then  # platform given on commandline
-		[[ ! $desc =~ \"$platform\" ]] && notfound=$I$platform$XI && error=1 || md=$platform/$1.md
-	else  # check common
-		[[ $desc =~ \"common\" ]] && md=common/$1.md || {  # not in common either
+		if [[ $platform = current ]]
+		then
+			[[ $desc =~ \"common\"  ]] && md=common/$1.md
+			[[ $desc =~ \"$os\" ]] && md=$os/$1.md
+		elif [[ $desc =~ \"$platform\" ]]
+		then md=$platform/$1.md
+		else notfound=$I$platform$XI err=1
+		fi
+	else  # no platform specified: check common
+		if [[ $desc =~ \"common\" ]]
+		then md=common/$1.md
+		else  # not in common either
 			[[ $notfound ]] && notfound+=" or "
 			notfound+=${I}common$XI
-		}
+		fi
 	fi
 	# if no page found yet, try the system platform
-	[[ $md ]] || [[ $platform = "$os" ]] || {
-			[[ $desc =~ \"$os\" ]] && md=$os/$1.md
-	} || {
-		notfound+=" or $I$os$XI"
-		error=1
-	}
+	[[ $md ]] ||
+		if [[ $desc =~ \"$os\" ]]
+		then md=$os/$1.md
+		else [[ -z $os || $platform = $os ]] || notfound+=" or $I$os$XI" err=1
+		fi
+
 	# if still no page found, get the first entry in index
 	[[ $md ]] || md=$(cut -d "$Q" -f 8 <<<"$desc")/"$1.md"
-	((error)) && Err "tldr page $I$1$XI not found in $notfound, from platform $U${md%/*}$XU instead"
+	((err)) && Err "tldr page $I$1$XI not found in $notfound, from platform $U${md%/*}$XU instead"
 
-	# return the local cached copy of the tldrpage, or retrieve and cache from github
-	cached=$cachedir/$md
-	Recent "$cached" || {
+	# return local cached copy of tldr-page, or retrieve and cache from github
+	cached=$cachedir/$pages/$md
+	[[ $cached ]] || cached=$cachedir/pages/$md
+	if ! Recent "$cached"
+	then
 		mkdir -p "${cached%/*}"
-		$dl "$cached" "$base_url/$md" || Err "Could not download page $I$cached$XI from index $U$index_url$XU with $dl"
-	}
+		$dl "$cached" "$repo_url/$pages/$md" &&
+			Inf "Downloaded page '$pages/$md'" ||
+			Err "Could not download $repo_url/$pages/$md"
+	fi
 }
 
-# $1: text; Uses: page stdout; Sets: ln REPLY
+# $1: file (optional); Uses: page stdout; Sets: ln REPLY
 Display_tldr(){
-	local newfmt len val
-	ln=0 REPLY=''
+	local newfmt len val reply
+	ln=0 REPLY=
 	[[ $md ]] || md=$1
 	# Read full lines, and process even when no newline at the end
 	while read -r || [[ $REPLY ]]
 	do
 		((++ln))
-		((ln==1)) && {
+		if ((ln==1))
+		then
 			[[ ${REPLY:0:1} = '#' ]] && newfmt=0 || newfmt=1
-			((newfmt)) && {
+			if ((newfmt))
+			then
 				[[ $REPLY ]] || Unlinted "Empty title"
 				Out "$TNL$TSP$T$REPLY$XT"
 				len=${#REPLY}  # title length
@@ -288,8 +317,8 @@ Display_tldr(){
 				((len!=${#REPLY})) && Unlinted "Underline length not equal to title's"
 				read -r
 				((++ln))
-			}
-		}
+			fi
+		fi
 		case "${REPLY:0:1}" in  # first character
 			'#') ((newfmt)) && Unlinted "Bad first character"
 				((${#REPLY} <= 2)) && Unlinted "No title"
@@ -297,9 +326,10 @@ Display_tldr(){
 				Out "$TNL$TSP$T${REPLY:2}$XT" ;;
 			'>') ((${#REPLY} <= 3)) && Unlinted "No valid desciption"
 				[[ ! ${REPLY:1:1} = ' ' ]] && Unlinted "2nd character no space"
-				[[ ! ${REPLY: -1} = '.' ]] && Unlinted "Description doesn't end in full stop"
+				reply=${REPLY//$'\n'}
+				[[ ! ${reply: -1} = '.' && ! ${reply: -1} = '。' ]] && Unlinted "Description doesn't end in full stop"
 				Out "$DNL$DSP$D${REPLY:2}$XD"
-				DNL='' ;;
+				DNL= ;;
 			'-') ((newfmt)) && Unlinted "Bad first character"
 				((${#REPLY} <= 2)) && Unlinted "No example content"
 				[[ ! ${REPLY:1:1} = ' ' ]] && Unlinted "2nd character no space"
@@ -315,7 +345,7 @@ Display_tldr(){
 			'`') ((newfmt)) && Unlinted "Bad first character"
 				((${#REPLY} <= 2)) && Unlinted "No valid code content"
 				[[ ! ${REPLY: -1} = '`' ]] && Unlinted "Code doesn't end in backtick"
-				val=${REPLY:1:-1}
+				val=${REPLY:1:${#REPLY}-2}
 				# Value: convert {{value}}
 				val=${val//\{\{/$CX$V}
 				val=${val//\}\}/$XV$C}
@@ -326,99 +356,160 @@ Display_tldr(){
 				Out "$ENL$ESP$E$REPLY$XE" ;;
 		esac
 	done <"$1"
-	trap 'less -Gg -~RXQFP"%pB\% tldr $I$page$XI - browse up/down, press Q to exit" <<<"$stdout"' EXIT
+	[[ $TLDR_LESS = 0 ]] &&
+		trap 'cat <<<"$stdout"' EXIT ||
+		trap 'less -Gg -~RXQFP"%pB\% tldr $I$page$XI - browse up/down, press Q to exit" <<<"$stdout"' EXIT
 }
 
 # $1: exit code; Uses: platform index
 List_pages(){
-	local platformtext c1 c2 c3
-	[[ $platform ]] && platformtext=" from platform $I$platform$XI"
-	Inf "Known tldr pages$platformtext:"
-	Out "$(while read -r c1 c2 c3; do printf "%-19s %-19s %-19s %-19s$N" $c1 $c2 $c3; done \
-			<<<$(tr '{' '\n' <$index |grep "$platform" |cut -d "$Q" -f4))"
+	local ptext pregex=$platform
+	[[ $platform ]] && ptext="platform $I$platform$XI" ||
+		pregex=^ ptext="${I}all$XI platforms"
+	if [[ $platform = current ]]
+	then [[ $os ]] &&
+			pregex="-e $os -e common" ptext="$I$os$XI platform and ${I}common$XI" ||
+			pregex=common ptext="platform not detected, ${I}common$XI"
+	fi
+	Inf "Known tldr pages from $ptext:"
+	Out "$(tr '{' '\n' <"$index" |grep '^"name"' |grep $pregex |
+			cut -d "$Q" -f4 |column)"
 	exit "$1"
 }
 
+# $1: regex(es); Uses: cachedir
+Find_regex(){
+	local regex=$* list=$cachedir/*/*/*.md
+	while (($#))
+	do
+		list=$(grep "$1" $list |cut -d: -f1)
+		shift
+	done
+	n=$(wc -l <<<"$list")
+	list=$(sort -u <<<"$list")
+	[[ -z $list ]] && Err "Regex $U$regex$XU not found" && exit 6
+	local t=$(wc -l <<<"$list")
+	if ((t==1))
+	then
+		Display_tldr "$list"
+	else
+		Inf "Regex $U$regex$XU $I$n$XI times found in these $I$t$XI tldr pages:"
+		Out "$(sed -e 's@.*/@@' -e 's@...$@@' <<<"$list" |column)"
+	fi
+	exit 0
+}
+
 # $1: exit code; Uses: dl cachedir zip_url
 Cache_fill(){
+	updated=0
 	local tmp unzip
-	unzip="$(type -p unzip) -q" || {
-		Err "Unzip is necessary to fill the cache"
-		exit 6
-	}
-	tmp=$(mktemp -d)
-	$dl "$tmp/pages.zip" "$zip_url" || {
-		rm -- "$tmp"
-		Err "Could not download pages archive from $U$zip_url$XU with $dl"
+	! unzip="$(type -P unzip) -q" &&
+		Err "tldr requires ${I}unzip$XI to fill the cache" &&
 		exit 7
-	}
-	$unzip "$tmp/pages.zip" -d "$tmp" 'pages/*' || {
-		rm -- "$tmp"
-		Err "Couldn't unzip the cache archive on $tmp/pages.zip"
+	tmp=$(mktemp -d)
+	if ! $dl "$tmp/pages.zip" "$zip_url"
+	then
+		rm -- "$tmp" || Err "Error deleting temporary directory $tmp"
+		Err "Could not download pages archive from $U$zip_url$XU with $dl"
 		exit 8
-	}		
+	fi
+	if ! $unzip "$tmp/pages.zip" -d "$tmp"
+	then
+		rm -- "$tmp" || Err "Error deleting temporary directory $tmp"
+		Err "Couldn't unzip the cache archive on $tmp/pages.zip"
+		exit 9
+	fi
 	rm -rf -- "${cachedir:?}/"*
-	mv -- "$tmp/pages/"* "${cachedir:?}/"
+	mv -- "$tmp/index.json" "$tmp"/pages* "${cachedir:?}/"
 	rm -rf -- "$tmp"
 	Inf "Pages cached in $U$cachedir$XU"
-	exit "$1"
+	updated=1
 }
 
 # $@: commandline parameters; Uses: version cached; Sets: platform page
 Main(){
-	local markdown err nomore='No more command line arguments allowed'
+	local markdown=0 err=0 nomore='Arguments ignored: '
 	Config
-	markdown=0 err=0
 	case "$1" in
-	-l|--list) [[ $2 ]] && {
+	-s|--search) [[ -z $2 ]] && Err "Search term(s) [regex] needed" && Usage 10
+		shift
+		Find_regex "$@" ;;
+	-l|--list)
+		if [[ $2 ]]
+		then
 			platform=$2
-			[[ ,common,linux,osx,sunos, = *,$platform,* ]] || {
-				Err "Unknown platform $I$platform$XI"
-				Usage 9
-			}
-			[[ $3 ]] && Err "$nomore" && err=10
-		}
+			[[ $platform == *,* ]] && Err "No commma allowed, just one platform" &&
+				Usage 11
+			[[ ,$platforms,all,current, != *,$platform,* ]] &&
+				Err "Unknown platform $I$platform$XI" && Usage 12
+			[[ $platform = all ]] && platform=
+			shift 2
+			[[ $1 ]] && Err "$nomore$*" && err=13
+		fi
 		List_pages "$err" ;;
-	-c|--cache) [[ $2 ]] && Err "$nomore" && err=11
-		Cache_fill "$err" ;;
-	-v|--version) [[ $2 ]] && Err "$nomore" && err=12
-		Inf "$version"
+	-a|--list-all) shift
+		[[ $1 ]] && Err "$nomore$*" && err=14
+		platform=current
+		List_pages $err ;;
+	-u|--update) shift
+		[[ $1 ]] && Err "$nomore$*" && err=15
+		((updated)) || Cache_fill
 		exit "$err" ;;
-	-u|--update) [[ $2 ]] && Err "$nomore" && err=13
-		Update_index
+	-v|--version) shift
+		[[ $1 ]] && Err "$nomore$*" && err=16
+		Inf "$ver"
 		exit "$err" ;;
-	-r|--render) [[ -z $2 ]] && Err "Specify a file to render" && Usage 14
-		[[ $3 ]] && Err "$nomore" && err=15
-		[[ -f "$2" ]] && {
-			Display_tldr "$2" && exit "$err"
+	-r|--render)[[ -z $2 ]] && Err "Specify a file to render" && Usage 17
+		file=$2
+		shift 2
+		[[ $1 ]] && Err "$nomore$*" && err=18
+		if [[ -f "$file" ]]
+		then
+			Display_tldr "$file" && exit "$err"
 			Err "A file error occured"
-			exit 16
-		} || Err "No file:$I $2$XI" && exit 17 ;;
+			exit 19
+		else
+			Err "No file: ${I}$2$XI"
+			exit 20
+		fi ;;
 	-m|--markdown) shift
 		page=$*
-		[[ -z $page ]] && Err "Specify a page to display" && Usage 18
+		[[ -z $page ]] && Err "Specify a page to display" && Usage 21
 		[[ -f "$page" && ${page: -3:3} = .md ]] && Out "$(cat "$page")" && exit 0
 		markdown=1 ;;
-	''|-h|-\?|--help) [[ $2 ]] && Err "$nomore" && err=19
+	''|-h|-\?|--help) [[ $2 ]] && Err "$nomore" && err=22
 		Usage "$err" ;;
-	-*) Err "Unrecognized option $I$1$XI"; Usage 20 ;;
+	-*) Err "Unrecognized option $I$1$XI"; Usage 23 ;;
 	*) page=$* ;;
 	esac
 
-	[[ -z $page ]] && Err "No command specified" && Usage 21
-	[[ $page =~ ' -' || ${page:0:1} = '-' ]] && Err "Only one option allowed" && Usage 22
+	[[ -z $page ]] && Err "No command specified" && Usage 24
+	[[ $page = *' '-* ]] && Err "No options after page allowed" && Usage 25
 	[[ $page = */* ]] && platform=${page%/*} && page=${page##*/}
-	[[ $platform && ,common,linux,osx,sunos, != *,$platform,* ]] && {
-		Err "Unknown platform $I$platform$XI"
-		Usage 23
-	}
-
+	[[ $platform == *,* ]] && Err "No comma allowed in platform" && Usage 26
+	[[ $platform && ,$platforms,all,current, != *,$platform,* ]] &&
+		Err "Unknown platform $I$platform$XI" &&
+		Usage 27
+	[[ $platform = all ]] && platform=
 	Get_tldr "${page// /-}"
-	[[ ! -s $cached ]] && Err "tldr page for command $I$page$XI not found" \
-			&& Inf "Contribute new pages at:$XB$URL https://github.com/tldr-pages/tldr$XURL" && exit 24
-	((markdown)) && Out "$(cat "$cached")" || Display_tldr "$cached"
+	if [[ -s $cached ]]
+	then # File present
+		((markdown)) && Out "$(cat "$cached")" || Display_tldr "$cached"
+	elif [[ ! $lang = en ]]
+	then # Not English and no file
+		pages=pages
+		Get_tldr "${page// /-}"
+		[[ -s $cached ]] &&
+			Err "tldr page for command $I$page$XI not found in '$lang' but found in English" &&
+			((markdown)) && Out "$(cat "$cached")" ||
+			Display_tldr "$cached"
+	else # Just not found
+			Err "tldr page for command $I$page$XI not found" &&
+				Inf "Contribute new pages at:$XB ${URL}https://github.com/tldr-pages/tldr$XURL" && exit 28
+	fi
 }
 
+export LC_ALL=en_US.UTF-8
 Main "$@"
-# The error trap will output the accumulated stdout
+# The exit trap will output the accumulated stdout
 exit 0

tldr-lint

@@ -1,14 +1,14 @@
-#!/bin/bash
+#!/usr/bin/env bash
 set +vx
 [[ $- = *i* ]] && echo "Don't source this script!" && return 1
-version='0.11'
-# tldr-lint version 0.11
+version='0.1.4'
+# tldr-lint version 0.13
 # Linter for new syntax tldr source files
 # Old syntax files $f can be changed into new syntax files by:
 #  sed -i -e "1s/^# //" -e 's/^- //' -e 's/^`\(.*\)`$/    \1/' "$f"
 #  e=$(sed '1s/./=/g;q' "$f") sed -i "2i$e" "$f"
-# Part of http://github.com/pepa65/tldr-bash-client
-# Requirements: coreutils, sed, grep, find
+# Part of http://gitlab.com/pepa65/tldr-bash-client
+# Requirements: coreutils sed grep find
 
 Help(){  # $1: optional message
 	# Use: self, version
@@ -122,8 +122,10 @@ Check(){  # $1:filename
 		done
 	done <<<"$f"
 	[[ $line ]] && Flag "Newline required at the end of a page" $n
+	((examples>8)) && Flag "More than 8 examples"
 	Ok "$examples Examples" $((flags-check+!examples))
 	Ok "$B$1$XB" $flags
+	((flags)) && fail=1
 }
 
 U=$'\e[4m' XU=$'\e[24m' B=$'\e[1m' XB=$'\e[0m'
@@ -150,6 +152,7 @@ do
 	esac
 done
 
+fail=0
 [[ $file || $dir ]] || Help "No valid file or directory given"
 [[ $file ]] && Check "$file"
 [[ $dir ]] &&
@@ -158,4 +161,5 @@ done
 		Check "$REPLY"
 	done < <(find "$dir" -name '*.md')
 
+((fail)) && exit 2
 exit 0