zshrc: Add experimental bzr backend to vcs_info()
[grml-etc-core.git] / etc / zsh / zshrc
1 # Filename:      zshrc
2 # Purpose:       config file for zsh (z shell)
3 # Authors:       grml-team (grml.org), (c) Michael Prokop <mika@grml.org>
4 # Bug-Reports:   see http://grml.org/bugs/
5 # License:       This file is licensed under the GPL v2.
6 # Latest change: Wed Aug 06 23:50:53 CEST 2008 [mika]
7 ################################################################################
8 # This file is sourced only for interactive shells. It
9 # should contain commands to set up aliases, functions,
10 # options, key bindings, etc.
11 #
12 # Global Order: zshenv, zprofile, zshrc, zlogin
13 ################################################################################
14
15 # zsh-refcard-tag documentation: {{{
16 #   You may notice strange looking comments in the zshrc (and ~/.zshrc as
17 #   well). These are there for a purpose. grml's zsh-refcard can now be
18 #   automatically generated from the contents of the actual configuration
19 #   files. However, we need a little extra information on which comments
20 #   and what lines of code to take into account (and for what purpose).
21 #
22 # Here is what they mean:
23 #
24 # List of tags (comment types) used:
25 #   #a#     Next line contains an important alias, that should
26 #           be included in the grml-zsh-refcard.
27 #           (placement tag: @@INSERT-aliases@@)
28 #   #f#     Next line contains the beginning of an important function.
29 #           (placement tag: @@INSERT-functions@@)
30 #   #v#     Next line contains an important variable.
31 #           (placement tag: @@INSERT-variables@@)
32 #   #k#     Next line contains an important keybinding.
33 #           (placement tag: @@INSERT-keybindings@@)
34 #   #d#     Hashed directories list generation:
35 #               start   denotes the start of a list of 'hash -d'
36 #                       definitions.
37 #               end     denotes its end.
38 #           (placement tag: @@INSERT-hasheddirs@@)
39 #   #A#     Abbreviation expansion list generation:
40 #               start   denotes the beginning of abbreviations.
41 #               end     denotes their end.
42 #           Lines within this section that end in '#d .*' provide
43 #           extra documentation to be included in the refcard.
44 #           (placement tag: @@INSERT-abbrev@@)
45 #   #m#     This tag allows you to manually generate refcard entries
46 #           for code lines that are hard/impossible to parse.
47 #               Example:
48 #                   #m# k ESC-h Call the run-help function
49 #               That would add a refcard entry in the keybindings table
50 #               for 'ESC-h' with the given comment.
51 #           So the syntax is: #m# <section> <argument> <comment>
52 #   #o#     This tag lets you insert entries to the 'other' hash.
53 #           Generally, this should not be used. It is there for
54 #           things that cannot be done easily in another way.
55 #           (placement tag: @@INSERT-other-foobar@@)
56 #
57 #   All of these tags (except for m and o) take two arguments, the first
58 #   within the tag, the other after the tag:
59 #
60 #   #<tag><section># <comment>
61 #
62 #   Where <section> is really just a number, which are defined by the
63 #   @secmap array on top of 'genrefcard.pl'. The reason for numbers
64 #   instead of names is, that for the reader, the tag should not differ
65 #   much from a regular comment. For zsh, it is a regular comment indeed.
66 #   The numbers have got the following meanings:
67 #         0 -> "default"
68 #         1 -> "system"
69 #         2 -> "user"
70 #         3 -> "debian"
71 #         4 -> "search"
72 #         5 -> "shortcuts"
73 #         6 -> "services"
74 #
75 #   So, the following will add an entry to the 'functions' table in the
76 #   'system' section, with a (hopefully) descriptive comment:
77 #       #f1# Edit an alias via zle
78 #       edalias() {
79 #
80 #   It will then show up in the @@INSERT-aliases-system@@ replacement tag
81 #   that can be found in 'grml-zsh-refcard.tex.in'.
82 #   If the section number is omitted, the 'default' section is assumed.
83 #   Furthermore, in 'grml-zsh-refcard.tex.in' @@INSERT-aliases@@ is
84 #   exactly the same as @@INSERT-aliases-default@@. If you want a list of
85 #   *all* aliases, for example, use @@INSERT-aliases-all@@.
86 #}}}
87
88 # zsh profiling {{{
89 # just execute 'ZSH_PROFILE_RC=1 zsh' and run 'zprof' to get the details
90 if [[ -n $ZSH_PROFILE_RC ]] ; then
91     zmodload zsh/zprof
92 fi
93 # }}}
94
95 # {{{ check for version/system
96 # check for versions (compatibility reasons)
97 is4(){
98     [[ $ZSH_VERSION == <4->* ]] && return 0
99     return 1
100 }
101
102 is41(){
103     [[ $ZSH_VERSION == 4.<1->* || $ZSH_VERSION == <5->* ]] && return 0
104     return 1
105 }
106
107 is42(){
108     [[ $ZSH_VERSION == 4.<2->* || $ZSH_VERSION == <5->* ]] && return 0
109     return 1
110 }
111
112 is43(){
113     [[ $ZSH_VERSION == 4.<3->* || $ZSH_VERSION == <5->* ]] && return 0
114     return 1
115 }
116
117 #f1# Checks whether or not you're running grml
118 isgrml(){
119     [[ -f /etc/grml_version ]] && return 0
120     return 1
121 }
122
123 #f1# Checks whether or not you're running a grml cd
124 isgrmlcd(){
125     [[ -f /etc/grml_cd ]] && return 0
126     return 1
127 }
128
129 if isgrml ; then
130 #f1# Checks whether or not you're running grml-small
131     isgrmlsmall() {
132         [[ ${${${(f)"$(</etc/grml_version)"}%% *}##*-} == 'small' ]] && return 0 ; return 1
133     }
134 else
135     isgrmlsmall() { return 1 }
136 fi
137
138 #f1# are we running within an utf environment?
139 isutfenv() {
140     case "$LANG $CHARSET $LANGUAGE" in
141         *utf*) return 0 ;;
142         *UTF*) return 0 ;;
143         *)     return 1 ;;
144     esac
145 }
146
147 # check for user, if not running as root set $SUDO to sudo
148 (( EUID != 0 )) && SUDO='sudo' || SUDO=''
149
150 # change directory to home on first invocation of zsh
151 # important for rungetty -> autologin
152 # Thanks go to Bart Schaefer!
153 isgrml && checkhome() {
154     if [[ -z "$ALREADY_DID_CD_HOME" ]] ; then
155         export ALREADY_DID_CD_HOME=$HOME
156         cd
157     fi
158 }
159
160 # check for zsh v3.1.7+
161
162 if ! [[ ${ZSH_VERSION} == 3.1.<7->*      \
163      || ${ZSH_VERSION} == 3.<2->.<->*    \
164      || ${ZSH_VERSION} == <4->.<->*   ]] ; then
165
166     printf '-!-\n'
167     printf '-!- In this configuration we try to make use of features, that only\n'
168     printf '-!- require version 3.1.7 of the shell; That way this setup can be\n'
169     printf '-!- used with a wide range of zsh versions, while using fairly\n'
170     printf '-!- advanced features in all supported versions.\n'
171     printf '-!-\n'
172     printf '-!- However, you are running zsh version %s.\n' "$ZSH_VERSION"
173     printf '-!-\n'
174     printf '-!- While this *may* work, it might as well fail.\n'
175     printf '-!- Please consider updating to at least version 3.1.7 of zsh.\n'
176     printf '-!-\n'
177     printf '-!- DO NOT EXPECT THIS TO WORK FLAWLESSLY!\n'
178     printf '-!- If it does today, you'\''ve been lucky.\n'
179     printf '-!-\n'
180     printf '-!- Ye been warned!\n'
181     printf '-!-\n'
182
183     function zstyle() { : }
184 fi
185
186 # }}}
187
188 # utility functions {{{
189 # this function checks if a command exists and returns either true
190 # or false. This avoids using 'which' and 'whence', which will
191 # avoid problems with aliases for which on certain weird systems. :-)
192 check_com() {
193     local -i comonly
194
195     if [[ ${1} == '-c' ]] ; then
196         (( comonly = 1 ))
197         shift
198     else
199         (( comonly = 0 ))
200     fi
201
202     if (( ${#argv} != 1 )) ; then
203         printf 'usage: check_com [-c] <command>\n' >&2
204         return 1
205     fi
206
207     if (( comonly > 0 )) ; then
208         [[ -n ${commands[$1]}  ]] && return 0
209         return 1
210     fi
211
212     if   [[ -n ${commands[$1]}    ]] \
213       || [[ -n ${functions[$1]}   ]] \
214       || [[ -n ${aliases[$1]}     ]] \
215       || [[ -n ${reswords[(r)$1]} ]] ; then
216
217         return 0
218     fi
219
220     return 1
221 }
222
223 # creates an alias and precedes the command with
224 # sudo if $EUID is not zero.
225 salias() {
226     local only=0 ; local multi=0
227     while [[ ${1} == -* ]] ; do
228         case ${1} in
229             (-o) only=1 ;;
230             (-a) multi=1 ;;
231             (--) shift ; break ;;
232             (-h)
233                 printf 'usage: salias [-h|-o|-a] <alias-expression>\n'
234                 printf '  -h      shows this help text.\n'
235                 printf '  -a      replace '\'' ; '\'' sequences with '\'' ; sudo '\''.\n'
236                 printf '          be careful using this option.\n'
237                 printf '  -o      only sets an alias if a preceding sudo would be needed.\n'
238                 return 0
239                 ;;
240             (*) printf "unkown option: '%s'\n" "${1}" ; return 1 ;;
241         esac
242         shift
243     done
244
245     if (( ${#argv} > 1 )) ; then
246         printf 'Too many arguments %s\n' "${#argv}"
247         return 1
248     fi
249
250     key="${1%%\=*}" ;  val="${1#*\=}"
251     if (( EUID == 0 )) && (( only == 0 )); then
252         alias -- "${key}=${val}"
253     elif (( EUID > 0 )) ; then
254         (( multi > 0 )) && val="${val// ; / ; sudo }"
255         alias -- "${key}=sudo ${val}"
256     fi
257
258     return 0
259 }
260
261 # a "print -l ${(u)foo}"-workaround for pre-4.2.0 shells
262 # usage: uprint foo
263 #   Where foo is the *name* of the parameter you want printed.
264 #   Note that foo is no typo; $foo would be wrong here!
265 if ! is42 ; then
266     uprint () {
267         local -a u
268         local w
269         local parameter=${1}
270
271         if [[ -z ${parameter} ]] ; then
272             printf 'usage: uprint <parameter>\n'
273             return 1
274         fi
275
276         for w in ${(P)parameter} ; do
277             [[ -z ${(M)u:#${w}} ]] && u=( ${u} ${w} )
278         done
279
280         builtin print -l ${u}
281     }
282 fi
283
284 # Check if we can read given files and source those we can.
285 xsource() {
286     if (( ${#argv} < 1 )) ; then
287         printf 'usage: xsource FILE(s)...\n' >&2
288         return 1
289     fi
290
291     while (( ${#argv} > 0 )) ; do
292         [[ -r ${1} ]] && source ${1}
293         shift
294     done
295     return 0
296 }
297
298 # Check if we can read a given file and 'cat(1)' it.
299 xcat() {
300     if (( ${#argv} != 1 )) ; then
301         printf 'usage: xcat FILE\n' >&2
302         return 1
303     fi
304
305     [[ -r ${1} ]] && cat ${1}
306     return 0
307 }
308
309 # Remove these functions again, they are of use only in these
310 # setup files. This should be called at the end of .zshrc.
311 xunfunction() {
312     local -a funcs
313     funcs=(salias xcat xsource xunfunction zrcautoload)
314
315     for func in $funcs ; do
316         [[ -n ${functions[$func]} ]] \
317             && unfunction $func
318     done
319     return 0
320 }
321
322 # autoload wrapper - use this one instead of autoload directly
323 function zrcautoload() {
324     setopt local_options extended_glob
325     local fdir ffile
326     local -i ffound
327
328     ffile=${1}
329     (( found = 0 ))
330     for fdir in ${fpath} ; do
331         [[ -e ${fdir}/${ffile} ]] && (( ffound = 1 ))
332     done
333
334     (( ffound == 0 )) && return 1
335     if [[ $ZSH_VERSION == 3.1.<6-> || $ZSH_VERSION == <4->* ]] ; then
336         autoload -U ${ffile} || return 1
337     else
338         autoload ${ffile} || return 1
339     fi
340     return 0
341 }
342
343 #}}}
344
345 # Load is-at-least() for more precise version checks {{{
346
347 # Note that this test will *always* fail, if the is-at-least
348 # function could not be marked for autoloading.
349 zrcautoload is-at-least || is-at-least() { return 1 }
350
351 # }}}
352
353 # locale setup {{{
354 if [[ -z "$LANG" ]] ; then
355    xsource "/etc/default/locale"
356 fi
357
358 export LANG=${LANG:-en_US.iso885915}
359 for var in LC_ALL LC_MESSAGES ; do
360     [[ -n ${(P)var} ]] && export $var
361 done
362
363 xsource "/etc/sysconfig/keyboard"
364
365 TZ=$(xcat /etc/timezone)
366 # }}}
367
368 # check for potentially old files in 'completion.d' {{{
369 setopt extendedglob
370 xof=(/etc/zsh/completion.d/*~/etc/zsh/completion.d/_*(N))
371 if (( ${#xof} > 0 )) ; then
372     printf '\n -!- INFORMATION\n\n'
373     printf ' -!- %s file(s) not starting with an underscore (_) found in\n' ${#xof}
374     printf ' -!- /etc/zsh/completion.d/.\n\n'
375     printf ' -!- While this has been the case in old versions of grml-etc-core,\n'
376     printf ' -!- recent versions of the grml-zsh-setup have all these files rewritten\n'
377     printf ' -!- and renamed. Furthermore, the grml-zsh-setup will *only* add files\n'
378     printf ' -!- named _* to that directory.\n\n'
379     printf ' -!- If you added functions to completion.d yourself, please consider\n'
380     printf ' -!- moving them to /etc/zsh/functions.d/. Files in that directory, not\n'
381     printf ' -!- starting with an underscore are marked for automatic loading\n'
382     printf ' -!- by default (so that is quite convenient).\n\n'
383     printf ' -!- If there are files *not* starting with an underscore from an older\n'
384     printf ' -!- grml-etc-core in completion.d, you may safely remove them.\n\n'
385     printf ' -!- Delete the files for example via running:\n\n'
386     printf "      rm ${xof}\n\n"
387     printf ' -!- Note, that this message will *not* go away, unless you yourself\n'
388     printf ' -!- resolve the situation manually.\n\n'
389     BROKEN_COMPLETION_DIR=1
390 fi
391 unset xof
392 # }}}
393
394 # {{{ set some variables
395 if check_com -c vim ; then
396 #v#
397     export EDITOR=${EDITOR:-vim}
398 else
399     export EDITOR=${EDITOR:-vi}
400 fi
401
402 #v#
403 export PAGER=${PAGER:-less}
404
405 #v#
406 export MAIL=${MAIL:-/var/mail/$USER}
407
408 # if we don't set $SHELL then aterm, rxvt,.. will use /bin/sh or /bin/bash :-/
409 export SHELL='/bin/zsh'
410
411 # color setup for ls:
412 check_com -c dircolors && eval $(dircolors -b)
413
414 # set width of man pages to 80 for more convenient reading
415 # export MANWIDTH=${MANWIDTH:-80}
416
417 # Search path for the cd command
418 #  cdpath=(.. ~)
419
420 # completion functions go to /etc/zsh/completion.d
421 # function files may be put into /etc/zsh/functions.d, from where they
422 # will be automatically autoloaded.
423 if [[ -n "$BROKEN_COMPLETION_DIR" ]] ; then
424     print 'Warning: not setting completion directories because broken files have been found.' >&2
425 else
426     [[ -d /etc/zsh/completion.d ]] && fpath=( $fpath /etc/zsh/completion.d )
427     if [[ -d /etc/zsh/functions.d ]] ; then
428         fpath+=( /etc/zsh/functions.d )
429         for func in /etc/zsh/functions.d/[^_]*[^~] ; do
430             zrcautoload -U ${func:t}
431         done
432     fi
433 fi
434
435 # automatically remove duplicates from these arrays
436 typeset -U path cdpath fpath manpath
437 # }}}
438
439 # {{{ keybindings
440 if [[ "$TERM" != emacs ]] ; then
441     [[ -z "$terminfo[kdch1]" ]] || bindkey -M emacs "$terminfo[kdch1]" delete-char
442     [[ -z "$terminfo[khome]" ]] || bindkey -M emacs "$terminfo[khome]" beginning-of-line
443     [[ -z "$terminfo[kend]"  ]] || bindkey -M emacs "$terminfo[kend]"  end-of-line
444     [[ -z "$terminfo[kdch1]" ]] || bindkey -M vicmd "$terminfo[kdch1]" vi-delete-char
445     [[ -z "$terminfo[khome]" ]] || bindkey -M vicmd "$terminfo[khome]" vi-beginning-of-line
446     [[ -z "$terminfo[kend]"  ]] || bindkey -M vicmd "$terminfo[kend]"  vi-end-of-line
447     [[ -z "$terminfo[cuu1]"  ]] || bindkey -M viins "$terminfo[cuu1]"  vi-up-line-or-history
448     [[ -z "$terminfo[cuf1]"  ]] || bindkey -M viins "$terminfo[cuf1]"  vi-forward-char
449     [[ -z "$terminfo[kcuu1]" ]] || bindkey -M viins "$terminfo[kcuu1]" vi-up-line-or-history
450     [[ -z "$terminfo[kcud1]" ]] || bindkey -M viins "$terminfo[kcud1]" vi-down-line-or-history
451     [[ -z "$terminfo[kcuf1]" ]] || bindkey -M viins "$terminfo[kcuf1]" vi-forward-char
452     [[ -z "$terminfo[kcub1]" ]] || bindkey -M viins "$terminfo[kcub1]" vi-backward-char
453     # ncurses stuff:
454     [[ "$terminfo[kcuu1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuu1]/O/[}" vi-up-line-or-history
455     [[ "$terminfo[kcud1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcud1]/O/[}" vi-down-line-or-history
456     [[ "$terminfo[kcuf1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcuf1]/O/[}" vi-forward-char
457     [[ "$terminfo[kcub1]" == $'\eO'* ]] && bindkey -M viins "${terminfo[kcub1]/O/[}" vi-backward-char
458     [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M viins "${terminfo[khome]/O/[}" beginning-of-line
459     [[ "$terminfo[kend]"  == $'\eO'* ]] && bindkey -M viins "${terminfo[kend]/O/[}"  end-of-line
460     [[ "$terminfo[khome]" == $'\eO'* ]] && bindkey -M emacs "${terminfo[khome]/O/[}" beginning-of-line
461     [[ "$terminfo[kend]"  == $'\eO'* ]] && bindkey -M emacs "${terminfo[kend]/O/[}"  end-of-line
462 fi
463
464 ## keybindings (run 'bindkeys' for details, more details via man zshzle)
465 # use emacs style per default:
466 bindkey -e
467 # use vi style:
468 # bindkey -v
469
470 #if [[ "$TERM" == screen ]] ; then
471 bindkey '\e[1~' beginning-of-line       # home
472 bindkey '\e[4~' end-of-line             # end
473 bindkey '\e[A'  up-line-or-search       # cursor up
474 bindkey '\e[B'  down-line-or-search     # <ESC>-
475
476 bindkey '^xp'   history-beginning-search-backward
477 bindkey '^xP'   history-beginning-search-forward
478 # bindkey -s '^L' "|less\n"             # ctrl-L pipes to less
479 # bindkey -s '^B' " &\n"                # ctrl-B runs it in the background
480 # if terminal type is set to 'rxvt':
481 bindkey '\e[7~' beginning-of-line       # home
482 bindkey '\e[8~' end-of-line             # end
483 #fi
484
485 # insert unicode character
486 # usage example: 'ctrl-x i' 00A7 'ctrl-x i' will give you an Â§
487 # See for example http://unicode.org/charts/ for unicode characters code
488 zrcautoload insert-unicode-char
489 zle -N insert-unicode-char
490 #k# Insert Unicode character
491 bindkey '^Xi' insert-unicode-char
492
493 # just type 'cd ...' to get 'cd ../..'
494 #  rationalise-dot() {
495 #  if [[ $LBUFFER == *.. ]] ; then
496 #    LBUFFER+=/..
497 #  else
498 #    LBUFFER+=.
499 #  fi
500 #  }
501 #  zle -N rationalise-dot
502 #  bindkey . rationalise-dot
503
504 #  bindkey '\eq' push-line-or-edit
505
506 ## toggle the ,. abbreviation feature on/off
507 # NOABBREVIATION: default abbreviation-state
508 #                 0 - enabled (default)
509 #                 1 - disabled
510 NOABBREVIATION=${NOABBREVIATION:-0}
511
512 grml_toggle_abbrev() {
513     if (( ${NOABBREVIATION} > 0 )) ; then
514         NOABBREVIATION=0
515     else
516         NOABBREVIATION=1
517     fi
518 }
519
520 zle -N grml_toggle_abbrev
521 bindkey '^xA' grml_toggle_abbrev
522
523 # }}}
524
525 # a generic accept-line wrapper {{{
526
527 # This widget can prevent unwanted autocorrections from command-name
528 # to _command-name, rehash automatically on enter and call any number
529 # of builtin and user-defined widgets in different contexts.
530 #
531 # For a broader description, see:
532 # <http://bewatermyfriend.org/posts/2007/12-26.11-50-38-tooltime.html>
533 #
534 # The code is imported from the file 'zsh/functions/accept-line' from
535 # <http://ft.bewatermyfriend.org/comp/zsh/zsh-dotfiles.tar.bz2>, which
536 # distributed under the same terms as zsh itself.
537
538 # A newly added command will may not be found or will cause false
539 # correction attempts, if you got auto-correction set. By setting the
540 # following style, we force accept-line() to rehash, if it cannot
541 # find the first word on the command line in the $command[] hash.
542 zstyle ':acceptline:*' rehash true
543
544 function Accept-Line() {
545     setopt localoptions noksharrays
546     local -a subs
547     local -xi aldone
548     local sub
549
550     zstyle -a ":acceptline:${alcontext}" actions subs
551
552     (( ${#subs} < 1 )) && return 0
553
554     (( aldone = 0 ))
555     for sub in ${subs} ; do
556         [[ ${sub} == 'accept-line' ]] && sub='.accept-line'
557         zle ${sub}
558
559         (( aldone > 0 )) && break
560     done
561 }
562
563 function Accept-Line-getdefault() {
564     local default_action
565
566     zstyle -s ":acceptline:${alcontext}" default_action default_action
567     case ${default_action} in
568         ((accept-line|))
569             printf ".accept-line"
570             ;;
571         (*)
572             printf ${default_action}
573             ;;
574     esac
575 }
576
577 function accept-line() {
578     setopt localoptions noksharrays
579     local -a cmdline
580     local -x alcontext
581     local buf com fname format msg default_action
582
583     alcontext='default'
584     buf="${BUFFER}"
585     cmdline=(${(z)BUFFER})
586     com="${cmdline[1]}"
587     fname="_${com}"
588
589     zstyle -t ":acceptline:${alcontext}" rehash \
590         && [[ -z ${commands[$com]} ]]           \
591         && rehash
592
593     if    [[ -n ${reswords[(r)$com]} ]] \
594        || [[ -n ${aliases[$com]}     ]] \
595        || [[ -n ${functions[$com]}   ]] \
596        || [[ -n ${builtins[$com]}    ]] \
597        || [[ -n ${commands[$com]}    ]] ; then
598
599         # there is something sensible to execute, just do it.
600         alcontext='normal'
601         zle Accept-Line
602
603         default_action=$(Accept-Line-getdefault)
604         zstyle -T ":acceptline:${alcontext}" call_default \
605             && zle ${default_action}
606         return
607     fi
608
609     if    [[ -o correct              ]] \
610        || [[ -o correctall           ]] \
611        && [[ -n ${functions[$fname]} ]] ; then
612
613         # nothing there to execute but there is a function called
614         # _command_name; a completion widget. Makes no sense to
615         # call it on the commandline, but the correct{,all} options
616         # will ask for it nevertheless, so warn the user.
617         if [[ ${LASTWIDGET} == 'accept-line' ]] ; then
618             # Okay, we warned the user before, he called us again,
619             # so have it his way.
620             alcontext='force'
621             zle Accept-Line
622
623             default_action=$(Accept-Line-getdefault)
624             zstyle -T ":acceptline:${alcontext}" call_default \
625                 && zle ${default_action}
626             return
627         fi
628
629         # prepare warning message for the user, configurable via zstyle.
630         zstyle -s ":acceptline:${alcontext}" compwarnfmt msg
631
632         if [[ -z ${msg} ]] ; then
633             msg="%c will not execute and completion %f exists."
634         fi
635
636         zformat -f msg "${msg}" "c:${com}" "f:${fname}"
637
638         zle -M -- "${msg}"
639         return
640     elif [[ -n ${buf//[$' \t\n']##/} ]] ; then
641         # If we are here, the commandline contains something that is not
642         # executable, which is neither subject to _command_name correction
643         # and is not empty. might be a variable assignment
644         alcontext='misc'
645         zle Accept-Line
646
647         default_action=$(Accept-Line-getdefault)
648         zstyle -T ":acceptline:${alcontext}" call_default \
649             && zle ${default_action}
650         return
651     fi
652
653     # If we got this far, the commandline only contains whitespace, or is empty.
654     alcontext='empty'
655     zle Accept-Line
656
657     default_action=$(Accept-Line-getdefault)
658     zstyle -T ":acceptline:${alcontext}" call_default \
659         && zle ${default_action}
660 }
661
662 zle -N accept-line
663 zle -N Accept-Line
664
665 # }}}
666
667 # power completion - abbreviation expansion {{{
668 # power completion / abbreviation expansion / buffer expansion
669 # see http://zshwiki.org/home/examples/zleiab for details
670 # less risky than the global aliases but powerful as well
671 # just type the abbreviation key and afterwards ',.' to expand it
672 declare -A abk
673 setopt extendedglob
674 setopt interactivecomments
675 abk=(
676 # key  # value                (#d additional doc string)
677 #A# start
678     '...' '../..'
679     '....' '../../..'
680     'BG' '& exit'
681     'C' '| wc -l'
682     'G' '|& grep --color=auto'
683     'H' '| head'
684     'Hl' ' --help |& less -r'      #d (Display help in pager)
685     'L' '| less'
686     'LL' '|& less -r'
687     'M' '| most'
688     'N' '&>/dev/null'              #d (No Output)
689     'R' '| tr A-z N-za-m'          #d (ROT13)
690     'SL' '| sort | less'
691     'S' '| sort -u'
692     'T' '| tail'
693     'V' '|& vim -'
694 #A# end
695     'hide' "echo -en '\033]50;nil2\007'"
696     'tiny' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15\007"'
697     'small' 'echo -en "\033]50;6x10\007"'
698     'medium' 'echo -en "\033]50;-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15\007"'
699     'default' 'echo -e "\033]50;-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15\007"'
700     'large' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-150-*-*-c-*-iso8859-15\007"'
701     'huge' 'echo -en "\033]50;-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15\007"'
702     'smartfont' 'echo -en "\033]50;-artwiz-smoothansi-*-*-*-*-*-*-*-*-*-*-*-*\007"'
703     'semifont' 'echo -en "\033]50;-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15\007"'
704     'da' 'du -sch'
705     'j' 'jobs -l'
706     'u' 'translate -i'
707     'co' "./configure && make && sudo make install"
708     'CH' "./configure --help"
709     'conkeror' 'firefox -chrome chrome://conkeror/content'
710     'dir' 'ls -lSrah'
711     'lad' $'ls -d .*(/)\n# only show dot-directories'
712     'lsa' $'ls -a .*(.)\n# only show dot-files'
713     'lss' $'ls -l *(s,S,t)\n# only files with setgid/setuid/sticky flag'
714     'lsl' $'ls -l *(@[1,10])\n# only symlinks'
715     'lsx' $'ls -l *(*[1,10])\n# only executables'
716     'lsw' $'ls -ld *(R,W,X.^ND/)\n# world-{readable,writable,executable} files'
717     'lsbig' $'ls -flh *(.OL[1,10])\n# display the biggest files'
718     'lsd' $'ls -d *(/)\n# only show directories'
719     'lse' $'ls -d *(/^F)\n# only show empty directories'
720     'lsnew' $'ls -rl *(D.om[1,10])\n# display the newest files'
721     'lsold' $'ls -rtlh *(D.om[-11,-1])\n # display the oldest files'
722     'lssmall' $'ls -Srl *(.oL[1,10])\n# display the smallest files'
723     'rw-' 'chmod 600'
724     '600' 'chmod u+rw-x,g-rwx,o-rwx'
725     'rwx' 'chmod u+rwx'
726     '700' 'chmod u+rwx,g-rwx,o-rwx'
727     'r--' 'chmod u+r-wx,g-rwx,o-rwx'
728     '644' $'chmod u+rw-x,g+r-wx,o+r-wx\n # 4=r,2=w,1=x'
729     '755' 'chmod u+rwx,g+r-w+x,o+r-w+x'
730     'md' 'mkdir -p '
731     'cmplayer' 'mplayer -vo -fs -zoom fbdev'
732     'fbmplayer' 'mplayer -vo -fs -zoom fbdev'
733     'fblinks' 'links2 -driver fb'
734     'insecssh' 'ssh -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
735     'insecscp' 'scp -o "StrictHostKeyChecking=no" -o "UserKnownHostsFile=/dev/null"'
736     'fori' 'for i ({..}) { }'
737     'cx' 'chmod +x'
738     'e'  'print -l'
739     'se' 'setopt interactivecomments'
740     'va' 'valac --vapidir=../vapi/ --pkg=gtk+-2.0 gtktest.vala'
741     'fb2' '=mplayer -vo fbdev -fs -zoom 1>/dev/null -xy 2'
742     'fb3' '=mplayer -vo fbdev -fs  -zoom 1>/dev/null -xy 3'
743     'ci' 'centericq'
744     'D'  'export DISPLAY=:0.0'
745     'mp' 'mplayer -vo xv -fs -zoom'
746 )
747
748 globalias() {
749     local MATCH
750
751     if (( NOABBREVIATION > 0 )) ; then
752         LBUFFER="${LBUFFER},."
753         return 0
754     fi
755
756     matched_chars='[.-|_a-zA-Z0-9]#'
757     LBUFFER=${LBUFFER%%(#m)[.-|_a-zA-Z0-9]#}
758     LBUFFER+=${abk[$MATCH]:-$MATCH}
759 }
760
761 zle -N globalias
762 bindkey ",." globalias
763 # }}}
764
765 # {{{ autoloading
766 zrcautoload zmv    # who needs mmv or rename?
767 zrcautoload history-search-end
768
769 # we don't want to quote/espace URLs on our own...
770 # if autoload -U url-quote-magic ; then
771 #    zle -N self-insert url-quote-magic
772 #    zstyle ':url-quote-magic:*' url-metas '*?[]^()~#{}='
773 # else
774 #    print 'Notice: no url-quote-magic available :('
775 # fi
776 alias url-quote='autoload -U url-quote-magic ; zle -N self-insert url-quote-magic'
777
778 #m# k ESC-h Call \kbd{run-help} for the 1st word on the command line
779 alias run-help >&/dev/null && unalias run-help
780 zrcautoload run-help # use via 'esc-h'
781
782 # completion system
783 if zrcautoload compinit && compinit 2>/dev/null ; then
784     compinit 2>/dev/null || print 'Notice: no compinit available :('
785 else
786     print 'Notice: no compinit available :('
787     function zstyle { }
788     function compdef { }
789 fi
790
791 is4 && zrcautoload zed # use ZLE editor to edit a file or function
792
793 is4 && \
794 for mod in complist deltochar mathfunc ; do
795     zmodload -i zsh/${mod} 2>/dev/null || print "Notice: no ${mod} available :("
796 done
797
798 # autoload zsh modules when they are referenced
799 if is4 ; then
800     tmpargs=(
801         a   stat
802         a   zpty
803         ap  zprof
804         ap  mapfile
805     )
806
807     while (( ${#tmpargs} > 0 )) ; do
808         zmodload -${tmpargs[1]} zsh/${tmpargs[2]} ${tmpargs[2]}
809         shift 2 tmpargs
810     done
811     unset tmpargs
812 fi
813
814 if is4 && zrcautoload insert-files && zle -N insert-files ; then
815     #k# Insert files
816     bindkey "^Xf" insert-files # C-x-f
817 fi
818
819 bindkey ' '   magic-space    # also do history expansion on space
820 #k# Trigger menu-complete
821 bindkey '\ei' menu-complete  # menu completion via esc-i
822
823 # press esc-e for editing command line in $EDITOR or $VISUAL
824 if is4 && zrcautoload edit-command-line && zle -N edit-command-line ; then
825     #k# Edit the current line in \kbd{\$EDITOR}
826     bindkey '\ee' edit-command-line
827 fi
828
829 if is4 && [[ -n ${(k)modules[zsh/complist]} ]] ; then
830     #k# menu selection: pick item but stay in the menu
831     bindkey -M menuselect '\e^M' accept-and-menu-complete
832
833     # use the vi navigation keys (hjkl) besides cursor keys in menu completion
834     #bindkey -M menuselect 'h' vi-backward-char        # left
835     #bindkey -M menuselect 'k' vi-up-line-or-history   # up
836     #bindkey -M menuselect 'l' vi-forward-char         # right
837     #bindkey -M menuselect 'j' vi-down-line-or-history # bottom
838
839     # accept a completion and try to complete again by using menu
840     # completion; very useful with completing directories
841     # by using 'undo' one's got a simple file browser
842     bindkey -M menuselect '^o' accept-and-infer-next-history
843 fi
844
845 # press "ctrl-e d" to insert the actual date in the form yyyy-mm-dd
846 _bkdate() { BUFFER="$BUFFER$(date '+%F')"; CURSOR=$#BUFFER; }
847 zle -N _bkdate
848
849 #k# Insert a timestamp on the command line (yyyy-mm-dd)
850 bindkey '^Ed' _bkdate
851
852 # press esc-m for inserting last typed word again (thanks to caphuso!)
853 insert-last-typed-word() { zle insert-last-word -- 0 -1 };
854 zle -N insert-last-typed-word;
855
856 #k# Insert last typed word
857 bindkey "\em" insert-last-typed-word
858
859 # set command prediction from history, see 'man 1 zshcontrib'
860 #  is4 && zrcautoload predict-on && \
861 #  zle -N predict-on         && \
862 #  zle -N predict-off        && \
863 #  bindkey "^X^Z" predict-on && \
864 #  bindkey "^Z" predict-off
865
866 #k# Shortcut for \kbd{fg<enter>}
867 bindkey -s '^z' "fg\n"
868
869 # press ctrl-q to quote line:
870 #  mquote () {
871 #        zle beginning-of-line
872 #        zle forward-word
873 #        # RBUFFER="'$RBUFFER'"
874 #        RBUFFER=${(q)RBUFFER}
875 #        zle end-of-line
876 #  }
877 #  zle -N mquote && bindkey '^q' mquote
878
879 # run command line as user root via sudo:
880 sudo-command-line() {
881     [[ -z $BUFFER ]] && zle up-history
882     [[ $BUFFER != sudo\ * ]] && BUFFER="sudo $BUFFER"
883 }
884 zle -N sudo-command-line
885
886 #k# Put the current command line into a \kbd{sudo} call
887 bindkey "^Os" sudo-command-line
888
889 ### jump behind the first word on the cmdline.
890 ### useful to add options.
891 function jump_after_first_word() {
892     local words
893     words=(${(z)BUFFER})
894
895     if (( ${#words} <= 1 )) ; then
896         CURSOR=${#BUFFER}
897     else
898         CURSOR=${#${words[1]}}
899     fi
900 }
901 zle -N jump_after_first_word
902
903 bindkey '^x1' jump_after_first_word
904
905 # }}}
906
907 # {{{ set some important options
908 # Please update these tags, if you change the umask settings below.
909 #o# r_umask     002
910 #o# r_umaskstr  rwxrwxr-x
911 #o# umask       022
912 #o# umaskstr    rwxr-xr-x
913 (( EUID != 0 )) && umask 002 || umask 022
914
915 # history:
916 setopt append_history       # append history list to the history file (important for multiple parallel zsh sessions!)
917 is4 && setopt SHARE_HISTORY # import new commands from the history file also in other zsh-session
918 setopt extended_history     # save each command's beginning timestamp and the duration to the history file
919 is4 && setopt histignorealldups # If  a  new  command  line being added to the history
920                             # list duplicates an older one, the older command is removed from the list
921 setopt histignorespace      # remove command lines from the history list when
922                             # the first character on the line is a space
923 #  setopt histallowclobber    # add `|' to output redirections in the history
924 #  setopt NO_clobber          # warning if file exists ('cat /dev/null > ~/.zshrc')
925 setopt auto_cd              # if a command is issued that can't be executed as a normal command,
926                             # and the command is the name of a directory, perform the cd command to that directory
927 setopt extended_glob        # in order to use #, ~ and ^ for filename generation
928                             # grep word *~(*.gz|*.bz|*.bz2|*.zip|*.Z) ->
929                             # -> searches for word not in compressed files
930                             # don't forget to quote '^', '~' and '#'!
931 setopt longlistjobs         # display PID when suspending processes as well
932 setopt notify               # report the status of backgrounds jobs immediately
933 setopt hash_list_all        # Whenever a command completion is attempted, make sure \
934                             # the entire command path is hashed first.
935 setopt completeinword       # not just at the end
936 # setopt nocheckjobs          # don't warn me about bg processes when exiting
937 setopt nohup                # and don't kill them, either
938 # setopt printexitvalue       # alert me if something failed
939 # setopt dvorak               # with spelling correction, assume dvorak kb
940 setopt auto_pushd           # make cd push the old directory onto the directory stack.
941 setopt nonomatch            # try to avoid the 'zsh: no matches found...'
942 setopt nobeep               # avoid "beep"ing
943 setopt pushd_ignore_dups    # don't push the same dir twice.
944
945 MAILCHECK=30       # mailchecks
946 REPORTTIME=5       # report about cpu-/system-/user-time of command if running longer than 5 seconds
947 watch=(notme root) # watch for everyone but me and root
948
949 # define word separators (for stuff like backward-word, forward-word, backward-kill-word,..)
950 #  WORDCHARS='*?_-.[]~=/&;!#$%^(){}<>' # the default
951 #  WORDCHARS=.
952 #  WORDCHARS='*?_[]~=&;!#$%^(){}'
953 #  WORDCHARS='${WORDCHARS:s@/@}'
954
955 # only slash should be considered as a word separator:
956 slash-backward-kill-word() {
957     local WORDCHARS="${WORDCHARS:s@/@}"
958     # zle backward-word
959     zle backward-kill-word
960 }
961 zle -N slash-backward-kill-word
962
963 #k# Kill everything in a word up to its last \kbd{/}
964 bindkey '\ev' slash-backward-kill-word
965
966 # }}}
967
968 # {{{ history
969
970 ZSHDIR=$HOME/.zsh
971
972 #v#
973 HISTFILE=$HOME/.zsh_history
974 isgrmlcd && HISTSIZE=500  || HISTSIZE=5000
975 isgrmlcd && SAVEHIST=1000 || SAVEHIST=10000 # useful for setopt append_history
976
977 # }}}
978
979 # dirstack handling {{{
980
981 DIRSTACKSIZE=${DIRSTACKSIZE:-20}
982 DIRSTACKFILE=${DIRSTACKFILE:-${HOME}/.zdirs}
983
984 if [[ -f ${DIRSTACKFILE} ]] && [[ ${#dirstack[*]} -eq 0 ]] ; then
985     dirstack=( ${(f)"$(< $DIRSTACKFILE)"} )
986     # "cd -" won't work after login by just setting $OLDPWD, so
987     [[ -d $dirstack[0] ]] && cd $dirstack[0] && cd $OLDPWD
988 fi
989
990 chpwd() {
991     if is42 ; then
992         builtin print -l ${(u)dirstack} >! ${DIRSTACKFILE}
993     else
994         uprint dirstack >! ${DIRSTACKFILE}
995     fi
996 }
997
998 # }}}
999
1000 # {{{ display battery status on right side of prompt via running 'BATTERY=1 zsh'
1001 if [[ -n "$BATTERY" ]] ; then
1002     if check_com -c acpi ; then
1003         PERCENT="${(C)${(s| |)$(acpi 2>/dev/null)}[4]}"
1004         [[ -z "$PERCENT" ]] && PERCENT='acpi not present'
1005
1006         if [[ "${PERCENT%%%}" -lt 20 ]] ; then
1007             PERCENT="warning: ${PERCENT}%"
1008         fi
1009     fi
1010 fi
1011 # }}}
1012
1013 # set colors for use in prompts {{{
1014 if zrcautoload colors && colors 2>/dev/null ; then
1015     BLUE="%{${fg[blue]}%}"
1016     RED="%{${fg_bold[red]}%}"
1017     GREEN="%{${fg[green]}%}"
1018     CYAN="%{${fg[cyan]}%}"
1019     MAGENTA="%{${fg[magenta]}%}"
1020     YELLOW="%{${fg[yellow]}%}"
1021     WHITE="%{${fg[white]}%}"
1022     NO_COLOUR="%{${reset_color}%}"
1023 else
1024     BLUE=$'%{\e[1;34m%}'
1025     RED=$'%{\e[1;31m%}'
1026     GREEN=$'%{\e[1;32m%}'
1027     CYAN=$'%{\e[1;36m%}'
1028     WHITE=$'%{\e[1;37m%}'
1029     MAGENTA=$'%{\e[1;35m%}'
1030     YELLOW=$'%{\e[1;33m%}'
1031     NO_COLOUR=$'%{\e[0m%}'
1032 fi
1033
1034 # }}}
1035
1036 # gather version control information for inclusion in a prompt {{{
1037
1038 # vcs_info() documentation: {{{
1039 #
1040 # The vcs_info() feature can be configured via zstyle:
1041 #   First, the context in which we are working:
1042 #       :vcs_info:<vcs-string>
1043 #   ...where <vcs-string> is one of:
1044 #       - git, git-svn, hg, darcs, bzr, mtn, svn, cvs or svk
1045 #
1046 #   You can of course use ':vcs_info:*' to match all VCSs at once.
1047 #
1048 # There is one special context named 'init', that is in effect as long
1049 # as there was no decision what vcs backend to use.
1050 #
1051 # There are currently two styles, that are looked up:
1052 #   promptformat        - Used in most circumstances.
1053 #   promptactionformat  - Used if a there is a special action going on;
1054 #                         (like an interactive rebase or a merge conflict)
1055 #   enable              - Check in the 'init' context. If set to false,
1056 #                         vcs_info() will do nothing.
1057 #   disable             - Provide a list of systems, you don't want
1058 #                         the prompt to check for repositories (checked
1059 #                         in the 'init' context, too).
1060 #   use-simple          - If there are two different ways of gathering
1061 #                         information, you can select the simpler one
1062 #                         by setting this style to true; the default
1063 #                         is to use the not-that-simple code, which is
1064 #                         potentially a lot slower but might be more
1065 #                         accurate in all possible cases.
1066 #
1067 # The use-simple style is currently only available for the bzr backend.
1068 #
1069 # The default values for these in all contexts are:
1070 #   promptformat        " (%s)-[%b|%a]-"
1071 #   promptactionformat  " (%s)-[%b]-"
1072 #   enable              true
1073 #
1074 # In these formats, the following replacements are done:
1075 #   %s  - The vcs in use (git, hg, svn etc.)
1076 #   %b  - Information about the current branch.
1077 #   %a  - An identifier, that describes the action.
1078 #         Only makes sense in promptactionformat.
1079 #   %R  - base directory of the repository.
1080 #   %r  - repository name
1081 #         If %R is '/foo/bar/repoXY', %r is 'repoXY'.
1082 #
1083 # Not all vcs backends may support all replacements
1084 #
1085 # Examples:
1086 #   Don't use vcs_info at all (even though it's in your prompt):
1087 #   % zstyle ':vcs_info:*' enable false
1088 #
1089 #   Don't provide prompt info for bzr and svk:
1090 #   % zstyle ':vcs_info:*' disable bzr svk
1091 #
1092 #   Provide a prompt specifically for git:
1093 #   % zstyle ':vcs_info:git' promptformat       ' GIT, BABY! [%b]'
1094 #   % zstyle ':vcs_info:git' promptactionformat ' GIT ACTION! [%b|%a]'
1095 #
1096 #   Use the quicker bzr backend (if you do, please report if it does
1097 #   the-right-thing[tm] - thanks):
1098 #   % zstyle ':vcs_info:bzr' use-simple true
1099 #
1100 # If you want colors, make sure you enclose the color codes in %{...%}, because
1101 # the string provided by vcs_info() is used for prompts.
1102 #
1103 #   Example: PROMPT='%(?..[%?]-)%3~%$(vcs_info)#'
1104 #
1105 # This *requires* 'setopt prompt_subst'.
1106 # }}}
1107 VCS_INFO_adjust () { #{{{
1108     [[ -n ${vcs_comm[overwrite_name]} ]] && vcs=${vcs_comm[overwrite_name]}
1109     return 0
1110 }
1111 # }}}
1112 VCS_INFO_format () { # {{{
1113     local msg
1114
1115     if [[ -n ${1} ]] ; then
1116         zstyle -s ":vcs_info:${vcs}" promptactionformat msg
1117         [[ -z ${msg} ]] && msg=' (%s)-[%b|%a]-'
1118     else
1119         zstyle -s ":vcs_info:${vcs}" promptformat msg
1120         [[ -z ${msg} ]] && msg=' (%s)-[%b]-'
1121     fi
1122     printf '%s' ${msg}
1123 }
1124 # }}}
1125 VCS_INFO_realpath () { #{{{
1126     # replacing 'readlink -f', which is really not portable.
1127
1128     # If there *is* a chpwd() function unfunction it here.
1129     # The *real* zsh does not loose its chpwd(), because we run
1130     # in a different context (process substitution in $PROMPT).
1131     (( ${+functions[chpwd]} )) && unfunction chpwd
1132     setopt chaselinks
1133     cd $1 2>/dev/null && pwd
1134 }
1135 # }}}
1136 VCS_INFO_git_getaction () { #{{{
1137     local gitaction='' gitdir=${1}
1138     local tmp
1139
1140     for tmp in "${gitdir}/rebase-apply" \
1141                "${gitdir}/rebase"       \
1142                "${gitdir}/../.dotest" ; do
1143         if [[ -d ${tmp} ]] ; then
1144             if   [[ -f "${tmp}/rebasing" ]] ; then
1145                 gitaction="rebase"
1146             elif [[ -f "${tmp}/applying" ]] ; then
1147                 gitaction="am"
1148             else
1149                 gitaction="am/rebase"
1150             fi
1151             printf '%s' ${gitaction}
1152             return 0
1153         fi
1154     done
1155
1156     for tmp in "${gitdir}/rebase-merge/interactive" \
1157                "${gitdir}/.dotest-merge/interactive" ; do
1158         if [[ -f "${tmp}" ]] ; then
1159             printf '%s' "rebase-i"
1160             return 0
1161         fi
1162     done
1163
1164     for tmp in "${gitdir}/rebase-merge" \
1165                "${gitdir}/.dotest-merge" ; do
1166         if [[ -d "${tmp}" ]] ; then
1167             printf '%s' "rebase-m"
1168             return 0
1169         fi
1170     done
1171
1172     if [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1173         printf '%s' "merge"
1174     else
1175         if [[ -f "${gitdir}/BISECT_LOG" ]] ; then
1176             printf '%s' "bisect"
1177         fi
1178     fi
1179
1180     return 1
1181 }
1182 # }}}
1183 VCS_INFO_git_getbranch () { #{{{
1184     local gitbranch gitdir=${1}
1185     local gitsymref='git symbolic-ref HEAD'
1186
1187     if    [[ -d "${gitdir}/rebase-apply" ]] \
1188        || [[ -d "${gitdir}/rebase" ]]       \
1189        || [[ -d "${gitdir}/../.dotest" ]]   \
1190        || [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1191         gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1192         [[ -z ${gitbranch} ]] && gitbranch="$(< ${gitdir}/rebase-apply/head-name)"
1193
1194     elif   [[ -f "${gitdir}/rebase-merge/interactive" ]] \
1195         || [[ -d "${gitdir}/rebase-merge" ]] ; then
1196         gitbranch="$(< ${gitdir}/rebase-merge/head-name)"
1197
1198     elif   [[ -f "${gitdir}/.dotest-merge/interactive" ]] \
1199         || [[ -d "${gitdir}/.dotest-merge" ]] ; then
1200         gitbranch="$(< ${gitdir}/.dotest-merge/head-name)"
1201
1202     else
1203         gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1204
1205         if [[ $? -ne 0 ]] ; then
1206             gitbranch="$(git describe --exact-match HEAD 2>/dev/null)"
1207
1208             if [[ $? -ne 0 ]] ; then
1209                 gitbranch="${${"$(< $gitdir/HEAD)"}[1,7]}..."
1210             fi
1211         fi
1212     fi
1213
1214     printf '%s' "${gitbranch##refs/heads/}"
1215 }
1216 # }}}
1217 VCS_INFO_git_get_data () { # {{{
1218     setopt localoptions extendedglob
1219     local gitdir gitbase gitbranch gitaction msg
1220
1221     gitdir=${vcs_comm[gitdir]}
1222     gitbranch="$(VCS_INFO_git_getbranch ${gitdir})"
1223
1224     if [[ -z ${gitdir} ]] || [[ -z ${gitbranch} ]] ; then
1225         return
1226     fi
1227
1228     VCS_INFO_adjust
1229     gitaction="$(VCS_INFO_git_getaction ${gitdir})"
1230     msg=$(VCS_INFO_format ${gitaction})
1231
1232     gitbase=${PWD%/${$(git rev-parse --show-prefix)%/##}}
1233
1234     zformat -f msg "${msg}" "a:${gitaction}" "b:${gitbranch}" "s:${vcs}" "r:${gitbase:t}" "R:${gitbase}"
1235     printf '%s' ${msg}
1236 }
1237 # }}}
1238 VCS_INFO_darcs_get_data () { # {{{
1239     local msg darcsbase
1240
1241     darcsbase=${vcs_comm[basedir]}
1242     msg=$(VCS_INFO_format)
1243     zformat -f msg "${msg}" "a:" "b:${darcsbase:t}" "s:${vcs}" "r:${darcsbase:t}" "R:${darcsbase}"
1244     printf '%s' ${msg}
1245 }
1246 # }}}
1247 VCS_INFO_hg_get_data () { # {{{
1248     local msg hgbranch hgbase
1249
1250     hgbase=${vcs_comm[basedir]}
1251     hgbranch=$(< ${hgbase}/.hg/branch)
1252     msg=$(VCS_INFO_format)
1253     zformat -f msg "${msg}" "a:" "b:${hgbranch}" "s:${vcs}" "r:${hgbase:t}" "R:${hgbase}"
1254     printf '%s' ${msg}
1255 }
1256 # }}}
1257 VCS_INFO_mtn_get_data () { # {{{
1258     local msg mtnbranch mtnbase
1259
1260     mtnbase=${vcs_comm[basedir]}
1261     mtnbranch=$(mtn status | awk '/Current branch:/{ sub("Current branch: ", ""); print }')
1262     msg=$(VCS_INFO_format)
1263     zformat -f msg "${msg}" "a:" "b:${mtnbranch}" "s:${vcs}" "r:${mtnbase:t}" "R:${mtnbase}"
1264     printf '%s' ${msg}
1265 }
1266 # }}}
1267 VCS_INFO_svk_get_data () { # {{{
1268     local msg svkbranch svkbase
1269
1270     svkbase=${vcs_comm[basedir]}
1271     svkbranch=${svkbase##*
1272   }
1273     svkbase=${svkbase%%
1274   *}
1275
1276     msg=$(VCS_INFO_format)
1277     zformat -f msg "${msg}" "a:" "b:${svkbranch}" "s:${vcs}" "r:${svkbase:t}" "R:${svkbase}"
1278     printf '%s' ${msg}
1279 }
1280 # }}}
1281 VCS_INFO_svn_get_data () { # {{{
1282     local msg svnbranch svnbase
1283
1284     svnbase="."
1285     while [[ -d "${svnbase}/../.svn" ]]; do
1286         svnbase="${svnbase}/.."
1287     done
1288     svnbase=$(VCS_INFO_realpath ${svnbase})
1289     svnbranch=$(svn info "$base_dir" | awk '/^URL/ { sub(".*/","",$0); r=$0 } /^Revision/ { sub("[^0-9]*","",$0); print r":"$0 }')
1290
1291     msg=$(VCS_INFO_format)
1292     zformat -f msg "${msg}" "a:" "b:${svnbranch}" "s:${vcs}" "r:${svnbase:t}" "R:${svnbase}"
1293     printf '%s' ${msg}
1294 }
1295 # }}}
1296 VCS_INFO_bzr_get_data () { # {{{
1297     local msg bzrbranch bzrbase bzrrevno i j
1298
1299     if zstyle -t ":vcs_info:${vcs}" "use-simple" ; then
1300         bzrbase=${vcs_comm[basedir]}
1301         bzrbranch=${bzrbase:t}
1302         if [[ -f ${bzrbase}/.bzr/branch/last-revision ]] ; then
1303             bzrrevno=$(< ${bzrbase}/.bzr/branch/last-revision)
1304             bzrrevno=${bzrrevno%% *}
1305         fi
1306     else
1307         bzrbase=$(bzr info 2>/dev/null | sed -rne 's, *branch root: ,,p')
1308         bzrbase=$(VCS_INFO_realpath ${bzrbase})
1309
1310         bzr version-info 2> /dev/null | while read i j; do
1311             case "${i}" in
1312                 revno:)
1313                     bzrrevno=${j} ;;
1314                 branch-nick:)
1315                     bzrbranch=${j} ;;
1316             esac
1317         done
1318     fi
1319
1320     msg=$(VCS_INFO_format)
1321     zformat -f msg "${msg}" "a:" "b:${bzrbranch}:${bzrrevno}" "s:${vcs}" "r:${bzrbase:t}" "R:${bzrbase}"
1322     printf '%s' ${msg}
1323 }
1324 # }}}
1325 VCS_INFO_cvs_get_data () { # {{{
1326     local msg cvsbranch cvsbase basename
1327
1328     cvsbase="."
1329     while [[ -d "${cvsbase}/../CVS" ]]; do
1330         cvsbase="${cvsbase}/.."
1331     done
1332     cvsbase=$(VCS_INFO_realpath ${cvsbase})
1333     cvsbranch=$(< ./CVS/Repository)
1334     basename=${cvsbase:t}
1335     cvsbranch=${cvsbranch##${basename}/}
1336     [[ -z ${cvsbranch} ]] && cvsbranch=${basename}
1337
1338     msg=$(VCS_INFO_format)
1339     zformat -f msg "${msg}" "a:" "b:${cvsbranch}" "s:${vcs}" "r:${basename}" "R:${cvsbase}"
1340     printf '%s' ${msg}
1341 }
1342 # }}}
1343 # VCS_INFO_*_detect () {{{
1344
1345 VCS_INFO_detect_by_dir() {
1346     local dirname=${1}
1347     local basedir="." realbasedir
1348
1349     realbasedir=$(VCS_INFO_realpath ${basedir})
1350     while [[ ${realbasedir} != '/' ]]; do
1351         if [[ -n ${vcs_comm[detect_need_file]} ]] ; then
1352             [[ -d ${basedir}/${dirname} ]] && \
1353             [[ -f ${basedir}/${dirname}/${vcs_comm[detect_need_file]} ]] && \
1354                 break
1355         else
1356             [[ -d ${basedir}/${dirname} ]] && break
1357         fi
1358
1359         basedir=${basedir}/..
1360         realbasedir=$(VCS_INFO_realpath ${basedir})
1361     done
1362
1363     [[ ${realbasedir} == "/" ]] && return 1
1364     vcs_comm[basedir]=${realbasedir}
1365     return 0
1366 }
1367
1368 VCS_INFO_bzr_detect() {
1369     check_com -c bzr || return 1
1370     vcs_comm[detect_need_file]=branch/format
1371     VCS_INFO_detect_by_dir '.bzr'
1372     return $?
1373 }
1374
1375 VCS_INFO_cvs_detect() {
1376     check_com -c svn || return 1
1377     [[ -d "CVS" ]] && return 0
1378     return 1
1379 }
1380
1381 VCS_INFO_darcs_detect() {
1382     check_com -c darcs || return 1
1383     vcs_comm[detect_need_file]=format
1384     VCS_INFO_detect_by_dir '_darcs'
1385     return $?
1386 }
1387
1388 VCS_INFO_git_detect() {
1389     if check_com -c git && git rev-parse --is-inside-work-tree &> /dev/null ; then
1390         vcs_comm[gitdir]="$(git rev-parse --git-dir 2> /dev/null)" || return 1
1391         [[ -d ${vcs_comm[gitdir]}/svn ]] && vcs_comm[overwrite_name]='git-svn'
1392         return 0
1393     fi
1394     return 1
1395 }
1396
1397 VCS_INFO_hg_detect() {
1398     check_com -c hg || return 1
1399     vcs_comm[detect_need_file]=branch
1400     VCS_INFO_detect_by_dir '.hg'
1401     return $?
1402 }
1403
1404 VCS_INFO_mtn_detect() {
1405     check_com -c mtn || return 1
1406     vcs_comm[detect_need_file]=revision
1407     VCS_INFO_detect_by_dir '_MTN'
1408     return $?
1409 }
1410
1411 VCS_INFO_svk_detect() {
1412     local basedir
1413
1414     check_com -c svk || return 1
1415     [[ -f ~/.svk/config ]] || return 1
1416
1417     basedir=$(awk '/: *$/ { sub(/^ */,"",$0); sub(/: *$/,"",$0); if (match("'${PWD}'", $0"(/|$)")) { print $0; d=1; } } /depotpath/ && d == 1 { sub(".*/","",$0); r=$0 } /revision/ && d == 1 { print r ":" $2; exit 1 }' ~/.svk/config) && return 1
1418
1419     vcs_comm[basedir]=${basedir}
1420     return 0
1421 }
1422
1423 VCS_INFO_svn_detect() {
1424     check_com -c svn || return 1
1425     [[ -d ".svn" ]] && return 0
1426     return 1
1427 }
1428
1429 # }}}
1430 vcs_info () { # {{{
1431     local string
1432     local -i found
1433     local -a VCSs disabled
1434     local -x vcs
1435     local -Ax vcs_comm
1436
1437     vcs="init"
1438     zstyle -T ":vcs_info:${vcs}" "enable" || return 0
1439     zstyle -a ":vcs_info:${vcs}" "disable" disabled
1440
1441     VCSs=(git hg bzr darcs mtn svn cvs svk)
1442
1443     (( found = 0 ))
1444     for vcs in ${VCSs} ; do
1445         [[ -n ${(M)disabled:#${vcs}} ]] && continue
1446         vcs_comm=()
1447         VCS_INFO_${vcs}_detect && (( found = 1 )) && break
1448     done
1449
1450     (( found == 0 )) && return 0
1451
1452     string=$(VCS_INFO_${vcs}_get_data) || return 1
1453     printf '%s' ${string}
1454     return 0
1455 }
1456 # }}}
1457
1458 # change vcs_info formats for the grml prompt
1459 if [[ "$TERM" == dumb ]] ; then
1460     zstyle ':vcs_info:*' promptactionformat "(%s%)-[%b|%a] "
1461     zstyle ':vcs_info:*' promptformat       "(%s%)-[%b] "
1462 else
1463     # these are the same, just with a lot of colours:
1464     zstyle ':vcs_info:*' promptactionformat "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${YELLOW}|${RED}%a${MAGENTA}]${NO_COLOUR} "
1465     zstyle ':vcs_info:*' promptformat       "${MAGENTA}(${NO_COLOUR}%s${MAGENTA})${YELLOW}-${MAGENTA}[${GREEN}%b${MAGENTA}]${NO_COLOUR}%} "
1466 fi
1467
1468 # }}}
1469
1470 # {{{ set prompt
1471 if zrcautoload promptinit && promptinit 2>/dev/null ; then
1472     promptinit # people should be able to use their favourite prompt
1473 else
1474     print 'Notice: no promptinit available :('
1475 fi
1476
1477 setopt prompt_subst
1478
1479 # precmd() => a function which is executed just before each prompt
1480 # use 'NOPRECMD=1' to disable the precmd + preexec commands
1481
1482 # precmd () { setopt promptsubst; [[ -o interactive ]] && jobs -l;
1483
1484 # make sure to use right prompt only when not running a command
1485 is41 && setopt transient_rprompt
1486
1487 is4 && [[ -z $NOPRECMD ]] && precmd () {
1488     [[ -n $NOPRECMD ]] && return 0
1489     # allow manual overwriting of RPROMPT
1490     if [[ -n $RPROMPT ]] ; then
1491         [[ $TERM == screen* ]] && echo -n $'\ekzsh\e\\'
1492         # return 0
1493     fi
1494     # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
1495     if [[ -z $DONTSETRPROMPT ]] ; then
1496         if [[ -n $BATTERY ]] ; then
1497             RPROMPT="%(?..:()% ${PERCENT}${SCREENTITLE}"
1498             # RPROMPT="${PERCENT}${SCREENTITLE}"
1499         else
1500             RPROMPT="%(?..:()% ${SCREENTITLE}"
1501             # RPROMPT="${SCREENTITLE}"
1502         fi
1503     fi
1504     # adjust title of xterm
1505     # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
1506     case $TERM in
1507         (xterm*|rxvt)
1508             print -Pn "\e]0;%n@%m: %~\a"
1509             ;;
1510     esac
1511 }
1512
1513 # chpwd () => a function which is executed whenever the directory is changed
1514
1515 # preexec() => a function running before every command
1516 is4 && [[ -z $NOPRECMD ]] && \
1517 preexec () {
1518     [[ -n $NOPRECMD ]] && return 0
1519 # set hostname if not running on host with name 'grml'
1520     if [[ -n "$HOSTNAME" ]] && [[ "$HOSTNAME" != $(hostname) ]] ; then
1521        NAME="@$HOSTNAME"
1522     fi
1523 # get the name of the program currently running and hostname of local machine
1524 # set screen window title if running in a screen
1525     if [[ "$TERM" == screen* ]] ; then
1526         # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]}       # don't use hostname
1527         local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
1528         echo -ne "\ek$CMD\e\\"
1529     fi
1530 # set the screen title to "zsh" when sitting at the command prompt:
1531     if [[ "$TERM" == screen* ]] ; then
1532         SCREENTITLE=$'%{\ekzsh\e\\%}'
1533     else
1534         SCREENTITLE=''
1535     fi
1536 # adjust title of xterm
1537     case $TERM in
1538         (xterm*|rxvt)
1539             print -Pn "\e]0;%n@%m: $1\a"
1540             ;;
1541     esac
1542 }
1543
1544 EXITCODE="%(?..%?%1v )"
1545 PS2='`%_> '       # secondary prompt, printed when the shell needs more information to complete a command.
1546 PS3='?# '         # selection prompt used within a select loop.
1547 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
1548
1549 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
1550 if [[ -z "$debian_chroot" ]] && [[ -r /etc/debian_chroot ]] ; then
1551     debian_chroot=$(cat /etc/debian_chroot)
1552 fi
1553
1554 # don't use colors on dumb terminals (like emacs):
1555 if [[ "$TERM" == dumb ]] ; then
1556     PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< "'$(vcs_info)'"%# "
1557 else
1558     # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
1559     # set variable identifying the chroot you work in (used in the prompt below)
1560     if [[ -n $GRMLPROMPT ]] ; then
1561         PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
1562 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# "
1563     else
1564         # This assembles the primary prompt string
1565         if (( EUID != 0 )); then
1566             PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'$(vcs_info)'"%# "
1567         else
1568             PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< "'$(vcs_info)'"%# "
1569         fi
1570     fi
1571 fi
1572
1573 # if we are inside a grml-chroot set a specific prompt theme
1574 if [[ -n "$GRML_CHROOT" ]] ; then
1575     PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
1576 fi
1577 # }}}
1578
1579 # {{{ 'hash' some often used directories
1580 #d# start
1581 hash -d deb=/var/cache/apt/archives
1582 hash -d doc=/usr/share/doc
1583 hash -d linux=/lib/modules/$(command uname -r)/build/
1584 hash -d log=/var/log
1585 hash -d slog=/var/log/syslog
1586 hash -d src=/usr/src
1587 hash -d templ=/usr/share/doc/grml-templates
1588 hash -d tt=/usr/share/doc/texttools-doc
1589 hash -d www=/var/www
1590 #d# end
1591 # }}}
1592
1593 # {{{ some aliases
1594 if [[ $UID -eq 0 ]] ; then
1595     [[ -r /etc/grml/screenrc ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc'
1596 elif [[ -r $HOME/.screenrc ]] ; then
1597     alias screen="/usr/bin/screen -c $HOME/.screenrc"
1598 else
1599     [[ -r /etc/grml/screenrc_grml ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc_grml'
1600 fi
1601
1602 # do we have GNU ls with color-support?
1603 if ls --help 2>/dev/null | grep -- --color= >/dev/null && [[ "$TERM" != dumb ]] ; then
1604     #a1# execute \kbd{@a@}:\quad ls with colors
1605     alias ls='ls -b -CF --color=auto'
1606     #a1# execute \kbd{@a@}:\quad list all files, with colors
1607     alias la='ls -la --color=auto'
1608     #a1# long colored list, without dotfiles (@a@)
1609     alias ll='ls -l --color=auto'
1610     #a1# long colored list, human readable sizes (@a@)
1611     alias lh='ls -hAl --color=auto'
1612     #a1# List files, append qualifier to filenames \\&\quad(\kbd{/} for directories, \kbd{@} for symlinks ...)
1613     alias l='ls -lF --color=auto'
1614 else
1615     alias ls='ls -b -CF'
1616     alias la='ls -la'
1617     alias ll='ls -l'
1618     alias lh='ls -hAl'
1619     alias l='ls -lF'
1620 fi
1621
1622 alias mdstat='cat /proc/mdstat'
1623 alias ...='cd ../../'
1624
1625 # generate alias named "$KERNELVERSION-reboot" so you can use boot with kexec:
1626 if [[ -x /sbin/kexec ]] && [[ -r /proc/cmdline ]] ; then
1627     alias "$(uname -r)-reboot"="kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)""
1628 fi
1629
1630 alias cp='nocorrect cp'         # no spelling correction on cp
1631 alias mkdir='nocorrect mkdir'   # no spelling correction on mkdir
1632 alias mv='nocorrect mv'         # no spelling correction on mv
1633 alias rm='nocorrect rm'         # no spelling correction on rm
1634
1635 #a1# Execute \kbd{rmdir}
1636 alias rd='rmdir'
1637 #a1# Execute \kbd{rmdir}
1638 alias md='mkdir'
1639
1640 # see http://www.cl.cam.ac.uk/~mgk25/unicode.html#term for details
1641 alias term2iso="echo 'Setting terminal to iso mode' ; print -n '\e%@'"
1642 alias term2utf="echo 'Setting terminal to utf-8 mode'; print -n '\e%G'"
1643
1644 # make sure it is not assigned yet
1645 [[ $(whence -w utf2iso &>/dev/null) == 'utf2iso: alias' ]] && unalias utf2iso
1646
1647 utf2iso() {
1648     if isutfenv ; then
1649         for ENV in $(env | command grep -i '.utf') ; do
1650             eval export "$(echo $ENV | sed 's/UTF-8/iso885915/ ; s/utf8/iso885915/')"
1651         done
1652     fi
1653 }
1654
1655 # make sure it is not assigned yet
1656 [[ $(whence -w iso2utf &>/dev/null) == 'iso2utf: alias' ]] && unalias iso2utf
1657 iso2utf() {
1658     if ! isutfenv ; then
1659         for ENV in $(env | command grep -i '\.iso') ; do
1660             eval export "$(echo $ENV | sed 's/iso.*/UTF-8/ ; s/ISO.*/UTF-8/')"
1661         done
1662     fi
1663 }
1664
1665 # set up software synthesizer via speakup
1666 swspeak() {
1667     aumix -w 90 -v 90 -p 90 -m 90
1668     if ! [[ -r /dev/softsynth ]] ; then
1669         flite -o play -t "Sorry, software synthesizer not available. Did you boot with swspeak bootoption?"
1670         return 1
1671     else
1672         setopt singlelinezle
1673         unsetopt prompt_cr
1674         export PS1="%m%# "
1675         nice -n -20 speechd-up
1676         sleep 2
1677         flite -o play -t "Finished setting up software synthesizer"
1678     fi
1679 }
1680
1681 # I like clean prompt, so provide simple way to get that
1682 check_com 0 || alias 0='return 0'
1683
1684 # for really lazy people like mika:
1685 check_com S &>/dev/null || alias S='screen'
1686 check_com s &>/dev/null || alias s='ssh'
1687
1688 # get top 10 shell commands:
1689 alias top10='print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10'
1690
1691 # truecrypt; use e.g. via 'truec /dev/ice /mnt/ice' or 'truec -i'
1692 if check_com -c truecrypt ; then
1693     if isutfenv ; then
1694         alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
1695     else
1696         alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
1697     fi
1698 fi
1699
1700 #f1# Hints for the use of zsh on grml
1701 zsh-help() {
1702     print "$bg[white]$fg[black]
1703 zsh-help - hints for use of zsh on grml
1704 =======================================$reset_color"
1705
1706     print '
1707 Main configuration of zsh happens in /etc/zsh/zshrc (global)
1708 and /etc/skel/.zshrc which is copied to $HOME/.zshrc once.
1709 The files are part of the package grml-etc-core, if you want to
1710 use them on a non-grml-system just get the tar.gz from
1711 http://deb.grml.org/ or get the files from the mercurial
1712 repository:
1713
1714   http://hg.grml.org/grml-etc-core/raw-file/tip/etc/skel/.zshrc
1715   http://hg.grml.org/grml-etc-core/raw-file/tip/etc/zsh/zshrc
1716
1717 If you want to stay in sync with zsh configuration of grml
1718 run '\''ln -sf /etc/skel/.zshrc $HOME/.zshrc'\'' and configure
1719 your own stuff in $HOME/.zshrc.local. System wide configuration
1720 without touching configuration files of grml can take place
1721 in /etc/zsh/zshrc.local.
1722
1723 If you want to use the configuration of user grml also when
1724 running as user root just run '\''zshskel'\'' which will source
1725 the file /etc/skel/.zshrc.
1726
1727 For information regarding zsh start at http://grml.org/zsh/
1728
1729 Take a look at grml'\''s zsh refcard:
1730 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
1731
1732 Check out the main zsh refcard:
1733 % '$BROWSER' http://www.bash2zsh.com/zsh_refcard/refcard.pdf
1734
1735 And of course visit the zsh-lovers:
1736 % man zsh-lovers
1737
1738 You can adjust some options through environment variables when
1739 invoking zsh without having to edit configuration files.
1740 Basically meant for bash users who are not used to the power of
1741 the zsh yet. :)
1742
1743   "NOCOR=1    zsh" => deactivate automatic correction
1744   "NOMENU=1   zsh" => do not use menu completion (note: use strg-d for completion instead!)
1745   "NOPRECMD=1 zsh" => disable the precmd + preexec commands (set GNU screen title)
1746   "BATTERY=1  zsh" => activate battery status (via acpi) on right side of prompt'
1747
1748     print "
1749 $bg[white]$fg[black]
1750 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
1751 Enjoy your grml system with the zsh!$reset_color"
1752 }
1753
1754 # debian stuff
1755 if [[ -r /etc/debian_version ]] ; then
1756     #a3# Execute \kbd{apt-cache search}
1757     alias acs='apt-cache search'
1758     #a3# Execute \kbd{apt-cache show}
1759     alias acsh='apt-cache show'
1760     #a3# Execute \kbd{apt-cache policy}
1761     alias acp='apt-cache policy'
1762     #a3# Execute \kbd{apt-get dist-upgrade}
1763     salias adg="apt-get dist-upgrade"
1764     #a3# Execute \kbd{apt-get install}
1765     salias agi="apt-get install"
1766     #a3# Execute \kbd{aptitude install}
1767     salias ati="aptitude install"
1768     #a3# Execute \kbd{apt-get upgrade}
1769     salias ag="apt-get upgrade"
1770     #a3# Execute \kbd{apt-get update}
1771     salias au="apt-get update"
1772     #a3# Execute \kbd{aptitude update ; aptitude safe-upgrade}
1773     salias -a up="aptitude update ; aptitude safe-upgrade"
1774     #a3# Execute \kbd{dpkg-buildpackage}
1775     alias dbp='dpkg-buildpackage'
1776     #a3# Execute \kbd{grep-excuses}
1777     alias ge='grep-excuses'
1778
1779     # debian upgrade
1780     #f3# Execute \kbd{apt-get update \&\& }\\&\quad \kbd{apt-get dist-upgrade}
1781     upgrade() {
1782         if [[ -z "$1" ]] ; then
1783             $SUDO apt-get update
1784             $SUDO apt-get -u upgrade
1785         else
1786             ssh $1 $SUDO apt-get update
1787             # ask before the upgrade
1788             local dummy
1789             ssh $1 $SUDO apt-get --no-act upgrade
1790             echo -n 'Process the upgrade?'
1791             read -q dummy
1792             if [[ $dummy == "y" ]] ; then
1793                 ssh $1 $SUDO apt-get -u upgrade --yes
1794             fi
1795         fi
1796     }
1797
1798     # get a root shell as normal user in live-cd mode:
1799     if isgrmlcd && [[ $UID -ne 0 ]] ; then
1800        alias su="sudo su"
1801      fi
1802
1803     #a1# Take a look at the syslog: \kbd{\$PAGER /var/log/syslog}
1804     alias llog="$PAGER /var/log/syslog"     # take a look at the syslog
1805     #a1# Take a look at the syslog: \kbd{tail -f /var/log/syslog}
1806     alias tlog="tail -f /var/log/syslog"    # follow the syslog
1807     #a1# (Re)-source \kbd{/etc/skel/.zshrc}
1808     alias zshskel="source /etc/skel/.zshrc" # source skeleton zshrc
1809 fi
1810
1811 # sort installed Debian-packages by size
1812 if check_com -c grep-status ; then
1813     #a3# List installed Debian-packages sorted by size
1814     alias debs-by-size='grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd "  \n" | sort -rn'
1815 fi
1816
1817 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
1818 if [[ -L /usr/bin/cdrecord ]] || ! check_com -c cdrecord ; then
1819     if check_com -c wodim ; then
1820         alias cdrecord="echo 'cdrecord is not provided under its original name by Debian anymore.
1821 See #377109 in the BTS of Debian for more details.
1822
1823 Please use the wodim binary instead' ; return 1"
1824     fi
1825 fi
1826
1827 # get_tw_cli has been renamed into get_3ware
1828 if check_com -c get_3ware ; then
1829     get_tw_cli() {
1830         echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
1831         get_3ware
1832     }
1833 fi
1834
1835 # I hate lacking backward compatibility, so provide an alternative therefore
1836 if ! check_com -c apache2-ssl-certificate ; then
1837
1838     apache2-ssl-certificate() {
1839
1840     print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
1841     print 'You might want to take a look at Debian the package ssl-cert as well.'
1842     print 'To generate a certificate for use with apache2 follow the instructions:'
1843
1844     echo '
1845
1846 export RANDFILE=/dev/random
1847 mkdir /etc/apache2/ssl/
1848 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
1849 chmod 600 /etc/apache2/ssl/apache.pem
1850
1851 Run "grml-tips ssl-certificate" if you need further instructions.
1852 '
1853     }
1854 fi
1855 # }}}
1856
1857 # {{{ Use hard limits, except for a smaller stack and no core dumps
1858 unlimit
1859 is4 && limit stack 8192
1860 isgrmlcd && limit core 0 # important for a live-cd-system
1861 limit -s
1862 # }}}
1863
1864 # {{{ completion system
1865
1866 # called later (via is4 && grmlcomp)
1867 # notice: use 'zstyle' for getting current settings
1868 #         press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
1869 grmlcomp() {
1870     # TODO: This could use some additional information
1871
1872     # allow one error for every three characters typed in approximate completer
1873     zstyle ':completion:*:approximate:'    max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
1874
1875     # don't complete backup files as executables
1876     zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
1877
1878     # start menu completion only if it could find no unambiguous initial string
1879     zstyle ':completion:*:correct:*'       insert-unambiguous true
1880     zstyle ':completion:*:corrections'     format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
1881     zstyle ':completion:*:correct:*'       original true
1882
1883     # activate color-completion
1884     zstyle ':completion:*:default'         list-colors ${(s.:.)LS_COLORS}
1885
1886     # format on completion
1887     zstyle ':completion:*:descriptions'    format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
1888
1889     # complete 'cd -<tab>' with menu
1890     zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
1891
1892     # insert all expansions for expand completer
1893     zstyle ':completion:*:expand:*'        tag-order all-expansions
1894     zstyle ':completion:*:history-words'   list false
1895
1896     # activate menu
1897     zstyle ':completion:*:history-words'   menu yes
1898
1899     # ignore duplicate entries
1900     zstyle ':completion:*:history-words'   remove-all-dups yes
1901     zstyle ':completion:*:history-words'   stop yes
1902
1903     # match uppercase from lowercase
1904     zstyle ':completion:*'                 matcher-list 'm:{a-z}={A-Z}'
1905
1906     # separate matches into groups
1907     zstyle ':completion:*:matches'         group 'yes'
1908     zstyle ':completion:*'                 group-name ''
1909
1910     if [[ -z "$NOMENU" ]] ; then
1911         # if there are more than 5 options allow selecting from a menu
1912         zstyle ':completion:*'               menu select=5
1913     else
1914         # don't use any menus at all
1915         setopt no_auto_menu
1916     fi
1917
1918     zstyle ':completion:*:messages'        format '%d'
1919     zstyle ':completion:*:options'         auto-description '%d'
1920
1921     # describe options in full
1922     zstyle ':completion:*:options'         description 'yes'
1923
1924     # on processes completion complete all user processes
1925     zstyle ':completion:*:processes'       command 'ps -au$USER'
1926
1927     # offer indexes before parameters in subscripts
1928     zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
1929
1930     # provide verbose completion information
1931     zstyle ':completion:*'                 verbose true
1932
1933     # recent (as of Dec 2007) zsh versions are able to provide descriptions
1934     # for commands (read: 1st word in the line) that it will list for the user
1935     # to choose from. The following disables that, because it's not exactly fast.
1936     zstyle ':completion:*:-command-:*:'    verbose false
1937
1938     # set format for warnings
1939     zstyle ':completion:*:warnings'        format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
1940
1941     # define files to ignore for zcompile
1942     zstyle ':completion:*:*:zcompile:*'    ignored-patterns '(*~|*.zwc)'
1943     zstyle ':completion:correct:'          prompt 'correct to: %e'
1944
1945     # Ignore completion functions for commands you don't have:
1946     zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
1947
1948     # Provide more processes in completion of programs like killall:
1949     zstyle ':completion:*:processes-names' command 'ps c -u ${USER} -o command | uniq'
1950
1951     # complete manual by their section
1952     zstyle ':completion:*:manuals'    separate-sections true
1953     zstyle ':completion:*:manuals.*'  insert-sections   true
1954     zstyle ':completion:*:man:*'      menu yes select
1955
1956     # run rehash on completion so new installed program are found automatically:
1957     _force_rehash() {
1958         (( CURRENT == 1 )) && rehash
1959         return 1
1960     }
1961
1962     ## correction
1963     # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
1964     if [[ -n "$NOCOR" ]] ; then
1965         zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
1966         setopt nocorrect
1967     else
1968         # try to be smart about when to use what completer...
1969         setopt correct
1970         zstyle -e ':completion:*' completer '
1971             if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
1972                 _last_try="$HISTNO$BUFFER$CURSOR"
1973                 reply=(_complete _match _ignored _prefix _files)
1974             else
1975                 if [[ $words[1] == (rm|mv) ]] ; then
1976                     reply=(_complete _files)
1977                 else
1978                     reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
1979                 fi
1980             fi'
1981     fi
1982
1983     # zstyle ':completion:*' completer _complete _correct _approximate
1984     # zstyle ':completion:*' expand prefix suffix
1985
1986     # complete shell aliases
1987     # zstyle ':completion:*' completer _expand_alias _complete _approximate
1988
1989     # command for process lists, the local web server details and host completion
1990     zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
1991
1992     # caching
1993     [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
1994                             zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
1995
1996     # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
1997     if is42 ; then
1998         [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
1999         [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
2000     else
2001         _ssh_hosts=()
2002         _etc_hosts=()
2003     fi
2004     hosts=(
2005         $(hostname)
2006         "$_ssh_hosts[@]"
2007         "$_etc_hosts[@]"
2008         grml.org
2009         localhost
2010     )
2011     zstyle ':completion:*:hosts' hosts $hosts
2012     #  zstyle '*' hosts $hosts
2013
2014     # specify your logins:
2015     # my_accounts=(
2016     #  {grml,grml1}@foo.invalid
2017     #  grml-devel@bar.invalid
2018     # )
2019     # other_accounts=(
2020     #  {fred,root}@foo.invalid
2021     #  vera@bar.invalid
2022     # )
2023     # zstyle ':completion:*:my-accounts' users-hosts $my_accounts
2024     # zstyle ':completion:*:other-accounts' users-hosts $other_accounts
2025
2026     # specify specific port/service settings:
2027     #  telnet_users_hosts_ports=(
2028     #    user1@host1:
2029     #    user2@host2:
2030     #    @mail-server:{smtp,pop3}
2031     #    @news-server:nntp
2032     #    @proxy-server:8000
2033     #  )
2034     # zstyle ':completion:*:*:telnet:*' users-hosts-ports $telnet_users_hosts_ports
2035
2036     # use generic completion system for programs not yet defined; (_gnu_generic works
2037     # with commands that provide a --help option with "standard" gnu-like output.)
2038     compdef _gnu_generic tail head feh cp mv df stow uname ipacsum fetchipac
2039
2040     # see upgrade function in this file
2041     compdef _hosts upgrade
2042 }
2043 # }}}
2044
2045 # {{{ grmlstuff
2046 grmlstuff() {
2047 # people should use 'grml-x'!
2048     startx() {
2049         if [[ -e /etc/X11/xorg.conf ]] ; then
2050             [[ -x /usr/bin/startx ]] && /usr/bin/startx "$@" || /usr/X11R6/bin/startx "$@"
2051         else
2052             echo "Please use the script \"grml-x\" for starting the X Window System
2053 because there does not exist /etc/X11/xorg.conf yet.
2054 If you want to use startx anyway please call \"/usr/bin/startx\"."
2055             return -1
2056         fi
2057     }
2058
2059     xinit() {
2060         if [[ -e /etc/X11/xorg.conf ]] ; then
2061             [[ -x /usr/bin/xinit ]] && /usr/bin/xinit || /usr/X11R6/bin/xinit
2062         else
2063             echo "Please use the script \"grml-x\" for starting the X Window System.
2064 because there does not exist /etc/X11/xorg.conf yet.
2065 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
2066             return -1
2067         fi
2068     }
2069
2070     if check_com -c 915resolution ; then
2071         alias 855resolution='echo -e "Please use 915resolution as resolution modify tool for Intel graphic chipset."; return -1'
2072     fi
2073
2074     #a1# Output version of running grml
2075     alias grml-version='cat /etc/grml_version'
2076
2077     if check_com -c rebuildfstab ; then
2078         #a1# Rebuild /etc/fstab
2079         alias grml-rebuildfstab='rebuildfstab -v -r -config'
2080     fi
2081
2082     if check_com -c grml-debootstrap ; then
2083         alias debian2hd='print "Installing debian to harddisk is possible via using grml-debootstrap." ; return 1'
2084     fi
2085 }
2086 # }}}
2087
2088 # {{{ now run the functions
2089 isgrml && checkhome
2090 is4    && isgrml    && grmlstuff
2091 is4    && grmlcomp
2092 # }}}
2093
2094 # {{{ keephack
2095 is4 && xsource "/etc/zsh/keephack"
2096 # }}}
2097
2098 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
2099 # You use it as follows:
2100 # $ NTREF=/reference/file
2101 # $ ls -l *(e:nt:)
2102 # This lists all the files in the current directory newer than the reference file.
2103 # You can also specify the reference file inline; note quotes:
2104 # $ ls -l *(e:'nt ~/.zshenv':)
2105 is4 && nt() {
2106     if [[ -n $1 ]] ; then
2107         local NTREF=${~1}
2108     fi
2109     [[ $REPLY -nt $NTREF ]]
2110 }
2111 # }}}
2112
2113 # shell functions {{{
2114
2115 #f1# Provide csh compatibility
2116 setenv()  { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" }  # csh compatibility
2117
2118 #f1# Reload an autoloadable function
2119 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
2120
2121 #f1# Reload zsh setup
2122 reload() {
2123     if [[ "$#*" -eq 0 ]] ; then
2124         [[ -r ~/.zshrc ]] && . ~/.zshrc
2125     else
2126         local fn
2127         for fn in "$@"; do
2128             unfunction $fn
2129             autoload -U $fn
2130         done
2131     fi
2132 }
2133 compdef _functions reload freload
2134
2135 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
2136 sll() {
2137     [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
2138     for i in "$@" ; do
2139         file=$i
2140         while [[ -h "$file" ]] ; do
2141             ls -l $file
2142             file=$(readlink "$file")
2143         done
2144     done
2145 }
2146
2147 # fast manual access
2148 if check_com qma ; then
2149     #f1# View the zsh manual
2150     manzsh()  { qma zshall "$1" }
2151     compdef _man qma
2152 else
2153     manzsh()  { /usr/bin/man zshall |  vim -c "se ft=man| se hlsearch" +/"$1" - ; }
2154     # manzsh()  { /usr/bin/man zshall |  most +/"$1" ; }
2155     # [[ -f ~/.terminfo/m/mostlike ]] && MYLESS='LESS=C TERMINFO=~/.terminfo TERM=mostlike less' || MYLESS='less'
2156     # manzsh()  { man zshall | $MYLESS -p $1 ; }
2157 fi
2158
2159 if check_com -c $PAGER ; then
2160     #f1# View Debian's changelog of a given package
2161     dchange() {
2162         if [[ -r /usr/share/doc/${1}/changelog.Debian.gz ]] ; then
2163             $PAGER /usr/share/doc/${1}/changelog.Debian.gz
2164         elif [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
2165             $PAGER /usr/share/doc/${1}/changelog.gz
2166         else
2167             if check_com -c aptitude ; then
2168                 echo "No changelog for package $1 found, using aptitude to retrieve it."
2169                 if isgrml ; then
2170                     aptitude -t unstable changelog ${1}
2171                 else
2172                     aptitude changelog ${1}
2173                 fi
2174             else
2175                 echo "No changelog for package $1 found, sorry."
2176                 return 1
2177             fi
2178         fi
2179     }
2180     _dchange() { _files -W /usr/share/doc -/ }
2181     compdef _dchange dchange
2182
2183     #f1# View Debian's NEWS of a given package
2184     dnews() {
2185         if [[ -r /usr/share/doc/${1}/NEWS.Debian.gz ]] ; then
2186             $PAGER /usr/share/doc/${1}/NEWS.Debian.gz
2187         else
2188             if [[ -r /usr/share/doc/${1}/NEWS.gz ]] ; then
2189                 $PAGER /usr/share/doc/${1}/NEWS.gz
2190             else
2191                 echo "No NEWS file for package $1 found, sorry."
2192                 return 1
2193             fi
2194         fi
2195     }
2196     _dnews() { _files -W /usr/share/doc -/ }
2197     compdef _dnews dnews
2198
2199     #f1# View upstream's changelog of a given package
2200     uchange() {
2201         if [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
2202             $PAGER /usr/share/doc/${1}/changelog.gz
2203         else
2204             echo "No changelog for package $1 found, sorry."
2205             return 1
2206         fi
2207     }
2208     _uchange() { _files -W /usr/share/doc -/ }
2209     compdef _uchange uchange
2210 fi
2211
2212 # zsh profiling
2213 profile() {
2214     ZSH_PROFILE_RC=1 $SHELL "$@"
2215 }
2216
2217 #f1# Edit an alias via zle
2218 edalias() {
2219     [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
2220 }
2221 compdef _aliases edalias
2222
2223 #f1# Edit a function via zle
2224 edfunc() {
2225     [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
2226 }
2227 compdef _functions edfunc
2228
2229 # use it e.g. via 'Restart apache2'
2230 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
2231 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
2232 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
2233 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
2234 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
2235 if [[ -d /etc/init.d || -d /etc/service ]] ; then
2236     __start_stop() {
2237         local action_="${1:l}"  # e.g Start/Stop/Restart
2238         local service_="$2"
2239         local param_="$3"
2240
2241         local service_target_="$(readlink /etc/init.d/$service_)"
2242         if [[ $service_target_ == "/usr/bin/sv" ]]; then
2243             # runit
2244             case "${action_}" in
2245                 start) if [[ ! -e /etc/service/$service_ ]]; then
2246                            $SUDO ln -s "/etc/sv/$service_" "/etc/service/"
2247                        else
2248                            $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2249                        fi ;;
2250                 # there is no reload in runits sysv emulation
2251                 reload) $SUDO "/etc/init.d/$service_" "force-reload" "$param_" ;;
2252                 *) $SUDO "/etc/init.d/$service_" "${action_}" "$param_" ;;
2253             esac
2254         else
2255             # sysvinit
2256             $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2257         fi
2258     }
2259
2260     for i in Start Restart Stop Force-Reload Reload ; do
2261         eval "$i() { __start_stop $i \"\$1\" \"\$2\" ; }"
2262     done
2263 fi
2264
2265 #f1# Provides useful information on globbing
2266 H-Glob() {
2267     echo -e "
2268     /      directories
2269     .      plain files
2270     @      symbolic links
2271     =      sockets
2272     p      named pipes (FIFOs)
2273     *      executable plain files (0100)
2274     %      device files (character or block special)
2275     %b     block special files
2276     %c     character special files
2277     r      owner-readable files (0400)
2278     w      owner-writable files (0200)
2279     x      owner-executable files (0100)
2280     A      group-readable files (0040)
2281     I      group-writable files (0020)
2282     E      group-executable files (0010)
2283     R      world-readable files (0004)
2284     W      world-writable files (0002)
2285     X      world-executable files (0001)
2286     s      setuid files (04000)
2287     S      setgid files (02000)
2288     t      files with the sticky bit (01000)
2289
2290   print *(m-1)          # Files modified up to a day ago
2291   print *(a1)           # Files accessed a day ago
2292   print *(@)            # Just symlinks
2293   print *(Lk+50)        # Files bigger than 50 kilobytes
2294   print *(Lk-50)        # Files smaller than 50 kilobytes
2295   print **/*.c          # All *.c files recursively starting in \$PWD
2296   print **/*.c~file.c   # Same as above, but excluding 'file.c'
2297   print (foo|bar).*     # Files starting with 'foo' or 'bar'
2298   print *~*.*           # All Files that do not contain a dot
2299   chmod 644 *(.^x)      # make all plain non-executable files publically readable
2300   print -l *(.c|.h)     # Lists *.c and *.h
2301   print **/*(g:users:)  # Recursively match all files that are owned by group 'users'
2302   echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
2303 }
2304 alias help-zshglob=H-Glob
2305
2306 check_com -c qma && alias ?='qma zshall'
2307
2308 # grep for running process, like: 'any vim'
2309 any() {
2310     if [[ -z "$1" ]] ; then
2311         echo "any - grep for process(es) by keyword" >&2
2312         echo "Usage: any <keyword>" >&2 ; return 1
2313     else
2314         local STRING=$1
2315         local LENGTH=$(expr length $STRING)
2316         local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
2317         local REST=$(echo $(expr substr $STRING 2 $LENGTH))
2318         ps xauwww| grep "[$FIRSCHAR]$REST"
2319     fi
2320 }
2321
2322 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
2323 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
2324 [[ -r /proc/1/maps ]] && \
2325 deswap() {
2326     print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
2327     cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/')  > /dev/null
2328     print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
2329 }
2330
2331 # print hex value of a number
2332 hex() {
2333     [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
2334 }
2335
2336 # calculate (or eval at all ;-)) with perl => p[erl-]eval
2337 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
2338 peval() {
2339     [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
2340     perl -e "print eval($CALC),\"\n\";"
2341 }
2342 functions peval &>/dev/null && alias calc=peval
2343
2344 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
2345 # certain circumstances, so work around it, no matter which environment we have
2346 brltty() {
2347     if [[ -z "$DISPLAY" ]] ; then
2348         consolechars -f /usr/share/consolefonts/default8x16.psf.gz
2349         command brltty "$@"
2350     else
2351         command brltty "$@"
2352     fi
2353 }
2354
2355 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
2356 aoeu() {
2357     echo -n 'Switching to us keyboard layout: '
2358     [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
2359     echo 'Done'
2360 }
2361 asdf() {
2362     echo -n 'Switching to dvorak keyboard layout: '
2363     [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
2364     echo 'Done'
2365 }
2366 # just press 'asdf' key to toggle from neon layout to us keyboard layout
2367 uiae() {
2368     echo -n 'Switching to us keyboard layout: '
2369     setxkbmap us && echo 'Done' || echo 'Failed'
2370 }
2371
2372 # set up an ipv6 tunnel
2373 ipv6-tunnel() {
2374     case $1 in
2375         start)
2376             if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2377                 print 'ipv6 tunnel already set up, nothing to be done.'
2378                 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
2379             else
2380                 [[ -n "$PUBLIC_IP" ]] || \
2381                     local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
2382                                       awk '/inet addr:/ {print $2}' | tr -d 'addr:')
2383
2384                 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
2385                 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
2386                 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
2387                 ifconfig sit0 tunnel ::192.88.99.1 up
2388                 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
2389             fi
2390             ;;
2391         status)
2392             if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2393                 print 'ipv6 tunnel available' ; return 0
2394             else
2395                 print 'ipv6 tunnel not available' ; return 1
2396             fi
2397             ;;
2398         stop)
2399             if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2400                 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
2401                 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
2402             else
2403                 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
2404             fi
2405             ;;
2406         *)
2407             print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
2408             ;;
2409     esac
2410 }
2411
2412 # run dhclient for wireless device
2413 iwclient() {
2414     salias dhclient "$(wavemon -d | awk '/device/{print $2}')"
2415 }
2416
2417 # spawn a minimally set up ksh - useful if you want to umount /usr/.
2418 minimal-shell() {
2419     exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ksh
2420 }
2421
2422 # make a backup of a file
2423 bk() {
2424     cp -a "$1" "${1}_$(date --iso-8601=seconds)"
2425 }
2426
2427 # Switching shell safely and efficiently? http://www.zsh.org/mla/workers/2001/msg02410.html
2428 # bash() {
2429 #  NO_SWITCH="yes" command bash "$@"
2430 # }
2431 # restart () {
2432 #  exec $SHELL $SHELL_ARGS "$@"
2433 # }
2434
2435 # }}}
2436
2437 # log out? set timeout in seconds {{{
2438 # TMOUT=1800
2439 # do not log out in some specific terminals:
2440 #  if [[ "${TERM}" == ([Exa]term*|rxvt|dtterm|screen*) ]] ; then
2441 #    unset TMOUT
2442 #  fi
2443 # }}}
2444
2445 # {{{ make sure our environment is clean regarding colors
2446 for color in BLUE RED GREEN CYAN YELLOW MAGENTA WHITE ; unset $color
2447 # }}}
2448
2449 # source another config file if present {{{
2450 xsource "/etc/zsh/zshrc.local"
2451 xsource "${HOME}/.zshenv"
2452 # }}}
2453
2454 # "persistent history" {{{
2455 # just write important commands you always need to ~/.important_commands
2456 if [[ -r ~/.important_commands ]] ; then
2457     fc -R ~/.important_commands
2458 fi
2459 # }}}
2460
2461 ## genrefcard.pl settings {{{
2462 ### example: split functions-search 8,16,24,32
2463 #@# split functions-search 8
2464 ## }}}
2465
2466 # add variable to be able to check whether the file has been read {{{
2467 ZSHRC_GLOBAL_HAS_BEEN_READ=1
2468 # }}}
2469
2470 ## END OF FILE #################################################################
2471 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4