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