=====#zsh / wiki FAQ=====

This page aims to link to pages in the wiki (and, if applicable, elsewhere), to answer questions that new users are likely to run into.

However, this page does not replace the official [[http://zsh.sunsite.dk/FAQ/|zsh FAQ]]. It should be checked for answers as well.

  - So, where can I find answers myself?
    * [[http://zsh.sunsite.dk/FAQ/|The zsh FAQ]].
    * [[http://zsh.sf.net/Guide/|The Guide by pws]].
    * [[http://www.zsh.org/mla/|The mailing list archive]].
  - My configuration is acting weird. What can I do?
    * Try starting zsh with the '-f' option, and try to reproduce the problem. If that fixes your problem, the root of your problem is in your config.
    * [[config:files|zsh's setup files at a glance]]. 
  - Trouble with your key bindings (eg: PgUP/DOWN, HOME/END do not work)?
    * [[zle:bindkeys|Get your keys working]].
  - zsh's completion does not recognize new commands. What gives?
    * Here is a solution for that issue: [[examples:compsys:general#the_why_doesn_t_zsh_s_completion_realize_new_commands_faq|Automatic rehash on command completion]].
  - I got a variable: ''myvar="ls -la"'' Executing it does not work (zsh says: command not found: ls -la), but this works in bash/ksh/whatever. What's up?
    * See [[scripting:paramexp|Parameter Expansion]] for details.
  - Why does my prompt look like ''\u@\h:\w\$''? ...bash handles that.
    * Right. However, this is __zsh__wiki.org. ;-)
    * The [[convert:bash|bash convert's page]] links to a script that is supposed to translate prompts you might have had in bash.
    * If your prompt was especially twisted, and the script fails, you will still have to read the ''PROMPT EXPANSION'' section in [[http://zsh.dotsrc.org/Doc/Release/zsh_12.html#SEC40|the manual]] (zshmisc(1)).
  - So, any way to use colors in my prompt?
    * Sure: [[config:prompt|prompt setup]].
  - WTF is that completion thing doing? I'm pressing ''TAB'' and the cursor jumps somewhere weird...
    * This is __not__ a problem with the completion system.
    * Almost certainly, your prompt definition is broken.
    * Read [[config:prompt|prompt setup]] again.
  - zsh keeps terminating my background processes on exit. What can I do?
    * See the ''hup'' and ''check_jobs'' entries in [[options:jobs|Job Control Options]].
  - I want character ranges like ''{a..z}'' in bash. Help!1!!
    * Can a bash convert please update their [[convert:bash|convert's page]], please!? :-)
    * It's simple: use ''{a-z}'' and make sure, you've got the ''BRACE_CCL'' option.
    * Why not {a..z}? Well, let pws answer: [[http://www.zsh.org/mla/users/2007/msg00877.html|zu#11976]]
  - Hey, my uparrow acts strangly all of a sudden. What's up with that?
    * Short answer for most people: ''bindkey -e''.
    * Long answer for everyone: [[http://zsh.sourceforge.net/Doc/Release/zsh_17.html#SEC92|zshzle(1)/KEYMAPS]].
    * If that's still not your solution, see question 3 above.
  - Okay, I want to add a function file to my setup... OR: There is this shell function in zsh I want to overwrite for some reason. Any way to do that?
    * See [[config:functions|Function Files]].
  - Now, zsh's vi like bindings are kind of nice. However, I keep forgetting in what mode I am in. Any way zsh can help me there?
    * First, make sure you got zsh version 4.3.1 or newer.
    * Then, look at: [[examples:zlewidgets#vi_keys_-_show_mode|Show mode with vi keys]].