zshrc: Introduce 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 # display version control information on right side of prompt if $VCS is set {{{
1014 # based on Mike Hommey's http://web.glandium.org/blog/?p=170
1015 __vcs_dir() {
1016     local vcs base_dir sub_dir ref
1017
1018     sub_dir() {
1019       local sub_dir
1020       sub_dir=$(readlink -f "${PWD}")
1021       sub_dir=${sub_dir#$1}
1022       echo ${sub_dir#/}
1023     }
1024
1025     git_dir() {
1026       base_dir=$(git-rev-parse --show-cdup 2>/dev/null) || return 1
1027       base_dir=$(readlink -f "$base_dir/..")
1028       sub_dir=$(git-rev-parse --show-prefix)
1029       sub_dir=${sub_dir%/}
1030       ref=$(git-symbolic-ref -q HEAD || git-name-rev --name-only HEAD 2>/dev/null)
1031       ref=${ref#refs/heads/}
1032       vcs="git"
1033     }
1034
1035     svn_dir() {
1036       [[ -d ".svn" ]] || return 1
1037       base_dir="."
1038       while [[ -d "$base_dir/../.svn" ]]; do base_dir="$base_dir/.."; done
1039       base_dir=$(readlink -f "$base_dir")
1040       sub_dir=$(sub_dir "${base_dir}")
1041       ref=$(svn info "$base_dir" | awk '/^URL/ { sub(".*/","",$0); r=$0 } /^Revision/ { sub("[^0-9]*","",$0); print r":"$0 }')
1042       vcs="svn"
1043     }
1044
1045     svk_dir() {
1046         [[ -f ~/.svk/config ]] || return 1
1047         base_dir=$(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
1048         ref=${base_dir##*
1049   }
1050         base_dir=${base_dir%%
1051   *}
1052         sub_dir=$(sub_dir "${base_dir}")
1053         vcs="svk"
1054     }
1055
1056     hg_dir() {
1057         base_dir="."
1058         while [[ ! -d "$base_dir/.hg" ]]; do
1059             base_dir="$base_dir/.."
1060             [[ $(readlink -f "${base_dir}") = "/" ]] && return 1
1061         done
1062         base_dir=$(readlink -f "$base_dir")
1063         sub_dir=$(sub_dir "${base_dir}")
1064         ref=$(< "${base_dir}/.hg/branch")
1065         vcs="hg"
1066     }
1067
1068     hg_dir  ||
1069     git_dir ||
1070     svn_dir ||
1071     svk_dir # ||
1072   #  base_dir="$PWD"
1073   #  echo "${vcs:+($vcs)}${base_dir/$HOME/~}${vcs:+[$ref]${sub_dir}}"
1074     echo "${vcs:+($vcs)}${base_dir}${vcs:+[$ref]${sub_dir}}"
1075 }
1076
1077 # gather version control information for inclusion in a prompt
1078
1079 # vcs_info() documentation: {{{
1080 #
1081 # The vcs_info () feature can be configured via zstyle:
1082 #   First, the context in which we are working:
1083 #       :vcs_info:<vcs-string>
1084 #   ...where <vcs-string> is one of: git, hg, bzr, svn or svk
1085 #
1086 #   You can of course use ':vcs_info:*' to match all VCSs at once.
1087 #
1088 # There is one special context named 'init', that is in effect as long
1089 # as there was no decision what vcs backend to use.
1090 #
1091 # There are currently two styles, that are looked up:
1092 #   promptformat        - Used in most circumstances.
1093 #   promptactionformat  - Used if a there is a special action going on;
1094 #                         (like an interactive rebase or a merge conflict)
1095 #   enable              - check in the 'init' context. If set to false,
1096 #                         vcs_info() will do nothing.
1097 #
1098 # The default values for these in all contexts are:
1099 #   promptformat        " (%s)-[%b|%a]-"
1100 #   promptactionformat  " (%s)-[%b]-"
1101 #   enable              true
1102 #
1103 # In these formats, the following replacements are done:
1104 #   %s  - The vcs in use (git, hg, svn etc.)
1105 #   %b  - Information about the current branch.
1106 #   %a  - An identifier, that describes the action.
1107 #         Only makes sense in promptactionformat.
1108 #   %R  - base directory of the repository.
1109 #   %r  - repository name
1110 #         If %R is '/foo/bar/repoXY', %r is 'repoXY'.
1111 #
1112 # Not all vcs backends may support all replacements
1113 #
1114 # If you want colors, make sure you enclose the color codes in %{...%}, because
1115 # the string provided by vcs_info() is commonly used for prompts.
1116 #
1117 #   Example: PROMPT='%(?..[%?]-)%3~%$(vcs_info)#'
1118 #
1119 # This *requires* 'setopt prompt_subst'.
1120 # }}}
1121 VCS_INFO_default_action_format=' (%s)-[%b|%a]-'
1122 VCS_INFO_default_format=' (%s)-[%b]-'
1123 VCS_INFO_realpath () { #{{{
1124     # replacing 'readlink -f', which is really not portable.
1125     (( ${+functions[chpwd]} )) && unfunction chpwd
1126     setopt chaselinks
1127     cd $1 2>/dev/null && pwd
1128 }
1129 # }}}
1130 VCS_INFO_git_getaction () { #{{{
1131     local gitaction='' gitdir=${1}
1132     local tmp
1133
1134     for tmp in "${gitdir}/rebase-apply" \
1135                "${gitdir}/rebase"       \
1136                "${gitdir}/../.dotest" ; do
1137         if [[ -d ${tmp} ]] ; then
1138             if   [[ -f "${tmp}/rebasing" ]] ; then
1139                 gitaction="rebase"
1140             elif [[ -f "${tmp}/applying" ]] ; then
1141                 gitaction="am"
1142             else
1143                 gitaction="am/rebase"
1144             fi
1145             print '%s' ${gitaction}
1146             return 0
1147         fi
1148     done
1149
1150     for tmp in "${gitdir}/rebase-merge/interactive" \
1151                "${gitdir}/.dotest-merge/interactive" ; do
1152         if [[ -f "${tmp}" ]] ; then
1153             printf '%s' "rebase-i"
1154             return 0
1155         fi
1156     done
1157
1158     for tmp in "${gitdir}/rebase-merge" \
1159                "${gitdir}/.dotest-merge" ; do
1160         if [[ -d "${tmp}" ]] ; then
1161             printf '%s' "rebase-m"
1162             return 0
1163         fi
1164     done
1165
1166     if [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1167         printf '%s' "merge"
1168     else
1169         if [[ -f "${gitdir}/BISECT_LOG" ]] ; then
1170             printf '%s' "bisect"
1171         fi
1172     fi
1173
1174     return 1
1175 }
1176 # }}}
1177 VCS_INFO_git_getbranch () { #{{{
1178     local gitbranch gitdir=${1}
1179     local gitsymref='git symbolic-ref HEAD'
1180
1181     if    [[ -d "${gitdir}/rebase-apply" ]] \
1182        || [[ -d "${gitdir}/rebase" ]]       \
1183        || [[ -d "${gitdir}/../.dotest" ]]   \
1184        || [[ -f "${gitdir}/MERGE_HEAD" ]] ; then
1185         gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1186
1187     elif   [[ -f "${gitdir}/rebase-merge/interactive" ]] \
1188         || [[ -d "${gitdir}/rebase-merge" ]] ; then
1189         gitbranch="$(< ${gitdir}/rebase-merge/head-name)"
1190
1191     elif   [[ -f "${gitdir}/.dotest-merge/interactive" ]] \
1192         || [[ -d "${gitdir}/.dotest-merge" ]] ; then
1193         gitbranch="$(< ${gitdir}/.dotest-merge/head-name)"
1194
1195     else
1196         gitbranch="$(${(z)gitsymref} 2> /dev/null)"
1197
1198         if [[ $? -ne 0 ]] ; then
1199             gitbranch="$(git describe --exact-match HEAD 2>/dev/null)"
1200
1201             if [[ $? -ne 0 ]] ; then
1202                 gitbranch="${${"$(< $gitdir/HEAD)"}[1,7]}..."
1203             fi
1204         fi
1205     fi
1206
1207     printf '%s' "${gitbranch##refs/heads/}"
1208 }
1209 # }}}
1210 VCS_INFO_git_get_data () { # {{{
1211     setopt localoptions extendedglob
1212     local gitdir gitbase gitbranch gitaction msg
1213
1214     gitdir="$(git rev-parse --git-dir 2> /dev/null)"
1215
1216     if [[ $? -eq 0 ]] ; then
1217         gitbranch="$(VCS_INFO_git_getbranch ${gitdir})"
1218     fi
1219
1220     if [[ -z ${gitdir} ]] || [[ -z ${gitbranch} ]] ; then
1221         return
1222     fi
1223
1224     gitaction="$(VCS_INFO_git_getaction ${gitdir})"
1225     msg=$(VCS_INFO_format ${gitaction})
1226
1227     gitbase=${PWD%/${$(git rev-parse --show-prefix)%/##}}
1228
1229     zformat -f msg "${msg}" "a:${gitaction}" "b:${gitbranch}" "s:${vcs}" "r:${gitbase:t}" "R:${gitbase}"
1230     printf '%s' ${msg}
1231 }
1232 # }}}
1233 VCS_INFO_hg_get_data () { # {{{
1234     local msg hgbranch hgbase
1235
1236     hgbase=${1}
1237     hgbranch=$(< ${hgbase}/.hg/branch)
1238     msg=$(VCS_INFO_format)
1239     zformat -f msg "${msg}" "a:" "b:${hgbranch}" "s:${vcs}" "r:${hgbase:t}" "R:${hgbase}"
1240     printf '%s' ${msg}
1241 }
1242 # }}}
1243 VCS_INFO_svk_get_data () { # {{{
1244     local msg svkbranch svkbase
1245
1246     svkbase=${1}
1247     svkbranch=${svkbase##*
1248   }
1249     svkbase=${svkbase%%
1250   *}
1251
1252     msg=$(VCS_INFO_format)
1253     zformat -f msg "${msg}" "a:" "b:${svkbranch}" "s:${vcs}" "r:${svkbase:t}" "R:${svkbase}"
1254     printf '%s' ${msg}
1255 }
1256 # }}}
1257 VCS_INFO_svn_get_data () { # {{{
1258     local msg svnbranch svnbase
1259
1260     svnbase="."
1261     while [[ -d "${svnbase}/../.svn" ]]; do
1262         svnbase="${svnbase}/.."
1263     done
1264     svnbase=$(VCS_INFO_realpath ${svnbase})
1265     svnbranch=$(svn info "$base_dir" | awk '/^URL/ { sub(".*/","",$0); r=$0 } /^Revision/ { sub("[^0-9]*","",$0); print r":"$0 }')
1266
1267     msg=$(VCS_INFO_format)
1268     zformat -f msg "${msg}" "a:" "b:${svnbranch}" "s:${vcs}" "r:${svnbase:t}" "R:${svnbase}"
1269     printf '%s' ${msg}
1270 }
1271 # }}}
1272 VCS_INFO_bzr_get_data () { # {{{
1273     local msg bzrbranch bzrbase bzrrevno i j
1274
1275     bzrbase=$(bzr info | sed -rne 's, *branch root: ,,p')
1276     case ${bzrbase} in
1277         .) bzrbase=${PWD} ;;
1278     esac
1279
1280     bzr version-info | while read i j; do
1281         case "${i}" in
1282             revno:)
1283                 bzrrevno=${j} ;;
1284             branch-nick:)
1285                 bzrbranch=${j} ;;
1286         esac
1287     done
1288
1289     msg=$(VCS_INFO_format)
1290     zformat -f msg "${msg}" "a:" "b:${bzrbranch}:${bzrrevno}" "s:${vcs}" "r:${bzrbase:t}" "R:${bzrbase}"
1291     printf '%s' ${msg}
1292 }
1293 # }}}
1294 # VCS_INFO_*_detect () {{{
1295
1296 VCS_INFO_bzr_detect() {
1297     check_com -c bzr || return 1
1298     [[ -d ".bzr" ]] && return 0
1299     return 1
1300 }
1301
1302 VCS_INFO_git_detect() {
1303     check_com -c git && git rev-parse --is-inside-work-tree &> /dev/null && return 0
1304     return 1
1305 }
1306
1307 VCS_INFO_hg_detect() {
1308     local basedir="."
1309
1310     check_com -c hg || return 1
1311     while [[ ! -d ${basedir}/.hg ]]; do
1312         basedir=${basedir}/..
1313         [[ $(VCS_INFO_realpath ${basedir}) = "/" ]] && return 1
1314     done
1315
1316     printf '%s' $(VCS_INFO_realpath ${basedir})
1317     return 0
1318 }
1319
1320 VCS_INFO_svk_detect() {
1321     local output
1322
1323     check_com -c svk || return 1
1324     [[ -f ~/.svk/config ]] || return 1
1325
1326     output=$(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
1327
1328     printf '%s' ${output}
1329     return 0
1330 }
1331
1332 VCS_INFO_svn_detect() {
1333     check_com -c svn || return 1
1334     [[ -d ".svn" ]] && return 0
1335     return 1
1336 }
1337
1338 # }}}
1339 VCS_INFO_format () { # {{{
1340     local msg
1341
1342     if [[ -n ${1} ]] ; then
1343         zstyle -s ":vcs_info:${vcs}" promptactionformat msg
1344         [[ -z ${msg} ]] && msg=${VCS_INFO_default_action_format}
1345     else
1346         zstyle -s ":vcs_info:${vcs}" promptformat msg
1347         [[ -z ${msg} ]] && msg=${VCS_INFO_default_format}
1348     fi
1349     printf '%s' ${msg}
1350 }
1351 # }}}
1352 vcs_info () { # {{{
1353     local string output
1354     local -i found
1355     local -a VCSs
1356     local -x vcs
1357
1358     vcs="init"
1359     zstyle -T ":vcs_info:${vcs}" "enable" || return 0
1360
1361     VCSs=(git hg bzr svn svk)
1362
1363     (( found = 0 ))
1364     for vcs in ${VCSs} ; do
1365         output=$(VCS_INFO_${vcs}_detect) && (( found = 1 )) && break
1366     done
1367
1368     (( found == 0 )) && return 0
1369
1370     string=$(VCS_INFO_${vcs}_get_data ${output}) || return 1
1371     printf '%s' ${string}
1372     return 0
1373 }
1374 # }}}
1375
1376 # change vcs_info formats for the grml prompt
1377 zstyle ':vcs_info:*' promptactionformat \
1378 "%{${fg[magenta]}%}(%{${reset_color}%}%s%{${fg[magenta]}%})%{${fg[yellow]}%}-%{${fg[magenta]}%}[%{${fg[green]}%}%b%{${fg[yellow]}%}|%{${fg[red]}%}%a%{${fg[magenta]}%}]%{${reset_color}%} "
1379 zstyle ':vcs_info:*' promptformat \
1380 "%{${fg[magenta]}%}(%{${reset_color}%}%s%{${fg[magenta]}%})%{${fg[yellow]}%}-%{${fg[magenta]}%}[%{${fg[green]}%}%b%{${fg[magenta]}%}]%{${reset_color}%} "
1381
1382 # }}}
1383
1384 # {{{ set prompt
1385 if zrcautoload promptinit && promptinit 2>/dev/null ; then
1386     promptinit # people should be able to use their favourite prompt
1387 else
1388     print 'Notice: no promptinit available :('
1389 fi
1390
1391
1392 # precmd() => a function which is executed just before each prompt
1393 # use 'NOPRECMD=1' to disable the precmd + preexec commands
1394
1395 # precmd () { setopt promptsubst; [[ -o interactive ]] && jobs -l;
1396
1397 # make sure to use right prompt only when not running a command
1398 is41 && setopt transient_rprompt
1399
1400 is4 && [[ -z $NOPRECMD ]] && precmd () {
1401     [[ -n $NOPRECMD ]] && return 0
1402     # allow manual overwriting of RPROMPT
1403     if [[ -n $RPROMPT ]] ; then
1404         [[ $TERM == screen* ]] && echo -n $'\ekzsh\e\\'
1405         # return 0
1406     fi
1407     # just use DONTSETRPROMPT=1 to be able to overwrite RPROMPT
1408     if [[ -z $DONTSETRPROMPT ]] ; then
1409         if [[ -n $BATTERY ]] ; then
1410             RPROMPT="%(?..:()% ${PERCENT}${SCREENTITLE}"
1411             # RPROMPT="${PERCENT}${SCREENTITLE}"
1412         elif [[ -n $VCS ]] ; then
1413             RPROMPT="%(?..:()% $(__vcs_dir)${SCREENTITLE}"
1414         else
1415             RPROMPT="%(?..:()% ${SCREENTITLE}"
1416             # RPROMPT="${SCREENTITLE}"
1417         fi
1418     fi
1419     # adjust title of xterm
1420     # see http://www.faqs.org/docs/Linux-mini/Xterm-Title.html
1421     case $TERM in
1422         (xterm*|rxvt)
1423             print -Pn "\e]0;%n@%m: %~\a"
1424             ;;
1425     esac
1426 }
1427
1428 # chpwd () => a function which is executed whenever the directory is changed
1429
1430 # preexec() => a function running before every command
1431 is4 && [[ -z $NOPRECMD ]] && \
1432 preexec () {
1433     [[ -n $NOPRECMD ]] && return 0
1434 # set hostname if not running on host with name 'grml'
1435     if [[ -n "$HOSTNAME" ]] && [[ "$HOSTNAME" != $(hostname) ]] ; then
1436        NAME="@$HOSTNAME"
1437     fi
1438 # get the name of the program currently running and hostname of local machine
1439 # set screen window title if running in a screen
1440     if [[ "$TERM" == screen* ]] ; then
1441         # local CMD=${1[(wr)^(*=*|sudo|ssh|-*)]}       # don't use hostname
1442         local CMD="${1[(wr)^(*=*|sudo|ssh|-*)]}$NAME" # use hostname
1443         echo -ne "\ek$CMD\e\\"
1444     fi
1445 # set the screen title to "zsh" when sitting at the command prompt:
1446     if [[ "$TERM" == screen* ]] ; then
1447         SCREENTITLE=$'%{\ekzsh\e\\%}'
1448     else
1449         SCREENTITLE=''
1450     fi
1451 # adjust title of xterm
1452     case $TERM in
1453         (xterm*|rxvt)
1454             print -Pn "\e]0;%n@%m: $1\a"
1455             ;;
1456     esac
1457 }
1458
1459 # set colors
1460 if zrcautoload colors && colors 2>/dev/null ; then
1461     BLUE="%{${fg[blue]}%}"
1462     RED="%{${fg_bold[red]}%}"
1463     GREEN="%{${fg[green]}%}"
1464     CYAN="%{${fg[cyan]}%}"
1465     WHITE="%{${fg[white]}%}"
1466     NO_COLOUR="%{${reset_color}%}"
1467 else
1468     BLUE=$'%{\e[1;34m%}'
1469     RED=$'%{\e[1;31m%}'
1470     GREEN=$'%{\e[1;32m%}'
1471     CYAN=$'%{\e[1;36m%}'
1472     WHITE=$'%{\e[1;37m%}'
1473     NO_COLOUR=$'%{\e[0m%}'
1474 fi
1475
1476 EXITCODE="%(?..%?%1v )"
1477 PS2='`%_> '       # secondary prompt, printed when the shell needs more information to complete a command.
1478 PS3='?# '         # selection prompt used within a select loop.
1479 PS4='+%N:%i:%_> ' # the execution trace prompt (setopt xtrace). default: '+%N:%i>'
1480
1481 # set variable debian_chroot if running in a chroot with /etc/debian_chroot
1482 if [[ -z "$debian_chroot" ]] && [[ -r /etc/debian_chroot ]] ; then
1483     debian_chroot=$(cat /etc/debian_chroot)
1484 fi
1485
1486 # don't use colors on dumb terminals (like emacs):
1487 if [[ "$TERM" == dumb ]] ; then
1488     PROMPT="${EXITCODE}${debian_chroot:+($debian_chroot)}%n@%m %40<...<%B%~%b%<< %# "
1489 else
1490     # only if $GRMLPROMPT is set (e.g. via 'GRMLPROMPT=1 zsh') use the extended prompt
1491     # set variable identifying the chroot you work in (used in the prompt below)
1492     if [[ -n $GRMLPROMPT ]] ; then
1493         PROMPT="${RED}${EXITCODE}${CYAN}[%j running job(s)] ${GREEN}{history#%!} ${RED}%(3L.+.) ${BLUE}%* %D
1494 ${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# "
1495     else
1496         if (( EUID != 0 )); then
1497             PROMPT="${RED}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${BLUE}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
1498         else
1499             PROMPT="${BLUE}${EXITCODE}${WHITE}${debian_chroot:+($debian_chroot)}${RED}%n${NO_COLOUR}@%m %40<...<%B%~%b%<< %# " # primary prompt string
1500         fi
1501     fi
1502 fi
1503
1504 # if we are inside a grml-chroot set a specific prompt theme
1505 if [[ -n "$GRML_CHROOT" ]] ; then
1506     PROMPT="%{$fg[red]%}(CHROOT) %{$fg_bold[red]%}%n%{$fg_no_bold[white]%}@%m %40<...<%B%~%b%<< %\# "
1507 fi
1508 # }}}
1509
1510 # {{{ 'hash' some often used directories
1511 #d# start
1512 hash -d deb=/var/cache/apt/archives
1513 hash -d doc=/usr/share/doc
1514 hash -d linux=/lib/modules/$(command uname -r)/build/
1515 hash -d log=/var/log
1516 hash -d slog=/var/log/syslog
1517 hash -d src=/usr/src
1518 hash -d templ=/usr/share/doc/grml-templates
1519 hash -d tt=/usr/share/doc/texttools-doc
1520 hash -d www=/var/www
1521 #d# end
1522 # }}}
1523
1524 # {{{ some aliases
1525 if [[ $UID -eq 0 ]] ; then
1526     [[ -r /etc/grml/screenrc ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc'
1527 elif [[ -r $HOME/.screenrc ]] ; then
1528     alias screen="/usr/bin/screen -c $HOME/.screenrc"
1529 else
1530     [[ -r /etc/grml/screenrc_grml ]] && alias screen='/usr/bin/screen -c /etc/grml/screenrc_grml'
1531 fi
1532
1533 # do we have GNU ls with color-support?
1534 if ls --help 2>/dev/null | grep -- --color= >/dev/null && [[ "$TERM" != dumb ]] ; then
1535     #a1# execute \kbd{@a@}:\quad ls with colors
1536     alias ls='ls -b -CF --color=auto'
1537     #a1# execute \kbd{@a@}:\quad list all files, with colors
1538     alias la='ls -la --color=auto'
1539     #a1# long colored list, without dotfiles (@a@)
1540     alias ll='ls -l --color=auto'
1541     #a1# long colored list, human readable sizes (@a@)
1542     alias lh='ls -hAl --color=auto'
1543     #a1# List files, append qualifier to filenames \\&\quad(\kbd{/} for directories, \kbd{@} for symlinks ...)
1544     alias l='ls -lF --color=auto'
1545 else
1546     alias ls='ls -b -CF'
1547     alias la='ls -la'
1548     alias ll='ls -l'
1549     alias lh='ls -hAl'
1550     alias l='ls -lF'
1551 fi
1552
1553 alias mdstat='cat /proc/mdstat'
1554 alias ...='cd ../../'
1555
1556 # generate alias named "$KERNELVERSION-reboot" so you can use boot with kexec:
1557 if [[ -x /sbin/kexec ]] && [[ -r /proc/cmdline ]] ; then
1558     alias "$(uname -r)-reboot"="kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)""
1559 fi
1560
1561 alias cp='nocorrect cp'         # no spelling correction on cp
1562 alias mkdir='nocorrect mkdir'   # no spelling correction on mkdir
1563 alias mv='nocorrect mv'         # no spelling correction on mv
1564 alias rm='nocorrect rm'         # no spelling correction on rm
1565
1566 #a1# Execute \kbd{rmdir}
1567 alias rd='rmdir'
1568 #a1# Execute \kbd{rmdir}
1569 alias md='mkdir'
1570
1571 # see http://www.cl.cam.ac.uk/~mgk25/unicode.html#term for details
1572 alias term2iso="echo 'Setting terminal to iso mode' ; print -n '\e%@'"
1573 alias term2utf="echo 'Setting terminal to utf-8 mode'; print -n '\e%G'"
1574
1575 # make sure it is not assigned yet
1576 [[ $(whence -w utf2iso &>/dev/null) == 'utf2iso: alias' ]] && unalias utf2iso
1577
1578 utf2iso() {
1579     if isutfenv ; then
1580         for ENV in $(env | command grep -i '.utf') ; do
1581             eval export "$(echo $ENV | sed 's/UTF-8/iso885915/ ; s/utf8/iso885915/')"
1582         done
1583     fi
1584 }
1585
1586 # make sure it is not assigned yet
1587 [[ $(whence -w iso2utf &>/dev/null) == 'iso2utf: alias' ]] && unalias iso2utf
1588 iso2utf() {
1589     if ! isutfenv ; then
1590         for ENV in $(env | command grep -i '\.iso') ; do
1591             eval export "$(echo $ENV | sed 's/iso.*/UTF-8/ ; s/ISO.*/UTF-8/')"
1592         done
1593     fi
1594 }
1595
1596 # set up software synthesizer via speakup
1597 swspeak() {
1598     aumix -w 90 -v 90 -p 90 -m 90
1599     if ! [[ -r /dev/softsynth ]] ; then
1600         flite -o play -t "Sorry, software synthesizer not available. Did you boot with swspeak bootoption?"
1601         return 1
1602     else
1603         setopt singlelinezle
1604         unsetopt prompt_cr
1605         export PS1="%m%# "
1606         nice -n -20 speechd-up
1607         sleep 2
1608         flite -o play -t "Finished setting up software synthesizer"
1609     fi
1610 }
1611
1612 # I like clean prompt, so provide simple way to get that
1613 check_com 0 || alias 0='return 0'
1614
1615 # for really lazy people like mika:
1616 check_com S &>/dev/null || alias S='screen'
1617 check_com s &>/dev/null || alias s='ssh'
1618
1619 # get top 10 shell commands:
1620 alias top10='print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10'
1621
1622 # truecrypt; use e.g. via 'truec /dev/ice /mnt/ice' or 'truec -i'
1623 if check_com -c truecrypt ; then
1624     if isutfenv ; then
1625         alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077,utf8" '
1626     else
1627         alias truec='truecrypt --mount-options "rw,sync,dirsync,users,uid=1000,gid=users,umask=077" '
1628     fi
1629 fi
1630
1631 #f1# Hints for the use of zsh on grml
1632 zsh-help() {
1633     print "$bg[white]$fg[black]
1634 zsh-help - hints for use of zsh on grml
1635 =======================================$reset_color"
1636
1637     print '
1638 Main configuration of zsh happens in /etc/zsh/zshrc (global)
1639 and /etc/skel/.zshrc which is copied to $HOME/.zshrc once.
1640 The files are part of the package grml-etc-core, if you want to
1641 use them on a non-grml-system just get the tar.gz from
1642 http://deb.grml.org/ or get the files from the mercurial
1643 repository:
1644
1645   http://hg.grml.org/grml-etc-core/raw-file/tip/etc/skel/.zshrc
1646   http://hg.grml.org/grml-etc-core/raw-file/tip/etc/zsh/zshrc
1647
1648 If you want to stay in sync with zsh configuration of grml
1649 run '\''ln -sf /etc/skel/.zshrc $HOME/.zshrc'\'' and configure
1650 your own stuff in $HOME/.zshrc.local. System wide configuration
1651 without touching configuration files of grml can take place
1652 in /etc/zsh/zshrc.local.
1653
1654 If you want to use the configuration of user grml also when
1655 running as user root just run '\''zshskel'\'' which will source
1656 the file /etc/skel/.zshrc.
1657
1658 For information regarding zsh start at http://grml.org/zsh/
1659
1660 Take a look at grml'\''s zsh refcard:
1661 % xpdf =(zcat /usr/share/doc/grml-docs/zsh/grml-zsh-refcard.pdf.gz)
1662
1663 Check out the main zsh refcard:
1664 % '$BROWSER' http://www.bash2zsh.com/zsh_refcard/refcard.pdf
1665
1666 And of course visit the zsh-lovers:
1667 % man zsh-lovers
1668
1669 You can adjust some options through environment variables when
1670 invoking zsh without having to edit configuration files.
1671 Basically meant for bash users who are not used to the power of
1672 the zsh yet. :)
1673
1674   "NOCOR=1    zsh" => deactivate automatic correction
1675   "NOMENU=1   zsh" => do not use menu completion (note: use strg-d for completion instead!)
1676   "NOPRECMD=1 zsh" => disable the precmd + preexec commands (set GNU screen title)
1677   "BATTERY=1  zsh" => activate battery status (via acpi) on right side of prompt'
1678
1679     print "
1680 $bg[white]$fg[black]
1681 Please report wishes + bugs to the grml-team: http://grml.org/bugs/
1682 Enjoy your grml system with the zsh!$reset_color"
1683 }
1684
1685 # debian stuff
1686 if [[ -r /etc/debian_version ]] ; then
1687     #a3# Execute \kbd{apt-cache search}
1688     alias acs='apt-cache search'
1689     #a3# Execute \kbd{apt-cache show}
1690     alias acsh='apt-cache show'
1691     #a3# Execute \kbd{apt-cache policy}
1692     alias acp='apt-cache policy'
1693     #a3# Execute \kbd{apt-get dist-upgrade}
1694     salias adg="apt-get dist-upgrade"
1695     #a3# Execute \kbd{apt-get install}
1696     salias agi="apt-get install"
1697     #a3# Execute \kbd{aptitude install}
1698     salias ati="aptitude install"
1699     #a3# Execute \kbd{apt-get upgrade}
1700     salias ag="apt-get upgrade"
1701     #a3# Execute \kbd{apt-get update}
1702     salias au="apt-get update"
1703     #a3# Execute \kbd{aptitude update ; aptitude safe-upgrade}
1704     salias -a up="aptitude update ; aptitude safe-upgrade"
1705     #a3# Execute \kbd{dpkg-buildpackage}
1706     alias dbp='dpkg-buildpackage'
1707     #a3# Execute \kbd{grep-excuses}
1708     alias ge='grep-excuses'
1709
1710     # debian upgrade
1711     #f3# Execute \kbd{apt-get update \&\& }\\&\quad \kbd{apt-get dist-upgrade}
1712     upgrade() {
1713         if [[ -z "$1" ]] ; then
1714             $SUDO apt-get update
1715             $SUDO apt-get -u upgrade
1716         else
1717             ssh $1 $SUDO apt-get update
1718             # ask before the upgrade
1719             local dummy
1720             ssh $1 $SUDO apt-get --no-act upgrade
1721             echo -n 'Process the upgrade?'
1722             read -q dummy
1723             if [[ $dummy == "y" ]] ; then
1724                 ssh $1 $SUDO apt-get -u upgrade --yes
1725             fi
1726         fi
1727     }
1728
1729     # get a root shell as normal user in live-cd mode:
1730     if isgrmlcd && [[ $UID -ne 0 ]] ; then
1731        alias su="sudo su"
1732      fi
1733
1734     #a1# Take a look at the syslog: \kbd{\$PAGER /var/log/syslog}
1735     alias llog="$PAGER /var/log/syslog"     # take a look at the syslog
1736     #a1# Take a look at the syslog: \kbd{tail -f /var/log/syslog}
1737     alias tlog="tail -f /var/log/syslog"    # follow the syslog
1738     #a1# (Re)-source \kbd{/etc/skel/.zshrc}
1739     alias zshskel="source /etc/skel/.zshrc" # source skeleton zshrc
1740 fi
1741
1742 # sort installed Debian-packages by size
1743 if check_com -c grep-status ; then
1744     #a3# List installed Debian-packages sorted by size
1745     alias debs-by-size='grep-status -FStatus -sInstalled-Size,Package -n "install ok installed" | paste -sd "  \n" | sort -rn'
1746 fi
1747
1748 # if cdrecord is a symlink (to wodim) or isn't present at all warn:
1749 if [[ -L /usr/bin/cdrecord ]] || ! check_com -c cdrecord ; then
1750     if check_com -c wodim ; then
1751         alias cdrecord="echo 'cdrecord is not provided under its original name by Debian anymore.
1752 See #377109 in the BTS of Debian for more details.
1753
1754 Please use the wodim binary instead' ; return 1"
1755     fi
1756 fi
1757
1758 # get_tw_cli has been renamed into get_3ware
1759 if check_com -c get_3ware ; then
1760     get_tw_cli() {
1761         echo 'Warning: get_tw_cli has been renamed into get_3ware. Invoking get_3ware for you.'>&2
1762         get_3ware
1763     }
1764 fi
1765
1766 # I hate lacking backward compatibility, so provide an alternative therefore
1767 if ! check_com -c apache2-ssl-certificate ; then
1768
1769     apache2-ssl-certificate() {
1770
1771     print 'Debian does not ship apache2-ssl-certificate anymore (see #398520). :('
1772     print 'You might want to take a look at Debian the package ssl-cert as well.'
1773     print 'To generate a certificate for use with apache2 follow the instructions:'
1774
1775     echo '
1776
1777 export RANDFILE=/dev/random
1778 mkdir /etc/apache2/ssl/
1779 openssl req $@ -new -x509 -days 365 -nodes -out /etc/apache2/ssl/apache.pem -keyout /etc/apache2/ssl/apache.pem
1780 chmod 600 /etc/apache2/ssl/apache.pem
1781
1782 Run "grml-tips ssl-certificate" if you need further instructions.
1783 '
1784     }
1785 fi
1786 # }}}
1787
1788 # {{{ Use hard limits, except for a smaller stack and no core dumps
1789 unlimit
1790 is4 && limit stack 8192
1791 isgrmlcd && limit core 0 # important for a live-cd-system
1792 limit -s
1793 # }}}
1794
1795 # {{{ completion system
1796
1797 # called later (via is4 && grmlcomp)
1798 # notice: use 'zstyle' for getting current settings
1799 #         press ^Xh (control-x h) for getting tags in context; ^X? (control-x ?) to run complete_debug with trace output
1800 grmlcomp() {
1801     # TODO: This could use some additional information
1802
1803     # allow one error for every three characters typed in approximate completer
1804     zstyle ':completion:*:approximate:'    max-errors 'reply=( $((($#PREFIX+$#SUFFIX)/3 )) numeric )'
1805
1806     # don't complete backup files as executables
1807     zstyle ':completion:*:complete:-command-::commands' ignored-patterns '(aptitude-*|*\~)'
1808
1809     # start menu completion only if it could find no unambiguous initial string
1810     zstyle ':completion:*:correct:*'       insert-unambiguous true
1811     zstyle ':completion:*:corrections'     format $'%{\e[0;31m%}%d (errors: %e)%{\e[0m%}'
1812     zstyle ':completion:*:correct:*'       original true
1813
1814     # activate color-completion
1815     zstyle ':completion:*:default'         list-colors ${(s.:.)LS_COLORS}
1816
1817     # format on completion
1818     zstyle ':completion:*:descriptions'    format $'%{\e[0;31m%}completing %B%d%b%{\e[0m%}'
1819
1820     # complete 'cd -<tab>' with menu
1821     zstyle ':completion:*:*:cd:*:directory-stack' menu yes select
1822
1823     # insert all expansions for expand completer
1824     zstyle ':completion:*:expand:*'        tag-order all-expansions
1825     zstyle ':completion:*:history-words'   list false
1826
1827     # activate menu
1828     zstyle ':completion:*:history-words'   menu yes
1829
1830     # ignore duplicate entries
1831     zstyle ':completion:*:history-words'   remove-all-dups yes
1832     zstyle ':completion:*:history-words'   stop yes
1833
1834     # match uppercase from lowercase
1835     zstyle ':completion:*'                 matcher-list 'm:{a-z}={A-Z}'
1836
1837     # separate matches into groups
1838     zstyle ':completion:*:matches'         group 'yes'
1839     zstyle ':completion:*'                 group-name ''
1840
1841     if [[ -z "$NOMENU" ]] ; then
1842         # if there are more than 5 options allow selecting from a menu
1843         zstyle ':completion:*'               menu select=5
1844     else
1845         # don't use any menus at all
1846         setopt no_auto_menu
1847     fi
1848
1849     zstyle ':completion:*:messages'        format '%d'
1850     zstyle ':completion:*:options'         auto-description '%d'
1851
1852     # describe options in full
1853     zstyle ':completion:*:options'         description 'yes'
1854
1855     # on processes completion complete all user processes
1856     zstyle ':completion:*:processes'       command 'ps -au$USER'
1857
1858     # offer indexes before parameters in subscripts
1859     zstyle ':completion:*:*:-subscript-:*' tag-order indexes parameters
1860
1861     # provide verbose completion information
1862     zstyle ':completion:*'                 verbose true
1863
1864     # recent (as of Dec 2007) zsh versions are able to provide descriptions
1865     # for commands (read: 1st word in the line) that it will list for the user
1866     # to choose from. The following disables that, because it's not exactly fast.
1867     zstyle ':completion:*:-command-:*:'    verbose false
1868
1869     # set format for warnings
1870     zstyle ':completion:*:warnings'        format $'%{\e[0;31m%}No matches for:%{\e[0m%} %d'
1871
1872     # define files to ignore for zcompile
1873     zstyle ':completion:*:*:zcompile:*'    ignored-patterns '(*~|*.zwc)'
1874     zstyle ':completion:correct:'          prompt 'correct to: %e'
1875
1876     # Ignore completion functions for commands you don't have:
1877     zstyle ':completion::(^approximate*):*:functions' ignored-patterns '_*'
1878
1879     # Provide more processes in completion of programs like killall:
1880     zstyle ':completion:*:processes-names' command 'ps c -u ${USER} -o command | uniq'
1881
1882     # complete manual by their section
1883     zstyle ':completion:*:manuals'    separate-sections true
1884     zstyle ':completion:*:manuals.*'  insert-sections   true
1885     zstyle ':completion:*:man:*'      menu yes select
1886
1887     # run rehash on completion so new installed program are found automatically:
1888     _force_rehash() {
1889         (( CURRENT == 1 )) && rehash
1890         return 1
1891     }
1892
1893     ## correction
1894     # some people don't like the automatic correction - so run 'NOCOR=1 zsh' to deactivate it
1895     if [[ -n "$NOCOR" ]] ; then
1896         zstyle ':completion:*' completer _oldlist _expand _force_rehash _complete _files _ignored
1897         setopt nocorrect
1898     else
1899         # try to be smart about when to use what completer...
1900         setopt correct
1901         zstyle -e ':completion:*' completer '
1902             if [[ $_last_try != "$HISTNO$BUFFER$CURSOR" ]] ; then
1903                 _last_try="$HISTNO$BUFFER$CURSOR"
1904                 reply=(_complete _match _ignored _prefix _files)
1905             else
1906                 if [[ $words[1] == (rm|mv) ]] ; then
1907                     reply=(_complete _files)
1908                 else
1909                     reply=(_oldlist _expand _force_rehash _complete _ignored _correct _approximate _files)
1910                 fi
1911             fi'
1912     fi
1913
1914     # zstyle ':completion:*' completer _complete _correct _approximate
1915     # zstyle ':completion:*' expand prefix suffix
1916
1917     # complete shell aliases
1918     # zstyle ':completion:*' completer _expand_alias _complete _approximate
1919
1920     # command for process lists, the local web server details and host completion
1921     zstyle ':completion:*:urls' local 'www' '/var/www/' 'public_html'
1922
1923     # caching
1924     [[ -d $ZSHDIR/cache ]] && zstyle ':completion:*' use-cache yes && \
1925                             zstyle ':completion::complete:*' cache-path $ZSHDIR/cache/
1926
1927     # host completion /* add brackets as vim can't parse zsh's complex cmdlines 8-) {{{ */
1928     if is42 ; then
1929         [[ -r ~/.ssh/known_hosts ]] && _ssh_hosts=(${${${${(f)"$(<$HOME/.ssh/known_hosts)"}:#[\|]*}%%\ *}%%,*}) || _ssh_hosts=()
1930         [[ -r /etc/hosts ]] && : ${(A)_etc_hosts:=${(s: :)${(ps:\t:)${${(f)~~"$(</etc/hosts)"}%%\#*}##[:blank:]#[^[:blank:]]#}}} || _etc_hosts=()
1931     else
1932         _ssh_hosts=()
1933         _etc_hosts=()
1934     fi
1935     hosts=(
1936         $(hostname)
1937         "$_ssh_hosts[@]"
1938         "$_etc_hosts[@]"
1939         grml.org
1940         localhost
1941     )
1942     zstyle ':completion:*:hosts' hosts $hosts
1943     #  zstyle '*' hosts $hosts
1944
1945     # specify your logins:
1946     # my_accounts=(
1947     #  {grml,grml1}@foo.invalid
1948     #  grml-devel@bar.invalid
1949     # )
1950     # other_accounts=(
1951     #  {fred,root}@foo.invalid
1952     #  vera@bar.invalid
1953     # )
1954     # zstyle ':completion:*:my-accounts' users-hosts $my_accounts
1955     # zstyle ':completion:*:other-accounts' users-hosts $other_accounts
1956
1957     # specify specific port/service settings:
1958     #  telnet_users_hosts_ports=(
1959     #    user1@host1:
1960     #    user2@host2:
1961     #    @mail-server:{smtp,pop3}
1962     #    @news-server:nntp
1963     #    @proxy-server:8000
1964     #  )
1965     # zstyle ':completion:*:*:telnet:*' users-hosts-ports $telnet_users_hosts_ports
1966
1967     # use generic completion system for programs not yet defined; (_gnu_generic works
1968     # with commands that provide a --help option with "standard" gnu-like output.)
1969     compdef _gnu_generic tail head feh cp mv df stow uname ipacsum fetchipac
1970
1971     # see upgrade function in this file
1972     compdef _hosts upgrade
1973 }
1974 # }}}
1975
1976 # {{{ grmlstuff
1977 grmlstuff() {
1978 # people should use 'grml-x'!
1979     startx() {
1980         if [[ -e /etc/X11/xorg.conf ]] ; then
1981             [[ -x /usr/bin/startx ]] && /usr/bin/startx "$@" || /usr/X11R6/bin/startx "$@"
1982         else
1983             echo "Please use the script \"grml-x\" for starting the X Window System
1984 because there does not exist /etc/X11/xorg.conf yet.
1985 If you want to use startx anyway please call \"/usr/bin/startx\"."
1986             return -1
1987         fi
1988     }
1989
1990     xinit() {
1991         if [[ -e /etc/X11/xorg.conf ]] ; then
1992             [[ -x /usr/bin/xinit ]] && /usr/bin/xinit || /usr/X11R6/bin/xinit
1993         else
1994             echo "Please use the script \"grml-x\" for starting the X Window System.
1995 because there does not exist /etc/X11/xorg.conf yet.
1996 If you want to use xinit anyway please call \"/usr/bin/xinit\"."
1997             return -1
1998         fi
1999     }
2000
2001     if check_com -c 915resolution ; then
2002         alias 855resolution='echo -e "Please use 915resolution as resolution modify tool for Intel graphic chipset."; return -1'
2003     fi
2004
2005     #a1# Output version of running grml
2006     alias grml-version='cat /etc/grml_version'
2007
2008     if check_com -c rebuildfstab ; then
2009         #a1# Rebuild /etc/fstab
2010         alias grml-rebuildfstab='rebuildfstab -v -r -config'
2011     fi
2012
2013     if check_com -c grml-debootstrap ; then
2014         alias debian2hd='print "Installing debian to harddisk is possible via using grml-debootstrap." ; return 1'
2015     fi
2016 }
2017 # }}}
2018
2019 # {{{ now run the functions
2020 isgrml && checkhome
2021 is4    && isgrml    && grmlstuff
2022 is4    && grmlcomp
2023 # }}}
2024
2025 # {{{ keephack
2026 is4 && xsource "/etc/zsh/keephack"
2027 # }}}
2028
2029 # {{{ wonderful idea of using "e" glob qualifier by Peter Stephenson
2030 # You use it as follows:
2031 # $ NTREF=/reference/file
2032 # $ ls -l *(e:nt:)
2033 # This lists all the files in the current directory newer than the reference file.
2034 # You can also specify the reference file inline; note quotes:
2035 # $ ls -l *(e:'nt ~/.zshenv':)
2036 is4 && nt() {
2037     if [[ -n $1 ]] ; then
2038         local NTREF=${~1}
2039     fi
2040     [[ $REPLY -nt $NTREF ]]
2041 }
2042 # }}}
2043
2044 # shell functions {{{
2045
2046 #f1# Provide csh compatibility
2047 setenv()  { typeset -x "${1}${1:+=}${(@)argv[2,$#]}" }  # csh compatibility
2048
2049 #f1# Reload an autoloadable function
2050 freload() { while (( $# )); do; unfunction $1; autoload -U $1; shift; done }
2051
2052 #f1# Reload zsh setup
2053 reload() {
2054     if [[ "$#*" -eq 0 ]] ; then
2055         [[ -r ~/.zshrc ]] && . ~/.zshrc
2056     else
2057         local fn
2058         for fn in "$@"; do
2059             unfunction $fn
2060             autoload -U $fn
2061         done
2062     fi
2063 }
2064 compdef _functions reload freload
2065
2066 #f1# List symlinks in detail (more detailed version of 'readlink -f' and 'whence -s')
2067 sll() {
2068     [[ -z "$1" ]] && printf 'Usage: %s <file(s)>\n' "$0" && return 1
2069     for i in "$@" ; do
2070         file=$i
2071         while [[ -h "$file" ]] ; do
2072             ls -l $file
2073             file=$(readlink "$file")
2074         done
2075     done
2076 }
2077
2078 # fast manual access
2079 if check_com qma ; then
2080     #f1# View the zsh manual
2081     manzsh()  { qma zshall "$1" }
2082     compdef _man qma
2083 else
2084     manzsh()  { /usr/bin/man zshall |  vim -c "se ft=man| se hlsearch" +/"$1" - ; }
2085     # manzsh()  { /usr/bin/man zshall |  most +/"$1" ; }
2086     # [[ -f ~/.terminfo/m/mostlike ]] && MYLESS='LESS=C TERMINFO=~/.terminfo TERM=mostlike less' || MYLESS='less'
2087     # manzsh()  { man zshall | $MYLESS -p $1 ; }
2088 fi
2089
2090 if check_com -c $PAGER ; then
2091     #f1# View Debian's changelog of a given package
2092     dchange() {
2093         if [[ -r /usr/share/doc/${1}/changelog.Debian.gz ]] ; then
2094             $PAGER /usr/share/doc/${1}/changelog.Debian.gz
2095         elif [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
2096             $PAGER /usr/share/doc/${1}/changelog.gz
2097         else
2098             if check_com -c aptitude ; then
2099                 echo "No changelog for package $1 found, using aptitude to retrieve it."
2100                 if isgrml ; then
2101                     aptitude -t unstable changelog ${1}
2102                 else
2103                     aptitude changelog ${1}
2104                 fi
2105             else
2106                 echo "No changelog for package $1 found, sorry."
2107                 return 1
2108             fi
2109         fi
2110     }
2111     _dchange() { _files -W /usr/share/doc -/ }
2112     compdef _dchange dchange
2113
2114     #f1# View Debian's NEWS of a given package
2115     dnews() {
2116         if [[ -r /usr/share/doc/${1}/NEWS.Debian.gz ]] ; then
2117             $PAGER /usr/share/doc/${1}/NEWS.Debian.gz
2118         else
2119             if [[ -r /usr/share/doc/${1}/NEWS.gz ]] ; then
2120                 $PAGER /usr/share/doc/${1}/NEWS.gz
2121             else
2122                 echo "No NEWS file for package $1 found, sorry."
2123                 return 1
2124             fi
2125         fi
2126     }
2127     _dnews() { _files -W /usr/share/doc -/ }
2128     compdef _dnews dnews
2129
2130     #f1# View upstream's changelog of a given package
2131     uchange() {
2132         if [[ -r /usr/share/doc/${1}/changelog.gz ]] ; then
2133             $PAGER /usr/share/doc/${1}/changelog.gz
2134         else
2135             echo "No changelog for package $1 found, sorry."
2136             return 1
2137         fi
2138     }
2139     _uchange() { _files -W /usr/share/doc -/ }
2140     compdef _uchange uchange
2141 fi
2142
2143 # zsh profiling
2144 profile() {
2145     ZSH_PROFILE_RC=1 $SHELL "$@"
2146 }
2147
2148 #f1# Edit an alias via zle
2149 edalias() {
2150     [[ -z "$1" ]] && { echo "Usage: edalias <alias_to_edit>" ; return 1 } || vared aliases'[$1]' ;
2151 }
2152 compdef _aliases edalias
2153
2154 #f1# Edit a function via zle
2155 edfunc() {
2156     [[ -z "$1" ]] && { echo "Usage: edfun <function_to_edit>" ; return 1 } || zed -f "$1" ;
2157 }
2158 compdef _functions edfunc
2159
2160 # use it e.g. via 'Restart apache2'
2161 #m# f6 Start() \kbd{/etc/init.d/\em{process}}\quad\kbd{start}
2162 #m# f6 Restart() \kbd{/etc/init.d/\em{process}}\quad\kbd{restart}
2163 #m# f6 Stop() \kbd{/etc/init.d/\em{process}}\quad\kbd{stop}
2164 #m# f6 Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{reload}
2165 #m# f6 Force-Reload() \kbd{/etc/init.d/\em{process}}\quad\kbd{force-reload}
2166 if [[ -d /etc/init.d || -d /etc/service ]] ; then
2167     __start_stop() {
2168         local action_="${1:l}"  # e.g Start/Stop/Restart
2169         local service_="$2"
2170         local param_="$3"
2171
2172         local service_target_="$(readlink /etc/init.d/$service_)"
2173         if [[ $service_target_ == "/usr/bin/sv" ]]; then
2174             # runit
2175             case "${action_}" in
2176                 start) if [[ ! -e /etc/service/$service_ ]]; then
2177                            $SUDO ln -s "/etc/sv/$service_" "/etc/service/"
2178                        else
2179                            $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2180                        fi ;;
2181                 # there is no reload in runits sysv emulation
2182                 reload) $SUDO "/etc/init.d/$service_" "force-reload" "$param_" ;;
2183                 *) $SUDO "/etc/init.d/$service_" "${action_}" "$param_" ;;
2184             esac
2185         else
2186             # sysvinit
2187             $SUDO "/etc/init.d/$service_" "${action_}" "$param_"
2188         fi
2189     }
2190
2191     for i in Start Restart Stop Force-Reload Reload ; do
2192         eval "$i() { __start_stop $i \"\$1\" \"\$2\" ; }"
2193     done
2194 fi
2195
2196 #f1# Provides useful information on globbing
2197 H-Glob() {
2198     echo -e "
2199     /      directories
2200     .      plain files
2201     @      symbolic links
2202     =      sockets
2203     p      named pipes (FIFOs)
2204     *      executable plain files (0100)
2205     %      device files (character or block special)
2206     %b     block special files
2207     %c     character special files
2208     r      owner-readable files (0400)
2209     w      owner-writable files (0200)
2210     x      owner-executable files (0100)
2211     A      group-readable files (0040)
2212     I      group-writable files (0020)
2213     E      group-executable files (0010)
2214     R      world-readable files (0004)
2215     W      world-writable files (0002)
2216     X      world-executable files (0001)
2217     s      setuid files (04000)
2218     S      setgid files (02000)
2219     t      files with the sticky bit (01000)
2220
2221   print *(m-1)          # Files modified up to a day ago
2222   print *(a1)           # Files accessed a day ago
2223   print *(@)            # Just symlinks
2224   print *(Lk+50)        # Files bigger than 50 kilobytes
2225   print *(Lk-50)        # Files smaller than 50 kilobytes
2226   print **/*.c          # All *.c files recursively starting in \$PWD
2227   print **/*.c~file.c   # Same as above, but excluding 'file.c'
2228   print (foo|bar).*     # Files starting with 'foo' or 'bar'
2229   print *~*.*           # All Files that do not contain a dot
2230   chmod 644 *(.^x)      # make all plain non-executable files publically readable
2231   print -l *(.c|.h)     # Lists *.c and *.h
2232   print **/*(g:users:)  # Recursively match all files that are owned by group 'users'
2233   echo /proc/*/cwd(:h:t:s/self//) # Analogous to >ps ax | awk '{print $1}'<"
2234 }
2235 alias help-zshglob=H-Glob
2236
2237 check_com -c qma && alias ?='qma zshall'
2238
2239 # grep for running process, like: 'any vim'
2240 any() {
2241     if [[ -z "$1" ]] ; then
2242         echo "any - grep for process(es) by keyword" >&2
2243         echo "Usage: any <keyword>" >&2 ; return 1
2244     else
2245         local STRING=$1
2246         local LENGTH=$(expr length $STRING)
2247         local FIRSCHAR=$(echo $(expr substr $STRING 1 1))
2248         local REST=$(echo $(expr substr $STRING 2 $LENGTH))
2249         ps xauwww| grep "[$FIRSCHAR]$REST"
2250     fi
2251 }
2252
2253 # After resuming from suspend, system is paging heavily, leading to very bad interactivity.
2254 # taken from $LINUX-KERNELSOURCE/Documentation/power/swsusp.txt
2255 [[ -r /proc/1/maps ]] && \
2256 deswap() {
2257     print 'Reading /proc/[0-9]*/maps and sending output to /dev/null, this might take a while.'
2258     cat $(sed -ne 's:.* /:/:p' /proc/[0-9]*/maps | sort -u | grep -v '^/dev/')  > /dev/null
2259     print 'Finished, running "swapoff -a; swapon -a" may also be useful.'
2260 }
2261
2262 # print hex value of a number
2263 hex() {
2264     [[ -n "$1" ]] && printf "%x\n" $1 || { print 'Usage: hex <number-to-convert>' ; return 1 }
2265 }
2266
2267 # calculate (or eval at all ;-)) with perl => p[erl-]eval
2268 # hint: also take a look at zcalc -> 'autoload zcalc' -> 'man zshmodules | less -p MATHFUNC'
2269 peval() {
2270     [[ -n "$1" ]] && CALC="$*" || print "Usage: calc [expression]"
2271     perl -e "print eval($CALC),\"\n\";"
2272 }
2273 functions peval &>/dev/null && alias calc=peval
2274
2275 # brltty seems to have problems with utf8 environment and/or font Uni3-Terminus16 under
2276 # certain circumstances, so work around it, no matter which environment we have
2277 brltty() {
2278     if [[ -z "$DISPLAY" ]] ; then
2279         consolechars -f /usr/share/consolefonts/default8x16.psf.gz
2280         command brltty "$@"
2281     else
2282         command brltty "$@"
2283     fi
2284 }
2285
2286 # just press 'asdf' keys to toggle between dvorak and us keyboard layout
2287 aoeu() {
2288     echo -n 'Switching to us keyboard layout: '
2289     [[ -z "$DISPLAY" ]] && $SUDO loadkeys us &>/dev/null || setxkbmap us &>/dev/null
2290     echo 'Done'
2291 }
2292 asdf() {
2293     echo -n 'Switching to dvorak keyboard layout: '
2294     [[ -z "$DISPLAY" ]] && $SUDO loadkeys dvorak &>/dev/null || setxkbmap dvorak &>/dev/null
2295     echo 'Done'
2296 }
2297 # just press 'asdf' key to toggle from neon layout to us keyboard layout
2298 uiae() {
2299     echo -n 'Switching to us keyboard layout: '
2300     setxkbmap us && echo 'Done' || echo 'Failed'
2301 }
2302
2303 # set up an ipv6 tunnel
2304 ipv6-tunnel() {
2305     case $1 in
2306         start)
2307             if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2308                 print 'ipv6 tunnel already set up, nothing to be done.'
2309                 print 'execute: "ifconfig sit1 down ; ifconfig sit0 down" to remove ipv6-tunnel.' ; return 1
2310             else
2311                 [[ -n "$PUBLIC_IP" ]] || \
2312                     local PUBLIC_IP=$(ifconfig $(route -n | awk '/^0\.0\.0\.0/{print $8; exit}') | \
2313                                       awk '/inet addr:/ {print $2}' | tr -d 'addr:')
2314
2315                 [[ -n "$PUBLIC_IP" ]] || { print 'No $PUBLIC_IP set and could not determine default one.' ; return 1 }
2316                 local IPV6ADDR=$(printf "2002:%02x%02x:%02x%02x:1::1" $(print ${PUBLIC_IP//./ }))
2317                 print -n "Setting up ipv6 tunnel $IPV6ADDR via ${PUBLIC_IP}: "
2318                 ifconfig sit0 tunnel ::192.88.99.1 up
2319                 ifconfig sit1 add "$IPV6ADDR" && print done || print failed
2320             fi
2321             ;;
2322         status)
2323             if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2324                 print 'ipv6 tunnel available' ; return 0
2325             else
2326                 print 'ipv6 tunnel not available' ; return 1
2327             fi
2328             ;;
2329         stop)
2330             if ifconfig sit1 2>/dev/null | grep -q 'inet6 addr: 2002:.*:1::1' ; then
2331                 print -n 'Stopping ipv6 tunnel (sit0 + sit1): '
2332                 ifconfig sit1 down ; ifconfig sit0 down && print done || print failed
2333             else
2334                 print 'No ipv6 tunnel found, nothing to be done.' ; return 1
2335             fi
2336             ;;
2337         *)
2338             print "Usage: ipv6-tunnel [start|stop|status]">&2 ; return 1
2339             ;;
2340     esac
2341 }
2342
2343 # run dhclient for wireless device
2344 iwclient() {
2345     salias dhclient "$(wavemon -d | awk '/device/{print $2}')"
2346 }
2347
2348 # spawn a minimally set up ksh - useful if you want to umount /usr/.
2349 minimal-shell() {
2350     exec env -i ENV="/etc/minimal-shellrc" HOME="$HOME" TERM="$TERM" ksh
2351 }
2352
2353 # make a backup of a file
2354 bk() {
2355     cp -a "$1" "${1}_$(date --iso-8601=seconds)"
2356 }
2357
2358 # Switching shell safely and efficiently? http://www.zsh.org/mla/workers/2001/msg02410.html
2359 # bash() {
2360 #  NO_SWITCH="yes" command bash "$@"
2361 # }
2362 # restart () {
2363 #  exec $SHELL $SHELL_ARGS "$@"
2364 # }
2365
2366 # }}}
2367
2368 # log out? set timeout in seconds {{{
2369 # TMOUT=1800
2370 # do not log out in some specific terminals:
2371 #  if [[ "${TERM}" == ([Exa]term*|rxvt|dtterm|screen*) ]] ; then
2372 #    unset TMOUT
2373 #  fi
2374 # }}}
2375
2376 # {{{ make sure our environment is clean regarding colors
2377 for color in BLUE RED GREEN CYAN WHITE ; unset $color
2378 # }}}
2379
2380 # source another config file if present {{{
2381 xsource "/etc/zsh/zshrc.local"
2382 xsource "${HOME}/.zshenv"
2383 # }}}
2384
2385 # "persistent history" {{{
2386 # just write important commands you always need to ~/.important_commands
2387 if [[ -r ~/.important_commands ]] ; then
2388     fc -R ~/.important_commands
2389 fi
2390 # }}}
2391
2392 ## genrefcard.pl settings {{{
2393 ### example: split functions-search 8,16,24,32
2394 #@# split functions-search 8
2395 ## }}}
2396
2397 # add variable to be able to check whether the file has been read {{{
2398 ZSHRC_GLOBAL_HAS_BEEN_READ=1
2399 # }}}
2400
2401 ## END OF FILE #################################################################
2402 # vim:filetype=zsh foldmethod=marker autoindent expandtab shiftwidth=4