======Introduction======

Zsh is a shell for Un*x systems that has been around since 1990 and is more sophisticated and configurable than most shells out there. There are lots of features, such as:


  * Context-based completion of many functions (like remote filename completion in ssh, makefile targets, configure scripts, and much more), which is highly configurable.
  * A powerful programming language with complex pattern matching mechanism (a pattern like  **/*(^/)  matches all (non-hidden) files in all subdirectories, but not directories themselves)
  * Lots of CLI (Command Line Interface) options and bindkeys
  * Loadable module support for adding builtin commands

Zsh has a very good [[http://zsh.dotsrc.org/Guide/|User Guide]]. This wiki doesn't aim to take its place, but to provide an accessible outline of all the features of Zsh (with some nifty specifics!), provide examples of use, and foster a Zsh community.

======The Wiki======


=====Available documentation=====

  * [[docs:wikifaq|#zsh / wiki FAQ]]
  * [[docs:official|Official]]
  * [[docs:others|Other docs]]
  * [[docs:interactive|Interactive]]
  * [[docs:books|Books]]
  * [[docs:charindex|Character Index, e.g. What does this character do?]] (incomplete)

=====Installation=====

  * [[install:uncommon|Uncommon Systems]]

=====Configuration=====

  * [[config:files|Startup Files]]

=====ZLE (Zsh Line Editor)=====

  * [[zle:start|About ZLE]]
  * [[zle:bindkeys]]
  * [[zle:new_widget|Define your own ZLE widget]]

=====Options=====

  * [[options:init|Initialization]]
  * [[options:inout|Input/Output]]
  * [[options:expn|Expansion and Globbing]]
  * [[options:history|History]]
  * [[options:comp|Completion]]
  * [[options:emu|Shell Emulation]]
  * [[options:function|Scripting and Functions]]
  * [[options:chdir|Chdir Options]]
  * [[options:jobs|Job Control]]
  * [[options:prompt|Prompt Options]]
  * [[options:zle|Line Editor]]
  * [[options:state|State Options]]

=====Builtins=====

  * [[builtin:cd|cd]]


=====Scripting=====

  * [[scripting:array|Arrays]]

=====Help for converts=====

  * [[convert:bash|Bash]]
  * [[convert:tcsh|Tcsh]]
  * [[convert:users|User Experiences]]

=====Examples=====
  * Completion:
    * [[examples:compquickstart|Completion quickstart (compsys)]]
    * [[examples:compsys:start|Completion Examples (new)]]
      * [[examples:compsys:general|General Setup]]
      * [[examples:compsys:matchers|Matchers]]
      * [[examples:compsys:colors|Colors]]
      * [[examples:compsys:ignore|Ignoring matches]]
      * [[examples:compsys:hostnames|Hostname completion]]
      * [[examples:compsys:processes|Process Completion]]
      * [[examples:compsys:adding|Adding completions]]
    * [[examples:compctl|Completion Examples (old)]]
  * Keybindings:
    * [[examples:zlewidgets|existing widgets for bindkey]]
    * [[examples:zlewordchar|Deletion widgets in addition to the existing ones]]
    * [[examples:zleiab|Automagically replace strings on commandline]]
  * Parameters:
    * [[examples:mathpath|$mailpath]]
  * Aliases:
    * [[examples:aliasnormal|Normal Aliases]]
    * [[examples:aliasglobal|Global Aliases]]
    * [[examples:aliassuffix|Suffix Aliases]]
    * [[examples:aliasdirs|Named Directories]]
  * History:
    * [[examples:zhisthack|Zrajm's History Hack]]
  * Expansions:
    * [[examples:expnparam|Parameter]]
    * [[examples:expnhistory|History]]
  * Misc:
    * [[examples:functions|Functions]]
    * [[examples:hardstatus|Setting Xterm Title and screen's hardstatus]]


=====Zolutions=====
Software, that solves problems written in zsh.

  * [[code:zshmh|ZshMH]]
  * [[code:zshttpd|zshttpd]]
  * [[code:zsmbpasswd|ZsmbPasswd]]
  * [[code:zirc|ZIRC]]
  * [[code:zblog|zblog]]


=====Discussion=====
Room for discussion. Please put dialog-like discussions here.
  * [[discussion:whishlist|Whishlist]] - things you miss in the shell
  * [[discussion:zle|zle discussion]]
  * irc://#zsh@irc.freenode.net/ (english)
  * irc://#zsh-fr@irc.freenode.net (french)
  

=====Links=====
  * [[links:configs|Configuration Files]]
  * [[links:compdownloads|Completion Downloads]]