X-Git-Url: http://git.grml.org/?a=blobdiff_plain;f=doc%2Fgrmlzshrc.t2t;h=0b4c5b83e61ddcee506252e33dfae1d7acd8a7d6;hb=d923c855e3fe2e5f49960a17ec664d9adf7613b7;hp=1837a985d8cc9ae6343da4928f35e6ff8bf6486c;hpb=16e9ec67e0c4dbe11464ffc13a49f82bddabfa9e;p=grml-etc-core.git diff --git a/doc/grmlzshrc.t2t b/doc/grmlzshrc.t2t index 1837a98..0b4c5b8 100644 --- a/doc/grmlzshrc.t2t +++ b/doc/grmlzshrc.t2t @@ -1,6 +1,6 @@ GRMLZSHRC -Oktober, 2009 +June, 2010 %!target: man %!postproc(man): "^(\.TH.*) 1 " "\1 5 " @@ -58,6 +58,13 @@ and defaults to "/usr/share/command-not-found/command-not-found". Set this to zero to remove items in zsh config, which do not work in grml-small. +: **HISTFILE** +Where zsh saves the history. Default: ${HOME}/.zsh_history. + +: **HISTSIZE** +Number of commands to be kept in the history. On a grml-CD this defaults to +500, on a hard disk installation to 5000. + : **MAILCHECK** Sets the frequency in seconds for zsh to check for new mail. Defaults to 30. A value of zero turns off checking. @@ -77,6 +84,14 @@ that are run before every command (setting xterm/screen titles etc.). Show time (user, system and cpu) used by external commands, if they run longer than the defined number of seconds (default: 5). +: **SAVEHIST** +Number of commands to be stored in ${HISTFILE}. Defaults to 1000 on a grml-CD +and to 10000 on an installation on hard disk. + +: **watch** +As in tcsh(1) an array of login/logout events to be reported by the shell +builtin "log". For details see zshparam(1). Defaults to (notme root). + : **ZSH_NO_DEFAULT_LOCALE** Import "/etc/default/locale", if set to zero (default). @@ -285,6 +300,10 @@ of the terminal they are running in. If not already set, sets the default editor. Falls back to vi(1), if vim(1) is not available. +: **LESS_TERMCAP_*** +Some environment variables that add colour support to less(1) for viewing +man pages. See termcap(5) for details. + : **MAIL** The mailbox file for the current user is set to /var/mail/$USER, if not already set otherwise. @@ -415,6 +434,11 @@ Converts plaintext files to HTML using vim. The output is written to If 915resolution is available, issues a warning to the user to run it instead to modify the resolution on intel graphics chipsets. +: **accessed()** +Lists files in current directory, which have been accessed within the +last N days. N is an integer to be passed as first and only argument. +If no argument is specified N is set to 1. + : **agoogle()** Searches for USENET postings from authors using google groups. @@ -429,6 +453,12 @@ sequences) and the colors they represent. Pressing the 'asdf' keys toggles between dvorak or neon and us keyboard layout. +: **asc()** +Login on the host provided as argument using autossh. Then reattach a GNU screen +session if a detached session is around or detach a currently attached screen or +else start a new screen. This is especially useful for roadwarriors using GNU +screen and ssh. + : **audioburn()** Burns the files in ~/ripps (see audiorip() below) to an audio CD. Then prompts the user if she wants to remove that directory. You might need @@ -458,7 +488,8 @@ cdrecord. : **changed()** Lists files in current directory, which have been changed within the -last N days. N is an integer required as first and only argument. +last N days. N is an integer to be passed as first and only argument. +If no argument is specified N is set to 1. : **check_com()** Returns true if given command exists either as program, function, alias, @@ -520,36 +551,6 @@ thumbnails as clickable links to the respective original file. //Warning:// On start genthumbs() silently removes a possibly existing "index.html" and all files and/or directories beginning with "thumb-" in current directory! -: **getair()** -Tries to download, unpack and run AIR (imaging software) version 1.2.8. - -: **getgizmo()** -Tries to download and install Gizmo (VoIP software) for Debian. - -: **getskype()** -Tries to download and install Skype (VoIP software) for Debian. - -: **getskypebeta()** -Downloads and installs newer version of Skype. - -: **getxlite()** -Tries to download and unpack X-lite (VoIP software) from counterpath.com into -~/tmp. - -: **git-get-diff()** -Opens a specific git commitdiff from kernel.org in default browser. Tree is -chosen by the environment variable GITTREE which defaults to Linus Torvalds' -kernel tree. - -: **git-get-commit()** -Opens a specific git commit from kernel.org in default browser. The tree to -fetch from is controlled by the environment variable GITTREE which defaults -to Linus Torvalds' kernel tree. - -: **git-get-plaindiff()** -Fetches specific git diff from kernel.org. The tree is controlled by the -environment variable GITTREE which defaults to Linus Torvalds' kernel tree. - : **greph()** Searches the zsh command history for a regular expression. @@ -557,6 +558,13 @@ Searches the zsh command history for a regular expression. Prints the hexadecimal representation of the number supplied as argument (base ten only). +: **hgdi()** +Use GNU diff with options -ubwd for mercurial. + +: **hgstat()** +Displays diffstat between the revision given as argument and tip (no +argument means last revision). + : **hidiff()** Outputs highlighted diff; needs highstring(1). @@ -613,6 +621,10 @@ parameter. Lists images (i. e. files ending with ".jpg", ".gif" or ".png") in current directory. +: **linenr()** +Prints specified range of (numbered) lines of a file. +Usage: linenr [,] + : **makereadable()** Creates a PostScript and a PDF file (basename as first argument) from source code files. @@ -653,9 +665,10 @@ Creates a directory with first parameter as name inside $MAILDIR_ROOT Runs "make install" and logs the output under ~/.errorlogs/; useful for a clean deinstall later. -: **new()** +: **modified()** Lists files in current directory, which have been modified within the -last N days. N is an integer required as first and only argument. +last N days. N is an integer to be passed as first and only argument. +If no argument is specified N is set to 1. : **ogg2mp3_192()** Recodes an ogg file to mp3 with a bitrate of 192. @@ -789,6 +802,17 @@ line options, she always wants, in her .zshrc.local. : **vman()** Use vim(1) as manpage reader. +: **whatwhen()** +Searches the history for a given pattern and lists the results by date. +The first argument is the search pattern. The second and third ones are +optional and denote a search range (default: -100). + +: **weather()** +Retrieves and prints weather information from "http://weather.noaa.gov". +The first and only argument is the ICAO code for the desired station. +For a list of ICAO codes see +"http://en.wikipedia.org/wiki/List_of_airports_by_ICAO_code". + : **xcat()** Tries to cat(1) file(s) given as parameter(s). Always returns true. See also xunfunction() below. @@ -899,10 +923,16 @@ while watching a movie. : **CO** (//./configure//) Prepares compilation for building program from source. +: **cp** (//nocorrect cp//) +cp(1) without spelling correction. + : **da** (//du -sch//) Prints the summarized disk usage of the arguments as well as a grand total in human readable format. +: **dbp** (//dpkg-buildpackage//) +Builds binary or source packages from sources (See: dpkg-buildpackage(1)). + : **default** (//echo -en [ escape sequence ]//) Sets font of xterm to "-misc-fixed-medium-r-normal-*-*-140-*-*-c-*-iso8859-15" using escape sequence. @@ -922,6 +952,10 @@ can watch videos on a virtual tty. : **g** (//git//) Revision control system by Linus Torvalds. +: **ge** (//grep-excuses//) +Searches the testing excuses files for a specific maintainer (See: +grep-excuses(1)). + : **grep** (//grep --color=auto//) Shows grep output in nice colors, if available. @@ -934,6 +968,9 @@ Scans for new devices and updates /etc/fstab according to the findings. : **grml-version** (//cat /etc/grml_version//) Prints version of running grml. +: **hbp** (//hg-buildpackage//) +Helper program to maintain Debian packages with mercurial. + : **http** (//python -m SimpleHTTPServer//) Basic HTTP server implemented in python. Listens on port 8000/tcp and serves current directory. Implements GET and HEAD methods. @@ -953,6 +990,9 @@ Runs the function H-Glob() to expand or explain wildcards. : **hide** (//echo -en [ escape sequence ]//) Tries to hide xterm window using escape sequence. +: **hidiff** (//histring -fE '^Comparing files .*|^diff .*' | histring -c yellow -fE '^\-.*' | histring -c green -fE '^\+.*'//) +If histring(1) is installed, highlight important stuff in diff(1) output. + : **huge** (//echo -en [ escape sequence ]//) Sets huge font in xterm ("-misc-fixed-medium-r-normal-*-*-210-*-*-c-*-iso8859-15") using escape sequence. @@ -983,6 +1023,9 @@ if available. Includes file names starting with "." except "." and : **ll** (//ls -l --color=auto//) Lists files in long colored output format. +: **llog** (//$PAGER /var/log/syslog//) +Opens syslog in pager. + : **ls** (//ls -b -CF --color=auto//) Lists directory printing octal escapes for nongraphic characters. Entries are listed by columns and an indicator for file type is appended @@ -1027,11 +1070,30 @@ Lists only executable files. : **md** (//mkdir -p//) Creates directory including parent directories, if necessary +: **mdstat** (//cat /proc/mdstat//) +Lists all active md (i.e. linux software raid) devices with some information +about them. + : **medium** (//echo -en [ escape sequence ]//) Sets medium sized font ("-misc-fixed-medium-r-normal--13-120-75-75-c-80-iso8859-15") in xterm using escape sequence. +: **mkdir** (//nocorrect mkdir//) +mkdir(1) without spelling correction. + +: **mq** (//hg -R $(readlink -f $(hg root)/.hg/patches)//) +Executes the commands on the versioned patch queue from current repository. + +: **mv** (//nocorrect mv//) +mv(1) without spelling correction. + +: **rd** (//rmdir//) +Short rmdir(1) (remove directory). + +: **rm** (//nocorrect rm//) +rm(1) without spelling correction. + : **screen** (///usr/bin/screen -c ${HOME}/.screenrc//) If invoking user is root, starts screen session with /etc/grml/screenrc as config file. If invoked by a regular user, start a screen session @@ -1053,6 +1115,12 @@ anybody else. Grants read, write and execute permission of a file to the owner and read-only plus execute permission to anybody else. +: **S** (//screen//) +Short for screen(1). + +: **s** (//ssh//) +Short for ssh(1). + : **semifont** (//echo -en [ escape sequence ]//) Sets font of xterm to "-misc-fixed-medium-r-semicondensed-*-*-120-*-*-*-*-iso8859-15" using @@ -1069,11 +1137,25 @@ escape sequence. If user is running a grml live-CD, dont ask for any password, if she wants a root shell. +: **term2iso** (//echo 'Setting terminal to iso mode' ; print -n '\e%@'//) +Sets mode from UTF-8 to ISO 2022 (See: +http://www.cl.cam.ac.uk/~mgk25/unicode.html#term). + +: **term2utf** (//echo 'Setting terminal to utf-8 mode'; print -n '\e%G'//) +Sets mode from ISO 2022 to UTF-8 (See: +http://www.cl.cam.ac.uk/~mgk25/unicode.html#term). + : **tiny** (//echo -en [ escape sequence ]//) Sets tiny xterm font ("-misc-fixed-medium-r-normal-*-*-80-*-*-c-*-iso8859-15") using escape sequence. +: **tlog** (//tail -f /var/log/syslog//) +Prints syslog continuously (See tail(1)). + +: **top10** (//print -l ? ${(o)history%% *} | uniq -c | sort -nr | head -n 10//) +Prints the ten most used shell commands. + : **truec** (//truecrypt [ mount options ]//) Mount a truecrypt volume with some reasonable mount options ("rw,sync,dirsync,users,uid=1000,gid=users,umask=077" and "utf8", if @@ -1083,6 +1165,19 @@ available). Performs a system update followed by a system upgrade using aptitude; run by sudo, if necessary. See au and ag above. +: **url-quote** (//autoload -U url-quote-magic ; zle -N self-insert url-quote-magic//) +After calling, characters of URLs as typed get automatically escaped, if necessary, to +protect them from the shell. + +: **0** (//return 0//) +Gives a clean prompt (i.e. without $?). + +: **$(uname -r)-reboot** (//kexec -l --initrd=/boot/initrd.img-"$(uname -r)" --command-line=\"$(cat /proc/cmdline)\" /boot/vmlinuz-"$(uname -r)"//) +Reboots using kexec(8) and thus reduces boot time by skipping hardware initialization of BIOS/firmware. + +: **...** (cd ../../) +Changes current directory two levels higher. + : **?** (//qma zshall//) Runs the grml script qma (quick manual access) to build the collected man pages for the z-shell. This compressed file is kept at @@ -1277,7 +1372,7 @@ Beckert . = COPYRIGHT = -Copyright (c) 2009, grml project +Copyright (c) 2009-2010 grml project This manpage is distributed under the terms of the GPL version 2.