zshrc: update function git-get-plaindiff()
[grml-etc-core.git] / etc / skel / .zshrc
index e722f76..3d008a1 100644 (file)
@@ -3,7 +3,7 @@
 # Authors:       grml-team (grml.org), (c) Michael Prokop <mika@grml.org>
 # Bug-Reports:   see http://grml.org/bugs/
 # License:       This file is licensed under the GPL v2.
-# Latest change: Son Dez 09 22:58:07 CET 2007 [mika]
+# Latest Change: Sat Jan 26 11:55:04 CET 2008
 ################################################################################
 
 # source ~/.zshrc.global {{{
@@ -24,6 +24,9 @@
 if [[ -z "$ZSHRC_GLOBAL_HAS_BEEN_READ" ]] ; then
     print 'Warning: global zsh config has not been read.' >&2
     print '         prepare for possible errors!'         >&2
+    print '' >&2
+    print 'See our refcard for info on how to get the complete configuration:' >&2
+    print '    <http://grml.org/zsh/grml-zsh-refcard.pdf>' >&2
 fi
 # }}}
 
@@ -35,6 +38,7 @@ fi
 
 # completion system {{{
 # just make sure it is loaded in this file too
+# TODO: is this *really* needed? compsys should be run in the global zshrc already.
 check_com compinit || { autoload -U compinit && compinit }
 # }}}
 
@@ -60,8 +64,6 @@ if [[ -z "$BROWSER" ]] ; then
         check_com -c w3m && export BROWSER=w3m
     fi
 fi
-#v#
-(( ${+PAGER} )) || export PAGER="less"
 
 #m# v QTDIR \kbd{/usr/share/qt[34]}\quad [for non-root only]
 [[ -d /usr/share/qt3 ]] && export QTDIR=/usr/share/qt3
@@ -604,39 +606,6 @@ show-archive() {
     fi
 }
 
-# TODO: isn't ssl() like this, but clean?
-#       I'd like to remove this, it's a gross hack, IMHO -ft
-#f5# Follow symlinks
-folsym() {
-    if [[ -e $1 || -h $1 ]] ; then
-        file=$1
-    else
-        file=`which $1`
-    fi
-    if [[ -e $file || -L $file ]] ; then
-        if [[ -L $file ]] ; then
-            echo `ls -ld $file | perl -ane 'print $F[7]'` '->'
-            folsym `perl -le '$file = $ARGV[0];
-                              $dest = readlink $file;
-                              if ($dest !~ m{^/}) {
-                                  $file =~ s{(/?)[^/]*$}{$1$dest};
-                              } else {
-                                  $file = $dest;
-                              }
-                              $file =~ s{/{2,}}{/}g;
-                              while ($file =~ s{[^/]+/\.\./}{}) {
-                                  ;
-                              }
-                              $file =~ s{^(/\.\.)+}{};
-                              print $file' $file`
-        else
-            ls -d $file
-        fi
-    else
-        echo $file
-    fi
-}
-
 # It's shameless stolen from <http://www.vim.org/tips/tip.php?tip_id=167>
 #f5# Use \kbd{vim} as your manpage reader
 vman() { man $* | col -b | view -c 'set ft=man nomod nolist' - }
@@ -908,17 +877,22 @@ git-get-commit() {
 }
 
 #f5# Get specific git diff
-git-get-plaindiff() {
+git-get-plaindiff () {
     if [[ -z $GITTREE ]] ; then
-        GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
+       GITTREE='linux/kernel/git/torvalds/linux-2.6.git'
     fi
-    if [[ -z $1 ]] ; then
-        wget "http://kernel.org/git/?p=$GITTREE;a=commitdiff_plain;h=$1" -O $1.diff
+    if [[ -z $1 ]] ; then
+       echo 'Usage: git-get-plaindiff '
     else
-        echo 'Usage: git-get-plaindiff '
+       echo -n "Downloading $1.diff ... "
+       # avoid "generating ..." stuff from kernel.org server:
+       wget --quiet "http://kernel.org/git/?p=$GITTREE;a=commitdiff_plain;h=$1" -O /dev/null
+       wget --quiet "http://kernel.org/git/?p=$GITTREE;a=commitdiff_plain;h=$1" -O $1.diff \
+            && echo done || echo failed
     fi
 }
 
+
 # http://strcat.de/blog/index.php?/archives/335-Software-sauber-deinstallieren...html
 #f5# Log 'make install' output
 mmake() {
@@ -1072,6 +1046,55 @@ zurl() {
         | sed 's/value=//;s/"//g'
 }
 
+#f2# Find history events by search pattern and list them by date.
+whatwhen()  {
+# {{{
+    local usage help ident format_l format_s first_char remain first last
+    usage='USAGE: whatwhen [options] <searchstring> <search range>'
+    help='Use' \`'whatwhen -h'\'' for further explanations.'
+    ident=${(l,${#${:-Usage: }},, ,)}
+    format_l="${ident}%s\t\t\t%s\n"
+    format_s="${format_l//(\\t)##/\\t}"
+    # Make the first char of the word to search for case
+    # insensitive; e.g. [aA]
+    first_char=[${(L)1[1]}${(U)1[1]}]
+    remain=${1[2,-1]}
+    # Default search range is `-100'.
+    first=${2:-\-100}
+    # Optional, just used for `<first> <last>' given.
+    last=$3
+    case $1 in
+        ("")
+            printf '%s\n\n' 'ERROR: No search string specified. Aborting.'
+            printf '%s\n%s\n\n' ${usage} ${help} && return 1
+        ;;
+        (-h)
+            printf '%s\n\n' ${usage}
+            print 'OPTIONS:'
+            printf $format_l '-h' 'show help text'
+            print '\f'
+            print 'SEARCH RANGE:'
+            printf $format_l "'0'" 'the whole history,'
+            printf $format_l '-<n>' 'offset to the current history number; (default: -100)'
+            printf $format_s '<[-]first> [<last>]' 'just searching within a give range'
+            printf '\n%s\n' 'EXAMPLES:'
+            printf ${format_l/(\\t)/} 'whatwhen grml' '# Range is set to -100 by default.'
+            printf $format_l 'whatwhen zsh -250'
+            printf $format_l 'whatwhen foo 1 99'
+        ;;
+        (\?)
+            printf '%s\n%s\n\n' ${usage} ${help} && return 1
+        ;;
+        (*)
+            # -l list results on stout rather than invoking $EDITOR.
+            # -i Print dates as in YYYY-MM-DD.
+            # -m Search for a - quoted - pattern within the history.
+            fc -li -m "*${first_char}${remain}*" $first $last
+        ;;
+    esac
+# }}}
+}
+
 # change fluxbox keys from 'Alt-#' to 'Alt-F#' and vice versa
 fluxkey-change() {
     [[ -n "$FLUXKEYS" ]] || local FLUXKEYS="$HOME/.fluxbox/keys"
@@ -1097,6 +1120,7 @@ fluxkey-change() {
 weather() {
     [[ -n "$1" ]] || {
         print 'Usage: weather <station_id>' >&2
+        print 'List of stations: http://en.wikipedia.org/wiki/List_of_airports_by_ICAO_code'>&2
         return 1
     }
 
@@ -1129,8 +1153,6 @@ weather() {
         return 1
     fi
 }
-
-
 # }}}
 
 # mercurial related stuff {{{