[scripts] Add new tldr bash client

1 files changed, 411 insertions, 227 deletions

diff --git a/bin/bin/tldr b/bin/bin/tldr
index 2b294c0..cab9dfa 100755
--- a/bin/bin/tldr
+++ b/bin/bin/tldr
@@ -1,246 +1,430 @@
-#!/bin/bash
-# tldr client by Ray Lee, http://github.com/raylee/tldr
-# a Sunday afternoon's project, I'm sure there's room for improvement. PRs welcome!
-
-set -uf -o pipefail
-
-# initialize globals, sanity check the environment, etc.
-config() {
-    init_term_cmds
-
-    if [ -z $(which curl) ]; then
-        echo "${red}tldr requires \`curl\` installed in your path$reset"
-        exit 1
-    fi
-
-    configdir=~/.tldr
-    [ -d ~/.config ] && configdir=~/.config/tldr
-
-    platform=$(get_platform)
-    base_url="https://raw.githubusercontent.com/tldr-pages/tldr/master/pages"
-    index_url="http://tldr-pages.github.io/assets/index.json"
-    index="$configdir/index.json"
-    cache_days=14
-    force_update=''
-
-    #check if config folder exists, otherwise create it
-    [ -d "$configdir" ] || mkdir -p "$configdir"
-
-    [ ! -f $index ] && update_index
-    auto_update_index
-}
-
-update_index() {
-    curl -sf -o "$index" "$index_url"
-    res=$?
-    if [ $res -eq 22 ]; then
-        echo "Could not download index from $index_url"
-        exit 1
-    fi
-}
-
-# if the file exists and is more recent than $cache_days old
-recent() {
-    exists=$(find "$1" -mtime -$cache_days 2>/dev/null)
-    [ -n "$exists" -a -z "$force_update" ]
-}
-
-auto_update_index() {
-    recent "$index" || update_index
+#!/usr/bin/env bash
+set +vx -o pipefail
+[[ $- = *i* ]] && echo "Don't source this script!" && return 1
+version='0.35'
+# tldr-bash-client version 0.35
+# 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
+# - binary download: http://loof.bid/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):
+#  Colors: Black, Red, Green, Yellow, Blue, Magenta, Cyan, White
+#  BG: BlackBG, RedBG, GreenBG, YellowBG, BlueBG, MagentaBG, CyanBG, WhiteBG
+#  Modes: Bold, Underline, Italic, Inverse
+# '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 }"
+# 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 }"
+# Color/BG (Newline and Space also allowed) for error and info messages
+: "${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 }"
+
+# Alternative location of pages cache
+: "${TLDR_CACHE:= }"
+
+# Usage of 'less' or 'cat' for output (set to '0' for cat)
+: "${TLDR_LESS:= }"
+
+## Function definitions
+
+# $1: [optional] exit code; Uses: version cachedir
+Usage(){
+	Out "$(cat <<-EOF
+		 $HHE$version
+
+		 $HDEUSAGE: $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)
+
+		 ${HPL}platform$XHPL (optional) one of: ${HPL}common$XHPL, ${HPL}linux$XHPL, ${HPL}osx$XHPL, ${HPL}sunos$XHPL, ${HPL}current$XHPL (includes common)
+
+		 ${HOP}option$XHOP is optionally one of:
+		  $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 current platform + common
+		  $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-u$XHOP, $HOP--update$XHOP:               Update the pages cache by downloading repo archive
+		  $HOP-v$XHOP, $HOP--version$XHOP:              Version number and local 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$XE ${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.
+		EOF
+	)"
+	exit "${1:-0}"
 }
 
-# function contents via http://mywiki.wooledge.org/BashFAQ/037
-init_term_cmds() {
-    # only set if we're on an interactive session
-    [[ -t 2 ]] && {
-        reset=$(    tput sgr0   || tput me      ) # Reset cursor
-        bold=$(     tput bold   || tput md      ) # Start bold
-        under=$(    tput smul   || tput us      ) # Start underline
-        italic=$(   tput sitm   || tput ZH      ) # Start italic
-        eitalic=$(  tput ritm   || tput ZH      ) # End italic
-        default=$(  tput op                     )
-        back=$'\b'
-
-        [[ $TERM != *-m ]] && {
-            black=$(    tput setaf 0 || tput AF 0    )
-            red=$(      tput setaf 1 || tput AF 1    )
-            green=$(    tput setaf 2 || tput AF 2    )
-            yellow=$(   tput setaf 3 || tput AF 3    )
-            blue=$(     tput setaf 4 || tput AF 4    )
-            magenta=$(  tput setaf 5 || tput AF 5    )
-            cyan=$(     tput setaf 6 || tput AF 6    )
-            white=$(    tput setaf 7 || tput AF 7    )
-
-            onblue=$(   tput setab 4 || tput AB 4    )
-            ongrey=$(   tput setab 7 || tput AB 7    )
-        }
-    } 2>/dev/null ||:
-
-    # osx's termcap doesn't have italics. The below adds support for iTerm2
-    # and is harmless on Terminal.app
-    [ "$(get_platform)" = "osx" ] && {
-        italic=$(echo -e "\033[3m")
-        eitalic=$(echo -e "\033[23m")
-    }
+# $1: keep output; Uses/Sets: stdout
+Out(){ stdout+=$1$N;}
+
+# $1: keep error messages
+Err(){ Out "$ERRNL$ERRSP$ERR$B$1$XB$XERR";}
+
+# $1: keep info messages
+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=''
+	for style in $1
+	do
+		[[ $style = newline ]] && NL=$N
+		[[ $style = space ]] && SP=' '
+		COLOR+=${color[$style]:-}${bg[$style]:-}
+		XCOLOR=${xbg[$style]:-}${xcolor[$style]:-}$XCOLOR
+		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
+
+		[[ $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)
+		}
+	}
+
+	declare -A color=(['black']=$BLA ['red']=$RED ['green']=$GRE ['yellow']=$YEL \
+			['blue']=$BLU ['magenta']=$MAG ['cyan']=$CYA ['white']=$WHI)
+	declare -A xcolor=(['black']=$DEF ['red']=$DEF ['green']=$DEF ['yellow']=$DEF \
+			['blue']=$DEF ['magenta']=$DEF ['cyan']=$DEF ['white']=$DEF)
+	declare -A bg=(['blackbg']=$BLAB ['redbg']=$REDB ['greenbg']=$GREB ['yellowbg']=$YELB \
+			['bluebg']=$BLUB ['magentabg']=$MAGB ['cyanbg']=$CYAB ['whitebg']=$WHIB)
+	declare -A xbg=(['blackbg']=$DEFB ['redbg']=$DEFB ['greenbg']=$DEFB ['yellowbg']=$DEFB \
+			['bluebg']=$DEFB ['magentabg']=$DEFB ['cyanbg']=$DEFB ['whitebg']=$DEFB)
+	declare -A mode=(['bold']=$B ['underline']=$U ['italic']=$I ['inverse']=$R)
+	declare -A xmode=(['bold']=$XB ['underline']=$XU ['italic']=$XI ['inverse']=$XR)
+
+	# the 5 main tldr page styles and error message colors
+	Style "$TLDR_TITLE_STYLE"
+	T=$STYLES XT=$XSTYLES TNL=$NL TSP=$SP
+	Style "$TLDR_DESCRIPTION_STYLE"
+	D=$STYLES XD=$XSTYLES DNL=$NL DSP=$SP
+	Style "$TLDR_EXAMPLE_STYLE"
+	E=$STYLES XE=$XSTYLES ENL=$NL ESP=$SP
+	Style "$TLDR_CODE_STYLE"
+	C=$STYLES XC=$XSTYLES CNL=$NL CSP=$SP
+	Style "$TLDR_VALUE_ISTYLE"
+	V=$STYLES XV=$XSTYLES
+	Style "$TLDR_DEFAULT_ISTYLE"
+	HDE=$STYLES XHDE=$XSTYLES
+	Style "$TLDR_URL_ISTYLE"
+	URL=$STYLES XURL=$XSTYLES
+	HUR=$XHDE$STYLES XHUR=$XSTYLES$HDE
+	Style "$TLDR_OPTION_ISTYLE"
+	HOP=$XHDE$STYLES XHOP=$XSTYLES$HDE
+	Style "$TLDR_PLATFORM_ISTYLE"
+	HPL=$XHDE$STYLES XHPL=$XSTYLES$HDE
+	Style "$TLDR_COMMAND_ISTYLE"
+	HCO=$XHDE$STYLES XHCO=$XSTYLES$HDE
+	Style "$TLDR_FILE_ISTYLE"
+	HFI=$XHDE$STYLES XHFI=$XSTYLES$HDE
+	Style "$TLDR_HEADER_ISTYLE"
+	HHE=$XHDE$STYLES XHHE=$XSTYLES$HDE
+	Style "$TLDR_ERROR_COLOR"
+	ERR=$COLOR XERR=$XCOLOR ERRNL=$NL ERRSP=$SP
+	Style "$TLDR_INFO_COLOR"
+	INF=$COLOR XINF=$XCOLOR INFNL=$NL INFSP=$SP
 }
 
-heading() {
-    local line="$*"
-    echo "$bold$red${line:2}$reset"
+# $1: page
+Recent(){ find "$1" -mtime -"${TLDR_EXPIRY// /}" >/dev/null 2>&1;}
+
+# Initialize globals, check the environment; Uses: config cachedir version
+# Sets: stdout os version dl
+Config(){
+	type -p less >/dev/null || TLDR_LESS=0
+
+	os=common stdout='' Q='"' N=$'\n'
+	case "$(uname -s)" in
+		Darwin) os='osx' ;;
+		Linux) os='linux' ;;
+		SunOS) os='sunos' ;;
+	esac
+	Init_term
+	[[ $TLDR_LESS = 0 ]] && 
+		trap 'cat <<<"$stdout"' EXIT ||
+		trap 'less -~RXQFP"Browse up/down, press Q to exit " <<<"$stdout"' EXIT
+
+	version="tldr-bash-client version $version$XB ${URL}http://github.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
+		}
+	}
+
+	base_url='https://raw.githubusercontent.com/tldr-pages/tldr/master/pages'
+	zip_url='http://tldr-pages.github.io/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"
+		exit 4
+	}
+	index=$cachedir/index.json
+	# update if the file doesn't exists, or if it's older than $TLDR_EXPIRY
+	[[ -f $index ]] && Recent "$index" || Cache_fill 0
 }
 
-quotation() {
-    local line="$*"
-    echo "$under${line:2}$reset"
+# $1: error message; Uses: md REPLY ln
+Unlinted(){
+	Err "Page $I$md$XI not properly linted!$N${ERRSP}${ERR}Line $I$ln$XI [$XERR$U$REPLY$XU$ERR]$N$ERRSP$ERR$1"
+	exit 5
 }
 
-list_item() {
-    local line="$*"
-    echo "$line$reset"
+# $1: page; Uses: index cachedir base_url platform os dl cached md
+# Sets: cached md
+Get_tldr(){
+	local desc err 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\"")
+	# results in, eg, "name":"netstat","platform":["linux","osx"]},
+
+	[[ $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
+			[[ $notfound ]] && notfound+=" or "
+			notfound+=${I}common$XI
+		}
+	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
+	}
+	# 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"
+
+	# return the local cached copy of the tldrpage, or retrieve and cache from github
+	cached=$cachedir/$md
+	Recent "$cached" || {
+		mkdir -p "${cached%/*}"
+		$dl "$cached" "$base_url/$md" || Err "Could not download page $I$cached$XI with $dl"
+	}
 }
 
-code() {
-    local line="$*"
-    # I'm sure there's a better way to strip the first and last characters.
-    line="${line:1}"
-    line="${line%\`}"
-    # convert {{variable}} to italics
-    line=${line//\{\{/$italic}
-    line=${line//\}\}/$eitalic}
-
-    echo "$bold$line$reset"
-}
-
-text() {
-    local line="$*"
-    echo "$line"
+# $1: text; Uses: page stdout; Sets: ln REPLY
+Display_tldr(){
+	local newfmt len val
+	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)) && {
+			[[ ${REPLY:0:1} = '#' ]] && newfmt=0 || newfmt=1
+			((newfmt)) && {
+				[[ $REPLY ]] || Unlinted "Empty title"
+				Out "$TNL$TSP$T$REPLY$XT"
+				len=${#REPLY}  # title length
+				read -r
+				((++ln))
+				[[ $REPLY =~ [^=] ]] && Unlinted "Title underline must be equal signs"
+				((len!=${#REPLY})) && Unlinted "Underline length not equal to title's"
+				read -r
+				((++ln))
+			}
+		}
+		case "${REPLY:0:1}" in  # first character
+			'#') ((newfmt)) && Unlinted "Bad first character"
+				((${#REPLY} <= 2)) && Unlinted "No title"
+				[[ ! ${REPLY:1:1} = ' ' ]] && Unlinted "2nd character no space"
+				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"
+				Out "$DNL$DSP$D${REPLY:2}$XD"
+				DNL='' ;;
+			'-') ((newfmt)) && Unlinted "Bad first character"
+				((${#REPLY} <= 2)) && Unlinted "No example content"
+				[[ ! ${REPLY:1:1} = ' ' ]] && Unlinted "2nd character no space"
+				Out "$ENL$ESP$E${REPLY:2}$XE" ;;
+			' ') ((newfmt)) || Unlinted "Bad first character"
+				((${#REPLY} <= 4)) && Unlinted "No valid code content"
+				[[ ${REPLY:0:4} = '    ' ]] || Unlinted "No four spaces before code"
+				val=${REPLY:4}
+				# Value: convert {{value}}
+				val=${val//\{\{/$CX$V}
+				val=${val//\}\}/$XV$C}
+				Out "$CNL$CSP$C$val$XC" ;;
+			'`') ((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}
+				# Value: convert {{value}}
+				val=${val//\{\{/$CX$V}
+				val=${val//\}\}/$XV$C}
+				Out "$CNL$CSP$C$val$XC" ;;
+			'') continue ;;
+			*) ((newfmt)) || Unlinted "Bad first character"
+				[[ -z $REPLY ]] && Unlinted "No example content"
+				Out "$ENL$ESP$E$REPLY$XE" ;;
+		esac
+	done <"$1"
+	[[ $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
 }
 
-# an idiot-level recognition of tldr's markdown. Needs improvement, or
-# subcontracting out to a markdown -> ANSI formatting command
-display_tldr() {
-    # read one line at a time, don't strip whitespace ('IFS='), and process
-    # last line even if it doesn't have a newline at the end
-    while IFS= read -r line || [[ -n "$line" ]]; do
-        start=${line:0:1}           # get the first character
-        case "$start" in
-            '#') heading "$line"
-                ;;
-            '>') quotation "$line"
-                ;;
-            '-') list_item "$line"
-                ;;
-            '`') code "$line"
-                ;;
-            *) text "$line"
-                ;;
-        esac
-    done
+# $1: exit code; Uses: platform index
+List_pages(){
+	local platformtext c1 c2 c3
+	[[ $platform ]] && platformtext="platform $I$platform$XI" ||
+		platform=^ platformtext="${I}all$XI platforms"
+	[[ $platform = current ]] && platform="-e $os -e common" &&
+		platformtext="$I$os$XI platform and ${I}common$XI"
+	Inf "Known tldr pages from $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))"
+	exit "$1"
 }
 
-# convert the local platorm name to tldr's version
-get_platform() {
-    case `uname -s` in
-        Darwin) echo "osx"    ;;
-        Linux)  echo "linux"  ;;
-        SunOS)  echo "sunos"  ;;
-        *)      echo "common" ;;
-    esac
+# $1: exit code; Uses: dl cachedir zip_url
+Cache_fill(){
+	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"
+		exit 7
+	}
+	$unzip "$tmp/pages.zip" -d "$tmp" 'pages/*' || {
+		rm -- "$tmp"
+		Err "Couldn't unzip the cache archive on $tmp/pages.zip"
+		exit 8
+	}		
+	rm -rf -- "${cachedir:?}/"*
+	mv -- "$tmp/pages/"* "${cachedir:?}/"
+	rm -rf -- "$tmp"
+	Inf "Pages cached in $U$cachedir$XU"
+	exit "$1"
 }
 
-# extract the platform key from index.json, return preferred subpath to tldrpage
-path_for_cmd() {
-    local desc=$(tr '{' '\n' < $index | grep "\"name\":\"$1\"")
-    # results in, eg, "name":"netstat","platform":["linux","osx"]},
-
-    [ -z "$desc" ] && return
-
-    # use the platform specific version of the tldr first
-    if [[ $desc =~ \"$platform\" ]]; then
-        echo "$platform/$1.md"
-    elif [[ $desc =~ \"common\" ]]; then
-        echo "common/$1.md"
-    else
-        # take the first one so we can show something, but warn the user
-        local p=$(echo "$desc" | cut -d '"' -f 8)
-        >&2 echo -e "${red}tldr page $1 not found in $platform or common, using page from platform $p instead$reset\n"
-        echo "$p/$1.md"
-    fi
+# $@: commandline parameters; Uses: version cached; Sets: platform page
+Main(){
+	local markdown err nomore='No more command line arguments allowed'
+	Config
+	markdown=0 err=0
+	case "$1" in
+	-l|--list) [[ $2 ]] && {
+			platform=$2
+			[[ ,common,linux,osx,sunos,current, = *,$platform,* ]] || {
+				Err "Unknown platform $I$platform$XI"
+				Usage 9
+			}
+			[[ $3 ]] && Err "$nomore" && err=10
+		}
+		List_pages "$err" ;;
+	-a|--list-all) [[ $2 ]] && Err "$nomore" && err=11
+		platform=current
+		List_pages $err ;;
+	-u|--update) [[ $2 ]] && Err "$nomore" && err=12
+		Cache_fill "$err" ;;
+	-v|--version) [[ $2 ]] && Err "$nomore" && err=13
+		Inf "$version"
+		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"
+			Err "A file error occured"
+			exit 16
+		} || Err "No file: ${I}$2$XI" && exit 17 ;;
+	-m|--markdown) shift
+		page=$*
+		[[ -z $page ]] && Err "Specify a page to display" && Usage 18
+		[[ -f "$page" && ${page: -3:3} = .md ]] && Out "$(cat "$page")" && exit 0
+		markdown=1 ;;
+	''|-h|-\?|--help) [[ $2 ]] && Err "$nomore" && err=19
+		Usage "$err" ;;
+	-*) Err "Unrecognized option $I$1$XI"; Usage 20 ;;
+	*) page=$* ;;
+	esac
+
+	[[ -z $page ]] && Err "No command specified" && Usage 21
+	[[ ${page:0:1} = '-' || $page = *' '-* ]] && Err "Only one option allowed" && Usage 22
+	[[ $page = */* ]] && platform=${page%/*} && page=${page##*/}
+	[[ $platform && ,common,linux,osx,sunos, != *,$platform,* ]] && {
+		Err "Unknown platform $I$platform$XI"
+		Usage 23
+	}
+
+	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"
 }
 
-# return the local cached copy of the tldrpage, or retrieve and cache from github
-get_tldr() {
-    local p="$(path_for_cmd $1)"
-    cached="$configdir/$p"
-    recent "$cached" || {
-        mkdir -p $(dirname $cached)
-        curl -sf -o "$cached" "$base_url/$p"
-    }
-    # if the curl failed for some reason, keep cat from whinging
-    cat "$cached" 2>/dev/null
-}
-
-
-config
-
-usage() {
-    cmd=$(basename $0)
-    cat <<EOF
-USAGE: $cmd [options] <command>
-
-[options]
-    -l, --list:      show all available pages
-    -p, --platform:  show page from specific platform rather than autodetecting
-    -u, --update:    update, force retrieving latest copies of locally cached files
-    -h, -?, --help:  this help overview
-
-<command>
-    Show examples for this command
-
-The client caches a copy of all pages and the index locally under
-$configdir. By default, the cached copies will expire in $cache_days days.
-
-EOF
+Main "$@"
+# The error trap will output the accumulated stdout
 exit 0
-}
-
-while [ $# -gt 0 ]
-do
-    case "$1" in
-        -l|--list)
-            >&2 echo -e "Known tldr pages: \n"
-            tr '{' '\n' < "$configdir/index.json" | cut -d '"' -f4 | column
-            exit 0
-            ;;
-        -u|--update)
-            force_update=yes
-            update_index
-            ;;
-        -h|-\?|--help)
-            usage
-            ;;
-        -p|--platform)
-            shift
-            platform=$1
-            ;;
-        -*)
-            usage
-            ;;
-        *)
-            page=${1:-''}
-            ;;
-    esac
-    shift
-done
-
-[ -z ${page:-} ] && usage
-
-tldr="$(get_tldr $page)"
-
-if [ -z "$tldr" ]; then
-    echo "tldr page for command $page not found"
-    exit 1
-fi
-
-display_tldr <<< "$tldr"
-echo