prezto/modules/osx/functions/mand

#
# Opens man pages in Dash.app.
#
# Authors:
#   Sorin Ionescu <sorin.ionescu@gmail.com>
#

function mand {
  if (( $# > 0 )); then
    zstyle -s ':prezto:module:osx:man' dash-keyword 'dashkw' || dashkw='manpages'
    open "dash://$dashkw%3A$1" 2> /dev/null
    if (( $? != 0 )); then
      print "$0: Dash is not installed" >&2
      break
    fi
  else
    print 'What manual page do you want?' >&2
  fi

  unset dashkw
}

mand "$@"
Add capability to browse man pages in Dash.app 2013-05-21 13:46:42 -04:00			`#`
			`# Opens man pages in Dash.app.`
			`#`
			`# Authors:`
			`# Sorin Ionescu <sorin.ionescu@gmail.com>`
			`#`

			`function mand {`
			`if (( $# > 0 )); then`
[osx] Support custom keyword used by `mand` to open man pages in Dash.app `zstyle` based customization is now avaialble in zpreztorc. 2017-07-22 17:43:39 -05:00			`zstyle -s ':prezto:module:osx:man' dash-keyword 'dashkw' \|\| dashkw='manpages'`
osx module mand fix > The {query} has to be percent-escaped in macOS 11. Just replace `:` to `%3A` work fine. But add function like this one I find on stackoverflow to encode the entire query string would be more robust. ```bash urldecode() { # urldecode <string> local url_encoded="${1//+/ }" printf '%b' "${url_encoded//%/\\x}" } ``` 2021-03-01 11:30:59 +08:00			`open "dash://$dashkw%3A$1" 2> /dev/null`
Add capability to browse man pages in Dash.app 2013-05-21 13:46:42 -04:00			`if (( $? != 0 )); then`
			`print "$0: Dash is not installed" >&2`
			`break`
			`fi`
			`else`
			`print 'What manual page do you want?' >&2`
			`fi`
[osx] Support custom keyword used by `mand` to open man pages in Dash.app `zstyle` based customization is now avaialble in zpreztorc. 2017-07-22 17:43:39 -05:00
			`unset dashkw`
Add capability to browse man pages in Dash.app 2013-05-21 13:46:42 -04:00			`}`

			`mand "$@"`