# Zsh Navigation Tools
  
  http://imageshack.com/a/img633/7967/ps6rKR.png
  
  Set of tools like n-history – multi-word history searcher, n-cd – directory
  bookmark manager, n-kill – htop like kill utility, and more. Based on
  n-list, a tool generating selectable curses-based list of elements that has
  access to current Zsh session, i.e. has broad capabilities to work together
  with it. Feature highlights include incremental multi-word searching, ANSI
  coloring, unique mode, horizontal scroll, non-selectable elements, grepping and
  various integrations with Zsh.
  
  ## History Widget
  
  To have n-history as multi-word incremental searcher bound to Ctrl-R copy znt-*
  files into the */site-functions dir (unless you use Oh My Zsh) and
  add:
  
      autoload znt-history-widget
      zle -N znt-history-widget
      bindkey "^R" znt-history-widget
  
  to .zshrc. This is done automatically when using Oh My Zsh. Two other
  widgets exist, znt-cd-widget and znt-kill-widget, they can be too assigned
  to key combinations (no need for autoload when using Oh My Zsh):
  
      zle -N znt-cd-widget

      bindkey "^A" znt-cd-widget

      zle -N znt-kill-widget
      bindkey "^Y" znt-kill-widget
  
  Oh My Zsh stores history into ~/.zsh_history. When you switch to OMZ you could
  want to copy your previous data (from e.g. ~/.zhistory) into the new location.
  
  ## Introduction
  
  The tools are:
  
  - n-aliases - browses aliases, relegates editing to vared
  - n-cd - browses dirstack and bookmarked directories, allows to enter selected directory
  - n-functions - browses functions, relegates editing to zed or vared
  - n-history - browses history, allows to edit and run commands from it
  - n-kill - browses processes list, allows to send signal to selected process
  - n-env - browses environment, relegates editing to vared
  - n-options - browses options, allows to toggle their state
  - n-panelize - loads output of given command into the list for browsing
  
  All tools support horizontal scroll with <,>, {,}, h,l or left and right
  cursors. Other keys are:
  
  - [,] - jump directory bookmarks in n-cd and typical signals in n-kill
  - Ctrl-d, Ctrl-u - half page up or down
  - Ctrl-p, Ctrl-n - previous and next (also done with vim's j,k)
  - Ctrl-l - redraw of whole display
  - g, G - beginning and end of the list
  - Ctrl-o, o - enter uniq mode (no duplicate lines)
  - / - start incremental search
  - Enter - finish incremental search, retaining filter
  - Esc - exit incremental search, clearing filter
  - Ctrl-w (in incremental search) - delete whole word
  - Ctrl-k (in incremental search) - delete whole line
  
  ## Programming
  
  The function n-list is used as follows:
  
      n-list {element1} [element2] ... [elementN]
  
  This is all that is needed to be done to have the features like ANSI coloring,
  incremental multi-word search, unique mode, horizontal scroll, non-selectable
  elements (grepping is done outside n-list, see the tools for how it can be
  done). To set up non-selectable entries add their indices into array
  NLIST_NONSELECTABLE_ELEMENTS:
  
      typeset -a NLIST_NONSELECTABLE_ELEMENTS
      NLIST_NONSELECTABLE_ELEMENTS=( 1 )
  
  Result is stored as $reply[REPLY] ($ isn't needed before REPLY because
  of arithmetic context inside []). The returned array might be different from
  input arguments as n-list can process them via incremental search or uniq
  mode. $REPLY is the index in that possibly processed array. If $REPLY
  equals -1 it means that no selection have been made (user quitted via q
  key).
  
  To set up entries that can be jumped to with [,] keys add their indices to
  NLIST_HOP_INDEXES array:
  
      typeset -a NLIST_HOP_INDEXES
      NLIST_HOP_INDEXES=( 1 10 )
  
  n-list can automatically colorize entries according to a Zsh pattern.
  Following example will colorize all numbers with blue:
  
      local NLIST_COLORING_PATTERN="[0-9]##"
      local NLIST_COLORING_COLOR=$'\x1b[00;34m'
      local NLIST_COLORING_END_COLOR=$'\x1b[0m'
      local NLIST_COLORING_MATCH_MULTIPLE=1
      n-list "This is a number 123" "This line too has a number: 456"
  
  Blue is the default color, it doesn't have to be set. See zshexpn man page
  for more information on Zsh patterns. Briefly, comparing to regular
  expressions, (#s) is ^, (#e) is $, # is *, ## is +. Alternative
  will work when in parenthesis, i.e. (a|b). BTW by using this method you can
  colorize output of the tools, via their config files (check out e.g. n-cd.conf,
  it uses this).
  
  ## Performance

  ZNT are fastest with Zsh before 5.0.6 and starting from 5.2

  
  vim:filetype=conf